diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/examples/vim_file_chooser.vim | 2 | ||||
| -rw-r--r-- | doc/ranger.1 | 13 | ||||
| -rw-r--r-- | doc/ranger.pod | 11 |
3 files changed, 24 insertions, 2 deletions
diff --git a/doc/examples/vim_file_chooser.vim b/doc/examples/vim_file_chooser.vim index df6aacc9..aa3af763 100644 --- a/doc/examples/vim_file_chooser.vim +++ b/doc/examples/vim_file_chooser.vim @@ -3,7 +3,7 @@ " Add ranger as a file chooser in vim " " If you add this code to the .vimrc, ranger can be started using the command -" ":RagerChooser" or the keybinding "<leader>r". Once you select one or more +" ":RangerChooser" or the keybinding "<leader>r". Once you select one or more " files, press enter and ranger will quit again and vim will open the selected " files. diff --git a/doc/ranger.1 b/doc/ranger.1 index 4fef635d..59bf529c 100644 --- a/doc/ranger.1 +++ b/doc/ranger.1 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "RANGER 1" -.TH RANGER 1 "ranger-1.6.1" "01/29/2015" "ranger manual" +.TH RANGER 1 "ranger-1.6.1" "02/06/2015" "ranger manual" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -189,6 +189,10 @@ Change the configuration directory of ranger from ~/.config/ranger to \*(L"dir\* Create copies of the default configuration files in your local configuration directory. Existing ones will not be overwritten. Possible values: \fIall\fR, \&\fIcommands\fR, \fIrc\fR, \fIrifle\fR, \fIscope\fR. +.Sp +Note: You may want to disable loading of the global configuration files by +exporting \fIRANGER_LOAD_DEFAULT_RC=FALSE\fR in your environment. See also: +\&\fB\s-1FILES\s0\fR, \fB\s-1ENVIRONMENT\s0\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 @@ -1170,6 +1174,13 @@ You don't need to copy the whole file though, most configuration files are overlaid on top of the defaults (\fIcommands.py\fR, \fIrc.conf\fR) or can be sub-classed (\fIcolorschemes\fR). .PP +That being said, the user configuration files \fIrc.conf\fR and \fIcommands.py\fR are +loaded only after ranger loads the default configuration files. This may lead +to some confusing situations, for example when a key is being bound despite the +corresponding line being removed from the user's copy of the configuration +file. This behavior may be disabled with an environment variable (see also: +\&\fB\s-1ENVIRONMENT\s0\fR). +.PP When starting ranger with the \fB\-\-clean\fR option, it will not access or create any of these files. .SS "\s-1CONFIGURATION\s0" diff --git a/doc/ranger.pod b/doc/ranger.pod index e2311f3e..177cd0f5 100644 --- a/doc/ranger.pod +++ b/doc/ranger.pod @@ -72,6 +72,10 @@ Create copies of the default configuration files in your local configuration directory. Existing ones will not be overwritten. Possible values: I<all>, I<commands>, I<rc>, I<rifle>, I<scope>. +Note: You may want to disable loading of the global configuration files by +exporting I<RANGER_LOAD_DEFAULT_RC=FALSE> in your environment. See also: +B<FILES>, B<ENVIRONMENT> + =item B<--choosefile>=I<targetfile> Allows you to pick a file with ranger. This changes the behavior so that when @@ -1238,6 +1242,13 @@ You don't need to copy the whole file though, most configuration files are overlaid on top of the defaults (F<commands.py>, F<rc.conf>) or can be sub-classed (F<colorschemes>). +That being said, the user configuration files F<rc.conf> and F<commands.py> are +loaded only after ranger loads the default configuration files. This may lead +to some confusing situations, for example when a key is being bound despite the +corresponding line being removed from the user's copy of the configuration +file. This behavior may be disabled with an environment variable (see also: +B<ENVIRONMENT>). + When starting ranger with the B<--clean> option, it will not access or create any of these files. |