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

Back to Subject List

Old thread has been locked -- no new posts accepted in this thread
???
12/06/05 13:05
Read: times


 		 #104759 - I have seen such called "comments" way t
Responding to: ???'s previous message
Erik Malund said:
that is not comments, that is "explanations".

If anyone need a comment like
Save This Code
mov b,#64h ; Mply by 100 
mul ab
they should not even attempt to look at this.

Why not? Use of comment is to explain...


I have seen such called "comments" way too often, while, as indicated, "explanations" may be useful in working towards deciphereing some crappy code, they still are not "comments". That something is place in the comment field of a line of code does not make it a comment.

I have seen source code where there were zero, nada none comments, but every line had a "comment" such as
Save This Code
    push acc ;save accumulator
and when confronting the author he replied 'what is your problem I commented the whole thing".

This is, unfortunately, way too common writing comments for the sake of writing comments, not for the sake of making the program easier to follow.

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