From 63b50643b0ffd287d0070e494625056a05081ce8 Mon Sep 17 00:00:00 2001
From: Mike Burns <mike@mike-burns.com>
Date: Sun, 4 Aug 2013 10:35:14 -0400
Subject: Introduce exclusion patterns

The lsrc(1), rcup(1), and rcdn(1) commands now take any number of `-e`
flags, used to specify an exclusion pattern. This can also be controlled
via rcrc(5), the `EXCLUDES` variable.

An exclusion pattern specifies a file glob to skip. In the case of
lsrc(1), any file matching the glob is not listed; in rcup(1) it is not
symlinked; and in rcdn(1) it is not removed.

The file glob can be preceded by the name of a dotfiles directory
(separated from the file glob by a colon) to increase the specificity.

Useful for:

    rcdn -e rcrc
    rcup -d work-dotfiles -e bashrc
    rcup -d ~/.dotfiles -d wife-dotfiles -d sys-dotfiles -e wife-dotfiles:tigrc
---
 man/rcdn.1 | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

(limited to 'man/rcdn.1')

diff --git a/man/rcdn.1 b/man/rcdn.1
index 65c9bf0..c6f8e9f 100644
--- a/man/rcdn.1
+++ b/man/rcdn.1
@@ -19,17 +19,24 @@ and
 .Fl d
 flags.
 .Bl -tag
-.It Fl v
-increase verbosity. This can be repeated for extra verbosity.
+.It Fl d Ar DIR
+remove rc files from the
+.Ar DIR .
+This can be specified multiple times.
+.It Fl e Ar EXCL_PAT
+do not remove rc files that match
+.Ar EXCL_PAT .
+This can be repeated with additional patterns. See
+.Xr lsrc 1 ,
+.Sx EXCLUDE PATTERN ,
+for more details.
 .It Fl q
 decrease verbosity
 .It Fl t Ar TAG
 remove dotfiles according to
 .Ar TAG
-.It Fl d Ar DIR
-remove dotfiles from the
-.Ar DIR .
-This can be specified multiple times.
+.It Fl v
+increase verbosity. This can be repeated for extra verbosity.
 .It Ar files
 only remove the specified file(s)
 .El
@@ -39,8 +46,8 @@ only remove the specified file(s)
 .Dl rcdn zshrc
 .Dl rcdn -t python
 .Dl rcdn -d ~/corporate-dotfiles
+.Dl rcdn -e '*:.zshrc'
 .Sh FILES
-.Pa ~/.dotfiles
 .Pa ~/.rcrc
 .Sh SEE ALSO
 .Xr lsrc 1 ,
-- 
cgit v1.2.3