On 23/08/03 10:51AM, aisha wrote:
> On 23/08/03 09:45AM, Stuart Henderson wrote:
> > On 2023/08/03 07:23, Jason McIntyre wrote:
> > > On Wed, Aug 02, 2023 at 05:52:02PM -0400, aisha wrote:
> > > > Hi,
> > > >   Someone - https://www.youtube.com/watch?v=NQ5uD5x8vzg - mentioned 
> > > > that our man page for tar(1) doesn't have an extract example, so I 
> > > > thought it would be good to add a simple one which highlights a common 
> > > > use case.
> > > > 
> > > > OK?
> > > > 
> > > 
> > > hi.
> > > 
> > > the examples section is small enough that i suppose it wouldn;t be a
> > > problem to add another one.
> > 
> > as it must be specified in a non-obvious place on the command line and
> > it's not currently explained particularly clearly, I'd welcome an example
> > using -C.
> > 
> > > it does add another example with a similar set of options though, all in
> > > a different order. i wonder whether we should try and push the action as
> > > the first option, so people can see what we're doing. so "cXXX" when the
> > > example is to create, "tXXX" when listing? then keep the "vzf" options
> > > that are so common in the same order?
> > > 
> > > then the second example is probably more helpful as "Create a gzip(1)
> > > compressed archive blah.tgz".
> > > 
> > > i know this isn;t what you're posting about, so feel free to leave alone
> > > if you don;t want to tackle that.
> > > 
> > > one more thing. you could as easily remove the text "the folder", but
> > > i'd be tempted to use "directory", as that's more standard for our docs,
> > > and how -C itself describes it.
> > 
> > strongly agree on options order and "directory".
> 
> Thanks for the comments!
> Here's the updated patch.
> 
> OK?
> 

Small change to address the backup/-p comments, I've removed the word -backup 
from the tar archive name

OK?

Index: tar.1
===================================================================
RCS file: /cvs/src/bin/pax/tar.1,v
retrieving revision 1.64
diff -u -p -r1.64 tar.1
--- tar.1       31 Mar 2022 17:27:14 -0000      1.64
+++ tar.1       3 Aug 2023 15:02:49 -0000
@@ -331,7 +331,7 @@ and
 .Pp
 .Dl $ tar c bonvole sekve
 .Pp
-Output a
+Create a
 .Xr gzip 1
 compressed archive containing the files
 .Pa bonvole
@@ -340,7 +340,7 @@ and
 to a file called
 .Pa foriru.tar.gz :
 .Pp
-.Dl $ tar zcf foriru.tar.gz bonvole sekve
+.Dl $ tar czf foriru.tar.gz bonvole sekve
 .Pp
 Verbosely create an archive, called
 .Pa backup.tar.gz ,
@@ -349,7 +349,7 @@ of all files matching the shell
 function
 .Pa *.c :
 .Pp
-.Dl $ tar zcvf backup.tar.gz *.c
+.Dl $ tar cvzf backup.tar.gz *.c
 .Pp
 Verbosely list, but do not extract, all files ending in
 .Pa .jpeg
@@ -358,6 +358,13 @@ from a compressed archive named
 Note that the glob pattern has been quoted to avoid expansion by the shell:
 .Pp
 .Dl $ tar tvzf backup.tar.gz '*.jpeg'
+.Pp
+Verbosely extract an archive, called
+.Pa foo.tar.gz ,
+to the directory
+.Pa /var/foo :
+.Pp
+.Dl $ tar xvzf foo.tar.gz -C /var/foo
 .Pp
 For more detailed examples, see
 .Xr pax 1 .

Reply via email to