discrepancy in descriptions of --update

[Benno Schulenberg]

When looking at `info tar "tar inv" syn`, it says:

  Each NAME in the synopsis above is interpreted as an archive
  member name when the main command is ... or ‘--update’ (‘-u’).

And in `info tar op ad up` it says:

  ... by comparing the date of the specified archive members
  against the date of the file with the same name.

But in `info tar op ad up how` it says:

  You must use file name arguments with the ‘--update’ (‘-u’)
  operation.

The latter matches what the synopsis in the manpage shows:

  tar --update [--file ARCHIVE] [OPTIONS] [FILE...]

And this seems to be correct, because when doing:

  tar -cvf ball doc/*.texi
  echo extra >>doc/recipes.texi
  tar -uvf ball --wildcards 'doc/r*.texi'
  tar -uvf ball doc/r*.texi

the penultimate command (specifying member names) does nothing;
only the last command (specifying file names) updates the archive.

Benno

OpenPGP_signature
Description: OpenPGP digital signature