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/ -- To unsubscribe from this list: send the line "unsubscribe netfilter-devel" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
