1MKRC(1) BSD General Commands Manual MKRC(1)
2
4 mkrc — bless files into a dotfiles managed by rcm
5
7 mkrc [-ChoqSsVvUukK] [-t tag] [-d dir] [-B hostname] files ...
8
10 This program adds files to your dotfiles directory then update them back
11 into your home directory. It can install files under a tag or install
12 them in a different source directory. Remember to first create standard
13 rc files, then use mkrc on them.
14
15 It supports these options:
16
17 -B HOSTNAME
18 use the supplied hostname instead of computing one. Implies -o.
19
20 -C copy instead of symlinking when installing the rc file back into
21 your home directory. This will prevent future updates in the dot‐
22 files directory for added element, and its contents if it is a
23 directory.
24
25 -d DIR install dotfiles under the specified directory. Use only once to
26 override DOTFILES_DIRS value from RCRC and the absolute default
27 value.
28
29 -h show usage instructions.
30
31 -o install dotfiles into the host-specific directory.
32
33 -q decrease verbosity.
34
35 -S treat the specified rc files as files to be symlinked, even if
36 they are directories.
37
38 -s if the rc file is a file, symlink it; otherwise, make a directory
39 structure as described in rcup(1) in the section ALGORITHM. This
40 is the default.
41
42 -t TAG install dotfiles according to tag
43
44 -U the specified files or directories are to be installed without a
45 leading dot.
46
47 -u the specified files or directories are to be installed with a
48 leading dot. This is the default.
49
50 -v increase verbosity. This can be repeated for extra verbosity.
51
52 -V show the version number.
53
54 -k pass -k to rcup when installing the made rc file. This option en‐
55 ables pre- and post-hooks, which is the default, making this ef‐
56 fectively a no-op. See the ALGORITHM section in rcup(1).
57
58 -K pass -K to rcup when installing the made rc file. This option
59 prevents pre- and post-up hooks from running as part of creating
60 the rc file. See the ALGORITHM section in rcup(1).
61
63 RCRC User configuration file. Defaults to ~/.rcrc.
64
66 ~/.dotfiles ~/.rcrc
67
69 mkrc ~/.vimrc
70 mkrc -t zsh -d company-dotfiles ~/.zshrc ~/.zlogin
71 mkrc -o ~/.rcrc
72 mkrc -C .ssh
73 mkrc -S .zpretzo
74 mkrc -U bin
75
77 lsrc(1), rcdn(1), rcup(1), rcrc(5), rcm(7)
78
80 mkrc is maintained by Mike Burns <mburns@thoughtbot.com> and thoughtbot:
81 http://thoughtbot.com
82
83BSD April 13, 2020 BSD