<!-- $XConsortium: preface.sgm /main/6 1996/09/08 19:49:13 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. -->
<Preface Id="ABUG.pref.div.1">
<Title>Preface</Title>
<Para>This manual introduces the Application Builder <Emphasis>(</Emphasis>referred to throughout this
document as App Builder<Emphasis>)</Emphasis> and shows you how best to use it. See
<!--Original XRef content: '&xd2;Overview of
the App Builder Process&xd3; on page&numsp;4'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.intro.mkr.4"> for a summary description.</Para>
<Sect1 Id="ABUG.pref.div.2">
<Title>Who Should Use This Book</Title>
<Para>This user's guide is for anyone who wants to build or prototype a user
interface with App Builder. Because you can easily create and modify user
interfaces without writing any code using App Builder, it is a powerful tool for
programmers and non-programmers&mdash;including user interface designers and
project managers.</Para>
</Sect1>
<Sect1 Id="ABUG.pref.div.3">
<Title>How This Book Is Organized</Title>
<Para><!--Original XRef content: 'Chapter&numsp;1, &xd2;Getting Started'--><XRef Role="ChapNumAndTitleLead-in" Linkend="ABUG.intro.mkr.1"><Emphasis Role="Lead-in">,</Emphasis> includes an annotated picture of the App
Builder primary window, an overview of the process of building an
application, and instructions for starting App Builder.</Para>
<Para><!--Original XRef content: 'Chapter&numsp;2, &xd2;Managing Projects and Modules'--><XRef Role="ChapNumAndTitleLead-in" Linkend="ABUG.proj.mkr.1"><Emphasis Role="Lead-in">,</Emphasis> explains how to create, open,
save, and close projects and modules, and how to hide and show modules.</Para>
<Para><!--Original XRef content: 'Chapter&numsp;3, &xd2;Laying Out a User Interface'--><XRef Role="ChapNumAndTitleLead-in" Linkend="ABUG.layo.mkr.1"><Emphasis Role="Lead-in">,</Emphasis> explains how to drag and drop
objects from the object palettes, how to edit interface objects, and how to align
and distribute control objects in the interface.</Para>
<Para><!--Original XRef content: 'Chapter&numsp;4, &xd2;Editing Properties of Interface Objects'--><XRef Role="ChapNumAndTitleLead-in" Linkend="ABUG.edprp.mkr.1"><Emphasis Role="Lead-in">,</Emphasis> explains how to edit
object properties in the Revolving Property Editor.</Para>
<Para><Literal><!--Literal closed to allow XRef:--></Literal>
<!--Original XRef content: 'Chapter&numsp;5, &xd2;Creating and Editing Panes, Menus, and Messages'--><XRef Role="ChapNumAndTitleLead-in" Linkend="ABUG.crobj.mkr.1"><Emphasis Role="Lead-in">,</Emphasis> explains
how to create and edit pane objects, menus, and message dialog boxes.</Para>
<Para><!--Original XRef content: 'Chapter&numsp;6, &xd2;Adding Functionality to the Interface'--><XRef Role="ChapNumAndTitleLead-in" Linkend="ABUG.afunc.mkr.1"><Emphasis Role="Lead-in">,</Emphasis> explains how to create on-
item help, how to create functional connections between objects, and how to
establish drag and drop and application framework behavior.</Para>
<Para><!--Original XRef content: 'Chapter&numsp;7, &xd2;Grouping and Attaching Objects'--><XRef Role="ChapNumAndTitleLead-in" Linkend="ABUG.group.mkr.1"><Emphasis Role="Lead-in">,</Emphasis> explains how to group control
objects and how to attach objects to each other for dynamic resize behavior.</Para>
<Para><!--Original XRef content: 'Chapter&numsp;8, &xd2;Testing Menus, Help, and Connections'--><XRef Role="ChapNumAndTitleLead-in" Linkend="ABUG.test.mkr.1"><Emphasis Role="Lead-in">,</Emphasis> explains how to change
to test mode for testing certain App Builder functions.</Para>
<Para><!--Original XRef content: 'Chapter&numsp;9, &xd2;Generating Code and Building an Application'--><XRef Role="ChapNumAndTitleLead-in" Linkend="ABUG.codeg.mkr.1"><Emphasis Role="Lead-in">,</Emphasis> describes the
Code Generator and explains how to generate code, make your application,
and run it.</Para>
<Para><!--Original XRef content: 'Appendix&numsp;A, &xd2;App Builder Windows and Dialog Boxes'--><XRef Role="AppendixNumAndTitleLead-in" Linkend="ABUG.apRPE.mkr.1"><Emphasis Role="Lead-in">,</Emphasis> describes the
primary window, including its object palettes, and other App Builder
windows, including the Project Organizer, the Module Browser, and the Code
Generator.</Para>
<Para><!--Original XRef content: 'Appendix&numsp;B, &xd2;Revolving Property Editor'--><XRef Role="AppendixNumAndTitleLead-in" Linkend="ABUG.apRPE.mkr.1"><Emphasis Role="Lead-in">,</Emphasis> describes the Revolving Property
Editor in general and each of the individual property editors specifically.</Para>
</Sect1>
<Sect1 Id="ABUG.pref.div.4">
<Title Id="ABUG.pref.mkr.1">What DocBook SGML Markup Means</title>
<para>This book is written in the Structured Generalized Markup
Language (SGML) using the DocBook Document Type Definition (DTD).
The following table describes the DocBook markup used for
various semantic elements.
</para>
<Table Id="ABUG.pref.tbl.1" Frame="Topbot">
<title>DocBook SGML Markup</title>
<tgroup cols="3" colsep="0" rowsep="0">
<colspec colwidth="1.65in">
<colspec colwidth="2.63in">
<colspec colwidth="2.92in">
<thead>
<row>
<entry align="left" valign="bottom"><para><literal>Markup Appearance</literal></para></entry>
<entry align="left" valign="bottom"><para><literal>Semantic Element(s)</literal></para></entry>
<entry align="left" valign="bottom"><para><literal>Example</literal></para></entry></row>
</thead>
<tbody>
<row>
<entry align="left" valign="top"><para><command>AaBbCc123</command></para></entry>
<entry align="left" valign="top"><para>The names of commands.</para></entry>
<entry align="left" valign="top"><para>Use the <command>ls</command> command to list files.</para></entry>
</row>
<row>
<entry align="left" valign="top"><para><literal>AaBbCc123</literal></para></entry>
<entry align="left" valign="top"><para>The names of command options.</para></entry>
<entry align="left" valign="top"><para>Use <command>ls</command> <literal>&minus;a</literal>
to list all files.</para></entry>
</row>
<row>
<entry align="left" valign="top"><para><symbol role="Variable">AaBbCc123</symbol></para></entry>
<entry align="left" valign="top"><para>Command-line placeholder:
replace with a real name or value.</para></entry>
<entry align="left" valign="top"><para>To delete a file, type <command>rm</command> <symbol role="Variable">filename</symbol>.</para></entry>
</row>
<row>
<entry align="left" valign="top"><para><filename>AaBbCc123</filename></para></entry>
<entry align="left" valign="top"><para>The names of files and
directories.</para></entry>
<entry align="left" valign="top"><para>Edit your <filename>.login</filename>
file.</para></entry>
</row>
<row>
<entry align="left" valign="top"><para><emphasis>AaBbCc123</emphasis></para></entry>
<entry align="left" valign="top"><para>Book titles, new words or terms, or
words to be emphasized.</para></entry>
<entry align="left" valign="top"><para>Read Chapter 6 in <emphasis>User's
Guide</emphasis>.
These are called <emphasis>class</emphasis> options.
You <emphasis>must</emphasis> be root to do this.</para></entry>
</row></tbody></tgroup></table>
</sect1>
</preface>


