193 lines
6.5 KiB
Plaintext
193 lines
6.5 KiB
Plaintext
<!-- $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">-useWC <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>-useWC </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>-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>
|