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!news3.google.com!news.glorb.com!newsfeed.stueberl.de!ecngs!feeder.ecngs.de!217.19.16.137.MISMATCH!feeder2.cambrium.nl!feed.tweaknews.nl!proxad.net!infeed-1.proxad.net!news8-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:53:34 +0100 Message-ID: <87hdadlgrl.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 22:55:03 MET NNTP-Posting-Host: 81.56.47.149 X-Trace: 1132091703 news8-e.free.fr 29517 81.56.47.149:53179 X-Complaints-To: abuse@proxad.net Xref: g2news1.google.com comp.lang.ada:6408 Date: 2005-11-15T22:55:03+01:00 List-Id: >>>>> "Jacob" == Jacob Sparre Andersen writes: Jacob> Jacob (who believes that the optimal comment/code ratio is Jacob> zero) It depends. Sometimes (particularily when doing embedded stuff), you do have to comment the tricks you resort to. When I do some low-level Ada or Forth programming for microcontrollers, some of the words (that I need to optimize for performance) really need comments. If not for me (the author of the code), at least for others. What I do in general is reread every code I write one week later. Each time I ask myself "why did I do this?", even for one second, I add a comment. My experience shows that even when I go through the code one year later, I have no question that are not already answered in the comments. Sam -- Samuel Tardieu -- sam@rfc1149.net -- http://www.rfc1149.net/sam