in reply to Introspective POD

(I hope I'm not totally misunderstanding your question.) The standard practice, in my experience, is a suitable mention in the "SEE ALSO" section of the docs. Relatively low tech, I agree, but probably the only approach that is general enough to be useful.

the lowliest monk

Replies are listed 'Best First'.
Re^2: Introspective POD
by rvosa (Curate) on Aug 11, 2005 at 04:17 UTC
    I'm sceptical about the effictiveness of the SEE ALSO section: i) it has to be hand-maintained, so probably lagging behind development ii) it's usually at the bottom of the POD - many readers will tune out before that.

    I think my question is more general: can a module manipulate its POD, i.e.:
    =item TITLE ref $self - frobnication library version $VERSION =cut
    I'm interested in the (hypothetical) ability of interpolating variables (for example from @ISA), so that the documentation doesn't go stale.