1MKRC(1)                   BSD General Commands Manual                  MKRC(1)
2

NAME

4     mkrc — bless files into a dotfiles managed by rcm
5

SYNOPSIS

7     mkrc [-ChoqSsVvUukK] [-t tag] [-d dir] [-B hostname] files ...
8

DESCRIPTION

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

ENVIRONMENT

63     RCRC  User configuration file. Defaults to ~/.rcrc.
64

FILES

66     ~/.dotfiles ~/.rcrc
67

EXAMPLES

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

SEE ALSO

77     lsrc(1), rcdn(1), rcup(1), rcrc(5), rcm(7)
78

AUTHORS

80     mkrc is maintained by Mike Burns <mburns@thoughtbot.com> and thoughtbot:
81     http://thoughtbot.com
82
83BSD                             April 13, 2020                             BSD
Impressum