Path: csiph.com!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail From: rbowman Newsgroups: comp.os.linux.misc,alt.folklore.computers,comp.lang.python Subject: Re: Python Date: 18 Dec 2025 06:44:13 GMT Lines: 25 Message-ID: References: <10hvsd2$11k4$2@gal.iecc.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Trace: individual.net careKfav+wrW2bg/E0dWzA87+dESbxm6iDBgFMtjZlfpg1bK1n Cancel-Lock: sha1:PVqW8jYnVCer1m9Eod8VxL33mYE= sha256:P43/9OfrysGV1TF5iO1WC86KHRFH81jbgsrUEq4u51I= User-Agent: Pan/0.162 (Pokrosvk) Xref: csiph.com comp.os.linux.misc:79417 alt.folklore.computers:232665 comp.lang.python:197613 On Thu, 18 Dec 2025 03:28:34 -0000 (UTC), John Levine wrote: > According to c186282 : >> Well ... I'll better understand, and be able to mod, my old programs >> better than you. I find 'excessive' commenting anything BUT >> 'excessive'. I *enjoy* writing out the meaning and implications of >> almost every step. > > That's fine as long as it's done with adequate discipline > > i += 2; /* add one more bloofus to i */ /** obtain the list of units for the passed in object */ list_ret_val = (list_obj_ret *)ListObj(&obj_s, OTUnit); That's an actual example of a comment that doesn't add anything to the discussion. If you don't know what ListObj() does, the structure of the linked list it returns, or that you have to cast the data field of the linked list to a UnitStruct, that comment isn't going to help. If you do know it's readily apparent you're passing in a Cfs object to get the list of units attached to it. Doing a quick and dirty search there are 1752 calls to ListObj in the codebase very few of which are commented. If you're doing something quirky, comment it.