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=-0.9 required=5.0 tests=BAYES_00,FORGED_GMAIL_RCVD, FREEMAIL_FROM autolearn=no 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!35g2000prt.googlegroups.com!not-for-mail From: Maciej Sobczak Newsgroups: comp.lang.ada Subject: Re: Ada documentation tools. Date: Mon, 15 Nov 2010 01:47:38 -0800 (PST) Organization: http://groups.google.com Message-ID: References: NNTP-Posting-Host: 137.138.182.236 Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 X-Trace: posting.google.com 1289814458 10567 127.0.0.1 (15 Nov 2010 09:47:38 GMT) X-Complaints-To: groups-abuse@google.com NNTP-Posting-Date: Mon, 15 Nov 2010 09:47:38 +0000 (UTC) Complaints-To: groups-abuse@google.com Injection-Info: 35g2000prt.googlegroups.com; posting-host=137.138.182.236; posting-account=bMuEOQoAAACUUr_ghL3RBIi5neBZ5w_S User-Agent: G2/1.0 X-HTTP-UserAgent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.2.10) Gecko/20100914 Firefox/3.6.10,gzip(gfe) Xref: g2news1.google.com comp.lang.ada:15499 Date: 2010-11-15T01:47:38-08:00 List-Id: On 14 Lis, 23:26, "Peter C. Chapin" wrote: > I'm looking for a tool that can extract nicely formatted documentation > from Ada sources + comments. I'm looking for something that is similar > in nature to Doxygen or Javadoc. It should be free and it should work on > Windows. I'm aware of AdaDoc, AdaBrowse, and the documentation generator > available in GPS. I'm wondering if there are any others I should be > looking at With a risk of shameless plug, I will kindly point you to the online docs for YAMI4: http://www.inspirel.com/yami4/doc/ada/ These pages were generated directly from *.ads files by a very simple Tcl script that I have written explicitly for this purpose. I was not satisfied with the visual presentation style offered by other tools. The interesting thing about this script is that contrary to other tools, it does not perform any sophisticated analysis of the spec source - it only follows some simple text formatting patterns like indentation and vertical whitespace. On one hand you can consider this to be a severe limitation, but on the other hand this can be a motivation to actually format the source code properly. It works well for me. The script is not published anywhere, but I will share it with anybody who needs it, just contact me off the list. -- Maciej Sobczak * http://www.inspirel.com