Simple script to find all files including the given C or C++ header file,
possibly indirectly, via some other header. I.e. unlike a simple
'#include "foo.h"' *.h,
where-inc foo.h *.h will also find the headers
bar.h which, in turn, includes
foo.h. This can be useful to find
possible dependencies in a big project.
This is a Perl script without any non-core dependencies, so it doesn't require any installation but does require a working Perl (any not horribly outdated version should do).
Typically the script will be called with at least some header files, as
otherwise it work in almost the same way as
grep (except much slower), e.g.
where-inc foo.h include/*.h src/*.cpp
If it's unclear how some file in the output ends up including the header,
--show-how option may be added to display the inclusion path.
It is also possible to show all (input) files not including the given header
--invert-match option or its short form
where-inc -v prologue.h include/*.h
If the headers being searched are included not just by their name but using
some prefix, e.g.
#include <mylib/foo.hpp>, then this prefix must be given
on the command line using
-p, for short, option for the
where-inc -p mylib mylib/foo.h include/mylib/*.h
--verbose option can be added to show some informative messages.
Probably many, but the main limitation is that the script makes no attempt to
parse the input sources, beyond recognizing C and C++ comments in them, so it
still considers the files including the given header inside
#if 0 or similar
as including it.
LICENSE file for the details.