summaryrefslogtreecommitdiff
path: root/man/rcrc.5
diff options
context:
space:
mode:
authorGravatar Pablo Olmos de Aguilera Corradini and Mike Burns <pablo@glatelier.org>2013-10-27 17:16:30 -0300
committerGravatar Mike Burns <mike@mike-burns.com>2014-02-18 16:57:01 +0100
commit3700be9ce6802653df30c413179d93316bf0b291 (patch)
tree5e78da946c28e12b4a5fb760779d8e8689c02540 /man/rcrc.5
parent83c4875e23bb7595689ddd228a9825264b15f318 (diff)
Force some directories to be symlinks
Typically a directory structure is copied instead of symlinked, while files are symlinked. However, some cases require symlinked dirs: git submodules, vim plugins, and so on. This introduces a `SYMLINK_DIRS` option for rcrc(5) that takes a space-separated list of "exclude patterns". Any directory matching these patterns is symlinked. This also introduces a `-S` argument for lsrc(1), rcup(1), and rcdn(1). This argument takes a pattern, for one-off directory symlinking. It can be repeated. This also introduces `-S` and `-s` for mkrc(1). `-S` will re-install the files as symlinks, and `-s` will not. This does work with `-C`, though perhaps unintuitively - we don't know what the user means in this case. However, it will not crash. Bug: `-s` does not work right if `SYMLINK_DIRS` is set. Bug #36 addresses this.
Diffstat (limited to 'man/rcrc.5')
-rw-r--r--man/rcrc.59
1 files changed, 9 insertions, 0 deletions
diff --git a/man/rcrc.5 b/man/rcrc.5
index ec6ef9a..ca6e22e 100644
--- a/man/rcrc.5
+++ b/man/rcrc.5
@@ -46,6 +46,14 @@ under the section
.
.It Va TAGS
the default tags.
+.
+.It Va SYMLINK_DIRS
+a space-separated list of patterns. Directories matching a pattern are
+symlinked instead of descended. Patterns are explained in detail in
+.Xr lsrc 1
+under the section
+.Sx EXCLUDE PATTERN .
+.
.El
.Sh FILES
.Pa ~/.rcrc
@@ -55,6 +63,7 @@ the default tags.
.Dl DOTFILES_DIRS="/home/mike/.dotfiles /usr/share/dotfiles"
.Dl EXCLUDES="irbrc *:*emacs* dotfiles:python*"
.Dl TAGS="freebsd development email git laptop gmail notmuch"
+.Dl SYMLINK_DIRS="zprezto"
.Sh SEE ALSO
.Xr lsrc 1 ,
.Xr mkrc 1 ,