CLANG-RENAME(1)

💖 NAME 💖

clang-rename — bestie, this is the manual page for clang-rename 14, and it's gonna change your whole life (or at least your symbol names, which is basically the same thing) 💅

---

✨ DESCRIPTION ✨

okay so here's the whole vibe, literally the entire thing:

USAGE: clang-rename [options] <source0> [... <sourceN>]

that's it. that's the moment. you point it at some sources, you tell it what to rename, and it slays. 🦋

🌸 OPTIONS 🌸

not me listing every single one, but like, we're doing this properly. all of them. every last one. periodt.

🎀 Generic Options

the boring-but-essential girlies. every tool has them, and honestly? iconic for it.

• --help — shows you all the available options (--help-hidden if you wanna see even more 👀)
• --help-list — shows you the list of available options (--help-list-hidden for the extended cut)
• --version — tells you what version of this program you're running, so you can flex

🧚 clang-rename common options

okay THIS is where it gets good. the main character options, the ones you actually came here for 💜

• --export-fixes=<filename> — a YAML file where all the suggested fixes get stored. it's giving receipts ✨
• --extra-arg=<string> — an extra argument to append to the compiler command line (append! after! not before! we said what we said)
• --extra-arg-before=<string> — an extra argument to prepend to the compiler command line. front of the line, bestie, no cuts 🎀
• --force — ignore qualified names that don't exist. like, they're not there? don't care. moving on. 💀
• -i — overwrite the edited <file>s. in place. no take-backs, no backup, just vibes 😭 (fr fr, it writes over your files)
• --input=<string> — a YAML file to load your oldname-newname pairs from. bulk renaming era 🫶
• --new-name=<string> — the new name you want to change the symbol to. the glow-up itself 🌈
• --offset=<uint> — locates the symbol by offset instead of <line>:<column>. two ways to find the same girl ⭐
• -p=<string> — build path
• --pl — prints the locations affected by renaming to stderr. a little map of everywhere you're about to change 🗺️
• --pn — prints the found symbol's name prior to renaming to stderr. so you know who it was before the transformation 👑
• --qualified-name=<string> — the fully qualified name of the symbol. the whole entire government name, no nicknames 🔥

lowkey important: --extra-arg appends and --extra-arg-before prepends and those are not the same thing, don't mix them up bestie, iykyk 💅

---

and that's the whole page, we ate and left no crumbs 🍓

signing off from clang-rename 14, dated May 2025 — love u, go rename something cute 💖✨🎀