]> granicus.if.org Git - neomutt/commitdiff
docs: quasi-delete
authorRichard Russon <rich@flatcap.org>
Tue, 2 Aug 2016 09:17:45 +0000 (10:17 +0100)
committerRichard Russon <rich@flatcap.org>
Thu, 18 Aug 2016 14:51:02 +0000 (15:51 +0100)
doc/manual.xml.head
doc/muttrc.quasi-delete [new file with mode: 0644]
doc/vimrc.quasi-delete [new file with mode: 0644]

index 8fab50e0d961b4e94b0f4700b26f081bb9064448..d0ba1c20fd68b7aa80e32e857125a58a134f11b9 100644 (file)
@@ -11580,6 +11580,126 @@ color progress white red
   </sect2>
 </sect1>
 
+<sect1 id="quasi-delete">
+  <title>Quasi-Delete Patch</title>
+  <subtitle>Mark emails that should be hidden, but not deleted</subtitle>
+
+  <sect2 id="quasi-delete-patch">
+    <title>Patch</title>
+
+    <para>
+      To check if Mutt supports <quote>Quasi-Delete</quote>, look for
+      <quote>patch-quasi-delete</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="quasi-delete-intro">
+    <title>Introduction</title>
+
+        <para>
+    The <quote>quasi-delete</quote> function marks an email that should be
+    hidden from the index, but NOT deleted.
+        </para>
+
+        <para>
+    On its own, this patch isn't very useful.  It forms a useful part of
+    the notmuch plugin.
+        </para>
+  </sect2>
+
+<!--
+  <sect2 id="quasi-delete-variables">
+    <title>Variables</title>
+    <para>None</para>
+  </sect2>
+-->
+
+  <sect2 id="quasi-delete-functions">
+    <title>Functions</title>
+    <table id="table-quasi-delete-functions">
+      <title>Quasi-Delete Functions</title>
+      <tgroup cols="4">
+        <thead>
+          <row>
+            <entry>Menus</entry>
+            <entry>Default Key</entry>
+            <entry>Function</entry>
+            <entry>Description</entry>
+          </row>
+        </thead>
+        <tbody>
+          <row>
+            <entry>index,pager</entry>
+            <entry>(none)</entry>
+            <entry><literal>&lt;quasi-delete&gt;</literal></entry>
+            <entry>delete from mutt, don't touch on disk</entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
+  </sect2>
+
+<!--
+  <sect2 id="quasi-delete-commands">
+    <title>Commands</title>
+    <para>None</para>
+  </sect2>
+
+  <sect2 id="quasi-delete-colors">
+    <title>Colors</title>
+    <para>None</para>
+  </sect2>
+
+  <sect2 id="quasi-delete-sort">
+    <title>Sort</title>
+    <para>None</para>
+  </sect2>
+-->
+
+  <sect2 id="quasi-delete-muttrc">
+    <title>Muttrc</title>
+<screen>
+<emphasis role="comment"># Example Mutt config file for the 'quasi-delete' feature.
+# The 'quasi-delete' function marks an email that should be hidden
+# from the index, but NOT deleted.</emphasis>
+bind index,pager Q quasi-delete
+<emphasis role="comment"># vim: syntax=muttrc</emphasis>
+</screen>
+  </sect2>
+
+  <sect2 id="quasi-delete-see-also">
+    <title>See Also</title>
+
+    <itemizedlist>
+      <listitem><para><ulink url="http://www.neomutt.org/">NeoMutt Project</ulink></para></listitem>
+      <listitem><para><link linkend="notmuch">notmuch patch</link></para></listitem>
+    </itemizedlist>
+  </sect2>
+
+  <sect2 id="quasi-delete-known-bugs">
+    <title>Known Bugs</title>
+    <para>None</para>
+  </sect2>
+
+  <sect2 id="quasi-delete-credits">
+    <title>Credits</title>
+    <itemizedlist>
+    <listitem><para>Karel Zak <email>kzak@redhat.com</email></para></listitem>
+    <listitem><para>Richard Russon <email>rich@flatcap.org</email></para></listitem>
+    </itemizedlist>
+  </sect2>
+</sect1>
+
 <sect1 id="sidebar">
   <title>Sidebar</title>
   <subtitle>Overview of mailboxes</subtitle>
diff --git a/doc/muttrc.quasi-delete b/doc/muttrc.quasi-delete
new file mode 100644 (file)
index 0000000..67031ff
--- /dev/null
@@ -0,0 +1,7 @@
+# Example Mutt config file for the 'quasi-delete' feature.
+
+# The 'quasi-delete' function marks an email that should be hidden
+# from the index, but NOT deleted.
+bind index,pager Q quasi-delete
+
+# vim: syntax=muttrc
diff --git a/doc/vimrc.quasi-delete b/doc/vimrc.quasi-delete
new file mode 100644 (file)
index 0000000..f8a69e7
--- /dev/null
@@ -0,0 +1,5 @@
+" Vim syntax file for the mutt quasi-delete patch
+
+syntax match muttrcFunction     contained "\<quasi-delete\>"
+
+" vim: syntax=vim