syque.com

The Psychology of Quality and More

| Menu | Books | Share | Search | Settings |

C Style: Standards and Guidelines (contents)

Part 2 : Commenting and Naming

CHAPTER 4 : Commenting
CHAPTER 5 : Naming
 

PART 3 : LAYOUT

<-- Prev page | Next page -->

<-- Prev part | Next part -->

 

The comments around the code and the names of identifiers used within the code together constitute the readable English in a program. Individually and collectively they explain to the reader what is happening. The comments allow explanation around a point, setting the context and giving reasons for what is about to happen or has just happened. The identifiers are more succinct, being constrained to being a part of the code, but which when well named can make the code read clearly and make its operation and purpose more understandable. It is thus well worth the additional effort required to make the code and comments literally more readable.

 

<-- Prev page | Next page -->

 

Site Menu

| Home | Top | Settings |

Quality: | Quality Toolbook | Tools of the Trade | Improvement Encyclopedia | Quality Articles | Being Creative | Being Persuasive |

And: | C Style (Book) | Stories | Articles | Bookstore | My Photos | About | Contact |

Settings: | Computer layout | Mobile layout | Small font | Medium font | Large font | Translate |

 

You can buy books here

More Kindle books:

And the big
paperback book


Look inside

 

Please help and share:

 

| Home | Top | Menu |

© Changing Works 2002-
Massive Content -- Maximum Speed