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-Language: ENGLISH,ASCII Path: g2news1.google.com!news3.google.com!feeder.news-service.com!xlned.com!feeder1.xlned.com!news.netcologne.de!newsfeed-fusi2.netcologne.de!news.mixmin.net!aioe.org!not-for-mail From: =?iso-8859-15?Q?Hibou57_=28Yannick_Duch=EAne=29?= Newsgroups: comp.lang.ada Subject: Re: Ada and Doxygen Date: Thu, 25 Feb 2010 16:02:16 +0100 Organization: At Home Message-ID: References: <4b84fb09$0$6579$9b4e6d93@newsspool3.arcor-online.net> <3fce72e0-ac88-4900-80bc-4a15ac607cfd@k18g2000prf.googlegroups.com> NNTP-Posting-Host: LgmlzkxO8f1oyw4OqQt/kw.user.speranza.aioe.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-15; 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.10 (Win32) Xref: g2news1.google.com comp.lang.ada:9323 Date: 2010-02-25T16:02:16+01:00 List-Id: Le Thu, 25 Feb 2010 14:31:47 +0100, Marco a =E9= crit: > Yes for all but the most trivial applications (the term program is > too simplistic) some sort of external documentation is needed. While you may also guess/feel it's needed, even facing a trivial = application. You can infer the efficiency of a method from a trivial cas= e, = as long as you mind is not tied to this trivial case (that comment is = anecdotal, but it was in my mind, and it is for long) > Can > this some-how be tied to the code so a simple refactor of a package > name or public parameter would just be updated automatically? Please, I need to understand more about what you were to say : do you me= an = update of the documentation or automatic refactoring operations while = editing source ? What kind of synch were you thinking about exactly ? -- = No-no, this isn't an oops ...or I hope (TM) - Don't blame me... I'm just= = not lucky