From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham
	autolearn_force=no version=3.4.4
X-Google-Thread: 103376,deac256a05c84a59
X-Google-Attributes: gid103376,public
X-Google-Language: ENGLISH,ASCII-7-bit
Path: 
 g2news1.google.com!news3.google.com!news.glorb.com!tiscali!newsfeed1.ip.tiscali.net!feed.news.tiscali.de!newsfeed.freenet.de!151.189.20.20.MISMATCH!newsfeed.arcor.de!news.arcor.de!not-for-mail
Date: Wed, 26 Jan 2005 17:46:57 +0100
From: Georg Bauhaus <bauhaus@futureapps.de>
Organization: future apps GmbH
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US;
 rv:1.7.3) Gecko/20041007 Debian/1.7.3-5
X-Accept-Language: en
MIME-Version: 1.0
Newsgroups: comp.lang.ada
Subject: Re: DOM and SAX parsing in Ada
References: <41900010.D28DD400@boeing.com><9CWjd.17305$5K2.1356@attbi_s03>
  <1106223415.857525.176640@c13g2000cwb.googlegroups.com>
  <gemini.iaoife001pbek00hc.nick.roberts@acm.org>
  <41F4DB6F.4090909@mailinator.com>
  <gemini.iavppg0091gj502zw.nick.roberts@acm.org>
 <35nh12F4oe4caU1@individual.net>
  <gemini.iawt1w000svx202ss.nick.roberts@acm.org>
  <UPWdnYp5d-1PFmrcRVn-rA@comcast.com>
 <gemini.iaxmj2001ydde00mw.nick.roberts@acm.org>
In-Reply-To: <gemini.iaxmj2001ydde00mw.nick.roberts@acm.org>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Message-ID: <41f7c974$0$17618$9b4e6d93@newsread4.arcor-online.net>
NNTP-Posting-Date: 26 Jan 2005 17:46:44 MET
NNTP-Posting-Host: 9b350d8e.newsread4.arcor-online.net
X-Trace: 
 DXC=E0^l_>C;gB6cbQG5oOHD^6:ejgIfPPld4jW\KbG]kaM8DAHcn;Zl5e8i]<Aa9015A4UUng9_FXZ=3>:=P9Ihe`B8@Z?dZ]MOid5
X-Complaints-To: abuse@arcor.de
Xref: g2news1.google.com comp.lang.ada:7989
Date: 2005-01-26T17:46:44+01:00
List-Id: <comp.lang.ada>

Nick Roberts wrote:

> On the subject of comments, I suggested that the amount of maintenance
> documention (in the form of comments or in any other form) was insufficient
> -- it was nearly nonexistent, in fact -- and the answer was, in essence,
> that no maintenance documentation is required, since the code is
> self-documenting. I'm afraid, to me, that attitude is unacceptable (and
> doesn't seem very professional, frankly).

Looking at the code, there are lots and lots of comments,
mostly in the specs, but also in some bodies. I have also found the
introductory sections in some of the specs instructive, if somewhat
formal.
What is it that is missing when you want to "maintain" XML/Ada?

georg