<!-- $XConsortium: uil.sgm /main/12 1996/09/08 21:43:44 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<RefEntry Id="CDEMMA.MAN1.rsml.1">
<RefMeta>
<RefEntryTitle>uil</RefEntryTitle>
<ManVolNum>user cmd</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Command>uil</Command></RefName>
<RefPurpose>The user interface language compiler
<IndexTerm>
<Primary>user interface language</Primary>
</IndexTerm><IndexTerm>
<Primary>user interface language</Primary>
<Secondary>compiler</Secondary>
</IndexTerm></RefPurpose>
</RefNameDiv>
<IndexTerm>
<Primary>uil</Primary>
</IndexTerm><IndexTerm>
<Primary>uil</Primary>
<Secondary>compiler</Secondary>
</IndexTerm>
<RefSynopsisDiv>
<CmdSynopsis>
<Command>uil</Command>
<Group>
<Arg><Replaceable>options</Replaceable></Arg>
</Group>
<Arg><Replaceable>file</Replaceable></Arg>
</CmdSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para>The
<Command>uil</Command>
command invokes the UIL compiler. The User Interface
Language (UIL)
is a specification language for describing the initial state of a user
interface for a Motif application. The specification describes the
objects (menus, dialog boxes, labels, push buttons, and so on) used
in the interface and specifies the routines to be called when the
interface changes state as a result of user interaction.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">file</Symbol></Term>
<ListItem>
<Para>Specifies the file to be compiled
through the UIL compiler.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">options</Symbol></Term>
<ListItem>
<Para>Specifies one or more of the following options:
</Para>
<VariableList>
<VarListEntry>
<Term><Literal>&minus;I</Literal><Symbol Role="Variable">pathname</Symbol></Term>
<ListItem>
<Para>This option causes the compiler to look for include files
in the directory specified if the include files have not been
found in the paths that already were searched.
Specify this option followed by a pathname, with no intervening
spaces.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>&minus;m</Literal></Term>
<ListItem>
<Para>Machine code is listed. This directs the compiler to place in the
listing file a description of the
records that it added to the User Interface Database (UID). This helps you isolate
errors. The default is no machine code.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>&minus;o&ensp;</Literal><Symbol Role="Variable">file</Symbol></Term>
<ListItem>
<IndexTerm>
<Primary>user interface database</Primary>
</IndexTerm><IndexTerm>
<Primary>uid file</Primary>
</IndexTerm>
<Para>Directs the compiler to produce a UID.
By default, UIL creates a UID with the name <Literal>a.uid</Literal>.
The file specifies the filename for the UID.
No UID is produced if the compiler issues any diagnostics
categorized as error or severe. UIDs are portable only across same-size
machine architectures.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>&minus;s</Literal></Term>
<ListItem>
<Para>Directs the compiler to set the locale before compiling any files.
The locale is set in an implementation-dependent manner.
On ANSI C-based systems, the locale is usually set by calling
<Action>setlocale(<Symbol Role="Define">LC_ALL, ""</Symbol>)</Action>.
If this option is not specified, the compiler does not set the
locale.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>&minus;v&ensp;</Literal><Symbol Role="Variable">file</Symbol></Term>
<ListItem>
<Para>Directs the compiler to generate a listing.
The file specifies the filename for the listing.
If the <Literal>&minus;v</Literal> option is not present,
no listing is generated by the compiler.
The default is no listing.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>&minus;w</Literal></Term>
<ListItem>
<Para>Specifies that the
compiler suppress all warning and informational messages.
If this option is not present, all messages are
generated,
regardless of the severity.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>&minus;wmd&ensp;</Literal><Symbol Role="Variable">file</Symbol></Term>
<ListItem>
<Para>Specifies a binary widget meta-language description file to
be used in place of the default WML description.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RELATED INFORMATION</Title>
<Para><Filename MoreInfo="RefEntry">X</Filename>(1) and &cdeman.Uil3;.
</Para>
</RefSect1>
</RefEntry>

