docs: note that blacklist/whitelist follow symlinks

Make it more explicit that they do and add an example for each command.

Relates to #5338.
This commit is contained in:
Kelvin M. Klann 2022-08-28 19:07:03 -03:00
parent 8e04409614
commit c78c2b4ec4

View file

@ -190,6 +190,13 @@ Example:
Blacklist directory or file. File globbing is supported, see \fBFILE GLOBBING\fR section for more details. Blacklist directory or file. File globbing is supported, see \fBFILE GLOBBING\fR section for more details.
.br .br
.br
Symbolic link handling: Blacklisting a path that is a symbolic link will also
blacklist the path that it points to.
For example, if ~/foo is blacklisted and it points to /foo, then /foo will also
be blacklisted.
.br
.br .br
Example: Example:
.br .br
@ -2922,8 +2929,12 @@ all directories in /usr.
.br .br
.br .br
Symbolic link handling: With the exception of the user home directory, both the Symbolic link handling: Whitelisting a path that is a symbolic link will also
link and the real file should be in the same top directory. whitelist the path that it points to.
For example, if ~/foo is whitelisted and it points to ~/bar, then ~/bar will
also be whitelisted.
Restrictions: With the exception of the user home directory, both the link and
the real file should be in the same top directory.
For symbolic links in the user home directory, both the link and the real file For symbolic links in the user home directory, both the link and the real file
should be owned by the user. should be owned by the user.
.br .br