On 09-Jul-10 10:55:08, Brett Parker wrote:
On 09 Jul 11:42, Ted Harding wrote:
On 09-Jul-10 10:18:10, Brett Parker wrote:
[...] Erm, I have a man page for tar in Debian... Maybe you haven't got man installed :p
I do have 'man' installed, and I do have a man page for 'tar'. It just doesn't give any examples of use. That's what I said.
It has examples here...
""" EXAMPLES Create archive.tar from files foo and bar. tar -cf archive.tar foo bar List all files in archive.tar verbosely. tar -tvf archive.tar Extract all files from archive.tar. tar -xf archive.tar
"""
OOPS! I had skipped over the "preamble" bit, where the "EXAMPLES" are, to get down to the options list. Therefore I missed it.
Mind you, although the examples given are
EXAMPLES tar -xvvf foo.tar extract foo.tar tar -xvvzf foo.tar.gz extract gzipped foo.tar.gz tar -cvvf foo.tar foo/ tar contents of folder foo in foo.tar
all of which use "vv", when you get down to the description of option "v" you don't see a mention of the double usage:
-v, --verbose verbosely list files processed
and that's it. So a bit of extra explanation is needed at that point in the man page. Man pages are traditionally (and in some cases notoriously) very terse and concise, but they should be complete as a reference for the behaviour of the command. That's what they're intended to be!
Ted.
-------------------------------------------------------------------- E-Mail: (Ted Harding) Ted.Harding@manchester.ac.uk Fax-to-email: +44 (0)870 094 0861 Date: 09-Jul-10 Time: 12:11:05 ------------------------------ XFMail ------------------------------