From d61396f694b4ac201cdfd76765e455fefb31b5e4 Mon Sep 17 00:00:00 2001 From: Mike Burns Date: Fri, 7 Mar 2014 11:32:23 +0100 Subject: Document glob bugs Until we can get a handle on globbing, we cannot close #11. That bug is the last remaining ticket blocking the 1.2.1 release. However, it may involve a larger modification than a patch release should. Documenting allows us to make the release while working on the bug for the next release. http://1389blog.com/pix/thats-a-feature-not-a-bug.jpg --- man/lsrc.1 | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) (limited to 'man') diff --git a/man/lsrc.1 b/man/lsrc.1 index 65ba05e..98109e8 100644 --- a/man/lsrc.1 +++ b/man/lsrc.1 @@ -25,7 +25,7 @@ section, for details on the directory layout. . It supports these options: . -.Bl -tag +.Bl -tag -width "-I excl_pat" .It Fl d Ar DIR list dotfiles from the DIR. This can be specified multiple times. . @@ -104,6 +104,9 @@ Or more simply: .Pp .Dl bash_profile .Pp +See the caveats noted in +.Sx BUGS +when using an exclude pattern. .Sh ENVIRONMENT .Bl -tag -width ".Ev RCRC" .It Ev RCRC @@ -121,3 +124,11 @@ User configuration file. Defaults to .Xr rcm 7 .Sh AUTHORS .An "Mike Burns" Aq mike@mike-burns.com +.Sh BUGS +There are a few bugs around shell globs. Anything involving an exclude +pattern is unpredictable, so use +.Fl v +when dealing with patterns. Specifically, globs may expand at any +time and remain expanded for the duration of the run, which means they +cannot be applied more than once. In addition, globs involving +relative directory names do not work. -- cgit v1.2.3