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-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,327f3e801a405191 X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 2002-01-13 04:01:10 PST Path: archiver1.google.com!news1.google.com!sn-xit-02!supernews.com!news.tele.dk!small.news.tele.dk!151.189.0.75!newsfeed.arcor-online.net!news.belwue.de!cert.uni-stuttgart.de!not-for-mail From: Florian Weimer Newsgroups: comp.lang.ada Subject: Re: "Javadoc" for Ada Date: 13 Jan 2002 12:59:42 +0100 Organization: RUS-CERT, University of Stuttgart, Germany Sender: rusfw@CERT.Uni-Stuttgart.DE Message-ID: <87vge6pikx.fsf@CERT.Uni-Stuttgart.DE> References: <3C413630.A2CEB446@concentric.net> NNTP-Posting-Host: skytrain.rus.uni-stuttgart.de Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: hornet.rus.uni-stuttgart.de 1010923093 24361 129.69.1.194 (13 Jan 2002 11:58:13 GMT) X-Complaints-To: abuse@cert.uni-stuttgart.de NNTP-Posting-Date: Sun, 13 Jan 2002 11:58:13 +0000 (UTC) User-Agent: Gnus/5.090001 (Oort Gnus v0.01) Emacs/21.1 Xref: archiver1.google.com comp.lang.ada:18855 Date: 2002-01-13T12:59:42+01:00 List-Id: Joseph P Vlietstra writes: > We recently updated our C/C++ preamble standards to be closer to Java > doc comments and use Doxygen (Javadoc for C++) to generate documentation. > We are considering changing our Ada preamble standards in a similar > manner. Are there any doc comment utilities for Ada similar? We use an ASIS-based tool for generating documentation. It extracts the documentation from comments, and automatically adds documented entities to the proper index. Texinfo is the markup language. The system is not comparable to JavaDoc, however, because it does not enforce structure in the documentation comments. We plan to release this tool under the GPL, but we have to sort out a few things first.