[Bug-tar] wrong options listed in the manual regarding restrictions on operations on compressed archives?

[Helmut Waitzmann]

Hello, GNU tar maintainers,

the manual
<http://www.gnu.org/software/tar/manual/html_node/tar_126.html#SEC126>
says

   First of all, compressed archives cannot be modified, i.e., you cannot
   update ('--update' ('-u')) them or delete ('--delete') members from
   them.  Likewise, you cannot append another tar archive to a compressed
   archive using '--append' ('-r')).

As far as I understand
<http://www.gnu.org/software/tar/manual/html_node/tar_41.html#SEC41>
(operations '--append' and '--concatenate'), this should say

   First of all, compressed archives cannot be modified, i.e., you cannot
   update ('--update' ('-u')) them or delete ('--delete') members from or
   add ('--append' ('-r')) members to them.  Likewise, you cannot append
   another tar archive to a compressed archive using ('--concatenate'
   ('--catenate', '-A')).

I think, the cause of this error in the manual page is the suboptimal
name of the operation '--append', which should rather have been called
'--add'.  So, maybe, the operation name '--add' as an alias (with a
suggestion to no longer use the name '--append') should be added?

If I recall correctly, this also disturbed users on this mailing list.

Thanks in advance,

Helmut
-- 
Wer mir E-Mail schreiben will, stelle   |   When writing me e-mail, please
bitte vor meine E-Mail-Adresse meinen   |   precede my e-mail address with
Vor- und Nachnamen, etwa so:            |   my full name, like
Helmut Waitzmann <address@hidden>, (Helmut Waitzmann) address@hidden