[nautilus] docs: touch up manual page

[Ernestas Kulik <ernestask src gnome org>]

commit 87d36e08060a8ec9bcaa444813e9cbde9a66bacc
Author: Ernestas Kulik <ernestask src gnome org>
Date:   Thu Jun 23 20:27:39 2016 +0300

    docs: touch up manual page
    
    As the manual page has been last updated in 2004, some sections are
    outdated. This commit updates the option list, the link to the Nautilus
    online page, adds a bugs section and tweaks the formatting to make the
    source more readable.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=733909

 docs/nautilus.1 |   69 +++++++++++++++++++++++++++++++++++--------------------
 1 files changed, 44 insertions(+), 25 deletions(-)
---
diff --git a/docs/nautilus.1 b/docs/nautilus.1
index ee5f203..b2bfa91 100644
--- a/docs/nautilus.1
+++ b/docs/nautilus.1
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH Nautilus 1 "24 May 2004"
+.TH Nautilus 1 "24 June 2016"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -16,54 +16,73 @@
 .\" .sp <n>    insert n+1 empty lines
 .\" for manpage-specific macros, see man(7)
 .SH NAME
-nautilus \- the GNOME File Manager
+nautilus \- a file manager for GNOME
+
 .SH SYNOPSIS
 .B nautilus
 .RI [ options ] " URIs" ...
 .br
+
 .SH DESCRIPTION
-This manual page documents briefly the
 .B nautilus
-command. This manual page was written for the Debian GNU/Linux distribution
-because the original program does not have a manual page.
-.PP
-Nautilus is the file manager for the GNOME desktop.
+is a file manager, designed for the GNOME 3 desktop.
 .br
+
 .SH OPTIONS
-Nautilus follows the usual GNU command line syntax, with long options starting
-with two dashes (`-'). A summary of options is included below.
 .TP
-.B \-g
+.BR \-c ", " \-\-check
+Perform a quick set of self-check tests.
+
 .TP
-.B \-\-geometry=\fIGEOMETRY\fR
+.BR \-g ", " \-\-geometry=\fIGEOMETRY\fR
 Create the initial window with the given geometry.
+
 .TP
-.B \-n
+.BR \-w ", " \-\-new-window
+Always open a new window for browsing specified URIs.
+
 .TP
-.B \-\-no-default-window
+.BR \-n ", " \-\-no-default-window
 Only create windows for explicitly specified URIs.
+
 .TP
 .B \-\-no-desktop
-Do not manage the desktop \(em ignore the preference set in the preferences
-dialog.
+Never manage the desktop (ignore the GSettings preference).
+
 .TP
-.B \-q
+.B \-\-force-desktop
+Always manage the desktop (ignore the GSettings preference).
+
 .TP
-.B \-\-quit
+.BR \-q ", " \-\-quit
 Quit Nautilus.
+
 .TP
-.B \-\-help
+.BR \-s ", " \-\-select
+Select specified URI in parent folder.
+
+.TP
+.BR \-h ", " \-\-help
 Show a summary of options.
+
 .TP
 .B \-\-version
 Show Nautilus' version.
+
 .TP
 Other standard GNOME options not listed here are also supported.
+
 .SH SEE ALSO
-Nautilus documentation can be found from the "Help" menu, or by pressing the
-F1 key. Nautilus also has a website at
-http://www.gnome.org/projects/nautilus/
-.SH AUTHOR
-This manual page was written by Takuo KITAME <kitame debian org> and Dafydd
-Harries <daf muse 19inch net> for the Debian GNU/Linux system (but may be used
-by others).
+The documentation may be accessed by pressing \fIF1\fR in the application or
+via the application menu.
+
+For further information, visit the website
+https://wiki.gnome.org/Apps/Nautilus
+
+.SH BUGS
+All bugs in the application may be reported at the GNOME Bugzilla at
+https://bugzilla.gnome.org/buglist.cgi?product=nautilus
+
+.\"This manual page was written by Takuo KITAME <kitame debian org> and Dafydd
+.\"Harries <daf muse 19inch net> for the Debian GNU/Linux system (but may be used
+.\"by others).