On 17 Mar 2005 at 13:11, Schupp Roderich (extern) Com MD PD SWP 2 wrote: > Alan Stewart wrote: > > > > What about bracketing the whole pp stuff into > > > > > > =begin pp > > > > > > ...pp information, format TBD... > > > > > > =end pp > > I was also thinking that way. However, =head2 shows up in the > > output of translators like pod2html, whereas =begin and =for > > do not show up. Treating that as a feature, I was thinking > > It IS a feature: a podlator that doesn't know about FOO > is supposed to ignore all stuff between "=begin FOO" and > "=end FOO" or between "=for FOO ..." and the next POD directive. > > I think it's OK then that pod2html won't show this stuff > as it is of no value for the script's user. > > Cheers, Roderich
I meant treating the way translators behave as a pp pod feature. If the rest of your pod is traditional pod that provides usage instructions, you probably do want to hide it with =begin. If you use pod like I do (and I think Robin also), the pod is configuration management documentation, and you want the pp pod included with =head2. We should always provide for TMTOWTDI :) Alan
