DragonFly On-Line Manual Pages

Search: Section:  

RCRC(5)                  DragonFly File Formats Manual                 RCRC(5)


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

DragonFly 6.5-DEVELOPMENT        July 28, 2013       DragonFly 6.5-DEVELOPMENT

Search: Section: