--- a/src/doc/man/recoll.1
+++ b/src/doc/man/recoll.1
@@ -24,8 +24,15 @@
 .B \-q
 <query>
 ]
+
+.B recoll
+[
+.B \-c
+<configdir>
+]
+<url>
 .SH DESCRIPTION
-The
+In the first form, the
 .B recoll
 command will start the graphical user interface for querying the 
 .B Recoll 
@@ -73,6 +80,20 @@
 and the maximum number of results to be printed.
 .PP
 Please refer to online help for a full description.
+.PP
+In the second form, the 
+.B recoll
+command can be used to start a native viewer for a document indexed by
+Recoll. It will understand a final URL fragment (separated by a '#'
+character) to indicate an 
+.I ipath
+, the specifier for the part of the Recoll document access path which is is
+internal to a container such as a mbox folder or a zip archive, and will,
+if needed, create a temporary file to let a normal system utility display
+the document.
+.PP
+The second form is mostly used for opening embedded documents from the
+Ubuntu Unity Recoll lens.
 .SH SEE ALSO
 .PP 
 recollindex(1) recollq(1) recoll.conf(5)