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,81054609038e88e3 X-Google-Attributes: gid103376,public X-Google-Language: ENGLISH,ASCII-7-bit Path: g2news1.google.com!news2.google.com!proxad.net!feeder2-1.proxad.net!news15-e.free.fr!not-for-mail Date: Sun, 10 Oct 2004 00:54:58 +0200 From: Lionel Draghi User-Agent: Mozilla/5.0 (X11; U; Linux i686; fr-FR; rv:1.7.3) Gecko/20041001 Debian/1.7.3-3 X-Accept-Language: en-us, it MIME-Version: 1.0 Newsgroups: comp.lang.ada Subject: Re: Literate Programming in Ada, AdaDoc, AdaBrowse References: <2sqmccF1oit5sU1@uni-berlin.de> In-Reply-To: <2sqmccF1oit5sU1@uni-berlin.de> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Message-ID: <41686c27$0$24703$636a15ce@news.free.fr> Organization: Guest of ProXad - France NNTP-Posting-Date: 10 Oct 2004 00:54:31 MEST NNTP-Posting-Host: 82.65.174.21 X-Trace: 1097362471 news15-e.free.fr 24703 82.65.174.21:46019 X-Complaints-To: abuse@proxad.net Xref: g2news1.google.com comp.lang.ada:4970 Date: 2004-10-10T00:54:31+02:00 List-Id: Hello Nick, NaturalDocs may be interresting for you. It partially comply with your description. You can build documentation with sources, text files, pictures, etc. The structure of the document is in a text file. The main point is that you don't need more or less akward comment conventions or tags, and that it works on illegal Ada sources. Take a look on those page, there is a slightly modified example from the Ada Quality and Style, and the corresponding html page: http://lionel.draghi.free.fr/Natural_Docs_Test/autolayout.ads http://lionel.draghi.free.fr/Natural_Docs_Test/doc/autolayout-ads.html Pages like http://lionel.draghi.free.fr/Natural_Docs_Test/doc/ are generated from simple text files. On a project not yet public, I have a documentation build from sources, some text files, and UML diagrams exported from dia in svg format. It's far from beeing perfect, the result is far from beeing pretty, but it's so easy to use, and with almost no constraint on sources. -- Lionel Draghi