Re: The eternal "use XXX instead of POD" debate (was: Project Start: ?Section 1)
[email protected] (Larry Wall)
| Newsgroups | perl.perl6.documentation |
|---|---|
| Message-ID | <[email protected]> |
On Mon, Nov 11, 2002 at 03:50:34PM -0800, Damien Neil wrote:
: I'd love to see a cleaner POD, with tables, better support for lists,
: and the ability to turn syntax inferencing on a per-document basis.
We used a preprocessor to put tables into the POD for the Camel.
Lists don't seem to occur all that often in technical docs, so it
doesn't seem to be all that big a problem in practice, though we
could certainly talk about improvements. As for per-document policy,
there should certainly be some kind of
=use module
directive that, like Perl's C<use>, is something more than just an
"include".
Larry