comp.lang.ada
 help / color / mirror / Atom feed
From: Stephen Leake <stephen_leake@acm.org>
To: comp.lang.ada@ada-france.org
Subject: Re: DOM and SAX parsing in Ada
Date: 28 Jan 2005 05:23:48 -0500
Date: 2005-01-28T05:23:48-05:00	[thread overview]
Message-ID: <mailman.106.1106907848.527.comp.lang.ada@ada-france.org> (raw)
In-Reply-To: <gemini.iazxmw00jrr0d008g.nick.roberts@acm.org>

Nick Roberts <nick.roberts@acm.org> writes:

> I agree entirely, and the changes I wanted to make -- and I made this clear
> to the AdaCore employee -- were precisely designed to obviate this problem,
> by allowing the maintenance documentation to be placed in separate files.
> The changes I wanted to make were to place commented tags in the source
> code, so that the external documentation could readily refer to fragments of
> code (by tag).
> 
> It was this approach which the employee specifically rejected. The essence
> of what he said was that: no maintenance documentation was necessary (the
> source code was self-documenting); in any case, any such documentation
> should be entirely in the form of comments in the source code. I think he is
> seriously wrong on both counts.

Ok, I agree with you stongly here!

> The issue is whether I should:
> 
>    (a) create a fork of Ada/XML and develop it;
> 
>    (b) create a new Ada XML DOM package from scratch, and develop it;
> 
>    (c) design and create a new Ada XML I/O package, and develop it.

You left out:

(d) create a separate repository of documentation for XML/Ada

This option satisfies most of your immediate goal. It does not have
the links from the code to the documentation, but that can be handled
in other ways (admittedly not as nice).

> My objectives are:
> 
>    (1) to provide an Ada XML I/O package which I can use for my own specific
>        purpose (a literate programming 'reverse tangle' tool);
>
>    (2) to make this package available for the benefit of the Ada community.
> 
> Regarding objective (1), I need a package that can read a DTD (a very big
> and hairy one, in fact) and expand the general entities declared in it.
> Validation would also be nice. XML/Ada version 1.0 doesn't support all the
> functionality I need (nor validation)

Ok. Did AdaCore comment on the usefulness of this functionality? That
is, would they view it as a valuable contribution, worth their time to
integrate?


> -- and it has no maintenance documentation.

Which is not a show stopper, just a problem, which can be solved even
without AdaCore's cooperation.

-- 
-- Stephe




  parent reply	other threads:[~2005-01-28 10:23 UTC|newest]

Thread overview: 64+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2004-11-08 23:24 DOM and SAX parsing in Ada Tim Roede
2004-11-09  0:24 ` David Botton
2004-11-09  0:56   ` David Botton
2004-11-09  8:33     ` Martin Krischik
2004-11-09 13:25       ` David Botton
2004-11-09  3:14 ` Steve
2005-01-20 12:16   ` okellogg
2005-01-21 18:09     ` Nick Roberts
2005-01-24 11:26       ` Alex R. Mosteo
2005-01-24 12:16         ` Marius Amado Alves
2005-01-24 20:17           ` Georg Bauhaus
2005-01-24 21:18             ` Pascal Obry
2005-01-24 19:02         ` Marc A. Criley
2005-01-25  9:50           ` Alex R. Mosteo
2005-01-25 15:29         ` Nick Roberts
2005-01-25 18:21           ` Marc A. Criley
2005-01-26  5:39             ` Nick Roberts
2005-01-26  7:37               ` Martin Krischik
2005-01-26 12:24               ` Jeff C
2005-01-26 16:16                 ` Nick Roberts
2005-01-26 16:46                   ` Georg Bauhaus
2005-01-27 19:45                     ` Nick Roberts
2005-01-26 22:14                   ` Brian May
2005-01-27  9:28                     ` Martin Krischik
2005-01-27 19:55                     ` Nick Roberts
2005-01-28 10:05                       ` Stephen Leake
2005-01-26 23:48                   ` Stephen Leake
2005-01-27 20:05                     ` Nick Roberts
2005-01-27 20:57                       ` Marc A. Criley
2005-01-27 22:11                         ` Nick Roberts
2005-01-27 22:24                           ` Pascal Obry
2005-01-28  0:29                             ` Nick Roberts
2005-01-28  7:22                               ` Pascal Obry
2005-01-28  2:56                           ` Steve
2005-01-28 13:32                             ` Georg Bauhaus
2005-01-28 15:25                             ` Nick Roberts
2005-01-28 10:23                           ` Stephen Leake [this message]
2005-01-29 11:58                             ` Simon Wright
2005-01-28 13:47                           ` Georg Bauhaus
2005-01-29 17:08                             ` Nick Roberts
2005-01-31 14:24                               ` Marc A. Criley
2005-01-28 13:54                           ` Georg Bauhaus
2005-01-29 11:54                           ` Simon Wright
2005-01-29 16:54                             ` Nick Roberts
2005-01-28 10:17                       ` Stephen Leake
2005-01-27  4:11                   ` Jeff C
2005-01-27 19:05                     ` Pascal Obry
2005-01-27 20:15                     ` Nick Roberts
2005-01-27 22:28                       ` Pascal Obry
2005-01-28  0:30                         ` Nick Roberts
2005-01-26 14:12               ` Marc A. Criley
2005-01-27  3:59                 ` Steve
2005-01-27  9:32                   ` Martin Krischik
2005-01-27 19:27                     ` Pascal Obry
2005-01-28  3:17                       ` Steve
2005-01-28  7:14                         ` Pascal Obry
2005-01-28 10:00                         ` Stephen Leake
2005-01-28  7:47                       ` Martin Krischik
2005-01-28  9:57                       ` Stephen Leake
2005-01-28 16:36                         ` Pascal Obry
2021-11-22 13:01   ` James Hitch
2021-11-22 13:31     ` Simon Wright
2021-11-22 13:54       ` James Hitch
  -- strict thread matches above, loose matches on Subject: below --
2005-01-25  0:22 amado.alves
replies disabled

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox