Programming Logic and Design, Chapter 2, Using Program Comments (No Leading Letters)

current, modified, misleading

An additional responsibility regarding comments is that they must be kept _______ as a program is ________. Outdated comments can provide __________ information about a program's status.

annotation symbol, annotation symbol, three-sided box, step, dashed line, annotation symbols

In a flowchart, you can use an __________ ______ to hold information that expands on what is stored within another flowchart symbol. An annotation symbol is most often represented by a _____-_____ ___ that is connected to the ____ it references by a ______ ____. __________ _______ are used to hold comments or sometimes statements that are too long to fit neatly into a flowchart symbol.

is not, remember

Including program comments (is, is not) necessary to create a working program, but comments can help you to ________ the purpose of variables or to explain complicated calculations, especially when you come back to a program months or years after writing it. Some students do not like to include comments in their programs because it takes time to type them and they aren't part of the "real" program, but the programs you write in the future probably will require some comments. When you acquire your first programming job and modify a program written by another programmer, you will appreciate well-placed comments that explain complicated sections of the code.

nonexecuting statements, users, programmers, modifications

Program comments are _____________ __________ that help readers understand programming statements. Readers might include _____ who help you test the program and other ___________ who might have to modify your programs in the future. Even you, as the program's author, will appreciate comments when you make future _____________ and forget why you constructed a statement in a certain way.

internal documentation, external documentation

Program comments are a type of ________ _____________. This term distinguishes them from supporting documents outside the program, which are called ________ _____________.

syntax, differs, forward slashes

The ______ used to create program comments _______ among programming languages. This book starts comments in pseudocode with two _______ _______.

program comments, Program comments, are not, documentation

When you write programs, you often might want to insert _______ ________. _______ ________ are written explanations that (are, are not) part of the program logic but that serve as _____________ for readers of the program.

coded program, pseudocode, flowcharts, English-like, cryptic, program documentation, discarded

You probably will use comments in your _____ ________ more frequently than you use them in __________ or _________. For one thing, flowcharts and pseudocode are more _______-____ than the code in some languages, so your statements might be less _______. Also, your comments will remain in the program as part of the _______ _____________, but your planning tools are likely to be __________ once the program goes into production.