1RCRC(5)                     BSD File Formats Manual                    RCRC(5)
2

NAME

4     rcrc — configuration for rcm
5

SYNOPSIS

7     X="a b c"
8

DESCRIPTION

10     The rcm dotfile manager can be configured using a .rcrc file in your home
11     directory. This location can be changed by setting the RCRC environment
12     variable. The format is POSIX shell. It is sourced in by the lsrc(1),
13     mkrc(1), rcdn(1), and rcup(1) programs.
14
15     It supports these variables:
16
17     COPY_ALWAYS    always copy files that match the listed globs, never sym‐
18                    link them.
19
20     DOTFILES_DIRS  the source directories for dotfiles. The first in the list
21                    is the source to which dotfiles created using mkrc(1) are
22                    installed. The default value is ~/.dotfiles
23
24     EXCLUDES       a space-separated list of exclude patterns. Exclude pat‐
25                    terns are explained in detail in lsrc(1) under the section
26                    EXCLUDE PATTERN.
27
28     HOSTNAME       the hostname for this computer. This is normally computed
29                    using the hostname(1) command, but this command is non-
30                    standard and can prove unreliable. The HOSTNAME variable
31                    forces a known hostname.
32
33     TAGS           the default tags.
34
35     SYMLINK_DIRS   a space-separated list of patterns. Directories matching a
36                    pattern are symlinked instead of descended. Patterns are
37                    explained in detail in lsrc(1) under the section EXCLUDE
38                    PATTERN.
39
40     UNDOTTED       a space separated list of patterns. Files matching this
41                    pattern will be symlinked without a leading dot. If a file
42                    is also in SYMLINK_DIRS, then the directory will be sym‐
43                    linked without a leading dot.  Patterns are explained in
44                    detail in lsrc(1) under the section EXCLUDE PATTERN.
45

FILES

47     ~/.rcrc
48

EXAMPLES

50           COPY_ALWAYS="ssh/id_* weechat/* netrc"
51           COPY_ALWAYS="*"
52           DOTFILES_DIRS="/home/mike/.dotfiles /usr/share/dotfiles"
53           EXCLUDES="irbrc *:*emacs* dotfiles:python*"
54           HOSTNAME="eggplant"
55           TAGS="freebsd development email git laptop gmail notmuch"
56           SYMLINK_DIRS="zprezto texmf"
57           UNDOTTED="texmf"
58

SEE ALSO

60     lsrc(1), mkrc(1), rcdn(1), rcup(1), rcm(7)
61

AUTHORS

63     rcrc is maintained by Mike Burns <mburns@thoughtbot.com> and thoughtbot:
64     http://thoughtbot.se
65

BUGS

67     We only expand tilde inside DOTFILES_DIRS and not inside any patterns.
68     For more notes on the caution you should exercise around patterns, see
69     the BUGS section of lsrc(1).
70
71BSD                              July 28, 2013                             BSD
Impressum