From d0ab49c08cc6eaa592ff67ca3bc1130e6e3d54e2 Mon Sep 17 00:00:00 2001 From: James Wright Date: Fri, 7 Feb 2020 20:10:27 -0700 Subject: doc(rifle): Add note of rifle config reading in manpage In response to #1825. --- doc/rifle.pod | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/rifle.pod b/doc/rifle.pod index b4d76287..927196ce 100644 --- a/doc/rifle.pod +++ b/doc/rifle.pod @@ -71,7 +71,7 @@ Print a list of options and exit. rifle shares configuration files with ranger, though ranger is not required in order to use rifle. The default configuration file F is expected to be at F<~/.config/ranger/rifle.conf>. However, this can be overridden with -the B<-c> option. +the B<-c> option. Note that rifle will only read one F file. This file specifies patterns for determining the commands to open files with. The syntax is described in the comments of the default F that ships -- cgit 1.4.1-2-gfad0 From 58000a2318e8cf6574c1964da01bb104cbdc2357 Mon Sep 17 00:00:00 2001 From: toonn Date: Sat, 8 Feb 2020 13:44:09 +0100 Subject: Clarify that defaults will not be loaded Explicitly state that defaults won't be loaded if a configuration file is present and render the docs. --- doc/rifle.1 | 5 +++-- doc/rifle.pod | 3 ++- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/doc/rifle.1 b/doc/rifle.1 index 1d3553f4..b3dd6373 100644 --- a/doc/rifle.1 +++ b/doc/rifle.1 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "RIFLE 1" -.TH RIFLE 1 "rifle-1.9.3" "2019-12-31" "rifle manual" +.TH RIFLE 1 "rifle-1.9.3" "2020-02-08" "rifle manual" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -185,7 +185,8 @@ Print a list of options and exit. rifle shares configuration files with ranger, though ranger is not required in order to use rifle. The default configuration file \fIrifle.conf\fR is expected to be at \fI~/.config/ranger/rifle.conf\fR. However, this can be overridden with -the \fB\-c\fR option. +the \fB\-c\fR option. Note that due to the nature of the configuration, rifle will +only read one file, it will not read the defaults in addition. .PP This file specifies patterns for determining the commands to open files with. The syntax is described in the comments of the default \fIrifle.conf\fR that ships diff --git a/doc/rifle.pod b/doc/rifle.pod index 927196ce..e0abaa3b 100644 --- a/doc/rifle.pod +++ b/doc/rifle.pod @@ -71,7 +71,8 @@ Print a list of options and exit. rifle shares configuration files with ranger, though ranger is not required in order to use rifle. The default configuration file F is expected to be at F<~/.config/ranger/rifle.conf>. However, this can be overridden with -the B<-c> option. Note that rifle will only read one F file. +the B<-c> option. Note that due to the nature of the configuration, rifle will +only read one file, it will not read the defaults in addition. This file specifies patterns for determining the commands to open files with. The syntax is described in the comments of the default F that ships -- cgit 1.4.1-2-gfad0