[nft] Documentation point release/backport

[nft] Documentation point release/backport

[Colin Caine]

The man page distributed with nftables v0.7 is erroneous (add chain
syntax) and misses some important functionality e.g. `list ruleset`, but
the documentation in master is better (Thanks!).

Could the documentation in master be backported as a point release for
users (if v0.8 won't be soon)?

The wiki is OK as a replacement, but it would be very useful to have a
complete and authoritative reference.

Documentation lagging so far behind functionality might suggest that
contributors don't like editing docbook. If the asciidoc patch is
rejected, perhaps contributors who do like editing docbook could share
what tools they use?

My unsolicited two cents: if it were my choice, I'd switch to a readable
and easily writable markup (so contributors actually write it) which can
embed a real programming language (to encourage automation and testing
of the documentation).

Probably Pollen or scribble (racket DSLs) [1]? Neither have man
outputs yet, but you could go Pollen -> markdown -> man, or just extend
either a bit (it's not like the man(7) is complicated).

Thanks for reading,
Colin

[1]: https://docs.racket-lang.org/pollen/
     https://docs.racket-lang.org/scribble/