doc/ranger.1: put a list of resources at the top

2 files changed, 41 insertions, 25 deletions

diff --git a/doc/ranger.1 b/doc/ranger.1
index a8c70ad4..75757963 100644
--- a/doc/ranger.1
+++ b/doc/ranger.1
@@ -124,7 +124,7 @@
 .\" ========================================================================
 .\"
 .IX Title "RANGER 1"
-.TH RANGER 1 "ranger-1.6.0" "03/24/2013" "ranger manual"
+.TH RANGER 1 "ranger-1.6.0" "04/30/2013" "ranger manual"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -141,19 +141,25 @@ ranger \- visual file manager
 [\fB\-\-profile\fR] [\fB\-\-cmd\fR=\fIcommand\fR] [\fIpath\fR]
 .SH "DESCRIPTION"
 .IX Header "DESCRIPTION"
-ranger is a console file manager with \s-1VI\s0 key bindings.  It provides a
-minimalistic and nice curses interface with a view on the directory hierarchy.
-The secondary task of ranger is to figure out which program you want to use to
-open your files with.
+ranger is a console file manager with \s-1VI\s0 key bindings.
+.SH "RESOURCES"
+.IX Header "RESOURCES"
+\&\fIThis manual\fR contains instructions on how to use and configure ranger.
 .PP
-This manual mainly contains information on the usage of ranger.  Refer to the
-\&\fI\s-1README\s0\fR for install instructions and to \fIdoc/HACKING\fR for development
-specific information.  For configuration, see the files in \fIranger/config\fR.
-They are usually installed to \fI/usr/lib/python*/site\-packages/ranger/config\fR
-and can be obtained with ranger's \-\-copy\-config option.
+\&\fIInside ranger\fR, you can press \fI1?\fR for a list of key bindings, \fI2?\fR for
+commands and \fI3?\fR for settings.
 .PP
-Inside ranger, you can press \fI1?\fR for a list of key bindings, \fI2?\fR for a list
-of commands and \fI3?\fR for a list of settings.
+The \fI\s-1README\s0\fR contains install instructions.
+.PP
+The file \fIdoc/HACKING\fR contains guidelines for code modification.
+.PP
+The directory \fIdoc/configs\fR contains configuration files.  They are usually
+installed to \fI/usr/lib/python*/site\-packages/ranger/config\fR and can be
+obtained with ranger's \-\-copy\-config option.
+.PP
+The man page of \fIrifle\fR\|(1) describes the functions of the file opener
+.PP
+The section \fI\s-1LINKS\s0\fR of this man page contains further resources.
 .SH "OPTIONS"
 .IX Header "OPTIONS"
 .IP "\fB\-d\fR, \fB\-\-debug\fR" 14
diff --git a/doc/ranger.pod b/doc/ranger.pod
index ac9970c5..3a3c9052 100644
--- a/doc/ranger.pod
+++ b/doc/ranger.pod
@@ -19,19 +19,29 @@ B<ranger> [B<--version>] [B<--help>] [B<--debug>] [B<--clean>]
 
 =head1 DESCRIPTION
 
-ranger is a console file manager with VI key bindings.  It provides a
-minimalistic and nice curses interface with a view on the directory hierarchy.
-The secondary task of ranger is to figure out which program you want to use to
-open your files with.
-
-This manual mainly contains information on the usage of ranger.  Refer to the
-F<README> for install instructions and to F<doc/HACKING> for development
-specific information.  For configuration, see the files in F<ranger/config>.
-They are usually installed to F</usr/lib/python*/site-packages/ranger/config>
-and can be obtained with ranger's --copy-config option.
-
-Inside ranger, you can press I<1?> for a list of key bindings, I<2?> for a list
-of commands and I<3?> for a list of settings.
+ranger is a console file manager with VI key bindings.
+
+
+
+
+=head1 RESOURCES
+
+I<This manual> contains instructions on how to use and configure ranger.
+
+I<Inside ranger>, you can press I<1?> for a list of key bindings, I<2?> for
+commands and I<3?> for settings.
+
+The F<README> contains install instructions.
+
+The file F<doc/HACKING> contains guidelines for code modification.
+
+The directory F<doc/configs> contains configuration files.  They are usually
+installed to F</usr/lib/python*/site-packages/ranger/config> and can be
+obtained with ranger's --copy-config option.
+
+The man page of rifle(1) describes the functions of the file opener
+
+The section I<LINKS> of this man page contains further resources.