Convention
Description
[ x | y | ... ] *
Optional alternative items are grouped in
square brackets and separated by vertical
bars. Many or none can be selected.
#
A line starting with the # sign is comments.
II.
GUI conventions
Convention
Description
< >
Button names are inside angle brackets.
For example, click <OK>.
[ ]
Window names, menu items, data table
and field names are inside square
brackets. For example, pop up the [New
User] window.
/
Multi-level menus are separated by forward
slashes. For example, [File/Create/Folder].
III.
Symbols
Convention
Description
Warning
Means reader be extremely careful.
Improper operation may cause bodily
injury.
Caution
Means reader be careful. Improper
operation may cause data loss or damage
to equipment.
Note
Means a complementary description.
