[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[bug #55190] xargs documentation is confusing about the usage of -i and
[bug #55190] xargs documentation is confusing about the usage of -i and -I (capital i), and doesn't have any examples on this options
Tue, 11 Dec 2018 19:00:54 -0500 (EST)
Mozilla/5.0 (X11; Linux x86_64; rv:63.0) Gecko/20100101 Firefox/63.0
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" , 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.
Re. the actual case: suggestions/patches are welcome, in small
pieces to improve the documentation step by step.
Have a nice day,
Reply to this item at:
Message sent via Savannah