docs/82481: tar(1)/gtar(1) man page mod request

[Daniel Gerzo]

The following reply was made to PR docs/82481; it has been noted by GNATS.

From: Daniel Gerzo <danger at rulez.sk>
To: bug-followup at FreeBSD.org, weldon at mx0.excelsus.net
Cc:  
Subject: Re: docs/82481: tar(1)/gtar(1) man page mod request
Date: Tue, 17 Jan 2006 21:19:41 +0100

 --ReaqsoxgOBHFXBhH
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Hello Weldon and doc@,
 
    I took a look at this and it looks like it would be really good to
    fix that, although the -HEAD and RELENG_6 as well doesn't build or
    install gtar anymore, so the proposed fix should go to RELENG_5
    only.
 
    I also fixed examples in gtar manual page to reflect this change.
 
    Help provided by simon@ and slightly discussed with kientzle@
 
    Thanks for your report!
 
 -- 
 Sincerely,
    Daniel Gerzo
 
 --ReaqsoxgOBHFXBhH
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="tar.2.diff"
 
 diff -ruN tar.orig/bsdtar.1 tar/bsdtar.1
 --- tar.orig/bsdtar.1	Mon Jan  2 17:49:35 2006
 +++ tar/bsdtar.1	Tue Jan 17 21:08:49 2006
 @@ -629,6 +629,7 @@
  .Sh SEE ALSO
  .Xr bzip2 1 ,
  .Xr cpio 1 ,
 +.Xr gtar 1 ,
  .Xr gzip 1 ,
  .Xr mt 1 ,
  .Xr pax 1 ,
 @@ -659,8 +660,14 @@
  .Nm pdtar
  public-domain implementation (circa November, 1987)
  was quite influential, and formed the basis of GNU tar.
 -GNU tar was included as the standard system tar
 -in FreeBSD beginning with FreeBSD 1.0.
 +GNU tar was included as the standard system tar in
 +.Fx
 +beginning with
 +.Fx 1.0
 +until it was replaced by
 +.Xr bsdtar 1
 +in
 +.Fx 5.3 .
  .Pp
  This is a complete re-implementation based on the
  .Xr libarchive 3
 diff -ruN tar.orig/gtar.1 tar/gtar.1
 --- tar.orig/gtar.1	Mon Jan  2 17:49:44 2006
 +++ tar/gtar.1	Tue Jan 17 20:59:40 2006
 @@ -8,10 +8,10 @@
  .\"
  .Dd December 23, 2000
  .Os
 -.Dt TAR 1
 +.Dt GNU TAR 1
  .Sh NAME
 -.Nm tar
 -.Nd "tape archiver; manipulate ""tar"" archive files"
 +.Nm gtar
 +.Nd GNU "tape archiver; manipulate ""tar"" archive files"
  .Sh SYNOPSIS
  .Nm
  .Op Oo Fl Oc Ns Ar bundled-options Ar Args
 @@ -379,9 +379,9 @@
  and
  .Pa ernie ,
  you can enter
 -.Dl "tar cfb /dev/sa0 20 bert ernie"
 +.Dl "gtar cfb /dev/sa0 20 bert ernie"
  or
 -.Dl "tar --create --file /dev/sa0 --block-size 20 bert ernie"
 +.Dl "gtar --create --file /dev/sa0 --block-size 20 bert ernie"
  Note that the
  .Fl f
  and
 @@ -393,12 +393,12 @@
  .Pa /dev/sa0
  is the default device, and 20 is the default block
  size, the above example could have simply been
 -.Dl "tar c bert ernie"
 +.Dl "gtar c bert ernie"
  .Pp
  To extract all the C sources and headers from an archive named
  .Pa backup.tar ,
  type
 -.Dl "tar xf backup.tar '*.[ch]'"
 +.Dl "gtar xf backup.tar '*.[ch]'"
  Note that the pattern must be quoted to prevent the shell from
  attempting to expand it according the files in the current working
  directory (the shell does not have access to the list of files in
 @@ -406,27 +406,27 @@
  .Pp
  To move file hierarchies, use a command line like this:
  .Bd -literal
 -tar -cf - -C srcdir . | tar xpf - -C destdir
 +gtar -cf - -C srcdir . | gtar xpf - -C destdir
  .Ed
  .Pp
  To create a compressed archive on diskette, using
  .Xr gzip 1 ,
  use a command-line like
 -.Dl "tar --block-compress -z -c -v -f /dev/fd1a -b 36 tar/"
 +.Dl "gtar --block-compress -z -c -v -f /dev/fd1a -b 36 tar/"
  .Pp
  Note that you cannot mix bundled flags and
  .Fl -style
  flags; you can use
  single-letter flags in the manner above, rather than having to type
 -.Dl "tar --block-compress --gzip --verbose --file /dev/fd1a --block-size 20 tar/"
 +.Dl "gtar --block-compress --gzip --verbose --file /dev/fd1a --block-size 20 tar/"
  .Pp
  The above-created diskette can be listed with
 -.Dl "tar tvfbz /dev/fd1a 36"
 +.Dl "gtar tvfbz /dev/fd1a 36"
  .Pp
  To join two
  .Nm
  archives into a single archive, use
 -.Dl "tar Af archive1.tar archive2.tar"
 +.Dl "gtar Af archive1.tar archive2.tar"
  which will add the files contained in
  .Pa archive2.tar
  onto the end of
 @@ -441,7 +441,7 @@
  .Pa srcdir ,
  which were modified
  after Feb.\& 9th 1997, 13:00 h, use
 -.Dl "tar -c -f backup.tar --newer-mtime 'Feb 9 13:15 1997' srcdir/"
 +.Dl "gtar -c -f backup.tar --newer-mtime 'Feb 9 13:15 1997' srcdir/"
  .Pp
  Other possible time specifications are
  .Sq "02/09/97 13:15" ,
 @@ -513,6 +513,7 @@
  option is for compatibility with Solaris's
  .Nm .
  .Sh SEE ALSO
 +.Xr bsdtar 1 ,
  .Xr bzip2 1 ,
  .Xr compress 1 ,
  .Xr gzip 1 ,
 @@ -530,6 +531,12 @@
  .Nm
  written by
  .An John Gilmore .
 +GNU tar was included as the standard system tar since
 +.Fx 1.0
 +and was firstly replaced by
 +.Xr bsdtar 1
 +in
 +.Fx 5.3 .
  .Sh AUTHORS
  .An -nosplit
  A cast of thousands, including [as listed in the
 
 --ReaqsoxgOBHFXBhH--