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: a07f3367d7,887292c91e10d3fd X-Google-Attributes: gida07f3367d7,public,usenet X-Google-NewGroupId: yes X-Google-Language: ENGLISH,ASCII-7-bit Path: g2news2.google.com!postnews.google.com!p7g2000prb.googlegroups.com!not-for-mail From: AdaMagica Newsgroups: comp.lang.ada Subject: Re: Ada documentation tools. Date: Mon, 15 Nov 2010 04:38:17 -0800 (PST) Organization: http://groups.google.com Message-ID: <45458390-1074-4299-8faf-624bfda6db51@p7g2000prb.googlegroups.com> References: NNTP-Posting-Host: 80.156.44.178 Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 X-Trace: posting.google.com 1289824697 1573 127.0.0.1 (15 Nov 2010 12:38:17 GMT) X-Complaints-To: groups-abuse@google.com NNTP-Posting-Date: Mon, 15 Nov 2010 12:38:17 +0000 (UTC) Complaints-To: groups-abuse@google.com Injection-Info: p7g2000prb.googlegroups.com; posting-host=80.156.44.178; posting-account=rmHyLAoAAADSQmMWJF0a_815Fdd96RDf User-Agent: G2/1.0 X-HTTP-UserAgent: Mozilla/5.0 (Windows; U; Windows NT 5.2; de; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4,gzip(gfe) Xref: g2news2.google.com comp.lang.ada:16475 Date: 2010-11-15T04:38:17-08:00 List-Id: On 15 Nov., 12:40, "Peter C. Chapin" wrote: > On 2010-11-15 03:14, AdaMagica wrote: > > > So what do you expect from such a tool that the Ada spec does not yet > > provide? > > Mainly I want cross-referenced documentation that is easy to browse. I > realize that IDEs can provide much of this support but I like having > documentation that can be read without the help of a specific IDE (for > example, in any web browser). > > Peter Cross-referencing can best be done via the internal program representation (ASIS e.g.). Why is a browser to be preferred to an IDE like GPS? OK, you can use it without a compiler being present. This seems like a weak reason. Modern software needs the appropriate tools to read, and for source code, this is the compiler. Would you try to browse through a HOOD design or UML model created with some tool with a browser instead of a dedicated tool?