From ab90e557caa2b50704fdb899483ab5b76da440ed Mon Sep 17 00:00:00 2001
From: John Kerl <kerl.john.r@gmail.com>
Date: Sat, 21 Nov 2015 18:02:22 -0500
Subject: [PATCH] doc neaten

---
 doc/content-for-reference.html | 18 ++++++++++++++++--
 doc/reference.html             | 18 ++++++++++++++++--
 2 files changed, 32 insertions(+), 4 deletions(-)

diff --git a/doc/content-for-reference.html b/doc/content-for-reference.html
index 8e02d5b14..9e911ea05 100644
--- a/doc/content-for-reference.html
+++ b/doc/content-for-reference.html
@@ -990,8 +990,22 @@ filter '$url =~ "http.*com"'</tt>
 
 </ul>
 
-<p/>The <tt>i</tt> after the double-quoted regular-expression string is used to
-signify case-insensitive match.
+<p/>Points demonstrated by the above examples:
+
+<ul>
+
+<li/> There are no implicit start-of-string or end-of-string anchors; please
+use <tt>^</tt> and/or <tt>$</tt> explicitly.
+
+<li/> Miller regexes are wrapped with double quotes rather than slashes.
+
+<li/> The <tt>i</tt> after the ending double quote indicates a case-insensitive
+regex.
+
+<li/> Capture groups are wrapped with <tt>(...)</tt> rather than
+<tt>\(...\)</tt>; use <tt>\(</tt> and <tt>\)</tt> to match against parentheses.
+
+</ul>
 
 <p/>For <tt>filter</tt> and <tt>put</tt>, if the regular expression is a string
 literal (the normal case), it is precompiled at process start and reused
diff --git a/doc/reference.html b/doc/reference.html
index 030258266..a1b7c23d4 100644
--- a/doc/reference.html
+++ b/doc/reference.html
@@ -3310,8 +3310,22 @@ filter '$url =~ "http.*com"'</tt>
 
 </ul>
 
-<p/>The <tt>i</tt> after the double-quoted regular-expression string is used to
-signify case-insensitive match.
+<p/>Points demonstrated by the above examples:
+
+<ul>
+
+<li/> There are no implicit start-of-string or end-of-string anchors; please
+use <tt>^</tt> and/or <tt>$</tt> explicitly.
+
+<li/> Miller regexes are wrapped with double quotes rather than slashes.
+
+<li/> The <tt>i</tt> after the ending double quote indicates a case-insensitive
+regex.
+
+<li/> Capture groups are wrapped with <tt>(...)</tt> rather than
+<tt>\(...\)</tt>; use <tt>\(</tt> and <tt>\)</tt> to match against parentheses.
+
+</ul>
 
 <p/>For <tt>filter</tt> and <tt>put</tt>, if the regular expression is a string
 literal (the normal case), it is precompiled at process start and reused