CLANG-RENAME(1)

📦
version 18.1.8 · 5 versions
, in debian trixie, ubuntu questing

💅 NAME 💅

okay so bestie, welcome to clang-rename — it's the manual page for clang-rename 18, aka the little tool that goes "that symbol? new name. right now. periodt." 🎀

✨ DESCRIPTION ✨

The way you run it is literally this:

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

so you hand it some source files — <source0>, and if you're feeling extra, all the way up to <sourceN> — plus whatever options you want, and it does its thing. 🌸

🌈 OPTIONS 🌈

👑 Generic Options

These are the "everyone gets these" options, no cap:

  • --help — shows you all the available options. and if that's not enough tea for you, there's --help-hidden for even more. 🫖
  • --help-list — prints out the list of available options instead. and yes, --help-list-hidden exists too if you want the hidden ones. 🙈
  • --version — tells you which version of the program you're running. slay.

🦋 clang-rename common options

okay this is the main character section, pay attention:

  • --export-fixes=<filename> — writes the suggested fixes into a YAML file with this name. 💾
  • --extra-arg=<string> — an extra argument that gets appended to the compiler command line.
  • --extra-arg-before=<string> — same vibe but it gets prepended to the compiler command line instead. before, not after, iykyk.
  • --force — ignores qualified names that don't exist. like, "girl, i don't know her" energy. 😭
  • -i — overwrites the edited <file>s in place. careful bestie, this one commits. 🔥
  • --input=<string> — a YAML file to load your oldname-newname pairs from. basically a rename mood board. 🎀
  • --new-name=<string> — the new name you want the symbol to have. the glow-up itself. ✨
  • --offset=<uint> — finds the symbol by offset instead of by <line>:<column>. two ways to locate, pick your fighter.
  • -p <string> — the build path. 🏗️
  • --pl — prints the locations affected by the renaming to stderr.
  • --pn — prints the found symbol's name before renaming it, to stderr.
  • --qualified-name=<string> — the fully qualified name of the symbol. like the government name, not the nickname. 💜
bestie reminder: <source0> [... <sourceN>] are positional, so they come after your options — don't fight the synopsis, she's right.

and that's the whole page, no notes. this was written for clang-rename 18 back in June 2025 — if you're reading this from the future, hiii, hope the tool still ate. 👑🌈⭐

mwah, go rename something iconic 💖

📦 where this page comes from