Email: Password: Remember Me | Create Account (Free)

Back to Subject List

Old thread has been locked -- no new posts accepted in this thread
???
12/08/05 14:43
Modified:
  12/08/05 15:01

Read: times


 
#104886 - "anyone" and the point
Responding to: ???'s previous message
however, you are probably missing a point here.
I do not know what point I am missing, I stated:
"explanations" may be useful in working towards deciphereing some crappy code, they still are not "comments".

If you in any other context than "deciphering some crappy code" and in original source saw:
mov a,#64h ;move 100 to the accumulator
would you call that a comment?

"There’s a spec somewhere - perhaps only in the developer’s head - which describes in English what a function should do in a human-friendly manner. The code is a translation of that spec to cryptic and unforgiving computerese. So I figure the way to write a function is to create all of the comments first. The header, and even all of the individual little snippets of English spread throughout the code. Then the function’s design is done.

After that, anyone can fill in the code."

Oh yes, THIS is the IT managers' view. Should every program I wrote be of this simplistic/static/mechanistic case, I would have no job today, all has been already done... or would be "filled in by anybody"...


I think the point Jack makes here is that if comments are what they should be, then the above will be true.

HOWEVER, I doubt very much that it means "any idiot can fill in the code in a qualified manner".

Sometimes to make a point an exaggaration is necessary.

If i had the choice between "complete, accurate, well written comments" and "actual code" I would prefer the first to the second in case I were to use someone elses program as a 'reference".

Erik

List of 30 messages in thread
TopicAuthorDate
week puzzle V            01/01/70 00:00      
   that would be intersating only to codebr            01/01/70 00:00      
      codebreakers            01/01/70 00:00      
         busted            01/01/70 00:00      
   having a guess            01/01/70 00:00      
   Hmm,isn't it demotivating to reengineer?            01/01/70 00:00      
      Cool algorithm            01/01/70 00:00      
      maybe            01/01/70 00:00      
   Looks like BCD to binary routine            01/01/70 00:00      
   My assumption            01/01/70 00:00      
   The source with comments !            01/01/70 00:00      
      thanks            01/01/70 00:00      
         Seems more elegant ...            01/01/70 00:00      
            optimized=ugly            01/01/70 00:00      
         why "xrl a,#0F0h" ?            01/01/70 00:00      
            Wow!            01/01/70 00:00      
         A bit shorter ...            01/01/70 00:00      
            za Slobodana Mandarica            01/01/70 00:00      
      another approach            01/01/70 00:00      
         optimizing further            01/01/70 00:00      
            packed bcd            01/01/70 00:00      
               packed bcd... by specification :-)            01/01/70 00:00      
      that is not comments, that is "explanati            01/01/70 00:00      
         true if            01/01/70 00:00      
         Yes they are Comments            01/01/70 00:00      
            Exactly !            01/01/70 00:00      
            I have seen such called "comments" way t            01/01/70 00:00      
               more on comments            01/01/70 00:00      
                  the point            01/01/70 00:00      
                     "anyone" and the point            01/01/70 00:00      

Back to Subject List