[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[bug #55190] xargs documentation is confusing about the usage of -i and
From: |
Bernhard Voelker |
Subject: |
[bug #55190] xargs documentation is confusing about the usage of -i and -I (capital i), and doesn't have any examples on this options |
Date: |
Tue, 11 Dec 2018 19:00:54 -0500 (EST) |
User-agent: |
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" [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/