Volume 6A: Motif Programming Manual

23.3.2 Specifying Module−wide Options

Options for the module, if present, immediately follow the module name. The options allow you to tell the UIL

compiler how it should deal with certain information it encounters in the module. The Motif 1.2 compiler supports the

following three options: names for setting case sensitivity, character_set for setting the default character set,

and object for indicating whether the widget or gadget variants of certain objects are used by default. You may see

the version option in older UIL modules. This option is supported in Motif 1.2 for backwards compatibility but

may be dropped from future versions. Unlike the other options, the version setting does not affect the interpretation

of the module. It is used to associate a version string with the module. Instead of using the version option, you

should place version information in a comment or in a variable in a value section. The names option can be set to

case_sensitive or case_insensitive. As these settings imply, the option determines how the UIL compiler

interprets both programmer−defined names (like widget names) and built−in keywords. If you don't set this option, it

defaults to case_sensitive. For example, with the case_sensitive setting in effect, the names snowball,

SnowBall, and SNOWBALL are considered different by the compiler. However, the same names are considered to be

equal when case_insensitive is specified. When names are case_sensitive, built−in keywords must

appear in lowercase, but when ...