Path: news.eternal-september.org!eternal-september.org!feeder3.eternal-september.org!border-4.nntp.ord.giganews.com!nntp.giganews.com!local-3.nntp.ord.giganews.com!Xl.tags.giganews.com!local-4.nntp.ord.giganews.com!news.giganews.com.POSTED!not-for-mail
NNTP-Posting-Date: Mon, 03 Mar 2025 04:19:43 +0000
Subject: Re: comments, The joy of FORTRAN
Newsgroups: alt.folklore.computers,comp.os.linux.misc
References: <59CJO.19674$MoU3.15170@fx36.iad>
 <1193769225.762545617.347047.peter_flass-yahoo.com@news.eternal-september.org>
 <j6KwP.62410$OrR5.58268@fx18.iad>
 <tcmcnTfrnOhGnFn6nZ2dnZfqn_GdnZ2d@giganews.com> <vq2fu3$6db$3@gal.iecc.com>
From: c186282 <c186282@nnada.net>
Date: Sun, 2 Mar 2025 23:19:41 -0500
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101
 Thunderbird/78.13.0
MIME-Version: 1.0
In-Reply-To: <vq2fu3$6db$3@gal.iecc.com>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Message-ID: <yI-cndUOFbNCsFj6nZ2dnZfqn_ednZ2d@giganews.com>
Lines: 41
X-Usenet-Provider: http://www.giganews.com
X-Trace: sv3-ZVWsQlptjNiGBtv+TvHMa+ofseKvZ4xJUbPJSAIPBpLEsgJpcKyysKU4YVzaofsswIm6Vvlt/X9vrut!6cKKseINp1wpOeEe/Cj0fY9ctMBIuc3HFt7/pNAfb+A0pN0I0mHdN0r3WM4aJLDLnG569fgiHyUo
X-Complaints-To: abuse@giganews.com
X-DMCA-Notifications: http://www.giganews.com/info/dmca.html
X-Abuse-and-DMCA-Info: Please be sure to forward a copy of ALL headers
X-Abuse-and-DMCA-Info: Otherwise we will be unable to process your complaint properly
X-Postfilter: 1.3.40

On 3/2/25 3:43 PM, John Levine wrote:
> According to c186282  <c186282@nnada.net>:
>>    Even 'clear' C is often NOT so clear - neither
>>    the syntax or logic. You've gotta EXPLAIN every
>>    step to yourself.
> 
> Well, yeah.
> 
> 	i += 2;	/* add 1 to index */

Actually, that adds 2 to the index  :-)

Example :

#include <stdio.h>
int main();
{
  int i=0;
  do
  {
    i += 2 ;
    printf("%d\n",i);
  }
  while (i<10);
}

.. . .

Output :

2
4
6
8
10

.. . .

So ... doc is important, but it needs to be accurate.
Best to add those comments immediately, not a day or
week later when you're already forgetting.