Return Styles: Pseud0ch, Terminal, Valhalla, NES, Geocities, Blue Moon. Entire thread

WTF no comments

Name: Anonymous 2008-01-15 22:42

So, I'm reading some source code from Plan 9, and I just realized that it's nearly uncommented. I expected a little more from Rob Pike.

Name: Anonymous 2008-01-16 9:18

>>9
Your example is horrible, because in the second part you explain the "what" along with the "why".

Also, explicit null-termination is a very common thing to do when handling strings in C, and therefore hardly merits a mention; the reader can just assume that it is being done for a reason (i.e. because the FOO protocol requires it) and shut up about it. I would further argue that any misunderstandings caused by this are the smaller pain in the _|_ than the maintenance load imposed by verbose commenting.

Newer Posts
Don't change these.
Name: Email:
Entire Thread Thread List