summary refs log tree commit diff stats
path: root/doc/ranger.pod
diff options
context:
space:
mode:
authornfnty <git@nfnty.se>2017-02-16 05:33:50 +0100
committernfnty <git@nfnty.se>2017-02-16 05:33:50 +0100
commit004badd136850ec48533eb3591b841d4ee38e156 (patch)
treea02f4faa8b5d75983751da17d8c1c37ab26414fd /doc/ranger.pod
parent9572d80597aac9575615b488b894fd4d81490bd4 (diff)
downloadranger-004badd136850ec48533eb3591b841d4ee38e156.tar.gz
doc: man: Clarify config sourcing
Diffstat (limited to 'doc/ranger.pod')
-rw-r--r--doc/ranger.pod21
1 files changed, 9 insertions, 12 deletions
diff --git a/doc/ranger.pod b/doc/ranger.pod
index 8b02ee63..bb30fab3 100644
--- a/doc/ranger.pod
+++ b/doc/ranger.pod
@@ -1406,18 +1406,15 @@ out the tag argument, all tagged files are unmarked.
 ranger reads several configuration files which are located in
 F<$HOME/.config/ranger> or F<$XDG_CONFIG_HOME/ranger> if $XDG_CONFIG_HOME is
 defined.  You can use the --copy-config option to obtain the default
-configuration files.  Each of the files contains further documentation.
-
-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>).
+configuration files.  The files contain further documentation.
+
+F<rc.conf>, F<commands.py> and F<colorschemes> do not need to be copied fully
+as they will only be adding to the default configuration files except if explicitly
+overridden. 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>). Note: All other configuration files only
+read from one source; i.e. default OR user, not both.
 
 When starting ranger with the B<--clean> option, it will not access or create
 any of these files.