Scroll to navigation

MKRC(1) General Commands Manual MKRC(1)

NAME

mkrcbless files into a dotfiles managed by rcm

SYNOPSIS

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

DESCRIPTION

This program adds files to your dotfiles directory then update them back into your home directory. It can install files under a tag or install them in a different source directory. Remember to first create standard rc files, then use mkrc on them.

It supports these options:

HOSTNAME
use the supplied hostname instead of computing one. Implies -o.
copy instead of symlinking when installing the rc file back into your home directory. This will prevent future updates in the dotfiles directory for added element, and its contents if it is a directory.
DIR
install dotfiles under the specified directory. Use only once to override DOTFILES_DIRS value from RCRC and the absolute default value.
show usage instructions.
install dotfiles into the host-specific directory.
decrease verbosity.
treat the specified rc files as files to be symlinked, even if they are directories.
if the rc file is a file, symlink it; otherwise, make a directory structure as described in rcup(1) in the section ALGORITHM. This is the default.
TAG
install dotfiles according to tag
the specified files or directories are to be installed without a leading dot.
the specified files or directories are to be installed with a leading dot. This is the default.
increase verbosity. This can be repeated for extra verbosity.
show the version number.
pass -k to rcup when installing the made rc file. This option enables pre- and post-hooks, which is the default, making this effectively a no-op. See the ALGORITHM section in rcup(1).
pass -K to rcup when installing the made rc file. This option prevents pre- and post-up hooks from running as part of creating the rc file. See the ALGORITHM section in rcup(1).

ENVIRONMENT

User configuration file. Defaults to ~/.rcrc.

FILES

~/.dotfiles ~/.rcrc

EXAMPLES

mkrc ~/.vimrc
mkrc -t zsh -d company-dotfiles ~/.zshrc ~/.zlogin
mkrc -o ~/.rcrc
mkrc -C .ssh
mkrc -S .zpretzo
mkrc -U bin

SEE ALSO

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

AUTHORS

mkrc is maintained by Mike Burns <mburns@thoughtbot.com> and thoughtbot

April 13, 2020 Linux 6.4.0-150600.23.25-default