CLANG-INCLUDE-FIXER(1)

💖 NAME 💖

okay so bestie, welcome to clang-include-fixer — manual page for clang-include-fixer 13, filed under User Commands, and honestly she's the friend who always knows where the thing is. this whole page is her. 💅

---

🦋 DESCRIPTION 🦋

✨ USAGE ✨

clang-include-fixer [options] <source0> [... <sourceN>]

that's the whole vibe: you give her some source files — <source0> all the way out to <sourceN> — you sprinkle on some [options], and she handles the rest. main character energy, no notes. 🫶

---

🎀 OPTIONS 🎀

🌈 Generic Options

• --help — shows you all the available options she's got. want the secret menu too? that's --help-hidden, and it's giving extra. 👀
• --help-list — prints out a list of the available options. and yes, there's a --help-list-hidden for more, because of course there is. ✨
• --version — tells you which version of this program you're running. a lil identity check, love that for her. 🪪

🧚 Tool options

• --db=<value> — tells her the input format to use. here's the menu of <value>s:
  • =fixed — hard-coded mapping. old reliable. 💀
  • =yaml — a Yaml database that was created by find-all-symbols.
  • =fuzzyYaml — a Yaml database, except the names are fuzzy-matched. soft focus, very demure. 🌸
• --extra-arg=<string> — one extra argument, appended to the compiler command line. little bonus at the end. ✨
• --extra-arg-before=<string> — one extra argument, but prepended to the compiler command line. she goes first, obviously, she's the main character. 👑
• --input=<string> — a string used to initialize the database. 🍓
• --insert-header=<string> — insert one specific header. > heads up bestie: this one should run with STDIN mode. The result is written to stdout, and it's currently used for editor integration. It supports YAML/JSON format:

-insert-header="{
  FilePath: "/path/to/foo.cc", QuerySymbolInfos: [
  {RawIdentifier: foo,
  Range: {Offset: 0, Length: 3}}
  ], HeaderInfos: [ {Headers: "\"foo_a.h\"",
  QualifiedName: "a::foo"} ]}"

• --minimize-paths — whether to minimize the added include paths. tidy queen. 🧹
• --output-headers — prints the symbol being queried and all its relevant headers in JSON format to stdout:

{
  "FilePath": "/path/to/foo.cc", "QuerySymbolInfos": [
  {"RawIdentifier": "foo",
  "Range": {"Offset": 0, "Length": 3}}
  ], "HeaderInfos": [ {"Header": "\"foo_a.h\"",
  "QualifiedName": "a::foo"} ]
}

• -p=<string> — the build path. 📁
• -q — reduces terminal output. less yapping, more doing. 🤫
• --query-symbol=<string> — query a given symbol directly in the database (like, say, "a::b::foo") without even parsing the file. she just knows. 🔮
• --stdin — overrides the source file's content (in the overlaying virtual file system) with input from <stdin>, then runs the tool on that new content using the compilation options of the source file. This mode is currently used for editor integration. 🖥️✨
• --style=<string> — the fallback style for reformatting after inserting new headers, used when there's no clang-format config file found. she's got a backup fit. 💜

---

ngl bestie, that's the whole page — every option, every value, every default, all accounted for. nothing skipped, nothing invented. iykyk. 🌈

and that's a wrap!! this was clang-include-fixer 13, from July 2023, living her best life in the User Commands manual. go fix some includes, you absolute icon. 💖🎀🦋✨