Add a "backticks in double quotes" example to the manual.

Co-authored-by: Richard Russon <rich@flatcap.org>

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 3896798de8a331821a0ce96df47a5776fbe0942d..2fdb76d694c12c69c2751a647c6ff914bbdf984f 100644 (file)
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -3742,6 +3742,19 @@ over several lines"
         <title>Using external command's output in configuration files</title>
         <screen>my_hdr X-Operating-System: `uname -a`</screen>
       </example>
+      <para>
+        To avoid the output of backticks being parsed, place them inside double
+        quotes.  In <xref linkend="ex-backtick-dblquotes"/>, the output of the
+        gpg decryption is assigned directly to $imap_pass, so that special
+        characters in the password (e.g.<quote>'</quote>, <quote>#</quote>,
+        <quote>$</quote>) are not parsed and interpreted specially by neomutt.
+      </para>
+      <example id="ex-backtick-dblquotes">
+        <title>Preventing the output of backticks from being parsed</title>
+<screen>
+set imap_pass="`gpg --batch -q --decrypt ~/.neomutt/account.gpg`"
+</screen>
+      </example>
       <para>
         Both environment variables and NeoMutt variables can be accessed by
         prepending <quote>$</quote> to the name of the variable. For example,