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

1 files changed, 44 insertions, 25 deletions

diff --git a/docs/nautilus.1 b/docs/nautilus.1
index ee5f2033a..b2bfa9132 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).