I would also suggest that man pages need examples. Oftentimes, what is required, and how it is required, is not very clear, and examples would go a long way towards helping people more. Granted, some man pages do have examples, but not near enough do.