On 23 Feb 2001, Russ Allbery wrote:
> schwern <[EMAIL PROTECTED]> writes:
>
> > And a perldoc --private flag (or -p or whatever) to display it along
> > with the rest of the docs!
>
> > This will require some modification to pod2man and pod2text, but
> > nothing difficult.
>
> That's a good idea. Patches welcome; I'd prefer =begin/=end hidden
> with no underscores and in lower case and --hidden, I think, unless
> someone has a better term; that's more general than "internals" and I
> think somewhat more accurate than "private." But I could also be
> convinced I'm wrong.
>
I like "hidden" too.
I see that Pod::Parser itself has hidden pod sections.
Spotting these sort of sections is exactly what Marek's Pod::Compiler
would be good for - all the translators will have to be modified to
support a "hidden" siwtch.
Changing all the pod translators to use Pod::Compiler would simplify a lot
of this (pod2latex included) since Pod::Parser is not really at a high
enough level to prevent duplication of code between the translators.
Pod::Compiler might help Michael Schwern's quest for a simpler interface
to Pod::Parser as well.
--
Tim Jenness
JCMT software engineer/Support scientist
http://www.jach.hawaii.edu/~timj
