Date: Tue, 17 Jan 2006 20:30:11 GMT From: Daniel Gerzo <danger@rulez.sk> To: freebsd-doc@FreeBSD.org Subject: Re: docs/82481: tar(1)/gtar(1) man page mod request Message-ID: <200601172030.k0HKUBOT028563@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/82481; it has been noted by GNATS. 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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200601172030.k0HKUBOT028563>