From 122bbf0c6da226fc7e8a7e2a8d173b3e6259f7cf Mon Sep 17 00:00:00 2001
From: Mike Burns <mike@mike-burns.com>
Date: Mon, 5 Aug 2013 04:41:38 +0200
Subject: Inclusionary patterns: -I

The `-I` flag serves as an "undo" for the `-e` pattern. It overrides any
matching exclusions, allowing for temporary
listing/installation/removal.

For example, if you want to try a `.pythonrc` but leave it in your
`EXCLUDES` in rcrc(5), you can do:

    rcup -Ipythonrc pythonrc
---
 man/lsrc.1 | 14 ++++++++++++--
 man/rcdn.1 | 15 ++++++++++++++-
 man/rcup.1 | 13 +++++++++++++
 3 files changed, 39 insertions(+), 3 deletions(-)

(limited to 'man')

diff --git a/man/lsrc.1 b/man/lsrc.1
index 863ceb8..fb48680 100644
--- a/man/lsrc.1
+++ b/man/lsrc.1
@@ -7,9 +7,10 @@
 .Sh SYNOPSIS
 .Nm lsrc
 .Op Fl vq
-.Op Fl t Ar tag
 .Op Fl d Ar dir
 .Op Fl e Ar excl_pat
+.Op Fl I Ar excl_pat
+.Op Fl t Ar tag
 .Op files ...
 .Sh DESCRIPTION
 This program lists all configuration files, both the sources in the
@@ -31,10 +32,19 @@ list dotfiles according to TAG
 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
+exclude the files that match the given pattern. See
 .Sx EXCLUDE PATTERN
 for more details. This option can be repeated.
 .
+.It Fl I Ar excl_pat
+include the files that match the given pattern. This is applied after
+any
+.Fl e
+options. It uses the same pattern language as
+.Fl e ;
+more details are in the
+.Sx EXCLUDE PATTERN
+section.
 .It Fl v
 increase verbosity. This can be repeated for extra verbosity.
 .
diff --git a/man/rcdn.1 b/man/rcdn.1
index c6f8e9f..9007783 100644
--- a/man/rcdn.1
+++ b/man/rcdn.1
@@ -7,8 +7,10 @@
 .Sh SYNOPSIS
 .Nm rcdn
 .Op Fl vq
-.Op Fl t Ar tag
 .Op Fl d Ar dir
+.Op Fl e Ar excl_pat
+.Op Fl I Ar excl_pat
+.Op Fl t Ar tag
 .Op Ar files ...
 .Sh DESCRIPTION
 This program will remove all the rc files that the
@@ -30,6 +32,17 @@ This can be repeated with additional patterns. See
 .Xr lsrc 1 ,
 .Sx EXCLUDE PATTERN ,
 for more details.
+.It Fl I Ar EXCL_PAT
+remove rc files that match
+.Ar EXCL_PAT
+despite being excluded by the
+.Fl e
+flag or a setting in
+.Xr rcrc 5 .
+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
diff --git a/man/rcup.1 b/man/rcup.1
index 16c818c..342ee6b 100644
--- a/man/rcup.1
+++ b/man/rcup.1
@@ -8,6 +8,8 @@
 .Nm rcup
 .Op Fl fiqv
 .Op Fl d Ar dir
+.Op Fl e Ar excl_pat
+.Op Fl I Ar excl_pat
 .Op Fl t Ar tag
 .Op Ar files ...
 .Sh DESCRIPTION
@@ -42,6 +44,17 @@ symlink
 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 I Ar EXCL_PAT
+install rc files that match
+.Ar EXCL_PAT
+despite being excluded by the
+.Fl e
+flag or a setting in
+.Xr rcrc 5 .
+This can be repeated with additional patterns. See
+.Xr lsrc 1 ,
+.Sx EXCLUDE PATTERN ,
+for more details.
 .It Fl t Ar TAG
 install dotfiles according to
 .Ar TAG
-- 
cgit v1.2.3