CLANG-RENAME(1)

💅 NAME 💅

clang-rename — the manual page for clang-rename 17, bestie. it's a User Command, it lives in section 1, and yes she's iconic.

---

✨ DESCRIPTION ✨

okay so. here's the whole vibe. the usage is literally this, copy it exactly:

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

and then we got the OPTIONS. buckle up, there's a few. 🎀

🌸 Generic Options 🌸

these are the universal ones, the main character energy options that every clang tool shows up with:

• --help — shows you all the available options. and if you want the secret menu, like the ones they don't advertise, add --help-hidden for more. 🙈
• --help-list — prints out a list of all the available options. and yep, --help-list-hidden for more, same deal. ✨
• --version — tells you what version of this program you're running. slay.

🦋 clang-rename common options 🦋

now THIS is the section you actually came here for. the real ones:

• --export-fixes=<filename> — a YAML file where the suggested fixes get stored. like, the receipts of what it would have done. 🍓
• --extra-arg=<string> — an extra argument you wanna append to the compiler command line.
• --extra-arg-before=<string> — same idea but you prepend it instead. front of the line, main character behavior. 👑
• --force — ignores nonexistent qualified names. like, doesn't care if the thing you named isn't there. bold. 💀
• -i — overwrites the edited <file>s. yes, in place. no take-backs. 😭
• --input=<string> — a YAML file to load your oldname-newname pairs from. the glow-up instructions, basically. 💖
• --new-name=<string> — the new name you want the symbol changed to. the whole point, fr fr. ⭐
• --offset=<uint> — locates the symbol by offset instead of by <line>:<column>. different coordinate system, same destination. 🌈
• -p <string> — the build path.
• --pl — prints the locations affected by the renaming out to stderr.
• --pn — prints the found symbol's name, before it gets renamed, out to stderr.
• --qualified-name=<string> — the fully qualified name of the symbol. the full government name, no nicknames. 💜

ngl bestie, watch out for -i — it edits your files for real. no undo, no ctrl+z, no "wait actually." be sure. 🫶

---

that's the whole page, no cap. this was clang-rename 17 from June 2025 — go rename something and make it gorgeous. periodt. 💅✨🎀🦋