narse has asked for the wisdom of the Perl Monks concerning the following question:
Hi all. I am looking for a way to inherit perldoc documentation from other packages. I would like objects to inherit pod as well as methods from their superclass. In my case, the most important methods are inherited and I would like the documentation for the subclass to reflect this, however, duplication of comments is unreasonable and will undoubtable lead to stale documentation.
I understand the difficulties resulting from the freedom of style in pod. I would be willing to adopt certain documentation styles to accomplish my goals. I may also be willing to run a script that copies comments from one pm to another althought this seems sloppy.
Does anyone have any suggestions?