Palm OS Programming, 2nd Edition

Understanding the Manual

Syntax

• Items in all CAPS appear as literals in the file.

• Items enclosed in “<” and “>” are required fields.

• Items enclosed in “[” and “]” are optional fields.

• Bold items are default.

• Each field’s required type is indicated by a suffix after the field name (see below for types).

Types

.i

Identifier

Example: kFoo

.c

Character (may contain normal C style character escapes)

Example: "O"

.s

String (may contain normal C-style character escapes)

Example: “Click Me”

.ss

Multiline string

PilRC will concatenate strings on separate lines.

Example:

"Now is the time for all good " \
"men to come and aid of their country"

.n

Number

Defined constant or simple arithmetic expression. Valid operators are “+”, “-”, “*” and “/”. Precedence is left to right, unless changed with the use of parenthesis.

Note: Math calculations are integer based.

Example:

23
12+3+1
12*(2+3)
'PALM'

.p

Position coordinate

May be a number, expression, or one of the following keywords.

AUTO

Automatic width or height.

Value is computed based on the text in the item.

CENTER

Centers the item either horizontally or vertically.

CENTER@<coord.n>

Centers the item at the coordinate that follows.

RIGHT@<coord.n>

Aligns the item at the right coordinate that follows.

BOTTOM@<coord.n>

Aligns the item at the bottom coordinate that follows.

PREVLEFT

Previous item’s left coordinate.

PREVRIGHT

Previous item’s right coordinate.

PREVTOP

Previous item’s top coordinate.

PREVBOTTOM

Previous item’s bottom coordinate.

PREVWIDTH

Previous item’s ...