Prev: STR912 ARM with SSD1906 TFT controller
Next: another bizarre architecture
From: larwe on 30 Jan 2007 12:27


On Jan 30, 1:19 pm, "Elan Magavi" <E...(a)nomailnospam.com> wrote:

> In 25 years I have never actually seen code with every line commented. Ever.

Me neither, though unfortunately I HAVE seen the opposite extreme more
than once :) Even worse is code like this:

write_i2c(0x68, 0xff); // write 0x27 to register 0x05 (turn off
speaker)

where the comment belongs to a source line that was cut and pasted for
use elsewhere; the args were changed but the comment was never
updated. I see a lot of this sort of thing.

The OP's request would of course not present much of a problem; I can
easily write a little program to add a comment to every single line in
the source.

Hmm. Does a macro count as code? Actually, what's a line? If I simply
put a backslash at the end of every C line, does that mean I can use a
single comment for the entire source file?

From: mInfo on 30 Jan 2007 13:28
On Jan 30, 9:19 am, "Elan Magavi" <E...(a)nomailnospam.com> wrote:
> "larwe" <zwsdot...(a)gmail.com> wrote in message
>
> news:1170167621.271945.256720(a)v45g2000cwv.googlegroups.com...
>
>
>
>
>
>
>
> > On Jan 30, 12:42 am, "mInfo" <mas...(a)limosinfo.com> wrote:
> >> On Jan 29, 1:20 pm, "larwe" <zwsdot...(a)gmail.com> wrote:
>
> >> > On Jan 29, 4:37 pm, "mInfo" <mas...(a)limosinfo.com> wrote:
>
> >> > > The resulting code must be written in C/C++ and assembler. The
> >> > > code must have commentary for each line of code. The code should be
>
> >> > Sounds like this is a school project. If it was a valid contract job,
> >> > you would not have nonsensical requirements like the above.Did you say
> >> > "nonsensical requirements like the above"? Have you ever
> >> paid attention when you were reading the text? It says absolutely
>
> > Yes. And, like most other people in this NG, I have experience doing
> > an awful lot of school projects. I also have experience doing an awful
> > lot of customer projects for people who don't know what the buzzwords
> > they are using actually mean.
>
> > If you had written "adequately commented code developed with free
> > tools" I would not have had a problem.
>
> > I'd still bet money that this is a school project cut and pasted from
> > your homework sheet, but I'll grant the outside possibility that it is
> > a legitimate (though unpalatable) contract and you are simply
> > regurgitating specification bullet points you don't really understand.
>
> In 25 years I have never actually seen code with every line commented. Ever.- Hide quoted text -
>
> - Show quoted text -

"In 25 years I have never actually seen code with every line
commented. Ever." Me neither in my 30 years of seeing the code. Are
you guys just looking for the subject to discuss, have nothing else to
do? You've gotten it!
It is absolutely obvious for everyone that it was a typo in my
message, that's all. The subject is closed now :) Who needs every line
commented (or any extra information for that matter) anyway in our
timeframe-limited life style? What's going to be next?

From: Elan Magavi on 31 Jan 2007 12:55

"mInfo" <master(a)limosinfo.com> wrote in message
news:1170181739.909014.274350(a)k78g2000cwa.googlegroups.com...
that it was a typo in my
> message, that's all. The subject is closed now :) Who needs every line
> commented (or any extra information for that matter) anyway in our
> timeframe-limited life style? What's going to be next?
>

Ok.. just be more careful in the future. ;)


First  |  Prev  | 
Pages: 1 2
Prev: STR912 ARM with SSD1906 TFT controller
Next: another bizarre architecture