Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > comp.lang.python > #197630
| Date | 2025-12-19 00:29 -0500 |
|---|---|
| Subject | Re: Python |
| Newsgroups | comp.os.linux.misc, alt.folklore.computers, comp.lang.python |
| References | (20 earlier) <mqegqtFl85nU6@mid.individual.net> <CcCcnbUCnYYD-N_0nZ2dnZfqn_SdnZ2d@giganews.com> <mqgdu2Fng8U3@mid.individual.net> <fsidnRnSK9Uz7d70nZ2dnZfqnPednZ2d@giganews.com> <10i13o0$c16d$1@dont-email.me> |
| From | c186282 <c186282@nnada.net> |
| Organization | wokiesux |
| Message-ID | <DeicnTTwGb40f9n0nZ2dnZfqn_udnZ2d@giganews.com> (permalink) |
Cross-posted to 3 groups.
On 12/18/25 09:40, Peter Flass wrote: > On 12/17/25 20:10, c186282 wrote: >> On 12/17/25 14:17, rbowman wrote: >>> On Wed, 17 Dec 2025 03:11:09 -0500, c186282 wrote: >>> >>>> Probably 50% of the text in my code - doesn't matter which lang >>>> - is >>>> 'comments'. >>> >>> I looked at some of my code and it's pretty much comment free. There >>> are a >>> couple of .c files with comments that I reused from another project that >>> have somebody's comments. >>> >>> I had a tendency to clone similar projects and inherit some code that I >>> could tweak so the final executable did one thing well. We had a >>> couple of >>> nightmares that originally did one thing well but for the next >>> project the >>> programmer said 'That's close to what I need. A few configuration values >>> here and there and it will work.' The next time around it got some more >>> configuration values to do something else. I have a Swiss Army knife I >>> found; it's in the junk drawer. >> >> >> 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. >> > > I comment *A LOT*. When I had to go back and revisit some very old code, > I wished I had commented more. I've almost never looked at a program and > said "I wish it had fewer comments." Ah, you live in the Real World :-) Maybe SOME here have eidetic memory and have crystal perfect comprehension about how their huge 1975 COBOL opus worked ... A few of us need enough detailed comments to work us through the steps and reasoning again ... Hmm ... have one Python function floating around where the actual code is about 6 lines - but there's about 30 comment lines above it explaining how/why it works AND little helper comments after every line :-) It was a really crushed-down way of splicing one directory tree into another at the exact right place - string+math trix - came to me while riding a motorcycle down an interstate highway. Good for backup stuff. BUT, needed to EXPLAIN it to myself, WHY it worked before I forgot, and there's ONE little gotcha that needed some elaboration. Did translate it into Pascal and 'C', but it's bigger in 'C' because of the ruder string-handling. I think the Pascal version had a couple extra lines to get around the gotcha. Gotta look up some of my old stuff again ..... Anyway, FAR easier to UNDER-comment than OVER-comment.
Back to comp.lang.python | Previous | Next — Previous in thread | Next in thread | Find similar
Re: Python Lawrence D’Oliveiro <ldo@nz.invalid> - 2025-12-14 23:29 +0000
Re: Python mm0fmf <none@invalid.com> - 2025-12-15 12:57 +0000
Re: Python Alexander Schreiber <als@usenet.thangorodrim.de> - 2025-12-15 22:57 +0100
Re: Python c186282 <c186282@nnada.net> - 2025-12-15 22:31 -0500
Re: Python Greg Ewing <greg.ewing@canterbury.ac.nz> - 2025-12-16 17:51 +1300
Re: Python rbowman <bowman@montana.com> - 2025-12-16 08:32 +0000
Re: Python Lawrence D’Oliveiro <ldo@nz.invalid> - 2025-12-16 21:45 +0000
Re: Python rbowman <bowman@montana.com> - 2025-12-17 01:54 +0000
Re: Python c186282 <c186282@nnada.net> - 2025-12-17 03:11 -0500
Re: Python rbowman <bowman@montana.com> - 2025-12-17 19:17 +0000
Re: Python c186282 <c186282@nnada.net> - 2025-12-17 22:10 -0500
Re: Python John Levine <johnl@taugh.com> - 2025-12-18 03:28 +0000
Re: Python c186282 <c186282@nnada.net> - 2025-12-17 23:02 -0500
Re: Python rbowman <bowman@montana.com> - 2025-12-18 06:54 +0000
Re: Python c186282 <c186282@nnada.net> - 2025-12-18 04:25 -0500
Re: Python rbowman <bowman@montana.com> - 2025-12-18 19:22 +0000
Re: Python c186282 <c186282@nnada.net> - 2025-12-19 01:14 -0500
Re: Python rbowman <bowman@montana.com> - 2025-12-18 06:44 +0000
Re: Python Peter Flass <Peter@Iron-Spring.com> - 2025-12-18 07:40 -0700
Re: Python Richard Kettlewell <invalid@invalid.invalid> - 2025-12-18 18:00 +0000
Re: Python rbowman <bowman@montana.com> - 2025-12-18 18:28 +0000
Re: Python Peter Flass <Peter@Iron-Spring.com> - 2025-12-18 12:52 -0700
Re: Python rbowman <bowman@montana.com> - 2025-12-19 03:53 +0000
Re: Python c186282 <c186282@nnada.net> - 2025-12-19 00:37 -0500
Re: Python "Michael F. Stemper" <michael.stemper@gmail.com> - 2026-03-04 10:32 -0600
Comments (was: Python) ram@zedat.fu-berlin.de (Stefan Ram) - 2026-03-04 17:17 +0000
Re: Python ted@loft.tnolan.com (Ted Nolan <tednolan>) - 2026-03-04 20:01 +0000
Re: Python "Carlos E.R." <robin_listas@es.invalid> - 2026-03-04 21:29 +0100
Re: Python Lawrence D’Oliveiro <ldo@nz.invalid> - 2026-03-04 20:37 +0000
Re: Python Peter Flass <Peter@Iron-Spring.com> - 2026-03-04 14:09 -0700
Re: Python Lawrence D’Oliveiro <ldo@nz.invalid> - 2026-03-04 22:35 +0000
Re: Python Nuno Silva <nunojsilva@invalid.invalid> - 2026-03-04 23:10 +0000
Re: Python c186282 <c186282@nnada.net> - 2026-03-04 20:30 -0500
Re: Python Peter Flass <Peter@Iron-Spring.com> - 2026-03-04 20:13 -0700
Re: Python Lawrence D’Oliveiro <ldo@nz.invalid> - 2026-03-05 03:49 +0000
Re: Python Charlie Gibbs <cgibbs@kltpzyxm.invalid> - 2026-03-05 17:42 +0000
Re: Python "Carlos E.R." <robin_listas@es.invalid> - 2026-03-05 20:02 +0100
Re: Python c186282 <c186282@nnada.net> - 2026-03-05 14:42 -0500
Re: Python Nuno Silva <nunojsilva@invalid.invalid> - 2026-03-06 00:12 +0000
Re: Python Bob Eager <news0009@eager.cx> - 2026-03-06 09:02 +0000
Re: Python Charlie Gibbs <cgibbs@kltpzyxm.invalid> - 2026-03-05 02:44 +0000
Re: Python Lawrence D’Oliveiro <ldo@nz.invalid> - 2026-03-05 03:50 +0000
Re: Python Piergiorgio Sartor <piergiorgio.sartor.this.should.not.be.used@nexgo.REMOVETHIS.de> - 2026-03-04 22:14 +0100
Re: Python The Natural Philosopher <tnp@invalid.invalid> - 2026-03-04 22:20 +0000
Re: Python c186282 <c186282@nnada.net> - 2025-12-19 00:29 -0500
Re: Python "Carlos E.R." <robin_listas@es.invalid> - 2025-12-20 12:38 +0100
Re: Python Dan Espen <dan1espen@gmail.com> - 2025-12-17 16:17 -0500
Re: Python Lawrence D’Oliveiro <ldo@nz.invalid> - 2025-12-17 22:11 +0000
Re: Python c186282 <c186282@nnada.net> - 2025-12-17 22:18 -0500
Re: Python rbowman <bowman@montana.com> - 2025-12-18 07:07 +0000
Re: Python Richard Kettlewell <invalid@invalid.invalid> - 2025-12-17 22:13 +0000
Re: Python rbowman <bowman@montana.com> - 2025-12-18 00:52 +0000
Re: Python Marc Haber <mh+usenetspam1118@zugschl.us> - 2025-12-18 08:03 +0100
Re: Python rbowman <bowman@montana.com> - 2025-12-18 07:39 +0000
Re: Python scott@slp53.sl.home (Scott Lurndal) - 2025-12-18 15:43 +0000
Re: Python rbowman <bowman@montana.com> - 2025-12-18 18:38 +0000
Re: Python c186282 <c186282@nnada.net> - 2025-12-19 00:56 -0500
Re: Python rbowman <bowman@montana.com> - 2025-12-19 08:18 +0000
Re: Python c186282 <c186282@nnada.net> - 2025-12-19 03:30 -0500
Re: Python rbowman <bowman@montana.com> - 2025-12-19 19:38 +0000
Re: Python c186282 <c186282@nnada.net> - 2025-12-20 04:01 -0500
Re: Python rbowman <bowman@montana.com> - 2025-12-21 04:08 +0000
Re: Python "Carlos E.R." <robin_listas@es.invalid> - 2025-12-27 22:36 +0100
i3 (was: Python) Axel Reichert <mail@axel-reichert.de> - 2025-12-19 08:57 +0100
Re: Python The Natural Philosopher <tnp@invalid.invalid> - 2025-12-18 09:55 +0000
Re: Python Marc Haber <mh+usenetspam1118@zugschl.us> - 2025-12-18 11:19 +0100
Re: Python The Natural Philosopher <tnp@invalid.invalid> - 2025-12-18 12:36 +0000
csiph-web