deheader 1 Dec 01 2010 deheader deheader Development Tools deheader report which includes in C or C++ compiles can be removed deheader -h -m -i -r -v -V file-or-dir This tool takes a list of C or C++ sourcefiles and generates a report on which #includes can be omitted from them. The test, for each foo.c or foo.cc or foo.cpp, is simply whether 'rm foo.o; make foo.o' returns a zero status (but the build command may be overridden). Optionally, with the -r switch, the unneeded headers are removed from the sourcefiles. If a sourcefile argument is a directory, the report is generated on all source files beneath it. Subdirectories beginning with a dot are assumed to be repository directories for version-control systems and ignored. If no arguments are given, the program runs as if the name of the current directory had been passed to it. Inclusions within the scope of #if/#ifdef/#else/#endif directives are left alone, because trying to reason about potential combinations of -D and U options would be too complicated and prone to weird errors. Test-compiling after running with -r will sometimes show that this tool removed some headers that are actually required for your build. This happens because deheader doesn't know about all the strange thungs your build system gets up to, and the problem of analyzing it to undertand them would be Turing-complete. Simply revert the altered files and continue. It is recommended that you arrange to compile with options that will stop the compiler on warnings when using this tool; otherwise it will be report headers that only declare prototypes and return types (and thus throw only warnings) as being not required. Under gcc the compiler options to accomplish this are -Werror -Wfatal-errors. If your makefile follows normal conventions, running with -m CFLAGS='-Werror -Wfatal-errors' may do the right thing; you can check this by running with -v -v -v to see what compilation commands are actually emitted. On each test compile, the original sourcefile is moved to a name with an .orig suffix and restored on interrupt or after processing with its original timestamp, unless the -r option was given and headers removed. At verbosity level 0, only messages indicating removable headers are issued. At verbosity 1, test compilations are timed and progess indicated with a twirling-baton prompt. At verbosity level 2, you get vebose progress messages on the analysis. At verbosity level 3, you see the output from the make and compilation commands. Running deheader will leave a lot of binaries in your directory that were compiled in ways possibly not invoked by your normal build process. Running "make clean" afterwards is strongly recommended. -h Display some help and exit. -m Set the build command used for test compiles. Defaults to 'make'. -i Set a pattern for includes to be ignored. Takes a Python regular expression. -r Remove header inclusions from sourcefiles where they are not required. -v Set verbosity. -V Show version of program snd exit. Eric S. Raymond esr@snark.thyrsus.com; (home page at http://www.catb.org/~esr/).