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? 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 14:46:23 -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-backup.tar.gz , +to the directory +.Pa /var/foo : +.Pp +.Dl $ tar xvzf foo-backup.tar.gz -C /var/foo .Pp For more detailed examples, see .Xr pax 1 .