From 26e9e407f648107900e7e6cf78aa2359c032eda4 Mon Sep 17 00:00:00 2001
From: Minijackson <minijackson@riseup.net>
Date: Fri, 24 Jan 2025 11:30:55 +0100
Subject: [PATCH] docs: add ca_test cli reference imported from CAref.html

---
 documentation/ca-cli.md          |  1 +
 modules/ca/src/client/Makefile   |  1 +
 modules/ca/src/client/ca_test.md | 10 ++++++++++
 3 files changed, 12 insertions(+)
 create mode 100644 modules/ca/src/client/ca_test.md

diff --git a/documentation/ca-cli.md b/documentation/ca-cli.md
index 85079cde1..fada7b09e 100644
--- a/documentation/ca-cli.md
+++ b/documentation/ca-cli.md
@@ -18,4 +18,5 @@ acctst
 catime
 casw
 caEventRate
+ca_test
 ```
diff --git a/modules/ca/src/client/Makefile b/modules/ca/src/client/Makefile
index c0cfbc4db..52600fc34 100644
--- a/modules/ca/src/client/Makefile
+++ b/modules/ca/src/client/Makefile
@@ -16,6 +16,7 @@ DOCS += acctst.md
 DOCS += catime.md
 DOCS += casw.md
 DOCS += caEventRate.md
+DOCS += ca_test.md
 
 #
 #	includes to install from this subproject
diff --git a/modules/ca/src/client/ca_test.md b/modules/ca/src/client/ca_test.md
new file mode 100644
index 000000000..c0b3c3fd4
--- /dev/null
+++ b/modules/ca/src/client/ca_test.md
@@ -0,0 +1,10 @@
+# ca_test
+
+    ca_test <PV name> [value to be written]
+
+## Description
+
+If a value is specified it is written to the PV. Next, the current value
+of the PV is converted to each of the many external data type that can
+be specified at the CA client library interface, and each of these is
+formated and then output to the console.