[Doc-SIG] DocStrings 0.3: Suggestion for documentation syntax (very long)

[Ka-Ping Yee]

On Fri, 4 Feb 2000, Tony J Ibbs (Tibs) wrote:
> 
> 1. Why don't we just use XML? - the proposed format is almost as verbose,
> and has the disadvantage that it is a new format "for the sake of it" [1].

Because XML is totally unacceptable for typing.  Moreover, it is quite easy
to type syntactically incorrect XML [1], and the concept of documentation so
complex that it requires debugging on a syntactic level just horrifies me.  


-- ?!ng

[1] ...as evidenced by my very own mistake!  Can you find the error in the
    silly XML example in my first message entitled "Ease of use is #1"?