diff options
| author |  Mike Burns <mike@mike-burns.com> | 2014-03-07 11:32:23 +0100 |
|---|---|---|
| committer | Mike Burns <mike@mike-burns.com> | 2014-03-07 11:37:19 +0100 |
| commit | d61396f694b4ac201cdfd76765e455fefb31b5e4 (patch) | |
| tree | 33b167eb1b3f8e8156faf62c5cc9f85e810c3b67 /man | |
| parent | ae23ec55b2f6dfa8b8b54dd771c6392fc38698b8 (diff) | |
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
Diffstat (limited to 'man')
| -rw-r--r-- | man/lsrc.1 | 13 |
1 files changed, 12 insertions, 1 deletions
@@ -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. |