|Subject:||Please add SEE ALSO section to manual pages|
The manual pages---in particular, sparse leaf pages like MIME::Decoder::Gzip64(3pm)--- should contain a SEE ALSO section to point to related manual pages higher up in the class hierarchy. Right now, the only cross-reference (of sorts) is in the SYNOPSIS section. This poses two problems. First, the SYNOPSIS section is generally not used for that, so people aren't used to looking for it there. Second, it is at the top of the document, which means that when you reach the bottom of the document and still haven't found what you were looking for, you have to then know to read the document a second time from the top to find the reference to more information. As a result, most people miss it entirely and just send nasty feedback to people who maintain web versions of these pages. :-) Please add SEE ALSO sections for these minor leaf pages to point people back to the main class pages. This will make navigation much better, particularly on web site versions of the content.