All of lore.kernel.org
 help / color / mirror / Atom feed
From: Pablo Neira Ayuso <pablo@netfilter.org>
To: Duncan Roe <duncan_roe@optusnet.com.au>
Cc: netfilter-devel@vger.kernel.org
Subject: Re: [PATCH libnetfilter_queue v3 2/6] build: doc: Add a man page post-processor to build_man.sh
Date: Sat, 28 Aug 2021 11:10:21 +0200	[thread overview]
Message-ID: <20210828091021.GB31560@salvia> (raw)
In-Reply-To: <20210828033508.15618-2-duncan_roe@optusnet.com.au>

On Sat, Aug 28, 2021 at 01:35:04PM +1000, Duncan Roe wrote:
> - 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
> For better readability, shell function definitions are separated by blank
> lines, and there is a bit of annotation.

Also applied, thanks.

Please, in the future, let's try to avoid this multi-item patches, one
thing at a time the best for traceability.

Thanks.

  reply	other threads:[~2021-08-28  9:10 UTC|newest]

Thread overview: 14+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-08-28  3:35 [PATCH libnetfilter_queue v3 1/6] build: doc: Fix man pages Duncan Roe
2021-08-28  3:35 ` [PATCH libnetfilter_queue v3 2/6] build: doc: Add a man page post-processor to build_man.sh Duncan Roe
2021-08-28  9:10   ` Pablo Neira Ayuso [this message]
2021-08-28  3:35 ` [PATCH libnetfilter_queue v3 3/6] build: doc: Avoid having to special-case `make distcheck` Duncan Roe
2021-08-28  9:10   ` Pablo Neira Ayuso
2021-08-28  3:35 ` [PATCH libnetfilter_queue v3 4/6] build: doc: fix `make distcleancheck` Duncan Roe
2021-08-28  9:11   ` Pablo Neira Ayuso
2021-08-28  3:35 ` [PATCH libnetfilter_queue v3 5/6] build: doc: Allow to specify whether to produce man pages, html, neither or both Duncan Roe
2021-08-30  1:08   ` Duncan Roe
2021-08-28  3:35 ` [PATCH libnetfilter_queue v3 6/6] build: doc: Eliminate warning from ./autogen.sh Duncan Roe
2021-08-29  3:45   ` [PATCH libnetfilter_queue v2] " Duncan Roe
2021-08-30  0:18     ` Pablo Neira Ayuso
2021-08-28  3:49 ` Verion info Duncan Roe
2021-08-28  9:09 ` [PATCH libnetfilter_queue v3 1/6] build: doc: Fix man pages Pablo Neira Ayuso

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20210828091021.GB31560@salvia \
    --to=pablo@netfilter.org \
    --cc=duncan_roe@optusnet.com.au \
    --cc=netfilter-devel@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.