Merge pull request #379 from sshanks-kx/fixes

fix broken links

Author: iciobanukx

docs/basics/by-topic.md

@@ -112,7 +112,7 @@ QLIC     | folder searched for `k4.lic` or `kc.lic` license key file | `$QHOME`:
 ## [Interprocess communication](ipc.md)
 
 <div markdown="1" class="typewriter">
-[\p](syscmds.md#listening-port)  [-p](cmdline.md#listening-port)          listen to port
+[\p](syscmds.md#p-listening-port)  [-p](cmdline.md#-p-listening-port)          listen to port
 [hopen hclose](../ref/hopen.md)    open/close connection
 [.z](../ref/dotz.md)              callbacks
 </div>
@@ -251,11 +251,11 @@ QLIC     | folder searched for `k4.lic` or `kc.lic` license key file | `$QHOME`:
 [lower](../ref/lower.md)   shift to lower case
 [ltrim](../ref/trim.md)   trim leading space
 [md5](../ref/md5.md)     hash from string
-[rtrim](../ref/trim.md#rtrim)   trim trailing space
+[rtrim](../ref/trim.md)   trim trailing space
 [ss](../ref/ss.md#ss)      string search
 [ssr](../ref/ss.md#ssr)     string search and replace
 [trim](../ref/trim.md)    trim leading and trailing space
-[upper](../ref/lower.md#upper)   shift to upper case
+[upper](../ref/lower.md)   shift to upper case
 </div>
 
 

docs/basics/datatypes.md

@@ -229,9 +229,6 @@ q)0w + 5
 0w
 ```
 
-:fontawesome-solid-book:
-[`.Q.M`](../ref/dotq.md#m-long-infinity) (long infinity)
-
 ??? detail "To infinity and beyond"
 
     Floating-point arithmetic follows [IEEE754](https://en.wikipedia.org/wiki/IEEE_754 "Wikipedia").

docs/basics/debug.md

@@ -230,7 +230,7 @@ q))&
 
 The debugger restores the original namespace and language (q or k) setting for each frame.
 
-View calculations and system commands, including [`\l`](syscmds.md#l-load), correspond to individual debug stack frames.
+View calculations and system commands, including [`\l`](syscmds.md#l-load-file-or-directory), correspond to individual debug stack frames.
 
 ```q
   .d1 ).Q.bt`

docs/basics/errors.md

@@ -390,7 +390,7 @@ pread
 pwuid
 
 :   OS is missing libraries for `getpwuid`.
-    (Most likely 32-bit app on 64-bit OS. Try to [install ia32-libs](../learn/install.md#step-2-put-kdb-in-qhome).)
+    (Most likely 32-bit app on 64-bit OS. Try to [install ia32-libs](../learn/install.md).)
 
 :   or
 
@@ -629,7 +629,7 @@ error | explanation
 [](){#cpu}cpu | The license is for fewer CPUs than available
 [](){#exp}exp | License expiry date is prior to system date. The license has expired. Commercial license holders should have their Designated Contacts reach out to licadmin@kx.com or contact sales@kx.com to begin a new commercial agreement.
 [](){#host}host | The hostname reported by the OS does not match the hostname or hostname-pattern in the license.<br><br>If you see `255.255.255.255` in the kdb+ banner, the machine likely cannot resolve its hostname to an IP address, which will cause a `host` error.<br><br>Since 4.1t 2022.07.01,4.0 2022.07.01 the detected hostname is printed. It can be used to compare with the hostname used within the license.
-[](){#k4.lic}k4.lic | `k4.lic` file not found. If the environment variable [`QLIC`](../learn/licensing.md#keeping-the-license-key-file-elsewhere) is set, check it is set to the directory containing the license file. **Note** that it should not be set to the location of the license file itself, but to the directory that contains the license file.  If `QLIC` is not set, check that the directory specified by the environment variables [`QHOME`](../learn/install.md#step-2-put-kdb-in-qhome) contains the license file.
+[](){#k4.lic}k4.lic | `k4.lic` file not found. If the environment variable [`QLIC`](../learn/licensing.md#keeping-the-license-key-file-elsewhere) is set, check it is set to the directory containing the license file. **Note** that it should not be set to the location of the license file itself, but to the directory that contains the license file.  If `QLIC` is not set, check that the directory specified by the environment variables [`QHOME`](../learn/install.md#step-2-unzip-your-download) contains the license file.
 [](){#os}os | Wrong OS or operating-system error (if runtime error)
 [](){#srv}srv | Client-only license in server mode
 [](){#upd}upd | Version of kdb+ more recent than update date, _or_ the function `upd` is undefined (sometimes encountered during ``-11!`:logfile``)

docs/basics/funsql.md

@@ -41,7 +41,7 @@ where:
 * `c` is the [Where phrase](qsql.md#where-phrase), a list of constraints.  
 Every constraint in `c` is a [parse tree](parsetrees.md) representing an expression to be evaluated; the result of each being a boolean vector. The parse tree consists of a function followed by a list of its arguments, each an expression containing column names and other variables. Represented by symbols, it distinguishes actual symbol constants by enlisting them. The function is applied to the arguments, producing a boolean vector that selects the rows. The selection is performed in the order of the items in `c`, from left to right: only rows selected by one constraint are evaluated by the next.
 <!-- : Every item in `c` is a triple consisting of a boolean- or int- valued binary function together with its arguments, each an expression containing column names and other variables. The function is applied to the two arguments, producing a boolean vector. The resulting boolean vector selects the rows that yield non-zero results. The selection is performed in the order of the items in `c`, from left to right. -->
-* `b` is the [By phrase](qsql.md#by-phrase).  
+* `b` is the [By phrase](../ref/select.md#by-phrase).  
 The domain of dictionary `b` is a list of symbols that are the key names for the grouping. Its range is a list of column expressions (parse trees) whose results are used to construct the groups. The grouping is ordered by the domain items, from major to minor.
 `b` is one of:
     -   the general empty list `()`
@@ -160,7 +160,7 @@ y   | 15 29
 
 ### Select distinct
 
-For special case [`select distinct`](../ref/select.md#distinct) specify `b` as `1b`.
+For special case [`select distinct`](../ref/select.md#limit-expression) specify `b` as `1b`.
 
 ```q
 q)t:([] c1:`a`b`a`c`b`c; c2:1 1 1 2 2 2; c3:10 20 30 40 50 60)
@@ -715,7 +715,7 @@ q)(#;3;enlist `a`b`c`d`e`f)~parse"3#`a`b`c`d`e`f"
 1b
 ```
 
-This causes a difficulty. As [discussed above](#variadic-operators), q has no unary syntax for operators.
+This causes a difficulty as q has no unary syntax for operators.
 
 Which means the following isn’t a valid q expression and so returns an error.
 

docs/basics/glossary.md

@@ -135,7 +135,7 @@ Characters ignored by the interpreter.
 A communication handle specifies a network resource.
 
 :fontawesome-solid-book:
-[Communication handles](../ref/hopen.md#Communication-handles)
+[Communication handles](../ref/hopen.md#communication-handles)
 <br>
 :fontawesome-solid-street-view:
 _Q for Mortals_

docs/basics/ipc.md

@@ -9,7 +9,7 @@ description: TCP/IP is used for communicating between processes. The protocol is
 _Simple, powerful, fast_
 
 <div markdown="1" class="typewriter">
-[\p](syscmds.md#listening-port)  [-p](cmdline.md#listening-port)          listen to port
+[\p](syscmds.md#p-listening-port)  [-p](cmdline.md#-p-listening-port)          listen to port
 [hopen hclose](../ref/hopen.md)    open/close connection
 [.z](../ref/dotz.md)              handle message (callbacks)
 </div>

docs/basics/peach.md

@@ -13,7 +13,7 @@ keywords: kdb+, parallel, parallel each, peach, q, uniform
 The iterator [Each Parallel](../ref/maps.md#each-parallel) `':` (or its mnemonic keyword `peach`) delegates processing to secondary tasks for parallel execution. 
 This can be useful, for example, for computationally expensive functions, or for accessing several drives at once from a single CPU.
 
-To execute in parallel, start kdb+ with multiple secondary processes, using [`-s` in the command line](cmdline.md#-s-secondary-threads), and (since V3.5) the [`\s`](syscmds.md#s-number-of-secondary-processes) system command.
+To execute in parallel, start kdb+ with multiple secondary processes, using [`-s` in the command line](cmdline.md#-s-secondary-threads), and (since V3.5) the [`\s`](syscmds.md#s-number-of-secondary-threads) system command.
 
 Each Parallel iterates a unary value: the argument list of the derived function is divided between secondary processes for evaluation. 
 
@@ -45,7 +45,7 @@ q)\ts .[g;]peach flip(2#1000000;2 3)
 32 1744
 ```
 
-The secondary processes used by Parallel Each and `peach` are either threads or processes according to the sign of the [value used in the command line](cmdline.md#-s-secondary-processes).
+The secondary processes used by Parallel Each and `peach` are either threads or processes according to the sign of the [value used in the command line](cmdline.md#-s-secondary-threads).
 
 
 ## Threads

docs/basics/syntax.md

@@ -383,7 +383,7 @@ A sequence of expressions separated by semicolons and surrounded by left and rig
 
 The first expression in a function expression can be a _signature_: an argument expression of the form `[name1;name2;…;nameN]` naming the arguments of the function. Like bracket notation, function notation does not require at least one semicolon; one expression (or none) between braces will do.
 
-Within a script, a function may be defined across [multiple lines](#multi-line-expressions).
+Within a script, a function may be defined across [multiple lines](#multiline-expressions).
 
 :fontawesome-solid-book-open: 
 [Function notation](function-notation.md)

docs/basics/syscmds.md

@@ -371,7 +371,7 @@ If the subsequent attempt fail, the request exits with [`'wsfull`](../basics/err
 
     : If most of the objects allocated from a 64MB slab are freed but one remains, the slab still cannot be returned to the OS (or coalesced). 
 
-The following example shows freeing an object ≥64MB in `deferred` mode, while inspecting memory usage via [`.Q.w[]`](../ref/dotq.md##w-memory-stats):
+The following example shows freeing an object ≥64MB in `deferred` mode, while inspecting memory usage via [`.Q.w[]`](../ref/dotq.md#w-memory-stats):
 ```q
 q).Q.w[]`used`heap    / original memory used and memory reserved by kdb+ at time of test
 371552 67108864
@@ -457,7 +457,7 @@ q)\a                 / with tables quote and trade
 `p`quote`s`sp`trade
 ```
 
-If [logging](../kb/logging.md) is enabled, the command [checkpoints](../kb/logging.md#check-pointing) the `.qdb` file and empties the log file.
+If [logging](../kb/logging.md) is enabled, the command [checkpoints](../kb/logging.md#check-pointing-rolling) the `.qdb` file and empties the log file.
 
 
 !!! danger "Operating systems may create hidden files, such as `DS_Store`, that block `\l` on a directory."