I guess I'm looking for something a little more indepth than perlpod, but then again, maybe the bare framework is all that I need.

What I like about javadoc is the ability to spell out the documentation of each variable, each function (return values, description etc), each class, and have a very nicely formatted set of html pages, that provided links to the various declarations, snippits etc.

Maybe I'm missing something, but perldoc doesn't seem to have the features that something like javadoc does. (Please let me know if I'm wrong.)