CLANG-RENAME(1)

πŸ“¦
version 15.0.7 Β· 3 versions
, in ubuntu jammy

✨ clang-rename ✨

okay so bestie, welcome to the glow-up era of clang-rename, and this is literally the manual page for clang-rename 15 πŸ’–


🌸 NAME 🌸

clang-rename β€” manual page for clang-rename 15


πŸ¦‹ DESCRIPTION πŸ¦‹

so the whole vibe is this: you feed it some source files and it renames stuff for you. the usage is:

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

and then we get into the options, which are split into two little groups, bestie πŸŽ€


πŸ’… OPTIONS πŸ’…

⭐ Generic Options

the basic-everything-flags, iykyk:

  • --help β€” shows you all the available options (and if you add --help-hidden you get even more, lowkey the secret menu πŸ‘€)
  • --help-list β€” shows you the list of available options (and --help-list-hidden for more, same energy as above fr fr)
  • --version β€” shows you what version of this program you're running, so you know exactly what you're working with πŸ’

🌈 clang-rename common options

this is the main character section, periodt:

  • --export-fixes=<filename> β€” drops a YAML file where all the suggested fixes get stored, so nothing gets lost 🫢
  • --extra-arg=<string> β€” one extra argument to append onto the compiler command line
  • --extra-arg-before=<string> β€” same thing but it gets prepended instead, front of the line energy πŸ‘‘
  • --force β€” tells it to ignore qualified names that don't exist. it's giving "don't check, just do it"
  • -i β€” overwrites the edited <file>s. like, actually writes the changes in πŸ”₯
  • --input=<string> β€” a YAML file to load your oldname-newname pairs from, so you can batch the whole thing
  • --new-name=<string> β€” the new name you want the symbol changed to, the actual glow-up ✨
  • --offset=<uint> β€” finds the symbol by offset instead of by <line>:<column>
  • -p <string> β€” the build path
  • --pl β€” prints the locations affected by the renaming out to stderr
  • --pn β€” prints the found symbol's name out to stderr before the renaming happens
  • --qualified-name=<string> β€” the fully qualified name of the symbol, no ambiguity, no games πŸ’œ

and that's the whole page, bestie β€” no notes, no skipped options, every single flag accounted for πŸŽ€

this gorgeous little document came to you from clang-rename 15, dated July 2023 β€” slay, iconic, ate, no cap πŸ’–βœ¨πŸ¦‹

πŸ“¦ where this page comes from