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: 103376,2a687662f09731bb X-Google-Attributes: gid103376,public X-Google-Language: ENGLISH,ASCII-7-bit Path: g2news1.google.com!news1.google.com!proxad.net!infeed-1.proxad.net!news6-e.free.fr!not-for-mail Sender: sam@willow.rfc1149.net From: Samuel Tardieu Newsgroups: comp.lang.ada Subject: Re: Request for comments on simple Ada program References: <87psp1lsc4.fsf@willow.rfc1149.net> Date: 15 Nov 2005 22:55:41 +0100 Message-ID: <87d5l1lgo2.fsf@willow.rfc1149.net> User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.4 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Leafnode-NNTP-Posting-Host: 2001:660:330f:f810:211:2fff:fea6:3aa1 Organization: Guest of ProXad - France NNTP-Posting-Date: 15 Nov 2005 23:00:13 MET NNTP-Posting-Host: 81.56.47.149 X-Trace: 1132092013 news6-e.free.fr 21624 81.56.47.149:62574 X-Complaints-To: abuse@proxad.net Xref: g2news1.google.com comp.lang.ada:6409 Date: 2005-11-15T23:00:13+01:00 List-Id: >>>>> "Jacob" == Jacob Sparre Andersen writes: >> Print all primes between 2 and Potential_Prime Jacob> ... between 2 and Upper_Bound. Yeah, typo while coming up with an educative example :) Jacob> I use similar comments to separate/introduce procedures, but Jacob> what do we add by repeating the name of the procedure in the Jacob> comment? Visual effect. If you have an editor which emphasizes subprogram names a lot, they might not be needed. However, putting them let anyone browsing the code (even in plain text only) see the subprogram names immediately. Sam -- Samuel Tardieu -- sam@rfc1149.net -- http://www.rfc1149.net/sam