The way this is usually done is to provide a link to the superclass documentation. I suppose one could use this link as a kind of an include statement in your postprocessing to pull in sections from the other perldocs (after you have parsed them), but as you say, it seems a bit inelegant. I would stick with the hypertext links; they are much easier to code and most people are fine with using links..