Specifications

AMD Geode™ GeodeROM Functional Specification 253
Configuring/Customizing
32087C
COMMENT_ITEM iname,row,col
Defines a non-selectable item on the menu. This may be used for headings within a menu. It is the same as defining an
item with the “NO_SELECT” flag.
SKIP_IF_NOT xx and END_SKIP xx
Special macros are used to remove code from the menu system for features not needed for a particular platform. These
macros are used due to the fact that predefined code in SETMAIN.C may use an external function made PUBLIC by
SMENU.ASM. These functions set a flag to preserve the PUBLICs in SMENU.ASM without generating code. Any LABEL_
is made PUBLIC as a NULL. Any ORDINAL_ is made PUBLIC as -1. The code in SETMAIN.C recognizes that no opera-
tions are to be performed on these entries.
xx is compared to 0 and, if = 0, turns on the skip flag. If xx is not zero, the skip flag is unchanged.
SKIP_IF_NOT and END_SKIP may be nested, but must not overlap. For example:
GOOD:
SKIP_IF_NOT A
:
:
SKIP_IF NOT B
:
:
END_SKIP B
:
END_SKIP A
WRONG!:
SKIP_IF_NOT A
:
:
SKIP_IF NOT B
:
END_SKIP A
:
:
END_SKIP B
END_MENU
Closes out the menu definitions and performs final clean-up as needed. END_MENU is required as the final menu defini-
tion.
Parameters Description
name The text placed on the menu window at the given row and column.
row (optional) The row in the menu window where the item is placed. If omitted, the item is placed on the line after
the last defined item. If the item is first, line two of the menu screen is used.
col (optional) The column of the menu screen where the item or text is placed. If omitted, the item is placed in the
same column as the previous entry. If this is the first entry in a menu, the default starting column is
column 2. If col is provided, it becomes the default starting column for all following entries in the cur-
rent menu.