From: Pablo Neira Ayuso <pablo@netfilter.org>
To: Duncan Roe <duncan_roe@optusnet.com.au>
Cc: netfilter-devel@vger.kernel.org
Subject: Re: [PATCH RFC libnetfilter_queue] doc: Get rid of DEPRECATED tag (Work In Progress)
Date: Mon, 11 Sep 2023 09:51:07 +0200 [thread overview]
Message-ID: <ZP7G68U/HKxIkUmp@calendula> (raw)
In-Reply-To: <20230911055425.8524-1-duncan_roe@optusnet.com.au>
On Mon, Sep 11, 2023 at 03:54:25PM +1000, Duncan Roe wrote:
> This is a call for comments on how we want the documentation to look.
> In conjunction with the git diff, readers may find it helpful to apply the patch
> in a temporary branch and check how the web page / man pages look.
> To get web & man pages, do something like
>
> ./configure --enable-html-doc; make -j; firefox doxygen/html/index.html
> MANPATH=$PWD/doxygen/man:$MANPATH
>
> Some changes are documented below - I'll post more later
>
> --- Preparation for man 7 libnetfilter_queue
> The /anchor / <h1> ... </h1> combo is in preparation for making
> libnetfilter_queue.7 from the main page. mainpage is morphed to a group
> (temporarily) so all \section lines have to be changed to <h1> because \section
> doesn't work in a group. The appearance stays the same.
>
> ---1st stab at commit message for finished patch
> libnetfilter_queue effectively supports 2 ABIs, the older being based on
> libnfnetlink and the newer on libmnl.
Yes, there are two APIs, same thing occurs in other existing
libnetfilter_* libraries, each of these APIs are based on libnfnetlink
and libmnl respectively.
> The libnetfilter_queue-based functions were tagged DEPRECATED but
> there is a fading hope to re-implement these functions using libmnl.
> So change DEPRECATED to "OLD API" and update the main page to
> explain stuff.
libnfnetlink will go away sooner or later. We are steadily replacing
all client of this library for netfilter.org projects. Telling that
this is not deprecated without providing a compatible "old API" for
libmnl adds more confusion to this subject.
If you want to explore providing a patch that makes the
libnfnetlink-based API work over libmnl, then go for it.
next prev parent reply other threads:[~2023-09-11 7:51 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-09-11 5:54 [PATCH RFC libnetfilter_queue] doc: Get rid of DEPRECATED tag (Work In Progress) Duncan Roe
2023-09-11 7:51 ` Pablo Neira Ayuso [this message]
2023-09-12 6:20 ` Duncan Roe
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=ZP7G68U/HKxIkUmp@calendula \
--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.