Tornado

Tornado 2.0
User’s Guide
Variables
For global variables, the Tcl set command appears first on the line, separated from
the identifier by a tab character. Complete the declaration with a meaningful
comment at the end of the same line. Variables, values, and comments should be
aligned, as in the following example:
set rootMemNBytes 0 ;# memory for TCB and root stack
set rootTaskId 0 ;# root task ID
set symSortByName 1 ;# boolean for alphabetical sort
Procedures
The procedure name and list of parameters appear on the first line, followed by the
opening curly brace. The declarations of global variables used inside the procedure
begin on the next line, one on each separate line. The rest of the procedure code
begins after a blank line. For example:
proc lstFind {list node} {
global firstNode
global lastNode
}
...
B.3.5 Code Layout
The maximum length for any line of code is 80 characters. If more than 80
characters are required, use the backslash character to continue on the next line.
The rest of this section describes conventions for the graphic layout of Tcl code,
covering the following elements:
■
■
■
■
vertical spacing
horizontal spacing
indentation
comments
Vertical Spacing
■
Use blank lines to make code more readable and to group logically related
sections of code together. Put a blank line before and after comment lines.
330