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.3 required=5.0 tests=BAYES_00, REPLYTO_WITHOUT_TO_CC autolearn=no 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!news1.google.com!newsfeed.stanford.edu!newsmi-us.news.garr.it!NewsITBone-GARR!area.cu.mi.it!news.newsland.it!proxad.net!feeder2-1.proxad.net!news19-e.free.fr!not-for-mail From: stephane@_delete_this_rochebrune.org (Stephane Riviere) Newsgroups: comp.lang.ada Subject: Re: Literate Programming in Ada, AdaDoc, AdaBrowse Date: Tue, 12 Oct 2004 17:29:45 GMT Organization: rochebrune Reply-To: stephane@_delete_this_rochebrune.org Message-ID: <416c124a.917969@news.free.fr> References: <2sqmccF1oit5sU1@uni-berlin.de> <4168e585.146011813@news.free.fr> X-Newsreader: Forte Agent 1.5/32.451 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit NNTP-Posting-Date: 12 Oct 2004 19:30:04 MEST NNTP-Posting-Host: 62.147.88.79 X-Trace: 1097602204 news19-e.free.fr 6475 62.147.88.79:1043 X-Complaints-To: abuse@proxad.net Xref: g2news1.google.com comp.lang.ada:5124 Date: 2004-10-12T19:30:04+02:00 List-Id: >Does AdaDoc require that the description be before the declaration, or >can it be after too? I find it more natural to put it after, like this: I fully agree with you, but today, you should do this way (put comments before the declaration). Note I'm just the author of the Texinfo module. AdaDoc has been written by Julien Burdy and Vincent ... (sorry, I remember only his surname). >In my opinion, writing the description before the declaration breaks the >text flow in about the same way as top-posting does. Again, you're right. I think it could be changed. Help needed. Anyway the AIDE documentation toolset proposed is already very powerfull and save huge amount of stupid work while vastly increase tech. doc. accuracy... -- Stephane Riviere Oleron Island - France http://stephane.rochebrune.org OpenPgp Key <5fd6a1e6> available on the web site above