Re: RFC 357 (v1) Perl should use XML for documentation instead ofPOD

2000-10-04 Thread Philip Newton
On Sun, 1 Oct 2000, Adam Turoff wrote: > POD has three mighty significant advantages over XML: > - it is easy to learn > - it is to write > - it is easy to ignore, if you're spelunking for Perl code > Try and do that, when interferes with syntactically. [snip] > Moving towards a sys

Re: RFC 357 (v1) Perl should use XML for documentation instead ofPOD

2000-10-03 Thread John Siracusa
On 10/3/00 12:01 PM, John Porter wrote: > John Siracusa wrote: >>> If you add (e.g.) support for tables, then pod is only translatable >>> into languages which also support tables. >> >> What languages *don't* support tables? > > I knew that was a bad example of my point. Think of something com

Re: RFC 357 (v1) Perl should use XML for documentation instead ofPOD

2000-10-03 Thread John Barnette
John Porter (Today): > Nicholas Clark wrote: > > On Mon, Oct 02, 2000 at 02:44:56PM -0600, John Barnette wrote: > > > But why extend the syntax for such a niche application? > > > > > > * POD can be easily converted to XML. > > > * POD can contain XML. > > > * Advanced concepts that POD ca

Re: RFC 357 (v1) Perl should use XML for documentation instead ofPOD

2000-10-03 Thread John Siracusa
On 10/3/00 10:59 AM, John Porter wrote: > John Siracusa wrote: >> POD is supposed to be the common format that can be transformed into other >> representations. Instead, you have to add the different representations >> yourself if you do anything remotely complex. > > No, POD is supposed to be si

Re: RFC 357 (v1) Perl should use XML for documentation instead ofPOD

2000-10-02 Thread Greg Williams
>XML, on the other hand, uses & as the escaping mechanism, helping >a reader sort-out deeply-nested escapings. ... >POD has a good advantage in that it's design allows for it to >embed well into code. If documentation is to be alongside >code, a direction to consider is to have the Perl >progra

Re: RFC 357 (v1) Perl should use XML for documentation instead ofPOD

2000-10-02 Thread John Siracusa
On 10/2/00 1:56 PM, Bart Lateur wrote: > The problem with XML is that it is so unforgiving; I think somebody > already mentioned that. Improperly nested tags, or one character it > doesn't recognize... and the parser says "nyet". Kind of like Perl, huh... ;) (this is a feature, not a bug! :) -Jo

Re: RFC 357 (v1) Perl should use XML for documentation instead ofPOD

2000-10-01 Thread Frank Tobin
Adam Turoff, at 03:22 -0400 on Sun, 1 Oct 2000, wrote: > POD has three mighty significant advantages over XML: > - it is easy to learn True, but XML is also easy to learn, and is more in-line with what the user will probably already know, as covered in the RFC. > - it is to write True, bu