CLANG-RENAME(1)

📦 version 11.1.0, in ubuntu jammy

✨ CLANG-RENAME ✨

okay bestie, so clang-rename is a whole manual page for clang-rename 11 and it's literally about to change your life (or at least your symbol names 💅). here's the tea, no cap.

🌸 DESCRIPTION 🌸

USAGE: it goes like this, exactly like this, don't freestyle it:

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

then we get into the OPTIONS and honestly? there's a lot. let's go.

🎀 Generic Options 🎀

the basics, the starter pack, the main character energy:

  • --help — shows you all the available options. and if you want the secret ones too, there's --help-hidden for more 👀
  • --help-list — prints out the list of available options. wanting more? --help-list-hidden for more ✨
  • --version — tells you what version of this program you're running. identity check 🪞

🦋 clang-rename common options 🦋

okay now the actual good stuff:

  • --export-fixes=<filename> — drops the suggested fixes into a YAML file. save the receipts, bestie 💾
  • --extra-arg=<string> — an extra argument, appended to the compiler command line
  • --extra-arg-before=<string> — same vibe but it gets prepended instead, so it goes first 👑
  • --force — ignores nonexistent qualified names. it's giving "i don't see it so it's not there" 💀
  • -i — overwrites the edited <file>s. be careful, this one really does the thing 🙈
  • --input=<string> — a YAML file to load your oldname-newname pairs from. bulk renaming? obsessed 🍓
  • --new-name=<string> — the new name you want the symbol to have. the glow-up ✨
  • --offset=<uint> — finds the symbol by offset instead of by <line>:<column>. different route, same destination 🗺️
  • -p=<string> — build path
  • --pl — prints the locations affected by the renaming to stderr. so you can see what's about to change 📍
  • --pn — prints the found symbol's name before renaming it, to stderr. pre-glow-up photo 📸
  • --qualified-name=<string> — the fully qualified name of the symbol. full government name, periodt 💅
ngl the <file> in -i is a real placeholder — -i overwrites edited files, so know what you're pointing it at before you commit, fr fr.

clang-rename 11 · January 2022 — that's the version and the date, mwah, tysm for reading my little manual page, ily, go rename something iconic 🫶🌈💖

📦 where this page comes from