Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Me, too.

What error codes does the program return? How about some non-trivial examples of use?

And does the man page actually document the software? All the switches, all the enumerated options and data range limits for each option?

In OpenBSD: all that is there. A documentation bug is a bug.

In Linux: "best wishes, and perhaps you'd like to write the man page for this utility you use once every two years?"

Disclosure: I use linux (through sheer inertia). I started on FreeBSD though, and got used to having adequate documentation.



The worst thing you can see in a Linux manpage: "For complete explanations, see the info(5) documentation"




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: