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,FREEMAIL_FROM autolearn=ham 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,UTF8 Path: g2news2.google.com!news3.google.com!feeder.news-service.com!feeder.news-service.com!94.75.214.39.MISMATCH!aioe.org!not-for-mail From: =?utf-8?Q?Yannick_Duch=C3=AAne_=28Hibou57?= =?utf-8?Q?=29?= Newsgroups: comp.lang.ada Subject: Re: Ada documentation tools. Date: Thu, 18 Nov 2010 00:06:48 +0100 Organization: Ada @ Home Message-ID: References: <6f234690-e21d-4d78-8dba-c017976029e9@z17g2000prz.googlegroups.com> <80dacf60-a610-4004-9298-69751bbfcaea@j12g2000prm.googlegroups.com> <8cdfee44-a675-46a3-b850-77661400dbc8@j9g2000vbr.googlegroups.com> <1c9aff07-3b32-4492-bd33-7f826bd47e10@f16g2000prj.googlegroups.com> <4ce14a1f$0$7667$9b4e6d93@newsspool1.arcor-online.net> NNTP-Posting-Host: w00cPq0BvzOlRCSRJJEoeQ.user.speranza.aioe.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed; delsp=yes Content-Transfer-Encoding: Quoted-Printable X-Complaints-To: abuse@aioe.org X-Notice: Filtered by postfilter v. 0.8.2 User-Agent: Opera Mail/10.63 (Win32) Xref: g2news2.google.com comp.lang.ada:16533 Date: 2010-11-18T00:06:48+01:00 List-Id: Le Mon, 15 Nov 2010 15:56:31 +0100, Georg Bauhaus = a =C3=A9crit: > tools that address proper comments. And do it formally, > otherwise documentation is necessarily bricolage. You really have that word in English too, =E2=80=9Cbricolage=E2=80=9D. F= unny. I have opened a similar topic some times ago, it was not welcomed as I = expected. I would like too, to have a standard to tag Ada comments. At t= he = time of that older topic, I though about Doxygen, which seemed to be = enough language neutral, but did not go further nor I really evaluated i= t. = May be the Java convention could be re-used straight as-is in Ada, as ma= ny = people know these. -- = Si les chats miaulent et font autant de vocalises bizarres, c=E2=80=99es= t pas pour = les chiens. =E2=80=9CI am fluent in ASCII=E2=80=9D [Warren 2010]