diff options
Diffstat (limited to 'doc/ranger.1')
| -rw-r--r-- | doc/ranger.1 | 94 |
1 files changed, 64 insertions, 30 deletions
diff --git a/doc/ranger.1 b/doc/ranger.1 index a8c70ad4..03687636 100644 --- a/doc/ranger.1 +++ b/doc/ranger.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.20) +.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28) .\" .\" Standard preamble: .\" ======================================================================== @@ -38,6 +38,8 @@ . ds PI \(*p . ds L" `` . ds R" '' +. ds C` +. ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. @@ -48,17 +50,24 @@ .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. -.ie \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" +.\" +.\" Avoid warning from groff about undefined register 'F'. +.de IX .. -. nr % 0 -. rr F -.\} -.el \{\ -. de IX +.nr rF 0 +.if \n(.g .if rF .nr rF 1 +.if (\n(rF:(\n(.g==0)) \{ +. if \nF \{ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" .. +. if !\nF==2 \{ +. nr % 0 +. nr F 2 +. \} +. \} .\} +.rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. @@ -124,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "RANGER 1" -.TH RANGER 1 "ranger-1.6.0" "03/24/2013" "ranger manual" +.TH RANGER 1 "ranger-1.6.1" "06/21/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 +150,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 +\&\fIInside ranger\fR, you can press \fI1?\fR for a list of key bindings, \fI2?\fR for +commands and \fI3?\fR for settings. +.PP +The \fI\s-1README\s0\fR contains install instructions. .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. +The file \fIdoc/HACKING\fR contains guidelines for code modification. .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 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 @@ -245,7 +260,7 @@ To enable this feature, install the program \*(L"w3m\*(R" and set the option \&\f(CW\*(C`preview_images\*(C'\fR to true. .SS "\s-1SELECTION\s0" .IX Subsection "SELECTION" -The \fIselection\fR is defined as \*(L"All marked files \s-1IF\s0 \s-1THERE\s0 \s-1ARE\s0 \s-1ANY\s0, otherwise +The \fIselection\fR is defined as \*(L"All marked files \s-1IF THERE ARE ANY,\s0 otherwise the current file.\*(R" Be aware of this when using the :delete command, which deletes all files in the selection. .PP @@ -379,7 +394,7 @@ Many key bindings take an additional numeric argument. Type \fI5j\fR to move down 5 lines, \fI2l\fR to open a file in mode 2, \fI10<Space>\fR to mark 10 files. .PP This list contains the most useful bindings: -.SS "\s-1MAIN\s0 \s-1BINDINGS\s0" +.SS "\s-1MAIN BINDINGS\s0" .IX Subsection "MAIN BINDINGS" .IP "h, j, k, l" 14 .IX Item "h, j, k, l" @@ -468,7 +483,7 @@ Toggle the mark-status of all files .IP "V" 14 .IX Item "V" Starts the visual mode, which selects all files between the starting point and -the cursor until you press \s-1ESC\s0. To unselect files in the same way, use \*(L"uV\*(R". +the cursor until you press \s-1ESC. \s0 To unselect files in the same way, use \*(L"uV\*(R". .IP "/" 14 Search for files in the current directory. .IP ":" 14 @@ -486,7 +501,7 @@ Go to the next or previous tab. You can also use \s-1TAB\s0 and \s-1SHIFT+TAB\s0 .IP "gc, ^W" 14 .IX Item "gc, ^W" Close the current tab. The last tab cannot be closed this way. -.SS "READLINE-LIKE \s-1BINDINGS\s0 \s-1IN\s0 \s-1THE\s0 \s-1CONSOLE\s0" +.SS "READLINE-LIKE \s-1BINDINGS IN THE CONSOLE\s0" .IX Subsection "READLINE-LIKE BINDINGS IN THE CONSOLE" .IP "^B, ^F" 14 .IX Item "^B, ^F" @@ -848,11 +863,15 @@ Examples: .IX Item "filter [string]" Displays only the files which contain the \fIstring\fR in their basename. Running this command without any parameter will reset the fitler. +.Sp +This command is based on the \fIscout\fR command and supports all of its options. .IP "find \fIpattern\fR" 2 .IX Item "find pattern" Search files in the current directory that contain the given (case-insensitive) string in their name as you type. Once there is an unambiguous result, it will be run immediately. (Or entered, if it's a directory.) +.Sp +This command is based on the \fIscout\fR command and supports all of its options. .IP "grep \fIpattern\fR" 2 .IX Item "grep pattern" Looks for a string in all marked files or directories. @@ -873,6 +892,8 @@ not in the console, task view or pager. To bind keys there, use the commands .IP "mark \fIpattern\fR" 2 .IX Item "mark pattern" Mark all files matching the regular expression pattern. +.Sp +This command is based on the \fIscout\fR command and supports all of its options. .IP "mark_tag [\fItags\fR]" 2 .IX Item "mark_tag [tags]" Mark all tags that are tagged with either of the given tags. When leaving out @@ -883,8 +904,13 @@ Creates a directory with the name \fIdirname\fR. .IP "open_with [\fIapplication\fR] [\fIflags\fR] [\fImode\fR]" 2 .IX Item "open_with [application] [flags] [mode]" Open the selected files with the given application, unless it is omitted, in -which case the default application is used. \fIflags\fR and \fImode\fR have their -own section in the man page. +which case the default application is used. \fIflags\fR change the way the +application is executed and are described in their own section in this man +page. The \fImode\fR is a number that specifies which application to use. The list +of applications is generated by the external file opener \*(L"rifle\*(R" and can be +displayed when pressing \*(L"r\*(R" in ranger. +.Sp +Note that if you specify an application, the mode is ignored. .IP "pmap \fIkey\fR \fIcommand\fR" 2 .IX Item "pmap key command" Binds keys for the pager. Works like the \f(CW\*(C`map\*(C'\fR command. @@ -938,11 +964,15 @@ a :filter\-like command using globbing. .IX Item "search pattern" Search files in the current directory that match the given (case insensitive) regular expression pattern. +.Sp +This command is based on the \fIscout\fR command and supports all of its options. .IP "search_inc \fIpattern\fR" 2 .IX Item "search_inc pattern" Search files in the current directory that match the given (case insensitive) regular expression pattern. This command gets you to matching files as you type. +.Sp +This command is based on the \fIscout\fR command and supports all of its options. .IP "set \fIoption\fR \fIvalue\fR" 2 .IX Item "set option value" Assigns a new value to an option. Valid options are listed in the settings @@ -982,6 +1012,8 @@ string, possibly with other letters in between. The filter is applied as you type. When only one directory is left, it is entered and the console is automatically reopened, allowing for fast travel. To close the console, press \s-1ESC\s0 or execute a file. +.Sp +This command is based on the \fIscout\fR command and supports all of its options. .IP "tunmap [\fIkeys ...\fR]" 2 .IX Item "tunmap [keys ...]" Removes key mappings of the taskview. Works like the \f(CW\*(C`unmap\*(C'\fR command. @@ -992,6 +1024,8 @@ in the console, taskview, or pager use \*(L"cunmap\*(R", \*(L"tunmap\*(R" or \*( .IP "unmark \fIpattern\fR" 2 .IX Item "unmark pattern" Unmark all files matching a regular expression pattern. +.Sp +This command is based on the \fIscout\fR command and supports all of its options. .IP "unmark_tag [\fItags\fR]" 2 .IX Item "unmark_tag [tags]" Unmark all tags that are tagged with either of the given tags. When leaving @@ -1067,7 +1101,7 @@ exists. External programs can determine whether they were spawned from ranger by checking for this variable. .IP "\s-1RANGER_LOAD_DEFAULT_RC\s0" 8 .IX Item "RANGER_LOAD_DEFAULT_RC" -If this variable is set to \s-1FALSE\s0, ranger will not load the default rc.conf. +If this variable is set to \s-1FALSE,\s0 ranger will not load the default rc.conf. This can save time if you copied the whole rc.conf to ~/.config/ranger/ and don't need the default one at all. .IP "\s-1EDITOR\s0" 8 @@ -1108,8 +1142,8 @@ provided along with the source code. \&\s-1GNU\s0 General Public License 3 or (at your option) any later version. .SH "LINKS" .IX Header "LINKS" -.IP "Download: http://ranger.nongnu.org/ranger\-stable.tar.gz <http://ranger.nongnu.org/ranger-stable.tar.gz>" 4 -.IX Item "Download: http://ranger.nongnu.org/ranger-stable.tar.gz <http://ranger.nongnu.org/ranger-stable.tar.gz>" +.IP "Download: <http://ranger.nongnu.org/ranger\-stable.tar.gz>" 4 +.IX Item "Download: <http://ranger.nongnu.org/ranger-stable.tar.gz>" .PD 0 .IP "The project page: <http://ranger.nongnu.org/>" 4 .IX Item "The project page: <http://ranger.nongnu.org/>" |