6.9. Tracing

Trace prints must be controllable [TRACE-CONTROL]

A trace print is a statement or sequence of statements that are present for debugging. Such prints can be left in the program, but it must be easy to turn them on or off. Write if(trace > 0) { ... } where trace is an integer global variable that indicates the level of tracing, and 0 might be replaced by 1, 2, etc.

Do not comment out traces [TRACE-COMMENT]

A trace print should be left in the program but made controllable. It should not be commented out.

Write traces to standard output [TRACE-FILE]

For this class, write all trace prints to the standard output. (Larger programs often have provisions to write traces to files.)

What to show in a trace print [TRACE-INFO]

Every trace print should show: The name of the function that contains the print; An indication of where the trace occurs; An indication of what the values being shown represent, if any values are shown; Values being shown, if any; A newline, if appropriate, so that trace prints are not run together on the same line. For example, a trace print that occurs at the beginning of a loop body in function getCompatibility might look like the following. if(trace > 0) { printf("getCompatibility: [top of loop] working on k = %i\n", k); }