updated manpages using fingerterm on N9

[notmuch-wiki] / manpages / notmuch-search-1.mdwn

diff --git a/manpages/notmuch-search-1.mdwn b/manpages/notmuch-search-1.mdwn
index e8b6c279d39d364d44f8556352293b1b90f2e058..4de091628229f4de616372191bcf0c6465b8e21e 100644 (file)
--- a/manpages/notmuch-search-1.mdwn
+++ b/manpages/notmuch-search-1.mdwn
@@ -71,6 +71,10 @@
                    null  characters  (--format=text0), as a JSON array (--for-
                    mat=json), or as an S-Expression list (--format=sexp).
 
+                   Note that each message may have multiple filenames  associ-
+                   ated  with  it.   All  of  them are included in the output,
+                   unless limited with the --duplicate=N option.
+
                <b>tags</b>
 
                    Output all tags that appear on  any  message  matching  the
@@ -82,8 +86,8 @@
            <b>--sort=</b>(<b>newest-first</b>|<b>oldest-first</b>)
 
                This option can be used to present results in either chronolog-
-               ical  order (<b>oldest-first</b>) or reverse chronological order (<b>new-</b>
-               <b>est-first</b>).
+               ical   order  (<b>oldest-first</b>)  or  reverse  chronological  order
+               (<b>newest-first</b>).
 
                Note: The thread order  will  be  distinct  between  these  two
                options  (beyond  being  simply reversed). When sorting by <b>old-</b>
@@ -125,6 +129,17 @@
                almost  identical to <b>false</b>, but the &quot;match count&quot; is the number
                of matching non-excluded messages in the  thread,  rather  than
                the number of matching messages.
+
+           <b>--duplicate=N</b>
+
+               Effective  with <b>--output=files</b>, output the Nth filename associ-
+               ated with each message matching the query (N is 1-based). If  N
+               is  greater  than  the number of files associated with the mes-
+               sage, don&apos;t print anything.
+
+               Note that this option is orthogonal  with  the  <b>folder:</b>  search
+               prefix.  The  prefix  matches messages based on filenames. This
+               option filters filenames of the matching messages.
 </pre>
 
 <h2>EXIT STATUS</h2>
@@ -138,10 +153,10 @@
 
 <h2>SEE ALSO</h2>
 <pre>
-       <a href='../notmuch-1/'>notmuch</a>(1),  <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not-</a>
-       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),  <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),   <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),
-       <a href='../notmuch-restore-1/'>notmuch-restore</a>(1),  <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7), <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>notmuch-</a>
+       <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1),  <a href='../notmuch-hooks-5/'>not-</a>
+       <a href='../notmuch-hooks-5/'>much-hooks</a>(5),   <a href='../notmuch-insert-1/'>notmuch-insert</a>(1),  <a href='../notmuch-new-1/'>notmuch-new</a>(1),  <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),
+       <a href='../notmuch-restore-1/'>notmuch-restore</a>(1), <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7), <a href='../notmuch-show-1/'>notmuch-show</a>(1),  <a href='../notmuch-tag-1/'>notmuch-</a>
        <a href='../notmuch-tag-1/'>tag</a>(1)
 </pre>
 
-<h2>Notmuch 0.16</h2>
+<h2>Notmuch 0.17</h2>