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	 envi-
       ronment	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 pat-
		      terns  are explained in detail in	lsrc(1)	under the sec-
		      tion "EXCLUDE PATTERN".

       HOSTNAME	      the hostname for this computer. This  is	normally  com-
		      puted 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.com

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.0.quarterly>

home | help