Re: [PATCH libnetfilter_queue v2] build: doc: Fix NAME entry in man pages

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Tue, Aug 10, 2021 at 12:40:01PM +1000, Duncan Roe wrote:
> Make the NAME line list the functions defined, like other man pages do.
> Also:
> - If there is a "Modules" section, delete it
> - If "Detailed Description" is empty, delete "Detailed Description" line
> - Reposition SYNOPSIS (with headers that we inserted) to start of page,
>   integrating with defined functions to look like other man pages
> - Delete all "Definition at line nnn" lines
> - Delete lines that make older versions of man o/p an unwanted blank line
> - Insert spacers and comments so Makefile.am is more readable
> 
> Signed-off-by: Duncan Roe <duncan_roe@xxxxxxxxxxxxxxx>
> ---
> v2: Delete lines that make older versions of man o/p an unwanted blank line
>  doxygen/Makefile.am | 172 ++++++++++++++++++++++++++++++++++++++++++++

Time to add this to an independent fixup shell script for
doxygen-based manpages that Makefile.am could call instead?

This script could be imported by other libraries too, so it only needs to
be downloaded from somewhere to be refreshed to keep it in sync with
latest.

The git tree could cache a copy of this script.

Could you have a look into this?

Thanks.



[Index of Archives]     [Netfitler Users]     [Berkeley Packet Filter]     [LARTC]     [Bugtraq]     [Yosemite Forum]

  Powered by Linux