[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
Re: bin/46142: The cpio(1), pax(1) and tar(1) manpages need improvement
The following reply was made to PR bin/46142; it has been noted by GNATS.
From: Bug Hunting <bughunting%xs4all.nl@localhost>
To: NetBSD GNATS <gnats-bugs%gnats.NetBSD.org@localhost>
Cc: Thomas Klausner <wiz%NetBSD.org@localhost>, Marc Balmer
Subject: Re: bin/46142: The cpio(1), pax(1) and tar(1) manpages need
Date: Sun, 11 Mar 2012 02:22:50 +0100
On Sun, Mar 04, 2012 at 03:05:03PM +0000, Thomas Klausner wrote:
> I think we should have consistency in the wording here.
The patch as proposed was made to create consistency within individual
manpages, but indeed not across them; if this is wished for, that
could be done so as well. Note however that the removals of
``/decompress'' in cpio.1 are not needed for consistency, but
because the `-o' option, what these parts are about, is about
archive creation, which does not involve decompression.
While at it, also note the mixed use of ``decompress'' and
``uncompress''; if this will be made to be consistent as well,
choosing the latter would probably be best, since that's also the
name of one of tar(1)'s options (and, of course, the external
program being called, i.e., uncompress(1)).
> > +Exit as soon as each specified
> > +.Ar file
> > +argument has been matched.
> I'd prefer:
> Exit as soon as all specified
> .Ar file
> arguments have been matched.
The sentence as proposed was copied verbatim (except the argument
name) from libarchive's bsdtar(1) manpage; sticking with that would
maintain a bit of consistency. Choose what fits best though.
On Sun, Mar 04, 2012 at 03:35:02PM +0000, Marc Balmer wrote:
> I don't understand why this change is requested or why it should be
> good. The only difference is that rstX are rewinding tape devices and
> nrstX are non-rewinding tapes (they rewind on close).
The reason is, as the PR says (although with the added note on
doubting the change along with it), that the default tape device
was changed to a non-rewinding one as well; why would tar(1) use
a non-rewinding tape as its default, but rewinding ones as other
Main Index |
Thread Index |