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