<!-- $XConsortium: builder.sgm /main/12 1996/09/08 19:49:47 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="CDEMX.MAN2.rsml.1">
<refmeta><refentrytitle>dtbuilder</refentrytitle><manvolnum>user cmd</manvolnum>
</refmeta>
<refnamediv><refname><command>dtbuilder</command></refname><refpurpose>the
CDE Application Builder</refpurpose></refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>dtbuilder</command><arg choice="opt">projectfile</arg><arg choice="opt">&minus;useWC&numsp;<replaceable>class<?Pub Caret></replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
<para>The <command>dtbuilder</command> utility is an interactive application
development tool and user interface management system for CDE. Known more
fully as the CDE Application Builder, <command>dtbuilder</command> is designed
to make it easier for developers to construct applications that integrate
well into the CDE. It provides two basic services - aid in assembling Motif
objects into the desired application user interface and generation of appropriate
calls to the routines that support CDE desktop services (e.g. ToolTalk, sessioning,
Help).</para>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<variablelist>
<varlistentry><term><literal>&minus;useWC&numsp;</literal><emphasis>class</emphasis></term>
<listitem>
<para>Use the specified widget class whenever possible. Valid values are:
</para>
<variablelist>
<varlistentry><term><symbol>dt</symbol></term>
<listitem>
<para>Generate <Symbol>DtComboBox</Symbol> and <Symbol>DtSpinBox</Symbol>
widgets. This value retains the CDE 1.0 behavior.</para>
</listitem>
</varlistentry>
<varlistentry><term><symbol>xm</symbol></term>
<listitem>
<para>Generate <Symbol>XmComboBox</Symbol> and <Symbol>XmSimpleSpinBox</Symbol> widgets. This value selects the Motif/Xm behavior.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>OPERANDS</title>
<para>The <command>dtbuilder</command> utility accepts an optional filename
operand that is interpreted as the name of an application project file that
should be loaded for editing. This file should be in the BIL format defined
for use by the Application Builder.</para>
<para>If no project file is specified, then <command>dtbuilder</command>
comes up "empty", ready for a new application to be developed interactively
by the user.</para>
</refsect1>
<refsect1>
<title>RESOURCES</title>
<para>If the <literal>&minus;useWC</literal> option is not specified, <command>dtbuilder</command> uses the <literal>useWidgetClass</literal> resource in
the Xt resources table to determine which class to use for generated widgets.
The class/type is <symbol>XmCUseWidgetClass</symbol>/<symbol>XtEnum</symbol> and the valid
values are:</para>
<variablelist>
<varlistentry><term><symbol>xm</symbol> (the default)</term>
<listitem>
<para>Generate <Symbol>XmComboBox</Symbol> and <Symbol>XmSimpleSpinBox</Symbol> widgets.
This value selects the Motif/Xm behavior.</para>
</listitem>
</varlistentry>
<varlistentry><term><symbol>dt</symbol></term>
<listitem>
<para>Generate <Symbol>DtComboBox</Symbol> and <Symbol>DtSpinBox</Symbol>
widgets.
This value retains the CDE 1.0 behavior.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>STDIN</title>
<para>Not used.</para>
</refsect1>
<refsect1>
<title>INPUT FILES</title>
<para>A project file to be processed by the
<command>dtbuilder</command> utility must to be in the BIL format defined
for the CDE Application
Builder.</para>
<para>Interactively, the Application Builder provides facilities for loading
additional project files, as well as application module files
(which also must be in the BIL format) and interface files that use
Motif's UIL format.</para>
</refsect1>
<refsect1>
<title>ENVIRONMENT VARIABLES</title>
<para>None.</para>
</refsect1>
<refsect1>
<title>ASYNCHRONOUS EVENTS</title>
<para>The
<command>dtbuilder</command> utility takes the standard action for all signals.
</para>
</refsect1>
<refsect1>
<title>STDOUT</title>
<para>Not used.</para>
</refsect1>
<refsect1>
<title>STDERR</title>
<para>Used only for diagnostic messages.</para>
</refsect1>
<refsect1>
<title>OUTPUT FILES</title>
<para>None by default.</para>
<para>Interactively, the Application Builder provides facilities for writing
("saving") application project and module files, both of which must be
in the BIL format, and also for writing ("exporting") interface files that
use
Motif's UIL format.</para>
</refsect1>
<refsect1>
<title>EXTENDED DESCRIPTION</title>
<para>None.</para>
</refsect1>
<refsect1>
<title>EXIT STATUS</title>
<para>The following exit values are returned:</para>
<variablelist>
<varlistentry><term>0</term>
<listitem>
<para>Normal termination.</para>
</listitem>
</varlistentry>
<varlistentry><term>1</term>
<listitem>
<para>Abnormal termination.
The
<command>dtbuilder</command> utility was unable to allocate necessary memory
or spawn the code generator.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>CONSEQUENCES OF ERRORS</title>
<para>Default.</para>
</refsect1>
<refsect1>
<title>APPLICATION USAGE</title>
<para>Because the
<command>dtbuilder</command> is a complex, highly-interactive tool, users
typically consider the command line interface as little more than the way
to start up the Application Builder.</para>
<para>CDE provides an "AppBuilder" action so the Application Builder can be
invoked through the standard action interface, including through
the Application Manager.</para>
</refsect1>
<refsect1>
<title>EXAMPLES</title>
<variablelist>
<varlistentry><term>dtbuilder</term>
<listitem>
<para>This runs the CDE Application Builder, presuming that the user will
either
be creating a new project or will load one interactively through the
Application Builder's "File" menu.</para>
</listitem>
</varlistentry>
<varlistentry><term>dtbuilder myproject.bip</term>
<listitem>
<!-- ex-TP-->
<para>Starts the CDE Application Builder and instructs it to load the project
defined in the file
<literal>myproject.bip</literal>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para>&cdeman.dtcodegen; &cdeman.BIL;</para>
</refsect1>
</refentry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 01:31:55-->
<?Pub *0000007534>
