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: a07f3367d7,8e11100f675ea2df X-Google-Attributes: gida07f3367d7,public,usenet X-Google-NewGroupId: yes X-Google-Language: ENGLISH,ASCII X-Received: by 10.180.97.198 with SMTP id ec6mr11257958wib.5.1357207264751; Thu, 03 Jan 2013 02:01:04 -0800 (PST) Path: i11ni349281wiw.0!nntp.google.com!feeder1.cambriumusenet.nl!feed.tweaknews.nl!193.141.40.65.MISMATCH!npeer.de.kpn-eurorings.net!npeer-ng0.de.kpn-eurorings.net!news.mixmin.net!eternal-september.org!feeder.eternal-september.org!mx04.eternal-september.org!.POSTED!not-for-mail From: "J-P. Rosen" Newsgroups: comp.lang.ada Subject: Re: asynchronous task communication Date: Thu, 03 Jan 2013 11:01:09 +0100 Organization: A noiseless patient Spider Message-ID: References: <1c2dnd5E6PMDR33NnZ2dnUVZ_sednZ2d@earthlink.com> <50e18094$0$6583$9b4e6d93@newsspool3.arcor-online.net> <7NednS4s2oukfXzNnZ2dnUVZ_oadnZ2d@earthlink.com> <7cudnYloBfQDw3_NnZ2dnUVZ_rKdnZ2d@earthlink.com> <6bqdndEYjoxeGHnNnZ2dnUVZ_sadnZ2d@earthlink.com> Mime-Version: 1.0 Injection-Date: Thu, 3 Jan 2013 10:01:04 +0000 (UTC) Injection-Info: mx04.eternal-september.org; posting-host="da91dd38436bbbf5b448e21e8f29aa94"; logging-data="2754"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX18TZF9+exetIVMKAhBBxUci" User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/17.0 Thunderbird/17.0 In-Reply-To: Cancel-Lock: sha1:DIQZ90BLVDXzopvw+SNpr7ustEg= X-Enigmail-Version: 1.4.6 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 8bit Date: 2013-01-03T11:01:09+01:00 List-Id: Le 03/01/2013 01:20, Charles Hixson a �crit : > Adabrowse can be used to produce decent end-user documentation, but I > want developer documentation. That means documenting > function/procedures/types/etc that only exist in *.adb files. Just put comments after the specification. These will show up when you fly over any occurrence of the subprogram name in GPS - Very convenient > I'm after > something that makes it easy for me to see what routines I've written, > what they're called, what they're for, The outline view in GPS shows you this - and the flyover feature of GPS works there too > and any notes to myself that > aren't appropriate for compile time warnings. I want to be able to come > back to the code in 6 months or a year and figure out what it's doing > easily. Especially for implementation, nothing beats appropriate (repeat: "appropriate") comments in the code. -- J-P. Rosen Adalog 2 rue du Docteur Lombard, 92441 Issy-les-Moulineaux CEDEX Tel: +33 1 45 29 21 52, Fax: +33 1 45 29 25 00 http://www.adalog.fr