Section: Robots, Real and Imagined
...Subsection: Comments = Documentation

Although Shakey will be carrying out the instructions in your program, humans may also read the code you write. Naturally, this includes your instructor, but it also includes you yourself. Consequently, the language allows us to insert annotations within the code. These annotations are called , and they are completely overlooked by Shakey. Comments serve to explain the intended logic of the program to the human audience.

In Shakey's language, any text following the symbols // on a line designates a comment. For example:

// Take two steps and turn left.

step();  // first step
step();  // second step

left();  // turn

The use of blank lines and comments makes your program easier for you as the programmer to develop.

Q. 2

In English, explain exactly what the following program fragment does.

left();
left();
step();
left();
left();