FIXINCLUDES(1)
π fixincludes(1) β the girlies' guide to trimming your #includes π
okay so bestie, this is the manual page for fixincludes, section 1 of the manual. yes, that section 1. we're in the big leagues now. sit down, grab a boba, and let's clean up your source files together π§β¨
β¨ NAME β¨
fixincludes β Reduce the number of #includes in KDE source files π
π¦ SYNOPSIS π¦
fixincludes [-v, --verbose] [-e, --experimental] [-m, --modify] [file]
[--help]
look at her. so simple. so elegant. she ate. π₯
πΈ DESCRIPTION πΈ
okay so here's the vibe: fixincludes tries to reduce the number of #includes in C++ source files. iconic behaviour, honestly. less clutter, more slay. π
but real talk β much of its processing is specific to KDE sources, so it might not work so well with sources for non-KDE applications. she's a KDE girlie through and through, and she's not gonna pretend otherwise. no cap. π
so what problems does she spot? here's the list, bestie:
- Including headers that are no longer supported but which exist for compatibility with older Qt/KDE versions π
- Including the same file multiple times π (girl. we talked about this.)
there's also an experimental mode which tries removing each #include one at a time (with a few exceptions) to see whether the source still compiles. ooh, spicy. πΆοΈ
β οΈ bestie, listen to me very carefully: this experimental mode will modify the original sources. it's not playing. it's not joking. it will touch your files. π«Ά
by default though? the sources will not be modified. the identified problems will simply be written to standard output. so you can peek without committing. we love a low-stakes vibe check. β¨
now β which files are we even looking at? the list of C++ sources to examine should be given on the command-line. that's it, that's the rule. but if no files are given, all C++ sources in or beneath the current directory will be examined β with the exception of directories whose Makefile.am contains -UQT_NO_COMPAT or -UKDE_NO_COMPAT. she's thorough, but she knows where she's not wanted. π
and for the record: this utility is part of the KDE Software Development Kit. π
π OPTIONS π
-v,--verboseβ Verbose mode, bestie. Additional debugging output is written to standard output. she's telling you everything she's thinking. main character energy, honestly. π£οΈβ¨-e,--experimentalβ Experimental mode, as described above in detail. and heads up: this option implies--modify. so like, yes, she will be touching your files. do not say we didn't warn you. π-m,--modifyβ As well as writing messages to standard output, actually modify the original sources to fix any problems that were found. committing to the bit. obsessed. π
π AUTHORS π
fixincludes was written by Dirk Mueller <mueller@kde.org>. thank you for your service, king. π
β AUTHOR β
Ben Burton <bab@debian.org>
- Author. yes that's literally the whole description and honestly? valid. periodt. π
and that's the whole page, bestie!! π this one came from the [FIXME: source] source and it's dated 2003-04-07 β an absolute vintage icon, truly ahead of her time. go forth, trim those includes, and remember: no duplicates, no outdated compat headers, no regrets πβ¨π¦π
π¦ where this page comes from
- arch rolling: kde-dev-scripts 26.08.2-1 Β· GPL-2.0-or-later AND LGPL-2.0-or-later
- epel 10: kde-dev-scripts 26.08.1-1.el10_3 Β· GPL-2.0-only AND GPL-2.0-or-later AND LGPL-2.0-only AND BSD-2-Clause
- epel 9: kde-dev-scripts 23.08.5-1.el9 Β· GPLv2+ and GPLv2+ and BSD
- fedora 43: kde-dev-scripts 25.08.2-1.fc43 Β· GPL-2.0-only AND GPL-2.0-or-later AND LGPL-2.0-only AND BSD-2-Clause
- fedora 43: kde-dev-scripts 26.04.3-1.fc43 Β· GPL-2.0-only AND GPL-2.0-or-later AND LGPL-2.0-only AND BSD-2-Clause
- fedora 44: kde-dev-scripts 25.12.3-1.fc44 Β· GPL-2.0-only AND GPL-2.0-or-later AND LGPL-2.0-only AND BSD-2-Clause
- fedora 44: kde-dev-scripts 26.08.1-1.fc44
- fedora 44: kde-dev-scripts 26.08.2-1.fc44 Β· GPL-2.0-only AND GPL-2.0-or-later AND LGPL-2.0-only AND BSD-2-Clause
- nixos 26.05: kde-dev-scripts 26.04.3
- nixpkgs unstable: kde-dev-scripts 26.08.2
- opensuse-leap 16.0: kdesdk-scripts 25.04.3-bp160.1.2 Β· GPL-2.0-only AND GFDL-1.2-only
- opensuse-leap 16.0: kdesdk-scripts 25.04.3-bp160.1.2 Β· GPL-2.0-only AND GFDL-1.2-only
- opensuse-leap 16.0: kdesdk-scripts 25.04.3-bp160.1.2 Β· GPL-2.0-only AND GFDL-1.2-only
- opensuse-leap 16.0: kdesdk-scripts 25.04.3-bp160.1.2 Β· GPL-2.0-only AND GFDL-1.2-only
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms