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,887292c91e10d3fd
X-Google-NewGroupId: yes
X-Google-Attributes: gida07f3367d7,domainid0,public,usenet
X-Google-Language: ENGLISH,ASCII-7-bit
Path: 
 g2news1.google.com!postnews.google.com!f16g2000prj.googlegroups.com!not-for-mail
From: AdaMagica <christoph.grein@eurocopter.com>
Newsgroups: comp.lang.ada
Subject: Re: Ada documentation tools.
Date: Mon, 15 Nov 2010 06:25:47 -0800 (PST)
Organization: http://groups.google.com
Message-ID: 
 <1c9aff07-3b32-4492-bd33-7f826bd47e10@f16g2000prj.googlegroups.com>
References: <s5adnQTW9suR_33RRVn_vwA@giganews.com>
 <c2c16ca4-9833-4947-a549-6de773ef78dc@35g2000prb.googlegroups.com>
 <6f234690-e21d-4d78-8dba-c017976029e9@z17g2000prz.googlegroups.com>
 <80dacf60-a610-4004-9298-69751bbfcaea@j12g2000prm.googlegroups.com>
 <8cdfee44-a675-46a3-b850-77661400dbc8@j9g2000vbr.googlegroups.com>
NNTP-Posting-Host: 80.156.44.178
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
X-Trace: posting.google.com 1289831148 16868 127.0.0.1 (15 Nov 2010 14:25:48
 GMT)
X-Complaints-To: groups-abuse@google.com
NNTP-Posting-Date: Mon, 15 Nov 2010 14:25:48 +0000 (UTC)
Complaints-To: groups-abuse@google.com
Injection-Info: f16g2000prj.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: g2news1.google.com comp.lang.ada:15508
Date: 2010-11-15T06:25:47-08:00
List-Id: <comp.lang.ada>

On 15 Nov., 14:06, Maciej Sobczak <see.my.homep...@gmail.com> wrote:
> On 15 Lis, 13:29, AdaMagica <christoph.gr...@eurocopter.com> wrote:
>
> > > Formatting. Presentation is not only about content.
>
> > Hm. How can a tool improve bad formatting in the code?
>
> Every reasonable code editor does it without any problem. Some people
> actually never format their code by hand and rely on tools to do that
> for them.
>
> > Format the code
> > correctly in the first place.
>
> Can I use a tool to do it?
>
> And, while we're at it, what does it mean "correctly"? Correctly
> according to your preferences or to mine? Tools can also automate the
> transition between different conventions.
>
> But formatting is not only about whitespace. It is also about colors,
> fonts, text flow, and so on. Code can be also printed or rendered in
> HTML browser - not necessarily as standalone content, but also as part
> of wiki pages, docs, etc.
>
> There are plenty of ways to "consume" the source code outside of the
> IDE and visualizing its content in many different ways is an important
> part of delivering the source code to users. Raw spec is not enough.
>
> --
> Maciej Sobczak *http://www.inspirel.com

The original wish was to have something like JavaDoc for Ada, which
just extracts the comments and strips the implementation to produce
something similar to what the Ada spec is per se.

Colouring, fonts etc. are rather more than just JavaDoc (modern
language sensitive IDEs have all this). OK, I haven't used Java for
years, so perhaps JavaDoc today is more than then.