summaryrefslogtreecommitdiff
path: root/man/rcrc.5
blob: ec6ef9ae0b73f33bf315f0ef8c49455fc02520d8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
.Dd July 28, 2013
.Dt RCRC 5
.Os
.Sh NAME
.Nm rcrc
.Nd configuration for rcm
.Sh SYNOPSIS
.Sm off
.Ns Ev X
.Ns =
.Ns Qo
.Va a\ \&
.Va b\ \&
.Va c
.Qc
.Sm on
.Sh DESCRIPTION
The rcm dotfile manager can be configured using a
.Pa .rcrc
file in your home directory. This location can be changed by setting the
.Pa RCRC
environment variable. The format is POSIX shell. It is sourced in by the
.Xr lsrc 1 ,
.Xr mkrc 1 ,
.Xr rcdn 1 ,
and
.Xr rcup 1
programs.
.Pp
It supports these variables:
.Bl -tag
.It Va COPY_ALWAYS
always copy files that match the listed globs, never symlink them.
.
.It Va DOTFILES_DIRS
the source directories for dotfiles. The first in the list is the
canonical source. The default value is
.Li ~/.dotfiles
.
.It Va EXCLUDES
a space-separated list of exclude patterns. Exclude patterns are
explained in detail in
.Xr lsrc 1
under the section
.Sx EXCLUDE PATTERN .
.
.It Va TAGS
the default tags.
.El
.Sh FILES
.Pa ~/.rcrc
.Sh EXAMPLES
.Dl COPY_ALWAYS="ssh/id_* weechat/* netrc"
.Dl COPY_ALWAYS="*"
.Dl DOTFILES_DIRS="/home/mike/.dotfiles /usr/share/dotfiles"
.Dl EXCLUDES="irbrc *:*emacs* dotfiles:python*"
.Dl TAGS="freebsd development email git laptop gmail notmuch"
.Sh SEE ALSO
.Xr lsrc 1 ,
.Xr mkrc 1 ,
.Xr rcdn 1 ,
.Xr rcup 1 ,
.Xr rcm 7
.Sh AUTHORS
.An "Mike Burns" Aq mike@mike-burns.com