X-Git-Url: http://rtime.felk.cvut.cz/gitweb/notmuch.git/blobdiff_plain/3755aadfbe1eb9a2fc9d1230c5b54b447666f206..9d13215705d9d0adfbce252892810a4b533d319a:/doc/man1/notmuch-search.rst

diff --git a/doc/man1/notmuch-search.rst b/doc/man1/notmuch-search.rst
index 60949068..a92779a7 100644
--- a/doc/man1/notmuch-search.rst
+++ b/doc/man1/notmuch-search.rst
@@ -85,6 +85,9 @@ Supported options for **search** include
             (--format=text0), as a JSON array (--format=json), or as
             an S-Expression list (--format=sexp).
 
+            Handling of duplicate addresses and/or names can be
+            controlled with the --unique option.
+
 	    Note: Searching for **sender** should much be faster than
 	    searching for **recipients** or **addresses**, because
 	    sender addresses are cached directly in the database
@@ -151,6 +154,36 @@ Supported options for **search** include
         prefix. The prefix matches messages based on filenames. This
         option filters filenames of the matching messages.
 
+    ``--unique=``\ (**none**\ \|\ **addr**\ \|\ **addrfold**\ \|\ **name**)[,\ ...]
+
+        Can be used with ``--output=addresses``, ``--output=sender``
+        or ``--output=recipients`` to control the address
+        deduplication algorithm.
+
+	**none** means that no deduplication is performed. The same
+	address can appear multiple times in the output.
+
+	**addr** means that case-sensitive deduplication is performed
+	on the address part. For example, given the addresses "John
+	Doe <john@example.com>" and "Dr. John Doe <john@example.com>",
+	only one will be printed.
+
+	**addrfold** means that case-insensitive deduplication is
+	performed on the address part. For example, given the
+	addresses "John Doe <john@example.com>" and "John Doe
+	<JOHN@EXAMPLE.COM>", only one will be printed. This is the
+	default.
+
+	**name** means that case-sensitive deduplication is performed
+	on the name part. For example, given the addresses "John Doe
+	<john@example.com>" and "John Doe <john@doe.name>", only one
+	will be printed.
+
+	It is possible to combine the above flags (except **none**) by
+	separating them with comma. For example,
+	``--unique=name,addr`` will print unique case-sensitive
+	combinations of name and address.
+
 EXIT STATUS
 ===========