From d65af720d175607a0ea25b1a337bfb9c4c5f00c7 Mon Sep 17 00:00:00 2001
From: Michael Davidsaver <mdavidsaver@gmail.com>
Date: Sat, 28 Nov 2020 09:26:40 -0800
Subject: [PATCH] doc

---
 documentation/qsrvpage.dox      | 21 ++++++++++++++++++++-
 documentation/release_notes.dox |  8 ++++++++
 2 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/documentation/qsrvpage.dox b/documentation/qsrvpage.dox
index d5993b7..41ea4c0 100644
--- a/documentation/qsrvpage.dox
+++ b/documentation/qsrvpage.dox
@@ -23,7 +23,9 @@ which is also the PV name.
 So unlike records, the "field" of a group have a different meaning.
 Group field names are _not_ part of the PV name.
 
-A group definition is split among several records.
+A group definition may be split among several records,
+or included in separate JSON file(s).
+
 For example of a group including two records is:
 
 @code
@@ -43,6 +45,23 @@ record(ai, "rec:Y") {
 }
 @endcode
 
+Or equivalently with separate .db file and .json files.
+
+@code
+# some .db
+record(ai, "rec:X") {}
+record(ai, "rec:Y") {}
+@endcode
+
+@code
+{
+    "grp:name": {
+        "X": {+channel:"VAL"},
+        "Y": {+channel:"VAL"}
+    }
+}
+@endcode
+
 This group, named "grp:name", has two fields "X" and "Y".
 
 @code
diff --git a/documentation/release_notes.dox b/documentation/release_notes.dox
index c0b5cf6..00e5d8c 100644
--- a/documentation/release_notes.dox
+++ b/documentation/release_notes.dox
@@ -2,6 +2,14 @@
 
 @page release_notes Release Notes
 
+Release 1.3.0 (UNRELEASED)
+==========================
+
+- Changes
+ - Add dbLoadGroup() iocsh function to read group JSON definitions
+   from a file.  Mappings in files must refer to full record names
+   instead of fields.  eg. 'recname.VAL' instead of 'VAL'.
+
 Release 1.2.4 (July 2020)
 =========================