From weldon@mx0.excelsus.net  Tue Jun 21 12:29:53 2005
Return-Path: <weldon@mx0.excelsus.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 285AB16A41C
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 21 Jun 2005 12:29:53 +0000 (GMT)
	(envelope-from weldon@mx0.excelsus.net)
Received: from mx0.excelsus.net (volt.excelsus.com [216.54.3.98])
	by mx1.FreeBSD.org (Postfix) with ESMTP id B04C543D48
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 21 Jun 2005 12:29:52 +0000 (GMT)
	(envelope-from weldon@mx0.excelsus.net)
Received: (qmail 82682 invoked by uid 0); 21 Jun 2005 12:29:52 -0000
Message-Id: <20050621122952.82681.qmail@mx0.excelsus.net>
Date: 21 Jun 2005 12:29:52 -0000
From: Weldon S Godfrey 3 <weldon@mx0.excelsus.net>
Reply-To: Weldon S Godfrey 3 <weldon@mx0.excelsus.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: tar/gtar man page mod request
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         82481
>Category:       docs
>Synopsis:       tar(1)/gtar(1) man page mod request
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    danger
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jun 21 12:30:10 GMT 2005
>Closed-Date:    Tue Jun 24 11:15:33 UTC 2008
>Last-Modified:  Tue Jun 24 11:15:33 UTC 2008
>Originator:     Weldon S Godfrey 3
>Release:        FreeBSD 5.4-RELEASE-p2 i386
>Organization:
Excelsus Engineering
>Environment:
System: FreeBSD volt.excelsus.com 5.4-RELEASE-p2 FreeBSD 5.4-RELEASE-p2 #5: Sun Jun 19 12:16:08 EDT 2005 weldon@volt.excelsus.com:/usr/obj/usr/src/sys/VOLT i386
	N/A
>Description:
at some point between 5.2.1-R and 5.4-R, tar was renamed gtar and bsdtar
became tar.  The "SEE ALSO" for the man pages of tar and gtar need references
to each other.  It might be a good idea to document this move in the "HISTORY"
sections

>How-To-Repeat:
	N/A
>Fix:
>Release-Note:
>Audit-Trail:

From: Daniel Gerzo <danger@rulez.sk>
To: bug-followup@FreeBSD.org, weldon@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--

From: Daniel Gerzo <danger@rulez.sk>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/82481: tar(1)/gtar(1) man page mod request
Date: Sun, 19 Feb 2006 19:50:01 +0100

 Hello,
 
    Could somebody merge this to RELENG_5 before 5.5-R?
 
 -- 
 Sincerely,
   Daniel Gerzo
 
Responsible-Changed-From-To: freebsd-doc->danger 
Responsible-Changed-By: danger 
Responsible-Changed-When: Sun Aug 20 21:19:28 UTC 2006 
Responsible-Changed-Why:  
Take this one. I think that the patch still applies, but I will have 
to discuss if it is worth to merge this to RELENG_5 or not, since 
the problem does not exist in HEAD/RELENG_6. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=82481 
State-Changed-From-To: open->closed 
State-Changed-By: danger 
State-Changed-When: Tue Jun 24 11:14:37 UTC 2008 
State-Changed-Why:  
Close this one as I don't think it's worth to merge this back to 
RELENG_5 as this branch is not supported anymore and there will be 
no more 5.x releases. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=82481 
>Unformatted:
