Re: [PATCH libmnl] build: do not build documentation automatically

[Pablo Neira Ayuso <pablo@netfilter.org>]

On Mon, Oct 14, 2024 at 01:12:02PM +0200, Jan Engelhardt wrote:
[...]
> Having worked extensively with wxWidgets (also doxygenated) in the past 
> however, I found that when the API is large, needs frequent lookup, 
> documentation has many pages, and online retrieval latency becomes a 
> factor, I prefer a local copy as a quality-of-live improvement.

For reference, there is one online available at:

https://www.netfilter.org/projects/libmnl/doxygen/html/

for the current release.

[...]
> Removals are a powerful action that is seldomly undone at the distro
> levels, so it can be regarded as the final say (well, in "95% of
> cases").
[...]
> Hiding stuff behind a configure knob is not a removal though,
> so it is not too big a deal.

Exactly.

> >Moreover, documentation is specifically designed for developers who
> >are engaged in the technical aspects. Most users of this software are
> >building it because it is a dependency for their software.
>                                             ^^^^^^^^^^^^^^
> 
> The way it's phrased makes those users users of the libmnl API (i.e.
> developers), and documentation is warranted.
> 
> (The following statement would be more accurate:
> 
> >Most users of this software are
> >building it because it is a dependency for someone else's software
> >they want to utilize.

That sounds more precise, yes.