summary refs log tree commit diff stats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/examples/vim_file_chooser.vim2
-rw-r--r--doc/ranger.113
-rw-r--r--doc/ranger.pod11
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.