On Sun, 24 Aug 2025 11:39:10 +0100, Jonathan Scott <jonathan.scott...@gmail.com> wrote:
>And comments are essential not just for future readers of the code, but also >to ensure >that the person writing the code can explain what they are doing, ensuring >they >have a full understanding. I generally wrote the block comments before I >wrote the code. Funny you say this about comments. The GCC and GLIBC compiler guys are the worst about comments in code which needs comments. Why is the only function with comments called error( ) and the comment says it's a common error function. Duh! The copyright notice is included but scant more at times. We talk about language optimization, but I doubt compiler guys write much of this code. Optimization is often hardware specific and It feels as if this code is written by who doesn't specialize in compiler internals. I love that you say "the person writing the code can explain" because that is a very IBM specific statement. When living in the open source world, it's very different. All this effort to build products but you never see a video that teaches people how to comment code irrespective of the language and build some standards.
