Path: ...!eternal-september.org!feeder3.eternal-september.org!news.eternal-september.org!.POSTED!not-for-mail
From: Lawrence D'Oliveiro <ldo@nz.invalid>
Newsgroups: comp.os.linux.advocacy,comp.os.linux.misc
Subject: Re: Can't Avoid That Shit Rust - Even On Gentoo
Date: Mon, 30 Sep 2024 06:03:29 -0000 (UTC)
Organization: A noiseless patient Spider
Lines: 14
Message-ID: <vddevg$24fps$4@dont-email.me>
References: <pan$96411$d204da43$cc34bb91$1fe98651@linux.rocks>
	<5mqdnZuGq4lgwm_7nZ2dnZfqnPSdnZ2d@earthlink.com>
	<9tDIO.25203$afc4.21891@fx42.iad> <llgvjcF5rlhU3@mid.individual.net>
	<59JIO.96321$WtV9.10707@fx10.iad> <vd8bou$15h6g$2@dont-email.me>
	<18udnd3mEtEGfGX7nZ2dnZfqnPGdnZ2d@earthlink.com>
	<vdap5d$1kp35$4@dont-email.me>
	<fcKcnSXE3MsnqWf7nZ2dnZfqnPudnZ2d@earthlink.com>
	<D0rKO.165127$EEm7.5633@fx16.iad>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Injection-Date: Mon, 30 Sep 2024 08:03:29 +0200 (CEST)
Injection-Info: dont-email.me; posting-host="a1a02b051aaecb67c07f3c0a04f3a680";
	logging-data="2244412"; mail-complaints-to="abuse@eternal-september.org";	posting-account="U2FsdGVkX1/7n8DWGY6vg22nESQ2IAjg"
User-Agent: Pan/0.160 (Toresk; )
Cancel-Lock: sha1:lgzJsvNFQ3PguSgIWu32BN3w+18=
Bytes: 1939

On Mon, 30 Sep 2024 05:52:35 GMT, Charlie Gibbs wrote:

> Be generous with comments ... [etc etc]

.... and remember they’re supposed to explain *why* the code does 
something, not just repeat *what* it does.

You’re talking to someone who has code in his collection going back over 
40 years. I learned the lessons of comments long ago.

Fun fact: I was reworking an old perpetual-calendar program I first wrote 
back in 1980, to use Fortran 90, a few months ago. And I found a bug in my 
algorithm that never showed up in any years from the 20th century, but did 
manifest itself in the 21st century.