Re: The eternal "use XXX instead of POD" debate (was: Project Start: ?Section 1)
[email protected] (Tim Bunce)
| Newsgroups | perl.perl6.documentation |
|---|---|
| Message-ID | <[email protected]> |
On Tue, Nov 12, 2002 at 11:40:05AM -0800, Larry Wall wrote: > 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". And has the freedom to change the grammar for pod text? And beyond? Tim.