News for hackers. Stuff that matters.
Re:Learn just enough Linux to get things done by michrassena on Thursday November 16, 2017 @12:11PM (#15714392)
I agree and wish distro maintainers could make some changes. I would love to use manual pages, but instead I search the Internet first. If every manual had a section with most-common examples, it would help immensely. You could just type 'manexamples tar' and it would print out

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?

There are no comments on this comment yet.