[Doxygen-develop] A wish: show only files included from a given start file

[Milan <mil...@se...>]

Hello,

I would like to suggest a new feature, I haven't find any discussion in the
list's archives about this...

In an example setup, I have a single directory with many .h and .c(pp)
files imlementing some reusable library. I want to generate
documentation of library's API, which is defined in some of header files in
the directory (the remaining headers define internal functions of the
library, not interesting for me now).

There is a single main header file, which is to be #include-d in applications
built upon the library (library's API), the single header file #include-s
(possibly transitively) all the API header files I am interested in.

I would like to have a new configuration parameter in which I would mention
the main header file. The generated documentation would contain only
constructs from the main header file and all the files transitively
#include-d from it. Other files in the input file set would be left out from
generated documentation.

Let's discuss the feature: should I (or anyone else) implement it? Or can I
solve it in another way (without having to somehow edit all the files in
directory).

TIA,
Milan