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,8e11100f675ea2df
X-Google-NewGroupId: yes
X-Google-Attributes: gida07f3367d7,domainid0,public,usenet
X-Google-Language: ENGLISH,ASCII-7-bit
X-Received: by 10.66.78.132 with SMTP id b4mr7676247pax.18.1357195245956;
        Wed, 02 Jan 2013 22:40:45 -0800 (PST)
Path: 
 6ni78887pbd.1!nntp.google.com!Xl.tags.giganews.com!border1.nntp.dca.giganews.com!nntp.giganews.com!local2.nntp.dca.giganews.com!nntp.earthlink.com!news.earthlink.com.POSTED!not-for-mail
NNTP-Posting-Date: Thu, 03 Jan 2013 00:40:45 -0600
Date: Wed, 02 Jan 2013 22:34:45 -0800
From: Charles Hixson <charleshixsn@earthlink.net>
User-Agent: Mozilla/5.0 (X11; Linux x86_64;
 rv:10.0.11) Gecko/20121122 Icedove/10.0.11
MIME-Version: 1.0
Newsgroups: comp.lang.ada
Subject: Re: asynchronous task communication
References: <1c2dnd5E6PMDR33NnZ2dnUVZ_sednZ2d@earthlink.com>
 <50e18094$0$6583$9b4e6d93@newsspool3.arcor-online.net>
 <7NednS4s2oukfXzNnZ2dnUVZ_oadnZ2d@earthlink.com>
 <aked87Fpfc1U1@mid.individual.net>
 <7cudnYloBfQDw3_NnZ2dnUVZ_rKdnZ2d@earthlink.com> <kbul1c$9bp$1@dont-email.me>
 <C4idnYdfRp48t37NnZ2dnUVZ_qadnZ2d@earthlink.com>
 <wccsj6ku421.fsf@shell01.TheWorld.com>
 <w_udnQefLbNTeX7NnZ2dnUVZ_q-dnZ2d@earthlink.com>
 <rui4vsmhmvoy$.1091h5zc4iw9o.dlg@40tude.net>
 <6bqdndEYjoxeGHnNnZ2dnUVZ_sadnZ2d@earthlink.com>
 <z3r2nhneqyjc.1jwsybu7b5118$.dlg@40tude.net>
 <MY2dnX5O5NO_TXnNnZ2dnUVZ_hudnZ2d@earthlink.com>
In-Reply-To: <MY2dnX5O5NO_TXnNnZ2dnUVZ_hudnZ2d@earthlink.com>
Message-ID: <P86dnb-drsJwunjNnZ2dnUVZ_smdnZ2d@earthlink.com>
X-Usenet-Provider: http://www.giganews.com
NNTP-Posting-Host: 216.244.16.210
X-Trace: 
 sv3-SzEytzj/CETPRotWjytswj4q2uuat3+m6Hl7gdciT2r7OmsxL78b0OD9LprTCXMx7H7EkcvdUV8MEgJ!bsy8dK92hJ2WNaUsfayxsbX5lOBbJwX/VJqaDw1HwoO0HIqOTyVAScOty/MlL88XwpdA+/xu+zb7!Axx+3K4w47QFuqE+Y5JdNQ==
X-Abuse-and-DMCA-Info: Please be sure to forward a copy of ALL headers
X-Abuse-and-DMCA-Info: Otherwise we will be unable to process your complaint
 properly
X-Postfilter: 1.3.40
X-Original-Bytes: 3041
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Date: 2013-01-02T22:34:45-08:00
List-Id: <comp.lang.ada>

On 01/02/2013 04:20 PM, Charles Hixson wrote:
> ... >
> Adabrowse can be used to produce decent end-user documentation, but I
> want developer documentation. That means documenting
> function/procedures/types/etc that only exist in *.adb files. I'm after
> something that makes it easy for me to see what routines I've written,
> what they're called, what they're for, and any notes to myself that
> aren't appropriate for compile time warnings. I want to be able to come
> back to the code in 6 months or a year and figure out what it's doing
> easily. (Not what I intended for it to do, which is what the specs give
> me. But what I actually did, and where I chose an approach because it
> was quick to do, but that needs to be updated. ... cases that aren't
> handled deserve a compile time warning, and an execution time error, but
> this for is things like an optimization that was postponed.) For this
> kind of thing my only complaint about DOxygen is that it's too verbose.
> Well, and that it doesn't handle Ada. (Actually DOxygen can produce both
> user and developer documentation, depending on how you set it to handle
> display of private variable, routines, etc. But it doesn't handle Ada.)
>
> I sure hope I can find something better than robodoc.

NaturalDocs seems to be that "something better".