RCDN(1)

💖 RCDN(1) — the rcdn page, bestie edition 💖

General Commands Manual · the one where we YEET the dotfiles

---

✨ NAME ✨

rcdn — remove dotfiles as managed by rcm

okay so. you know how rcup puts all your cute little dotfiles in place? rcdn is the undo button. it removes them. it's giving reverse card. 🃏

---

🌸 SYNOPSIS 🌸

rcdn [-hKkqVv] [-B hostname] [-d dir] [-I excl_pat] [-S excl_pat]
     [-s excl_pat] [-t tag] [-U excl_pat] [-u excl_pat] [-x excl_pat]
     [files ...]

---

🦋 DESCRIPTION 🦋

So. This program will remove all the rc files that the rcm(7) suite knows about. All of them. Every single one it's aware of. You can narrow that down with the -t and -d flags if you're not in a full-send mood. 💅

The files that get removed are symlinks. However, the COPY_ALWAYS setting in rcrc(5) modifies this. So:

• If a rc file is not a symlink but an ancestor directory is — that directory is the one that gets removed.
• If a rc file is not a symlink but is listed in COPY_ALWAYS — the file itself gets removed.

The rcdn program will run hooks before and after removing files, if these hooks exist. Hooks are executable programs inside the dotfiles directory, with the following names:

• hooks/pre-down
• hooks/post-down

These hooks are run each time rcdn is run and therefore must be idempotent. no cap. if your hook isn't idempotent it's gonna have a bad time. 😭

Hooks will be executed one at a time, sorted alphabetically. For instance, hooks/pre-down/animals will run before hooks/pre-down/aquariums, and hooks/pre-down/4-eyes will run before hooks/post-down/2-u-nothing-compares.

---

💅 OPTIONS 💅

• -B HOSTNAME — treat host-HOSTNAME as the host-specific directory instead of computing it. you don't gotta do the math, we did it for you. 🧮
• -d DIR — remove rc files from the DIR. This can be specified multiple times. (stack 'em up, queen 👑)
• -h — show usage instructions.
• -I EXCL_PAT — remove rc files that match EXCL_PAT despite being excluded by the -x flag or a setting in rcrc(5). This can be repeated with additional patterns. See lsrc(1), “EXCLUDE PATTERN”, for more details. (this is the override one. the "actually, no" one. 💀)
• -K — skip pre- and post-hooks. no hooks today, we're booked. 🙈
• -k — run pre- and post-hooks. This is the default.
• -q — decrease verbosity. shhh. 🤫
• -S EXCL_PAT — when removing dotfiles, any file that matches EXCL_PAT should be treated as a file that was symlinked, even if it is a directory. This can be repeated.
• -s EXCL_PAT — when removing dotfiles, any directory that matches EXCL_PAT should be recurred upon like normal. This is the default, and is the opposite of -S. This can be repeated.
• -t TAG — remove dotfiles according to TAG. 🏷️
• -U EXCL_PAT — any rc file or directory that matches EXCL_PAT is considered to have been installed without a leading dot when removing them. Must be specified for rc files or directories that were indeed installed without a leading dot. This can be repeated. See the documentation of the -U option in lsrc(1) for more information.
• -u EXCL_PAT — any rc file or directory that matches EXCL_PAT is considered to have been installed with a leading dot when removing them. This is the default, and is the opposite of -U. This can be repeated. See the documentation of the -u option in lsrc(1) for more information.
• -v — increase verbosity. This can be repeated for extra verbosity. (spam that -v, bestie, go -vvvv if you're feeling unhinged ✨)
• -V — show the version number.
• -x EXCL_PAT — do not remove rc files that match EXCL_PAT. This can be repeated with additional patterns. See lsrc(1), “EXCLUDE PATTERN”, for more details. (the leave it alone flag 🛑)
• files — only remove the specified file(s)

---

🌈 ENVIRONMENT 🌈

• RCRC — User configuration file. Defaults to ~/.rcrc.

---

🎀 FILES 🎀

• ~/.rcrc

---

⭐ EXAMPLES ⭐

like. here's the vibe. run these:

rcdn -v
rcdn zshrc
rcdn -t python
rcdn -d ~/corporate-dotfiles
rcdn -x '*:.zshrc'

---

👑 SEE ALSO 👑

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

(go read rcup(1) if you wanna do the opposite of this. balance. 🧚)

---

🫶 AUTHORS 🫶

rcdn is maintained by Mike Burns <mburns@thoughtbot.com> and thoughtbot: http://thoughtbot.com

---

Debian · August 2, 2013

and that's the whole page, bestie. 💖 shipped from Debian, dated August 2, 2013, and it ate. go forth and rcdn responsibly. periodt. ✨🎀🦋