Re: [PATCH libmnl 1/1] build: doc: "make" builds & installs a full set of man pages

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

 



Hi Pablo,

On Tue, Jun 29, 2021 at 11:38:37AM +0200, Pablo Neira Ayuso wrote:
> BTW, the autogenerated manpage differs quite a bit from standard
> manpages in other existing packages?

I noticed one substantial difference - missing the SYNOPSIS listing the required
#include lines.

The patch below adresses that, for the libnfq pktbuff modules.

After applying the patch, do you still see any substantial shortcomings in e.g.
`man pktb_alloc`?

Using doxygen does impose some stylistic differences, but compared to, say, `man
XShape` I think pktb_alloc(3) looks pretty normal? (You might need to install
libXext-devel for XShape(3)).

If you would apply the libnfq patch, I can get on with fixing the rest of
libnfq and libmnl.

Cheers ... Duncan.

Duncan Roe (1):
  src: doc: supply missing SYNOPSIS in pktbuff man pages

 src/extra/pktbuff.c | 45 +++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 41 insertions(+), 4 deletions(-)

-- 
2.17.5




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

  Powered by Linux