NAME

     rcrc — configuration for rcm

SYNOPSIS

     X="a b c"

DESCRIPTION

     The rcm dotfile manager can be configured using a .rcrc file in your home directory. This
     location can be changed by setting the RCRC environment variable. The format is POSIX shell.
     It is sourced in by the lsrc(1), mkrc(1), rcdn(1), and rcup(1) programs.

     It supports these variables:

     COPY_ALWAYS    always copy files that match the listed globs, never symlink them.

     DOTFILES_DIRS  the source directories for dotfiles. The first in the list is the source to
                    which dotfiles created using mkrc(1) are installed. The default value is
                    ~/.dotfiles

     EXCLUDES       a space-separated list of exclude patterns. Exclude patterns are explained in
                    detail in lsrc(1) under the section EXCLUDE PATTERN.

     HOSTNAME       the hostname for this computer. This is normally computed using the
                    hostname(1) command, but this command is non-standard and can prove
                    unreliable. The HOSTNAME variable forces a known hostname.

     TAGS           the default tags.

     SYMLINK_DIRS   a space-separated list of patterns. Directories matching a pattern are
                    symlinked instead of descended. Patterns are explained in detail in lsrc(1)
                    under the section EXCLUDE PATTERN.

     UNDOTTED       a space separated list of patterns. Files matching this pattern will be
                    symlinked without a leading dot. If a file is also in SYMLINK_DIRS, then the
                    directory will be symlinked without a leading dot.  Patterns are explained in
                    detail in lsrc(1) under the section EXCLUDE PATTERN.

FILES

     ~/.rcrc

EXAMPLES

           COPY_ALWAYS="ssh/id_* weechat/* netrc"
           COPY_ALWAYS="*"
           DOTFILES_DIRS="/home/mike/.dotfiles /usr/share/dotfiles"
           EXCLUDES="irbrc *:*emacs* dotfiles:python*"
           HOSTNAME="eggplant"
           TAGS="freebsd development email git laptop gmail notmuch"
           SYMLINK_DIRS="zprezto texmf"
           UNDOTTED="texmf"

SEE ALSO

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

AUTHORS

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

BUGS

     We only expand tilde inside DOTFILES_DIRS and not inside any patterns. For more notes on the
     caution you should exercise around patterns, see the BUGS section of lsrc(1).