On Wed, Jul 26, 2000 at 01:41:12PM -1000, Tim Jenness wrote:
> The Perl Data Language (PDL) comes with support for
>
> =for example
>
> but only uses it for online documentation support. They have private
> versions of Pod::Parser that recognises the 'example' tag (as well as
> 'usage' and others).
Oooh, that could be good and that could be bad. PDL is pretty popular
and I wouldn't want to step on their features. Then again, PDL si
pretty popular and can act as a springboard.
More info? What do they use their =for tags err... for?
> > Modifying all the POD utilities so they know to display "=for
> > example" might be a pain.
>
> I think there needs to be a pod pre-processor (before it hits Pod::Parser)
> to convert the
>
> =for example
>
> into the correct pod display format (or removing it).
This is a possibility for perl's internal docs, but its kind of a pain
fr external stuff. Perhaps we can distribute perl's internal docs
with the '=for example' built in (since if you install the docs you
should also install the new POD utilities) and provide a converter for
module/code authors who need to worry about compatibility.
--
Michael G Schwern http://www.pobox.com/~schwern/ [EMAIL PROTECTED]
Just Another Stupid Consultant Perl6 Kwalitee Ashuranse
Actually I'm very sure we can resurrect people because we have that
technology already. Cloning an entire sheep has already successfully been
done by Scottish scientists. In the future, cloning will be allowed because
resurrection is promised in the Torah, and it is clearly the will of God.
--Alex Chiu, Immortality Guy
