Re: asynchronous task communication

[Charles Hixson <charleshixsn@earthlink.net>]

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".