Re: RFC 331 (v2) Consolidate the $1 and C\1 notations

2000-10-03 Thread Dave Storrs
On Mon, 2 Oct 2000, Bart Lateur wrote: On Mon, 2 Oct 2000 12:46:06 -0700 (PDT), Dave Storrs wrote: Well, the main reason is that @/ worked best for my particular brain. But you cannot use it in an ordinary regex, can you? There's no way you can put $/[1] between slashes in

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

2000-10-03 Thread John Porter
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 cannot contain that the XML junkies

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

2000-10-03 Thread John Porter
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 simple. It addresses a very small, common subset

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

2000-10-03 Thread Robin Berjon
At 10:59 03/10/2000 -0400, John Porter wrote: Complex things should not be done in POD. Indeed. This debate has been done to death. Have any of the would-be pod-killers read the thread at http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/1999-08/thrd11.html#0 1078 ? The thread eventually

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 simple.

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 cannot contain that

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

2000-10-03 Thread John Porter
Robin Berjon wrote: At 10:59 03/10/2000 -0400, John Porter wrote: Complex things should not be done in POD. Indeed. This debate has been done to death. Have any of the would-be pod-killers read the thread at http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/1999-08/thrd11.html#0 1078

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

2000-10-03 Thread John Porter
John Siracusa wrote: On 10/3/00 10:59 AM, John Porter 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 complex.

Re: 184 (v3): Perl should support an interactive mode

2000-10-03 Thread Markus Peter
Christian Soeller wrote: Very little discussion was generated by this RFC. Several people noted that perl -de 42 and the Perl shell psh already provide some of what the RFC requests; this is noted in the RFC. The RFC is not being withdrawn, since 2 other people expressed (mild) interest

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 complex. O.k.,

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

2000-10-03 Thread Damien Neil
On Tue, Oct 03, 2000 at 03:42:49PM +0100, Graham Barr wrote: On Mon, Oct 02, 2000 at 12:58:37PM -0700, Damien Neil wrote: What? I don't think people should be writing either XML or HTML as the source documentation format. I said that, quite clearly. Then what are they going to write it

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

2000-10-03 Thread John Porter
John Siracusa wrote: Tables are my personal peeve, but I'm sure you can think of many more common documentation features that POD should support natively. Hypertext is another example, off the top of my head. I agree that pod could support these thing better. I believe it will, and it

RE: RFC 357 (v1) Perl should use XML for documentation instead of POD

2000-10-03 Thread Garrett Goebel
From: Peter Scott [mailto:[EMAIL PROTECTED]] As I said earlier, why don't we just define a syntax for *anything* to be used as an extension language, and let the, er, market decide? Here, here! Peaceful coexistance... what a concept.

RE: RFC 357 (v1) Perl should use XML for documentation instead of POD

2000-10-03 Thread Greg Boug
Some arguments for XML: - Done right, it could be easier to write and maintain Pod is already "done right", and it's already spectacularly easy to write and maintain. XML is a hammer in search of nail. Actually, a better analogy would be a its a sledge hammer in search of a fingernail

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

2000-10-03 Thread Peter Scott
At 12:01 PM 10/3/00 -0400, John Porter wrote: How would you down-convert a complex math formula to ascii from, say, xhtml? You know, I'm thinking TeX would make a great extension language for pod. Simple, powerful, text-based, with translators to lots of other formats, and good tool support