Re: [nft PATCH RFC] Convert man page source to asciidoc

2017-09-08 Thread Phil Sutter
On Wed, Sep 06, 2017 at 04:29:00PM +0200, Jan Engelhardt wrote: > > On Wednesday 2017-09-06 16:02, Phil Sutter wrote: > >> Knowing that, people just avoid them most of the time for groff - and if I > >> may > >> say so, it has not reduced the document quality. > > > >Right now, nft.8 makes

Re: [nft PATCH RFC] Convert man page source to asciidoc

2017-09-06 Thread Jan Engelhardt
On Wednesday 2017-09-06 16:02, Phil Sutter wrote: >> Knowing that, people just avoid them most of the time for groff - and if I >> may >> say so, it has not reduced the document quality. > >Right now, nft.8 makes extensive use of tables which is why I considered >proper table support an

Re: [nft PATCH RFC] Convert man page source to asciidoc

2017-09-06 Thread Phil Sutter
Hi, On Wed, Sep 06, 2017 at 03:25:51PM +0200, Jan Engelhardt wrote: > On Wednesday 2017-09-06 13:58, Phil Sutter wrote: > > > >Regarding reStructuredText, did you look at how tables are written > >there? If not, see here[2]. I really think that speaks for itself. > > Markup is the least problem.

Re: [nft PATCH RFC] Convert man page source to asciidoc

2017-09-06 Thread Jan Engelhardt
On Wednesday 2017-09-06 13:58, Phil Sutter wrote: > >Regarding reStructuredText, did you look at how tables are written >there? If not, see here[2]. I really think that speaks for itself. Markup is the least problem. Tables, when rendered, have a tendency to quickly grow too large for the

Re: [nft PATCH RFC] Convert man page source to asciidoc

2017-09-06 Thread Phil Sutter
Hi Arturo, On Wed, Sep 06, 2017 at 11:56:37AM +0200, Arturo Borrero Gonzalez wrote: > On 6 September 2017 at 10:41, Phil Sutter wrote: > > Beware: The conversion is incomplete and merely serves as base for > > discussion. > > > > This patch converts nft.xml into asciidoc markup, top

Re: [nft PATCH RFC] Convert man page source to asciidoc

2017-09-06 Thread Jan Engelhardt
On Wednesday 2017-09-06 11:56, Arturo Borrero Gonzalez wrote: > >Regarding the separation of text in different includes, why not creating >different manpages? Netfilter did this in the past with iptables(8) and >iptables-extensions(8). The split into iptables-extensions.8 happened not because of

Re: [nft PATCH RFC] Convert man page source to asciidoc

2017-09-06 Thread Pablo Neira Ayuso
Hi Arturo, On Wed, Sep 06, 2017 at 11:56:37AM +0200, Arturo Borrero Gonzalez wrote: > On 6 September 2017 at 10:41, Phil Sutter wrote: > > Beware: The conversion is incomplete and merely serves as base for > > discussion. > > > > This patch converts nft.xml into asciidoc markup, top

Re: [nft PATCH RFC] Convert man page source to asciidoc

2017-09-06 Thread Arturo Borrero Gonzalez
On 6 September 2017 at 10:41, Phil Sutter wrote: > Beware: The conversion is incomplete and merely serves as base for > discussion. > > This patch converts nft.xml into asciidoc markup, top down until (and > including) stateful objects description. I stopped there because it's > the