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

6 files changed, 88 insertions, 34 deletions

diff --git a/man/Makefile.in b/man/Makefile.in
index ed1e0db..51cc9de 100644
--- a/man/Makefile.in
+++ b/man/Makefile.in
@@ -184,9 +184,9 @@ $(srcdir)/Makefile.in:  $(srcdir)/Makefile.am  $(am__configure_deps)
 	      exit 1;; \
 	  esac; \
 	done; \
-	echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign man/Makefile'; \
+	echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu man/Makefile'; \
 	$(am__cd) $(top_srcdir) && \
-	  $(AUTOMAKE) --foreign man/Makefile
+	  $(AUTOMAKE) --gnu man/Makefile
 .PRECIOUS: Makefile
 Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
 	@case '$?' in \
diff --git a/man/lsrc.1 b/man/lsrc.1
index ff67a1f..863ceb8 100644
--- a/man/lsrc.1
+++ b/man/lsrc.1
@@ -9,6 +9,7 @@
 .Op Fl vq
 .Op Fl t Ar tag
 .Op Fl d Ar dir
+.Op Fl e Ar excl_pat
 .Op files ...
 .Sh DESCRIPTION
 This program lists all configuration files, both the sources in the
@@ -23,21 +24,52 @@ section, for details on the directory layout.
 It supports these options:
 .
 .Bl -tag
-.It Fl v
-increase verbosity. This can be repeated for extra verbosity.
-.
-.It Fl q
-decrease verbosity
-.
 .It Fl t Ar TAG
 list dotfiles according to TAG
 .
 .It Fl d Ar DIR
 list dotfiles from the DIR. This can be specified multiple times.
 .
+.It Fl e Ar excl_pat
+Exclude the files that matches the given pattern. See
+.Sx EXCLUDE PATTERN
+for more details. This option can be repeated.
+.
+.It Fl v
+increase verbosity. This can be repeated for extra verbosity.
+.
+.It Fl q
+decrease verbosity
+.
 .It Ar files ...
 only list the specified file(s)
 .El
+.Sh EXCLUDE PATTERN
+The exclude pattern specifies a colon-separated pair of dotfiles
+directory and file glob. The dotfiles directory is optional and, if
+omitted, defaults to
+.Li * ,
+which is a special token that matches any dotfiles directory. The file
+glob is relative to the dotfiles directory, ignoring meta directories. A
+colon combines them.
+.
+.Pp
+For example, to ignore all emacs-related items from the
+.Pa thoughtbot-dotfiles
+directory, use the exclude pattern:
+.Pp
+.Dl thoughtbot-dotfiles:*emacs*
+.Pp
+To ignore any
+.Pa bash_profile
+file, use the pattern:
+.Pp
+.Dl *:bash_profile
+.Pp
+Or more simply:
+.Pp
+.Dl bash_profile
+.Pp
 .Sh FILES
 .Pa ~/.dotfiles
 .Pa ~/.rcrc
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 ,
diff --git a/man/rcm.7 b/man/rcm.7
index 69ea809..3a9f659 100644
--- a/man/rcm.7
+++ b/man/rcm.7
@@ -83,10 +83,9 @@ in the directory directory. This will cause a
 or
 .Pa ~/.Makefile
 symlink to be created in your home
-directory. The best option here is to move that file outside of your
-dotfiles directory or remove it entirely.
+directory. Use an exclusion pattern to ignore these.
 .Pp
-.Dl rm -f install Rakefile Makefile install.sh
+.Dl rcup -e install -e Rakefile -e Makefile -e install.sh
 .Ss COMMON PROBLEM: DOTTED FILENAMES IN DOTFILES DIRECTORY
 A less common situation is for all the filenames in your dotfiles
 directory to be prefixed with a period. These files are skipped by the
@@ -201,6 +200,9 @@ will take precedence over
 .Pp
 .Dl rcup -d .dotfiles -d marriage-dotfiles -d thoughtbot-dotfiles
 .Pp
+An exclusion pattern can be tied to a specific dotfiles directory.
+.Pp
+.Dl rcup -d .dotfiles -d work-dotfiles -e 'work-dotfiles:powrc'
 .
 .Sh HOST-SPECIFIC DOTFILES
 You can also mark host-specific files. This will go by the hostname. The
diff --git a/man/rcrc.5 b/man/rcrc.5
index c66e718..f14eecf 100644
--- a/man/rcrc.5
+++ b/man/rcrc.5
@@ -17,30 +17,36 @@
 .Sh DESCRIPTION
 The rcm dotfile manager can be configured using a
 .Pa .rcrc
-file in your home directory. The format is POSIX shell, and it is
+file in your home directory. The format is POSIX shell. It is
 sourced in by the
 .Xr lsrc 1 ,
 .Xr mkrc 1 ,
+.Xr rcdn 1 ,
 and
 .Xr rcup 1
 programs.
 .Pp
 It supports these variables:
 .Bl -tag
-.It Va TAGS
-the default tags used by
-.Nm rcup
 .It Va DOTFILES_DIRS
 the source directories for dotfiles. The first in the list is the
 canonical source. The default value is
 .Li ~/.dotfiles
+.It Va EXCLUDES
+a space-separated list of exclude patterns. Exclude patterns are
+explained in detail in
+.Xr lsrc 1
+under the section
+.Sx EXCLUDE PATTERN .
+.It Va TAGS
+the default tags.
 .El
 .Sh FILES
-.Pa ~/.dotfiles
 .Pa ~/.rcrc
 .Sh EXAMPLES
-.Dl TAGS="freebsd development email git laptop gmail notmuch"
 .Dl DOTFILES_DIRS="/home/mike/.dotfiles /usr/share/dotfiles"
+.Dl EXCLUDES="irbrc *:*emacs* dotfiles:python*"
+.Dl TAGS="freebsd development email git laptop gmail notmuch"
 .Sh SEE ALSO
 .Xr lsrc 1 ,
 .Xr mkrc 1 ,
diff --git a/man/rcup.1 b/man/rcup.1
index a0921b2..16c818c 100644
--- a/man/rcup.1
+++ b/man/rcup.1
@@ -6,9 +6,9 @@
 .Nd update and install dotfiles
 .Sh SYNOPSIS
 .Nm rcup
-.Op Fl vqfi
-.Op Fl t Ar tag
+.Op Fl fiqv
 .Op Fl d Ar dir
+.Op Fl t Ar tag
 .Op Ar files ...
 .Sh DESCRIPTION
 This is a program to update and install personal dotfiles. These
@@ -23,25 +23,32 @@ for details on the directory layout.
 .Pp
 It supports these options:
 .Bl -tag
-.It f
+.It Fl d Ar DIR
+install dotfiles from the
+.Ar DIR
+\&. This can be specified multiple times.
+.It Fl e Ar EXCL_PAT
+do not install 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 f
 If the rc file already exists in your home directory but does not match
 the file in your dotfiles directory, remove the rc file then create the
 symlink
-.It i
+.It Fl i
 If the rc file already exists in your home directory but does not match
 the file in your dotfiles directory, prompt for how to handle it. This
 is the default
 .It Fl t Ar TAG
 install dotfiles according to
 .Ar TAG
-.It Fl d Ar DIR
-install dotfiles from the
-.Ar DIR
-\&. This can be specified multiple times.
-.It Fl v
-increase verbosity. This can be repeated for extra verbosity.
 .It Fl q
 decrease verbosity
+.It Fl v
+increase verbosity. This can be repeated for extra verbosity.
 .It Ar files
 only install the specified file(s)
 .El