Special

Introducing the “Welcome to Xojo” Bundle!

New to Xojo and looking for guidance? We've put together a terrific bundle to welcome you! Xojo Bundle

This bundle includes six back issues of the magazine -- all of year 21 in printed book and digital formats -- plus a one-year subscription (beginning with 22.1) so you'll be learning all about Xojo for the next year. It's the perfect way to get started programming with Xojo. And you save as much as $35 over the non-bundle price!

This offer is only available for a limited time as supplies are limited, so hurry today and order this special bundle before the offer goes away!

Article Preview


Buy Now

Issue 7.2

FEATURE

Comments on Comments

Exploring the benefits of better commenting

Issue: 7.2 (January/February 2009)
Author: Marc Zeedar
Author Bio: Marc taught himself programming in high school when he bought his first computer but had no money for software. He's had fun learning ever since.
Article Description: No description available.
Article Length (in bytes): 26,940
Starting Page Number: 18
Article Number: 7209
Related Link(s): None

Excerpt of article text...

One of my first puzzlements when learning to program in BASIC a couple decades ago was the bizarrely-named REM command. REM apparently allowed you to add a "remark" about the code -- any text following the word REM was ignored when the code was executed. This seemed useless to me except for vanity: almost all BASIC programs back in those days began with a few comments that listed the name of the program, the author, and the copyright. Other than that, what good were comments?

I've come a long way since those heady days, but I still struggle with comments. Comments are like flossing -- a healthy habit most people don't do often enough.

We all know that comments can be helpful. If you've ever seen a well-commented program you know that the comments help make what's going on more clear. If you've ever looked at non-commented code -- even of one of your own projects -- and been bewildered, you know the pain of not having good comments.

...End of Excerpt. Please purchase the magazine to read the full article.