Pablo Neira Ayuso <pablo@xxxxxxxxxxxxx> wrote: > On Sun, Feb 23, 2020 at 11:35:14PM +0100, Florian Westphal wrote: > > Pablo Neira Ayuso <pablo@xxxxxxxxxxxxx> wrote: > > > On Sat, Feb 08, 2020 at 12:28:44PM +1100, Duncan Roe wrote: > > > > This enables one to enter "man <any nfq function>" and get the appropriate > > > > group man page created by doxygen. > > > > > > > > - New makefile in doxygen directory. Rebuilds documentation if any sources > > > > change that contain doxygen comments, or if fixmanpages.sh changes > > > > - New shell script fixmanpages.sh which > > > > - Renames each group man page to the first function listed therein > > > > - Creates symlinks for subsequently listed functions (if any) > > > > - Deletes _* temp files > > > > - Update top-level makefile to visit new subdir doxygen > > > > - Update top-level configure to only build documentation if doxygen installed > > > > > > I'd prefer people to keep this infrastructure out of tree. Thanks. > > > > Hmm, why? > > Would you like to allow to generate manpage per function in the > library? We never had this so far. > > Probably a single manpage in the style of libnftables(3)? I like it. I mean, its up to distros to package this, I guess most of them will place this into some extra doc sub-package. $ man 3 ssl-<tab> zsh: do you wish to see all 416 possibilities (70 lines)? ... so there are libraries that do this. Also, from what I understand, there is not a single man-page per function, the extra ones are just aliases.
