aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2020-08-12 14:37:21 -0400
committerNick Mathewson <nickm@torproject.org>2020-08-12 14:37:21 -0400
commite1514420377b2290dfa52fa65374276a66973131 (patch)
tree51955f9b7378e1b736af78226105ac01e342fc26 /doc
parent11f1fe3aca08c19ab07d9380c1bd47678c99abc4 (diff)
parent60c436d14d05dcc5e03058a16373c53ff94469c5 (diff)
downloadtor-e1514420377b2290dfa52fa65374276a66973131.tar.gz
tor-e1514420377b2290dfa52fa65374276a66973131.zip
Merge remote-tracking branch 'tor-gitlab/mr/62'
Diffstat (limited to 'doc')
-rw-r--r--doc/man/tor.1.txt14
1 files changed, 11 insertions, 3 deletions
diff --git a/doc/man/tor.1.txt b/doc/man/tor.1.txt
index 318d31ac24..e8dcc7b236 100644
--- a/doc/man/tor.1.txt
+++ b/doc/man/tor.1.txt
@@ -211,14 +211,22 @@ backslash character (\) before the end of the line. Comments can be used in
such multiline entries, but they must start at the beginning of a line.
Configuration options can be imported from files or folders using the %include
-option with the value being a path. If the path is a file, the options from the
-file will be parsed as if they were written where the %include option is. If
+option with the value being a path. This path can have wildcards. Wildcards are
+expanded first, then sorted using lexical order. Then, for each matching file or
+folder, the following rules are followed: if the path is a file, the options from
+the file will be parsed as if they were written where the %include option is. If
the path is a folder, all files on that folder will be parsed following lexical
-order. Files starting with a dot are ignored. Files on subfolders are ignored.
+order. Files starting with a dot are ignored. Files in subfolders are ignored.
The %include option can be used recursively.
New configuration files or directories cannot be added to already running Tor
instance if **Sandbox** is enabled.
+The supported wildcards are * meaning any number of characters including none
+and ? meaning exactly one character. These characters can be escaped by preceding
+them with a backslash, except on Windows. Files starting with a dot are not matched
+when expanding wildcards unless the starting dot is explicitly in the pattern, except
+on Windows.
+
By default, an option on the command line overrides an option found in the
configuration file, and an option in a configuration file overrides one in
the defaults file.