Re: [Doxygen-users] Doxygen-users Digest, Vol 167, Issue 5

[Ron W <ron...@gm...>]

On Sun, Jun 14, 2020 at 8:04 AM <dox...@li...>
wrote:

> Date: Sat, 13 Jun 2020 15:38:43 -0700
> From: Mark <dox...@er...>
> Subject: [Doxygen-users] Generating man pages *only* for functions
>
> I am documenting the API of a library and generate HTML and man pages.
> Unfortunately it generates man pages for every structure and every field of
> every structure so the man 3 directory gets polluted with files like
> height.3 containing the man page for a field of a struct called height.
>
> Is there a way to get Doxygen to generate man pages only for the
> documented functions and stop this crazy pollution? Ideally these man pages
> would contain the documentation for any structures used in the function?s
> API. If I can?t solve this I will not be able to ship the man pages with
> the software.
>

Sounds like you have  EXTRACT_ALL turned on (see:
https://www.doxygen.nl/manual/config.html#cfg_extract_all)

If you turn that off, Doxygen will only generate documentation for
documented things. HOWEVER, it will complain about undocumented things.

There is  \internal and  \endinternal to designate ranges that should only
be included when INTERNAL_DOCS is on. (see:
https://www.doxygen.nl/manual/commands.html#cmdinternal)