From 11399da5fa9a85c74dbc47db5613fc13cebdb3b7 Mon Sep 17 00:00:00 2001
From: Ben Kibbey <bjk@luxsci.net>
Date: Sun, 21 Feb 2021 19:18:14 -0800
Subject: [PATCH] docs: Update to add LIST --sexp.

---
 doc/pwmd.html  | 16 ++++++++++++++--
 src/commands.c | 14 +++++++++++++-
 2 files changed, 27 insertions(+), 3 deletions(-)

diff --git a/doc/pwmd.html b/doc/pwmd.html
index bba9e62c..261d797d 100644
--- a/doc/pwmd.html
+++ b/doc/pwmd.html
@@ -1225,7 +1225,7 @@ Next: <a href="#LISTKEYS" accesskey="n" rel="next">LISTKEYS</a>, Previous: <a hr
 <span id="index-LIST-command"></span>
 <p>Syntax:
 </p><div class="example">
-<pre class="example">LIST [--inquire] [--recurse] [element[&lt;TAB&gt;child[..]]]
+<pre class="example">LIST [--inquire] [--recurse] [--sexp] [element[&lt;TAB&gt;child[..]]]
 </pre></div>
 
 <p>If no element path is given then a newline separated list of root elements 
@@ -1254,7 +1254,19 @@ same error flag.
 The option <samp>--recurse</samp> may be used to list the entire element tree 
 for a specified element path or the entire tree for all root elements.
 <br><br>
-When the <samp>--inquire</samp> option is passed then all remaining non-option 
+The option <samp>--sexp</samp> outputs the list in an s-expression and also 
+appends an elements&rsquo; attributes and attribute values. The syntax is:
+</p>
+<div class="example">
+<pre class="example">(11:list-result
+  (4:path N:&lt;path&gt; 5:flags N:&lt;flags&gt;
+    (5:attrs N:&lt;name&gt; N:&lt;value&gt; ...)
+  )
+  ...
+)
+</pre></div>
+
+<p>When the <samp>--inquire</samp> option is passed then all remaining non-option 
 arguments are retrieved via a server <em>INQUIRE</em>.
 </p>
 
diff --git a/src/commands.c b/src/commands.c
index e46213eb..21370ca4 100644
--- a/src/commands.c
+++ b/src/commands.c
@@ -5463,7 +5463,7 @@ init_commands ()
 ));
 
     new_command("LIST", 0, 0, 1, 0, list_command, _(
-"LIST [--inquire] [--recurse] [element[<TAB>child[..]]]\n" /* Showing document elements. */
+"LIST [--inquire] [--recurse] [--sexp] [element[<TAB>child[..]]]\n" /* Showing document elements. */
 "If no element path is given then a newline separated list of root elements "
 "is returned with a data response. If given, then children of the specified "
 "element path are returned."
@@ -5490,6 +5490,18 @@ init_commands ()
 "The option @option{--recurse} may be used to list the entire element tree "
 "for a specified element path or the entire tree for all root elements."
 "@*@*"
+"The option @option{--sexp} outputs the list in an s-expression and also "
+"appends an elements' attributes and attribute values. The syntax is:\n"
+"\n"
+"@example\n"
+"(11:list-result\n"
+"  (4:path N:<path> 5:flags N:<flags>\n"
+"    (5:attrs N:<name> N:<value> ...)\n"
+"  )\n"
+"  ...\n"
+")\n"
+"@end example\n"
+"\n"
 "When the @option{--inquire} option is passed then all remaining non-option "
 "arguments are retrieved via a server @emph{INQUIRE}."
 ));
-- 
2.11.4.GIT