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,2b909902584f450a X-Google-Attributes: gid103376,domainid0,public,usenet X-Google-Language: ENGLISH,ASCII-7-bit Path: g2news1.google.com!news3.google.com!feeder.news-service.com!news2.euro.net!newsfeed.freenet.de!newsfeed01.chello.at!newsfeed.arcor.de!newsspool1.arcor-online.net!news.arcor.de.POSTED!not-for-mail From: "Dmitry A. Kazakov" Subject: Re: ANN: Basil -- Internet Message (email) and MIME library for Ada v 1.0 Newsgroups: comp.lang.ada User-Agent: 40tude_Dialog/2.0.15.1 MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Reply-To: mailbox@dmitry-kazakov.de Organization: cbb software GmbH References: <3d42731b-4669-414e-87cc-454260ef62ec@d1g2000hsg.googlegroups.com> <1ff77708-02c3-4552-a8a0-128a7fc34581@27g2000hsf.googlegroups.com> <877ibdhm4g.fsf@ludovic-brenta.org> <4426acc1-81ba-4b82-b53d-fbf11b66e51f@z66g2000hsc.googlegroups.com> <9c8cfef5-fa43-4de1-9d20-4fe466186e5e@z66g2000hsc.googlegroups.com> <6er3r9F8f7psU1@mid.individual.net> <4888b373$0$9499$9b4e6d93@newsspool3.arcor-online.net> <6ets6sF8mbmbU1@mid.individual.net> <1r3p2b50a9dg6$.jiw25d2jmzu1.dlg@40tude.net> <6f5c3cF9onjlU1@mid.individual.net> Date: Mon, 28 Jul 2008 10:18:10 +0200 Message-ID: NNTP-Posting-Date: 28 Jul 2008 10:18:10 CEST NNTP-Posting-Host: c037b01f.newsspool1.arcor-online.net X-Trace: DXC=M86^B7e:TO\=>bdbdS?M0Yic==]BZ:af^4Fo<]lROoRQ4nDHegD_]RU7kgRoQ2;QkcU?_T X-Complaints-To: usenet-abuse@arcor.de Xref: g2news1.google.com comp.lang.ada:1361 Date: 2008-07-28T10:18:10+02:00 List-Id: On Mon, 28 Jul 2008 09:52:48 +0200, Alex R. Mosteo wrote: > Dmitry A. Kazakov wrote: > >> On Fri, 25 Jul 2008 13:38:26 +0200, Alex R. Mosteo wrote: >> >>> Dmitry A. Kazakov wrote: >>> >>> Incidentally, are you using some software to generate these webpages from >>> source code? >> >> Unfortunately no. I am lazy to write or else modify an existing one. But >> for all, I miss a concept of how this could be done. I mean tearing the >> comments from the sources in not enough to generate a readable text. > > I guess it can be done if you start commenting with this purpose in mind. Many > libraries' docs simply are Doxygen processed sources. Certainly the results > are in a wide range of polish. Right, and after that you have a dead end, because when sources get modified you need to start from the beginning. The only way, I can think of, is an integration into a source code management system which would keep track of the changes in the sources and in the docs, being aware of the dependencies between them. Unfortunately the systems I saw and deployed were close to unusable even for managing sources... (:-)) > Yours look really neat, Thanks > so I wondered if you were using AdaBrowse or some of > the other options out there for Ada. Yes, GNAT Pro has an integrated documentation generation. -- Regards, Dmitry A. Kazakov http://www.dmitry-kazakov.de