From e5238c692c74c9ee361c91f1e7cf2bdecf7418a0 Mon Sep 17 00:00:00 2001 From: hut Date: Mon, 18 Feb 2013 01:14:36 +0100 Subject: ranger.1: update list of ranger options --- doc/ranger.1 | 25 +++++++++++++++++-------- doc/ranger.pod | 29 ++++++++++++++++++++--------- ranger/core/main.py | 10 +++++----- 3 files changed, 42 insertions(+), 22 deletions(-) diff --git a/doc/ranger.1 b/doc/ranger.1 index 92d8a7f6..124e0418 100644 --- a/doc/ranger.1 +++ b/doc/ranger.1 @@ -133,9 +133,12 @@ ranger \- visual file manager .SH "SYNOPSIS" .IX Header "SYNOPSIS" -\&\fBranger\fR [\fB\-\-help\fR] [\fB\-\-version\fR] [\fB\-\-debug\fR] [\fB\-\-clean\fR] -[\fB\-\-list\-unused\-keys\fR] [\fB\-\-choosedir\fR=\fItargetfile\fR] -[\fB\-\-choosefile\fR=\fItargetfile\fR] [\fB\-\-copy\-config\fR=\fIfile\fR] [\fIpath\fR] +\&\fBranger\fR [\fB\-\-version\fR] [\fB\-\-help\fR] [\fB\-\-debug\fR] [\fB\-\-clean\fR] +[\fB\-\-confdir\fR=\fIdirectory\fR] [\fB\-\-copy\-config\fR=\fIwhich\fR] +[\fB\-\-choosefile\fR=\fItarget\fR] [\fB\-\-choosefiles\fR=\fItarget\fR] +[\fB\-\-choosedir\fR=\fItarget\fR] [\fB\-\-selectfile\fR=\fIfilepath\fR] +[\fB\-\-list\-unused\-keys\fR] [\fB\-\-list\-tagged\-files\fR=\fItag\fR] +[\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 @@ -163,6 +166,14 @@ exception in the statusbar/log and try to keep running. Activate the clean mode: ranger will not access or create any configuration files nor will it leave any traces on your system. This is useful when your configuration is broken, when you want to avoid clutter, etc. +.IP "\fB\-r\fR \fIdir\fR, \fB\-\-confdir\fR=\fIdir\fR" 14 +.IX Item "-r dir, --confdir=dir" +Change the configuration directory of ranger from ~/.config/ranger to \*(L"dir\*(R". +.IP "\fB\-\-copy\-config\fR=\fIfile\fR" 14 +.IX Item "--copy-config=file" +Create copies of the default configuration files in your local configuration +directory. Existing ones will not be overwritten. Possible values: \fIall\fR, +\&\fIrc\fR, \fIcommands\fR, \fIscope\fR. .IP "\fB\-\-choosefile\fR=\fItargetfile\fR" 14 .IX Item "--choosefile=targetfile" Allows you to pick a file with ranger. This changes the behavior so that when @@ -180,11 +191,6 @@ write the last visited directory into \fItargetfile\fR. .IP "\fB\-\-selectfile\fR=\fItargetfile\fR" 14 .IX Item "--selectfile=targetfile" Open ranger with \fItargetfile\fR selected. -.IP "\fB\-\-copy\-config\fR=\fIfile\fR" 14 -.IX Item "--copy-config=file" -Create copies of the default configuration files in your local configuration -directory. Existing ones will not be overwritten. Possible values: \fIall\fR, -\&\fIrc\fR, \fIcommands\fR, \fIscope\fR. .IP "\fB\-\-list\-unused\-keys\fR" 14 .IX Item "--list-unused-keys" List common keys which are not bound to any action in the \*(L"browser\*(R" context. @@ -194,6 +200,9 @@ use the key code returned by \f(CW\*(C`getch()\*(C'\fR. .IX Item "--list-tagged-files=tag" List all files which are tagged with the given tag. Note: Tags are single characters. The default tag is \*(L"*\*(R" +.IP "\fB\-\-profile\fR" 14 +.IX Item "--profile" +Print statistics of \s-1CPU\s0 usage on exit. .IP "\fB\-\-cmd\fR=\fIcommand\fR" 14 .IX Item "--cmd=command" Execute the command after the configuration has been read. Use this option diff --git a/doc/ranger.pod b/doc/ranger.pod index 0d8ef01e..c4e5c92c 100644 --- a/doc/ranger.pod +++ b/doc/ranger.pod @@ -7,9 +7,12 @@ ranger - visual file manager =head1 SYNOPSIS -B [B<--help>] [B<--version>] [B<--debug>] [B<--clean>] -[B<--list-unused-keys>] [B<--choosedir>=I] -[B<--choosefile>=I] [B<--copy-config>=I] [I] +B [B<--version>] [B<--help>] [B<--debug>] [B<--clean>] +[B<--confdir>=I] [B<--copy-config>=I] +[B<--choosefile>=I] [B<--choosefiles>=I] +[B<--choosedir>=I] [B<--selectfile>=I] +[B<--list-unused-keys>] [B<--list-tagged-files>=I] +[B<--profile>] [B<--cmd>=I] [I] @@ -49,6 +52,16 @@ Activate the clean mode: ranger will not access or create any configuration files nor will it leave any traces on your system. This is useful when your configuration is broken, when you want to avoid clutter, etc. +=item B<-r> I, B<--confdir>=I + +Change the configuration directory of ranger from ~/.config/ranger to "dir". + +=item B<--copy-config>=I + +Create copies of the default configuration files in your local configuration +directory. Existing ones will not be overwritten. Possible values: I, +I, I, I. + =item B<--choosefile>=I Allows you to pick a file with ranger. This changes the behavior so that when @@ -70,12 +83,6 @@ write the last visited directory into I. Open ranger with I selected. -=item B<--copy-config>=I - -Create copies of the default configuration files in your local configuration -directory. Existing ones will not be overwritten. Possible values: I, -I, I, I. - =item B<--list-unused-keys> List common keys which are not bound to any action in the "browser" context. @@ -87,6 +94,10 @@ use the key code returned by C. List all files which are tagged with the given tag. Note: Tags are single characters. The default tag is "*" +=item B<--profile> + +Print statistics of CPU usage on exit. + =item B<--cmd>=I Execute the command after the configuration has been read. Use this option diff --git a/ranger/core/main.py b/ranger/core/main.py index 809c3aae..bdebbccc 100644 --- a/ranger/core/main.py +++ b/ranger/core/main.py @@ -185,14 +185,14 @@ def parse_arguments(): help="activate debug mode") parser.add_option('-c', '--clean', action='store_true', help="don't touch/require any config files. ") + parser.add_option('-r', '--confdir', type='string', + metavar='dir', default=default_confdir, + help="change the configuration directory. (%default)") parser.add_option('--copy-config', type='string', metavar='which', help="copy the default configs to the local config directory. " "Possible values: all, rc, rifle, commands, scope") parser.add_option('--fail-unless-cd', action='store_true', help=SUPPRESS_HELP) # COMPAT - parser.add_option('-r', '--confdir', type='string', - metavar='dir', default=default_confdir, - help="the configuration directory. (%default)") parser.add_option('-m', '--mode', type='int', default=0, metavar='n', help=SUPPRESS_HELP) # COMPAT parser.add_option('-f', '--flags', type='string', default='', @@ -208,10 +208,10 @@ def parse_arguments(): parser.add_option('--choosedir', type='string', metavar='TARGET', help="Makes ranger act like a directory chooser. When ranger quits" ", it will write the name of the last visited directory to TARGET") - parser.add_option('--list-unused-keys', action='store_true', - help="List common keys which are not bound to any action.") parser.add_option('--selectfile', type='string', metavar='filepath', help="Open ranger with supplied file selected.") + parser.add_option('--list-unused-keys', action='store_true', + help="List common keys which are not bound to any action.") parser.add_option('--list-tagged-files', type='string', default=None, metavar='tag', help="List all files which are tagged with the given tag, default: *") -- cgit 1.4.1-2-gfad0