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/rcup.1 | 27 +++++++++++++++++----------
 1 file changed, 17 insertions(+), 10 deletions(-)

(limited to 'man/rcup.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
-- 
cgit v1.2.3