Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
RCRC(5) 		       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-stan-
		    dard 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 ex-
		    plained in detail in  lsrc(1)  under  the  section	"EXCLUDE
		    PATTERN".

     UNDOTTED	    a space separated list of patterns. Files matching this pat-
		    tern  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

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).

FreeBSD ports 15.quarterly	  July 28, 2013 			 RCRC(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rcrc&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help