Comment by dllthomas

"They almost never have examples(Is that some sort of rule?)"

They often have examples, though this is certainly better represented in some areas than others. One I looked at just the other day, man 7 aio, is 334 lines. Starts out describing the various aio functions and structures under DESCRIPTION, and has an EXAMPLE section: http://man7.org/linux/man-pages/man7/aio.7.html

Or, also off the top of my head, man 2 signalfd, 196 lines with example code: http://man7.org/linux/man-pages/man2/signalfd.2.html

Certainly there are man pages that aren't up to snuff (fix 'em!) but good man pages exist and many are great!