Difficulty finding documentation (and how to use the docs) for command-line programs

Jay Smith <jay-BB6z0fKkvBxWk0Htik3J/[email protected]>
Newsgroups gmane.linux.usability.annoyances
Organization Jay Smith and Associates
Message-ID <[email protected]>
It seems that I always need some obscure feature of a program. However, 
despite using various unixes and linux (as a business user, not as a tech 
person) for 14 years, I am still stymied by the difficulty in figuring out 
where to find the documentation for any given program, particularly 
command-line programs.

My server has 100s of MB of docs. But that is usually of little help.

If 'man programname' doesn't work, I am in trouble.  Between help and info 
and perldoc and stuff in postscript and this and that and whatever, it is a 
mess.

In many cases, if I knew how to find and use the docs, I would not have the 
question that I have.

Linux has to be more friendly to the non-technical user, especially when it 
comes to the accessibility of (and readability of) the docs.  In a perfect 
world, there would be an accepted standard of how one determines where the 
docs are and how to use them.  Doing something like 'programname --docs' 
should tell you where the docs are installed *on your system* and how to 
invoke them or use them; and if any special doc-reading program is needed, 
how to find out how to run that.

*I do like computers,* but I earn my living by using the output of the 
programs I run to increase my productivity so that I can deliver my 
product/service faster, at less cost, and in better quality.  I don't earn 
my living trying to figure out how to make a program work the way I want it to.

Jay
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.