Follow-up Comment #3, bug #55190 (project findutils): Actually POSIX is what the GNU findutils basically follow ... with the exception of additional GNU goodies ;-)
GNU standards say that "man pages are secondary" [1], and that the primary documentation should be available as Texinfo manual. Some GNU packages like the coreutils therefore generate the man pages from --help output (with some amendments). The findutils still have a lot of information in both formats (man + texinfo). My personal opinion is that maintaining both formats requires quite some resources, and yield both redundancy and (sometimes) the risk of discrepancies. For now, I wouldn't necessarily want to change that, but I could imagine that we could merge the most useful stuff together in the Texinfo format one day, and generate the man pages from --help, like others. Obviously, this is an awful step for the translators. [1] https://www.gnu.org/prep/standards/html_node/Man-Pages.html Re. the actual case: suggestions/patches are welcome, in small pieces to improve the documentation step by step. Have a nice day, Berny _______________________________________________________ Reply to this item at: <https://savannah.gnu.org/bugs/?55190> _______________________________________________ Message sent via Savannah https://savannah.gnu.org/
