CLANG-RENAME(1)

πŸ“¦
version 19.1.7 Β· 5 versions
, in debian bookworm, debian trixie

πŸ’… clang-rename β€” the glow-up era

okay bestie, so this is the manual page for clang-rename 19, a User Command, and she's literally here to rename symbols in your C++ like a little fairy godmother 🧚✨


🌸 NAME 🌸

clang-rename β€” manual page for clang-rename 19. that's the name, that's the brand, that's the whole vibe πŸ’–


✨ DESCRIPTION ✨

here's how you summon her:

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

so you feed her some source files and some options and she does the thing. iconic behaviour, honestly πŸ‘‘


πŸŽ€ OPTIONS πŸŽ€

πŸ’œ Generic Options (the universal ones, iykyk)

  • --help β€” shows you all the available options. and if you're feeling nosy, --help-hidden reveals even more 🫣
  • --help-list β€” prints out a whole list of the available options. add --help-list-hidden for the hidden ones too πŸ™ˆ
  • --version β€” tells you which version of this program you're running, in case you forgot. no judgment πŸ’…

πŸ¦‹ clang-rename common options (her main character options)

  • --export-fixes=<filename> β€” a YAML file to store suggested fixes in. she's keeping receipts πŸ“
  • --extra-arg=<string> β€” an extra argument to append to the compiler command line
  • --extra-arg-before=<string> β€” an extra argument to prepend to the compiler command line. yes it goes in front, that's the whole point πŸŽ€
  • --force β€” ignore nonexistent qualified names. bold. fearless. lowkey feral πŸ”₯
  • -i β€” overwrite the edited <file>s. so like, in place. no take-backs 🫢
  • --input=<string> β€” a YAML file to load oldname-newname pairs from πŸ“₯
  • --new-name=<string> β€” the new name you want to change the symbol to. the glow-up name, if you will ✨
  • --offset=<uint> β€” locates 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 πŸ“
  • --pn β€” prints the found symbol's name prior to renaming to stderr, so you know who she was before the transformation πŸ¦‹
  • --qualified-name=<string> β€” the fully qualified name of the symbol. the whole legal government name πŸ’œ

real talk bestie: this page is short and sweet, so there's not a lot of chaos to warn you about β€” but -i really does overwrite your files, so maybe double-check before you commit to the bit 😭

and that's the whole page, no notes πŸ’– this was clang-rename 19, dated June 2025 β€” stay slaying, and go rename something cute πŸŽ€βœ¨πŸŒˆ

πŸ“¦ where this page comes from