docs: add camonitor cli reference imported from CAref.html

documentation/ca-cli.md

@@ -6,4 +6,5 @@
 
 caget
 cainfo
+camonitor
 ```

modules/ca/src/tools/Makefile

@@ -26,5 +26,6 @@ PROD_LIBS = ca Com
 
 DOCS += caget.md
 DOCS += cainfo.md
+DOCS += camonitor.md
 
 include $(TOP)/configure/RULES

modules/ca/src/tools/camonitor.md

@@ -0,0 +1,122 @@
+# camonitor
+
+``` {program} camonitor
+```
+
+    camonitor [options] <PV name> ...
+
+## Description
+
+Subscribe to and print value updates for PV(s).
+
+## Options
+
+::: {option} -h
+Print usage information
+:::
+
+### CA options
+
+::: {option} -w <sec>
+Wait time, specifies longer CA timeout, default is 1.0 second.
+:::
+
+::: {option} -m <msk>
+Specify CA event mask to use.
+
+\<msk\> is any combination of `v` (value), `a` (alarm), `l` (log/archive),
+`p` (property).
+
+Default event mask is `va`
+:::
+
+::: {option} -p <prio>
+CA priority (0--99, default 0=lowest)
+:::
+
+### Timestamps
+
+Default: Print absolute timestamps (as reported by CA server)
+
+::: {option} -t <key>
+Specify timestamp source(s) and type, with \<key\> containing:
+
+`s` = CA server (remote) timestamps\
+`c` = CA client (local) timestamps (shown in `()`s)\
+`n` = no timestamps\
+`r` = relative timestamps (time elapsed since start of program)\
+`i` = incremental timestamps (time elapsed since last update)\
+`I` = incremental timestamps (time since last update, by channel)\
+
+`r`, `i` or `I` require `s` or `c` to select the time source.
+:::
+
+### Enum format
+
+::: {option} -n
+Print `DBF_ENUM` values as number (default is enum string)
+:::
+
+### Arrays
+
+Array values: Print number of elements, then list of values.
+
+By default: request and print all elements (dynamic arrays supported).
+
+::: {option} -# <count>
+Request and print first \<count\> elements of an array.
+:::
+
+::: {option} -S
+Print array of char as a string (long string).
+:::
+
+### Floating point format
+
+By default: use `%g` format.
+
+::: {option} -e <nr>
+Use `%e` format, with a precision of \<nr\> digits.
+:::
+
+::: {option} -f <nr>
+Use `%f` format, with a precision of \<nr\> digits.
+:::
+
+::: {option} -g <nr>
+Use `%g` format, with a precision of \<nr\> digits.
+:::
+
+::: {option} -s
+Get value as string (honors server-side precision).
+:::
+
+::: {option} -lx
+Round to long integer and print as hex number.
+:::
+
+::: {option} -lo
+Round to long integer and print as octal number.
+:::
+
+::: {option} -lb
+Round to long integer and print as binary number.
+:::
+
+### Integer number format
+
+By default: print as decimal number.
+
+::: {option} -0x
+Print as hex number.
+:::
+
+::: {option} -0o
+Print as octal number.
+:::
+
+::: {option} -0b
+Print as binary number.
+:::
+
+