From 1ae647168abdc129814e7b3d0955bcafca83fdba Mon Sep 17 00:00:00 2001
From: Richard Russon <rich@flatcap.org>
Date: Tue, 2 Aug 2016 10:18:01 +0100
Subject: [PATCH] docs: smime-encrypt-self

---
 doc/manual.xml.head           | 106 ++++++++++++++++++++++++++++++++++
 doc/muttrc.smime-encrypt-self |  10 ++++
 doc/vimrc.smime-encrypt-self  |   5 ++
 3 files changed, 121 insertions(+)
 create mode 100644 doc/muttrc.smime-encrypt-self
 create mode 100644 doc/vimrc.smime-encrypt-self

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 5704f3087..03ca20440 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -12103,6 +12103,112 @@ set skip_quoted_offset = 3
   </sect2>
 </sect1>
 
+<sect1 id="smime-encrypt-self-patch">
+  <title>smime-encrypt-self Patch</title>
+  <subtitle>Save an self-encrypted copy of emails</subtitle>
+
+  <sect2 id="smime-encrypt-self-patch2">
+    <title>Patch</title>
+
+    <para>
+      To check if Mutt supports <quote>smime-encrypt-self</quote>, look for
+      <quote>patch-smime-encrypt-self</quote> in the mutt version.
+      See: <xref linkend="mutt-patches"/>.
+    </para>
+
+    <itemizedlist>
+      <title>Dependencies:</title>
+      <listitem><para>mutt-1.6.2</para></listitem>
+    </itemizedlist>
+
+    <para>This patch is part of the <ulink url="http://www.neomutt.org/">NeoMutt Project</ulink>.</para>
+  </sect2>
+
+  <sect2 id="smime-encrypt-self-intro">
+    <title>Introduction</title>
+
+    <para>
+      Once you encrypt an email to someone you cannot read it.  This is good
+      for security, but bad for record-keeping.  If you wanted to keep a copy
+      of an encrypted email you could set <link linkend="fcc-clear">$fcc_clear</link>.
+    </para>
+
+    <para>
+      A better option is to enable
+      <link linkend="smime-encrypt-self">$smime_encrypt_self</link>, then set
+      <link linkend="smime-default-key">$smime_default_key</link> to your
+      personal S/MIME key id.
+    </para>
+
+<screen>
+set smime_encrypt_self = yes
+set smime_default_key  = bb345e23.0
+</screen>
+
+  </sect2>
+
+  <sect2 id="smime-encrypt-self-variables">
+    <title>Variables</title>
+
+    <table id="table-smime-encrypt-self-variables">
+      <title>smime-encrypt-self Variables</title>
+      <tgroup cols="3">
+        <thead>
+          <row>
+            <entry>Name</entry>
+            <entry>Type</entry>
+            <entry>Default</entry>
+          </row>
+        </thead>
+        <tbody>
+          <row>
+            <entry><literal>smime_encrypt_self</literal></entry>
+            <entry>quad</entry>
+            <entry>No</entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
+  </sect2>
+
+  <sect2 id="smime-encrypt-self-muttrc">
+    <title>Muttrc</title>
+<screen>
+<emphasis role="comment"># This is a complete list of smime-encrypt-self-related configuration.
+ 
+# --------------------------------------------------------------------------
+# VARIABLES - shown with their default values
+# --------------------------------------------------------------------------
+ 
+# Save a copy of outgoing email, encrypted to yourself</emphasis>
+set smime_encrypt_self = "no"
+ 
+<emphasis role="comment"># vim: syntax=muttrc</emphasis>
+</screen>
+  </sect2>
+
+  <sect2 id="smime-encrypt-self-see-also">
+    <title>See Also</title>
+
+    <itemizedlist>
+      <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
+    </itemizedlist>
+  </sect2>
+
+  <sect2 id="smime-encrypt-self-known-bugs">
+    <title>Known Bugs</title>
+    <para>None</para>
+  </sect2>
+
+  <sect2 id="smime-encrypt-self-credits">
+    <title>Credits</title>
+    <itemizedlist>
+    <listitem><para>Omen Wild <email>omen@mandarb.com</email></para></listitem>
+    <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
+    </itemizedlist>
+  </sect2>
+</sect1>
+
 </chapter>
 
 <chapter id="security">
diff --git a/doc/muttrc.smime-encrypt-self b/doc/muttrc.smime-encrypt-self
new file mode 100644
index 000000000..0ef7c481f
--- /dev/null
+++ b/doc/muttrc.smime-encrypt-self
@@ -0,0 +1,10 @@
+# This is a complete list of smime-encrypt-self-related configuration.
+
+# --------------------------------------------------------------------------
+# VARIABLES - shown with their default values
+# --------------------------------------------------------------------------
+
+# Save a copy of outgoing email, encrypted to yourself
+set smime_encrypt_self = "no"
+
+# vim: syntax=muttrc
diff --git a/doc/vimrc.smime-encrypt-self b/doc/vimrc.smime-encrypt-self
new file mode 100644
index 000000000..7fe9357da
--- /dev/null
+++ b/doc/vimrc.smime-encrypt-self
@@ -0,0 +1,5 @@
+" Vim syntax file for the mutt smime-encrypt-self patch
+
+syntax keyword muttrcVarQuad    contained skipwhite muttrcVarQuad
+
+" vim: syntax=vim
-- 
2.40.0