On 06/02/16 00:07, pizdel...@gmail.com wrote: ... > It's absolutely acceptable for a manual page to [...]
Stop right there. You don't get to dictate what is or isn't in the OpenBSD project's man pages. The two people who do have spoken, agreed with each other and not with you. You had a suggestion, you suggested it, it was rejected. Thanks for playing. Move on. Have a nice day. If you really think it is important, go ahead, create a web page, drop it out on the 'net, and see if you get famous as the person who writes better docs than the OpenBSD team. Or write a book. Documentation is an art (though, honestly...jmc@ makes it almost a science...it's amazing to watch, really). Include too much, the important details "everyone needs to know" are lost in the noise of "stuff most people/target audience already knows". Include too little, you will baffle new users. OpenBSD has over 600 basic commands in the standard install (not counting X). If you have to document basic Unix usage functionality in each man page, the signal to noise ratio will drop to useless for users on their second week of using Unix. So yes, a certain basic Unix knowledge is expected. Nick.
