From 937e565856a05a32060a43d2ee695443cf6c6af1 Mon Sep 17 00:00:00 2001 From: Mike Burns Date: Thu, 6 Mar 2014 13:43:26 +0100 Subject: Document that you must quote globs The shell likes to expand globs as conveniently as possible. Therefore, quote them when passing them to lsrc(1) and others (e.g. `-x '*vim*'`). --- man/lsrc.1 | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) (limited to 'man') diff --git a/man/lsrc.1 b/man/lsrc.1 index ad4368f..22920f4 100644 --- a/man/lsrc.1 +++ b/man/lsrc.1 @@ -54,12 +54,14 @@ options. It uses the same pattern language as .Fl x ; more details are in the .Sx EXCLUDE PATTERN -section. +section. Note that you may have to quote the exclude pattern so the +shell does not evaluate the glob. . .It Fl S Ar excl_pat -symlink the directory that match the given pattern. See +symlink the directories that match the given pattern. See .Sx EXCLUDE PATTERN -for more details. This option can be repeated. +for more details. This option can be repeated. You may need to quote the +pattern to prevent the shell from swallowing the glob. . .It Fl t Ar TAG list dotfiles according to TAG @@ -73,7 +75,8 @@ decrease verbosity .It Fl x Ar excl_pat exclude the files that match the given pattern. See .Sx EXCLUDE PATTERN -for more details. This option can be repeated. +for more details. This option can be repeated. Quote the pattern if it +contains a valid shell glob. . .It Ar files ... only list the specified file(s) @@ -104,7 +107,9 @@ Or more simply: .Pp .Dl bash_profile .Pp -See the caveats noted in +. +Since exclude patterns are often valid shell globs, be sure to quote +them. See the caveats noted in .Sx BUGS when using an exclude pattern. .Sh ENVIRONMENT -- cgit v1.2.3