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.
