scottro, you're right
!
But a lot of BSD man pages aren't perfect, too - especially, if one is looking for some basic information (and is not an expert!). Much often I have read man pages and after I knew as much as before. Why? Because a) quite often they are lacking structure (like starting with the basics and then proceeding to the more advanced tasks) and b) they are very theoretical.
In my case I often make the experience, that I read a man-page and after that I still do not know what to do
. Partially, it's because I'm not a native english-speaker. But even with a good dictionary it's sometimes hardly possible to get what the author wants to tell me.
And I think that it's sometimes because experts are writing for experts.