21 Jul
2025
21 Jul
'25
1:07 a.m.
On 2025-07-20 20:58, Chet Ramey via COFF wrote:
On 7/20/25 5:26 PM, Warren Toomey via COFF wrote:
I concur with this. Some of the code we wrote was highly optimized
mathematical code that was far from easy to understand. Separate
documents helped but methinks our former use of noweb was better.
So this isn't a rant so much as a request
for alternate perspectives. If
you have a spartan commenting style, why? Can you read your code and see
all the implications, or do you dislike lots of comments, or do you write
more external documentation etc.?
I think the age of my code base stacks up pretty well, and I find myself
commenting what I think are the complex parts and changes very heavily.
Above all, I want to be able to answer this question from my future self:
what the hell were you thinking? I find that I'm not nearly as clever as my
younger self.
+1
S.
Detailed change log entries are essential as well.
Chet