tar cvf somedir filename.tar create an archive from somedir and store it in filename.tar
tar xvpf filename.tar extract the contents of filename.tar and scatter them around your home directory
Instead of getting examples that I might use, when I visit a man page, I get a wall of text 926 lines long, describing every possible option, including GNU option styles, or some truncated mess telling me to read the info pages.
Of course, it's appropriate that all this information is included somewhere in the manual. I just think the common use cases should be first. Does anyone need a man page for 'ls' that starts off describing how to list inode numbers and SELinux labels?
The justification I usually hear is that SO is for learning to solve one case, while man pages are for learning how the tool works. There's some merit to that, but if a tool has some hidden gotcha or unusual use, SO tends to make that much clearer than the actual documentation.
I suppose comprehensiveness was a higher priority when there wasn't an online discussion of every imaginable case, but it still feels like a lot could be done to convey the same amount of information more gracefully.
It sounds like this project moved in the right direction and made the man page more efficient than googling, but many others haven't.
Section 3.3.3 "Old Option Styles" covers exactly the situation you describe.
> This old way of writing 'tar' options can surprise even experienced users. For example, the two commands:
> tar cfz archive.tar.gz file
> tar -cfz archive.tar.gz file
> are quite different. The first example uses 'archive.tar.gz' as the value for option 'f' and recognizes the option 'z'. The second example, however, uses 'z' as the value for option 'f' -- probably not what was intended.
> Old options are kept for compatibility with old versions of 'tar'.
> This second example could be corrected in many ways, among which the following are equivalent:
> tar -czf archive.tar.gz file
> tar -cf archive.tar.gz -z file
> tar cf archive.tar.gz -z file