X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-address-1.mdwn;h=716adf620d5f71bc7953f0d6779c420e07a8e977;hb=46b88668029f0f014c4ecf7a220b7a99a13776f3;hp=c0165aedd4c5c84c15fce747740cf8de225ee241;hpb=cf2df983cb6d13042694366be4aba76d4a98048b;p=notmuch-wiki

diff --git a/manpages/notmuch-address-1.mdwn b/manpages/notmuch-address-1.mdwn
index c0165ae..716adf6 100644
--- a/manpages/notmuch-address-1.mdwn
+++ b/manpages/notmuch-address-1.mdwn
@@ -53,27 +53,49 @@
                      Note:  With this option, addresses are printed only after
                      the whole search is finished. This may take long time.
 
+          <b>--deduplicate=(no|mailbox|address)</b>
+              Control the deduplication of results.
+
+              <b>no</b>     Output all occurences of addresses in the  matching  mes‐
+                     sages. This is not applicable with --output=count.
+
+              <b>mailbox</b>
+                     Deduplicate  addresses  based on the full, case sensitive
+                     name and email address, or mailbox. This  is  effectively
+                     the  same as piping the --deduplicate=no output to <b>sort</b> <b>|</b>
+                     <b>uniq</b>, except for  the  order  of  results.  This  is  the
+                     default.
+
+              <b>address</b>
+                     Deduplicate  addresses  based  on  the  case  insensitive
+                     address part of the mailbox. Of all  the  variants  (with
+                     different  name  or  case),  print the one occurring most
+                     frequently among the matching messages. If --output=count
+                     is specified, include all variants in the count.
+
           <b>--sort=(newest-first|oldest-first)</b>
-                 This option can be used to present results in either  chrono‐
-                 logical  order  (<b>oldest-first</b>) or reverse chronological order
+                 This  option can be used to present results in either chrono‐
+                 logical order (<b>oldest-first</b>) or reverse  chronological  order
                  (<b>newest-first</b>).
 
-                 By default, results will be displayed in reverse  chronologi‐
-                 cal  order,  (that  is,  the newest results will be displayed
+                 By  default, results will be displayed in reverse chronologi‐
+                 cal order, (that is, the newest  results  will  be  displayed
                  first).
 
-                 This option is not supported with --output=count.
+                 However, if either --output=count or --deduplicate=address is
+                 specified, this option  is  ignored  and  the  order  of  the
+                 results is unspecified.
 
           <b>--exclude=(true|false)</b>
                  A message is called &quot;excluded&quot; if it matches at least one tag
-                 in  search.tag_exclude that does not appear explicitly in the
-                 search terms. This option specifies whether to omit  excluded
+                 in search.tag_exclude that does not appear explicitly in  the
+                 search  terms. This option specifies whether to omit excluded
                  messages in the search process.
 
-                 The  default  value,  <b>true</b>,  prevents  excluded messages from
+                 The default value,  <b>true</b>,  prevents  excluded  messages  from
                  matching the search terms.
 
-                 <b>false</b> allows excluded messages  to  match  search  terms  and
+                 <b>false</b>  allows  excluded  messages  to  match search terms and
                  appear in displayed results.
 </pre>
 
@@ -88,9 +110,9 @@
 
 <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/'>not‐</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/'>not‐</a>
        <a href='../notmuch-tag-1/'>much-tag</a>(1), <a href='../notmuch-search-1/'>notmuch-search</a>(1)
 </pre>
 
@@ -101,7 +123,7 @@
 
 <h2>COPYRIGHT</h2>
 <pre>
-       2014, Carl Worth and many others
+       2009-2017, Carl Worth and many others
 </pre>
 
-<h2>0.19</h2>
+<h2>0.24</h2>