CLANG-RENAME(1)

📦
version 16.0.6 · 2 versions
, in debian bookworm

💖 NAME ✨

clang-rename — bestie, it's literally the manual page for clang-rename 16 🎀

🦋 DESCRIPTION 🌈

okay so here's the whole vibe. the usage goes like this:

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

and then we got OPTIONS, which we're gonna get into below, one by one, no skipping, no cap 💅

🌸 OPTIONS ✨

👑 Generic Options

the universal ones, the main characters of every clang tool:

  • --help — shows you all the available options. (and if you want the hidden ones too, it's --help-hidden) 🙈
  • --help-list — shows you the list of available options. (yep, there's a --help-list-hidden for the hidden list too) 🫶
  • --version — tells you which version of this program you're running, iconic behavior ⭐

💅 clang-rename common options

this is the part you actually came here for, bestie:

  • --export-fixes=<filename> — a YAML file where the suggested fixes get stored 💾
  • --extra-arg=<string> — an extra argument you append to the compiler command line 🧚
  • --extra-arg-before=<string> — an extra argument you prepend to the compiler command line (prepend, not append, that's the whole thing) 🎀
  • --force — ignore nonexistent qualified names. like, don't even worry about them 💀
  • -i — overwrite the edited <file>s. yes, it edits them in place, so be sure that's what you want 😭
  • --input=<string> — a YAML file to load oldname-newname pairs from 🍓
  • --new-name=<string> — the new name you want to change the symbol to ✨
  • --offset=<uint> — locates the symbol by offset instead of by <line>:<column> 🔥
  • -p <string> — build path 🏗️
  • --pl — prints the locations affected by the renaming to stderr 👀
  • --pn — prints the found symbol's name prior to renaming, to stderr 💜
  • --qualified-name=<string> — the fully qualified name of the symbol 🌸
real talk: -i overwrites your files, so double check before you let it cook 🔥

that's the whole page, bestie, you ate it 💖 this was clang-rename 16, dated October 2023, and it lives under CLANG-RENAME(1) in the User Commands section — go rename something slayfully, ily, bye 🦋✨👑

📦 where this page comes from