<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY date "Mar. 30, 2002"> <!-- date the manual was last updated -->
<!ENTITY app "<application>Glade</application>">
]>

<article id="index" lang="en">

  <articleinfo> 
  <title>Glade User Manual</title>
    <copyright>
      <year>2000</year>
      <holder>Michael Vance</holder>
    </copyright>

    <publisher>
      <publishername>
	GNOME Documentation Project
      </publishername>
    </publisher>

    &legal;

    <legalnotice id="feedback">
      <title>Feedback Information</title>
      <para>
	To report a bug or make a suggestion regarding this
	application or this documentation, please see  the
	<ulink type="help"
	       url="ghelp:gnome-feedback">GNOME Feedback Page</ulink>.
      </para>
    </legalnotice>

    <authorgroup>
      <author>
	  <firstname>Michael</firstname>
	  <surname>Vance</surname>
	</author>
  </authorgroup>

    <revhistory>

	<revision>
	  <revnumber>1.0</revnumber>
	  <date>11 May 2000</date> <!-- or use &date; -->
	  <revdescription>
                   <para role="author">Michael Vance</para>
                   <para role="publisher">GNOME Documentation Project</para>
          </revdescription>

	</revision>

  </revhistory>
     <releaseinfo>
       This is the Glade User Manual. It was last updated on &date;.
    </releaseinfo>

  </articleinfo>


<!-- INTRODUCTION -->

  <sect1 id="introduction">
    <title>Introduction</title> 
    
    <para>
      Glade is an application for creating
      graphical user interfaces that use the Gtk+ and GNOME libraries.
      Glade allows you to rapidly develope
      these interfaces, and can
      create source code in a variety of languages that will construct
      the interfaces for you. Glade can
      also be used in conjunction with
      libglade to dynamically create user
      interfaces from the XML description file that
      Glade creates.
    </para>

    <para>
       Glade can be obtained from <ulink
       url="http://glade.gnome.org/download.html"
       type="http">here</ulink>. Links are provided there for various
       package formats. Glade is also
       available from the GNOME CVS server. See the <ulink
       url="http://developer.gnome.org/tools/cvs.html" type="http">
       GNOME CVS page</ulink> for more information on how to get
       Glade from CVS.
    </para>

    <para>
      In order to use Glade's GNOME
      support, you will need to have a very recent version of GNOME,
      or compile Glade with
      <command>--disable-gnome</command>.
    </para>

    <para>
      Once installed, Glade can be started
      from the command-line by typing <command>glade-2</command>.
    </para>

  </sect1>

<!-- USING --> 

  <sect1 id="using">
    <title>Using Glade</title>

    <para>
      Glade is composed of several windows
      which each server a particular purpose. The main window contains
      the menu, toolbar and a list of top-level windows. The palette
      lists the various UI objects which you can use to bulid an
      inteface. The property editor lets you manipulate the properties
      of widgets, such as their size, color, signal masks, etc.
    </para>

    <para>
      Typically a Glade project begins with the construction of the
      user interface. Using the palette, you composite and insert
      widgets until you arrive at the desired interface. While doing
      this you usually use the property editor to manipulate the
      various packing settings, dimensions, etc., of the widgets.
    </para>

    <para> 
      When the interface is finished, you then usually save the
      project and build the C source files that will be used to generate
      the user interface. Integration with your project logic then
      follows. Some other things you may do:
    </para>

    <itemizedlist>
      <listitem>
	<para>
	  Use libglade to build the interface
	</para>
      </listitem>
      <listitem>
	<para>
          Use Glade to set the signal
          handlers for your widgets
	</para>
      </listitem>
      <listitem>
	<para>
          Emit Perl or Eiffel code instead of C
	</para>
      </listitem>
    </itemizedlist>

    <para>
      The various parts of Glade are
      described in detail in the sections that follow.
    </para>

  </sect1>

<!-- MENUS -->

  <sect1 id="menus">
    <title>Menus</title>

    <figure>
      <title>Glade menu</title>
      <screenshot>
	<graphic fileref="figures/menu.png" format="PNG" srccredit="mkv"/>
      </screenshot>
    </figure>

    <sect2 id="file-menu">
      <title>File</title>

      <figure>
	<title>File menu</title>
	<screenshot>
	  <graphic fileref="figures/file-menu.png" format="PNG" srccredit="mkv"/>
	</screenshot>
      </figure>

      <sect3 id="file-new-project">
	<title>New Project</title>

	<para>
          Create a new, empty Glade
          project. Glade will prompt you to
          create a new project. If you have not saved an existing
          project, select <command>Cancel</command> and then save
          it. Otherwise, select <command>OK</command>. 
        </para>

      </sect3>

      <sect3 id="file-open-project">
	<title>Open</title>

	<para>
          Open an existing Glade project. A
          standard Gtk+ dialog box
          will appear allowing you to specify the project file. Note
          that Gtk+ file dialog boxes have tab-completion in their
          filename field. 
        </para>

      </sect3>

      <sect3 id="file-save-project">
	<title>Save</title>

	<para>
          Save your project. If you have never saved your project, you
          will  be presented with the Project Options dialog, which
          will have default values entered in it. If you have
          specified the project settings in the past it will simply
          save your your current projectwithout comment.
	</para>

      </sect3>

      <sect3 id="file-build-source-code">
	<title>Build Source Code</title>

	<para>
          Generate the desired source code (C, Perl, Ada, etc.). If
          you have never saved your project, you will be presented
          with the Project Options dialog, which will have defaults
          values entered in it. If you have specified the project
          settings in the past it will simply emit code without
          comment.
	</para>
      </sect3>

      <sect3 id="file-project-options">
	<title>Project Options</title>

	<para>
          The project options dialog is described 
          <link linkend="project-options">here</link>.
	</para>

      </sect3>

      <sect3 id="exit-menu">
	<title>Exit</title>

	<para>
          Exit Glade. Currently
          Glade does not query you
          to save unsaved project data (although it does ask you if
          you wish to quit), so be sure to save your
          project before exiting.
	</para>

      </sect3>

    </sect2> <!-- File menu -->

    <sect2 id="edit-menu">
      <title>Edit menu</title>

      <figure>
	<title>Edit menu</title>
	<screenshot>
	  <graphic fileref="figures/edit-menu.png" format="PNG" srccredit="mkv"/>
	</screenshot>
      </figure>

      <sect3 id="edit-cut">
	<title>Cut</title>

	<para>
          This command will remove a widget from its parent and place
          it on the clipboard.
	</para>

      </sect3>

      <sect3 id="edit-copy">
	<title>Copy</title>

	<para>
          This command will copy a widget to the clipboard. The original
          widget remains attached to its parent.
	</para>

      </sect3>

      <sect3 id="edit-paste">
	<title>Paste</title>

	<para>
          If a widget currently exists on the clipboard, this command
          will allow you to copy the widget from the clipboard 
	</para>

      </sect3>

      <sect3 id="edit-clear">
	<title>Clear</title>

	<para>
          If a widget is currently selected, this command will delete it
          from its parent without moving it to the clipboard.
	</para>

      </sect3>

    </sect2> <!-- Edit menu -->

    <sect2 id="view-menu">
      <title>View menu</title>

      <figure>
	<title>View menu</title>
	<screenshot>
	  <graphic fileref="figures/view-menu.png" format="PNG" srccredit="mkv"/>
	</screenshot>
      </figure>

      <!-- FIXME: Link. -->

      <sect3 id="view-palette">
	<title>Show Palette</title>

	<para>
          Display the palette if it is currently hidden, or raise it
          to the top of the window stack if it is obscured.
	</para>

      </sect3>

      <sect3 id="view-property-editor">
	<title>Show Property Editor</title>

	<para>
          Display the property editor dialog if it is currently
          hidden, or raise it to the top of the window stack if it is
          obscured.
	</para>

      </sect3>

      <sect3 id="view-widget-tree">
	<title>Show Widget Tree</title>

	<para>
          Display the widget tree dialog if it is currently hidden, or
          raise it to the top of the window stack if it is obscured.
	</para>

      </sect3>

      <sect3 id="view-clipboard">
	<title>Show Clipboard</title>

	<para>
          Display the widget clipboard if it is currently hidden, or
          raise it to the top of the window stack if it is obscured.
	</para>

      </sect3>

    </sect2> <!-- View menu -->

    <sect2 id="settings-menu">
      <title>Settings menu</title>

      <figure>
	<title>Settings menu</title>
	<screenshot>
	  <graphic fileref="figures/settings-menu.png" format="PNG" srccredit="mkv"/>
	</screenshot>
      </figure>

      <sect3 id="settings-show-grid">
	<title>Show Grid</title>

	<para>
	  When placing widgets on a GtkFixed container, should
          Glade draw a grid for easy widget
          alignment?
	</para>

      </sect3>

      <sect3 id="settings-snap-to-grid">
	<title>Snap to Grid</title>

	<para>
	  When placing widgets on a GtkFixed container, do you want 
          Glade to snap them to the grid?
	</para>

      </sect3>

      <sect3 id="settings-show-widget-tooltips">
	<title>Show Widget Tooltips</title>

	<para>
	  When resting your cursor over an widget, should it display
          tooltips describing that widget?
	</para>

      </sect3>

      <sect3 id="settings-grid-options">
	<title>Grid Options</title>

	<figure>
	  <title>Grid options</title>
	  <screenshot>
	    <graphic fileref="figures/grid-options.png" format="PNG"
             srccredit="mkv"/>
	  </screenshot>
	</figure>

	<itemizedlist>
	  <listitem>
	    <para>
	      Horizontal spacing - number of pixels to skip
	      horizontally before drawing a line
	    </para>
	  </listitem>
	  <listitem>
	    <para>
	      Vertical spacing - number of pixels to skip
	      vertically before drawing a line
	    </para>
	  </listitem>
	  <listitem>
	    <para>
	      Grid style - should the grid be drawn as a series of
              dots or as lines?
	    </para>
	  </listitem>
        </itemizedlist>

      </sect3>

      <sect3 id="settings-snap-options">
	<title>Snap Options</title>

	<figure>
	  <title>Snap Options</title>
	  <screenshot>
	    <graphic fileref="figures/snap-options.png" format="PNG"
            srccredit="mkv"/>
	  </screenshot>
	</figure>

	<itemizedlist>
	  <listitem>
	    <para>
              Horizontal snapping - should
              Glade snap the left and/or
              right edges of a widget to the grid?
	    </para>
	  </listitem>
	  <listitem>
	    <para>
              Vertical snapping - should
              Glade snap the top and/or
              bottom edges of a widget to the grid?
	    </para>
	  </listitem>
	</itemizedlist>

      </sect3>

    </sect2> <!-- Settings menu -->

    <sect2 id="help-menu">
      <title>Help menu</title>

      <figure>
	<title>Help menu</title>
	<screenshot>
	  <graphic fileref="figures/help-menu.png" format="PNG" srccredit="mkv"/>
	</screenshot>
      </figure>

      <sect3 id="help-about">
	<title>About</title>

	<para>
	  Displays the About dialog, which shows the
          Glade logo, and provides
          authorship and contact information for
          Glade.
	</para>

      </sect3>

    </sect2> <!-- Help menu -->

    <sect2 id="toolbar">
      <title>Toolbar</title>

      <figure>
	<title>Toolbar</title>
	<screenshot>
	  <graphic fileref="figures/toolbar.png" format="PNG" srccredit="mkv"/>
	</screenshot>
      </figure>

      <sect3 id="toolbar-open">
	<title>Open</title>

	<para>
	  Corresponds to <link linkend="file-open-project">
          <command>File:Open</command></link>.
	</para>

      </sect3>

      <sect3 id="toolbar-save">
	<title>Save</title>

	<para>
	  Corresponds to <link linkend="file-save-project">
          <command>File:Save</command></link>.
	</para>

      </sect3>

      <sect3 id="toolbar-options">
	<title>Options</title>

	<para>
	  Corresponds to <link linkend="file-project-options">
          <command>File:Project Options</command></link>.
	</para>

      </sect3>

      <sect3 id="toolbar-build">
	<title>Build</title>

	<para>
	  Corresponds to <link linkend="file-build-source-code">
          <command>File:Build</command></link>.
	</para>

      </sect3>

    </sect2> <!-- Toolbar -->

  </sect1> <!-- Menus -->

<!-- PROJECTOPTIONS -->

  <sect1 id="project-options">
    <title>Project Options</title>

    <para>
    Note that it is advisable to only use ASCII characters for names of
    files and directories, and especially for names of the pixmap files.
    Different systems may use different encodings for the names of files
    and directories, which may cause problems unless you stick to plain
    ASCII.
    </para>

    <sect2 id="project-options-general">
      <title>General</title>

      <figure>
	<title>General Options</title>
	<screenshot>
	  <graphic fileref="figures/options-general.png" format="PNG"
           srccredit="mkv"/>
	</screenshot>
      </figure>

      <sect3 id="project-options-general-basic">
	<title>Basic Options</title>

	<variablelist>

	  <varlistentry>
	    <term>Project Directory</term>
	    <listitem>
	      <para>
                Directory in which the Glade project lies. You can
                select this using a file dialog box by clicking on
                <command>Browse</command>.
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Project Name</term>
	    <listitem>
	      <para>
                Name of your project. Editing this will
                cause your program name and project filename to change
                automatically.
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Program Name</term>
	    <listitem>
	      <para>
                Name of the executable used when Glade
                generates code for your project. Editing this will
                cause the project file to automatically change.
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Project File</term>
	    <listitem>
	      <para>
                Filename of the Glade project file,
                where all of your project information will be stored.
	      </para>
	    </listitem>
	  </varlistentry>

	</variablelist>

      </sect3> <!-- Basic options -->

      <sect3 id="project-options-general-subdirs">
	<title>Subdirectories</title>

	<variablelist>
	  <varlistentry>
	    <term>Source Directory</term>
	    <listitem>
	      <para>
                Directory where Glade should emit its source code when
                told to do so.
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Pixmaps Directory</term>
	    <listitem>
	      <para>
                Directory where Glade should expect to find any
                pixmaps that are used in the project.
	      </para>
	    </listitem>
	  </varlistentry>

	</variablelist>

      </sect3> <!-- Subdirectories -->

      <sect3 id="project-options-general-language">
	<title>Language</title>

	<!-- FIXME: per-language description? -->

	<para>
          Pick the programming language in which Glade should emit
          code. As of the writing of this document C, C++,
          Ada95, Perl and Eiffel are supported options.
	</para>

      </sect3> <!-- Language -->

      <sect3>
	<title>GNOME</title>

	<para>
          Should Glade emit code that uses the GNOME libraries?
	</para>

      </sect3>

    </sect2> <!-- General options -->

    <sect2>
      <title>C Options</title>

      <figure>
	<title>C Options</title>
	<screenshot>
	  <graphic fileref="figures/options-c.png" format="PNG" srccredit="mkv"/>
	</screenshot>
      </figure>

      <sect3 id="proejct-options-c-general">
	<title>General Options</title>

	<variablelist>

	  <varlistentry>
	    <term>Gettext Support</term>
	    <listitem>
	      <para>
                Should Glade emit code to suppport GNU gettext for
                internationalization?
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Set Widget Names</term>
	    <listitem>
	      <para>
                Should Glade emit code to set the names of all
                widgets? This is useful if you intend to use Gtk+
                calls such as <function>gtk_widget_path()</function>. Also see
                <function>gtk_widget_set_name()</function>.
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Backup Source Files</term>
	    <listitem>
	      <para>
                Should Glade make a backup of all your source files
                when you build new ones?
	      </para>
	    </listitem>
	  </varlistentry>

	</variablelist>

      </sect3>

      <sect3 id="proejct-options-c-file">
	<title>File Output Options</title>

	<variablelist>

	  <varlistentry>
	    <term>Output <filename>main.c</filename> File</term>
	    <listitem>
	      <para>
                Should Glade output a file,
                <filename>main.c</filename>, which contains a simple 
                bootstrap? If you enabled GNOME support, it will call
                <function>gnome_init()</function>, otherwise it calls
                <function>gtk_init()</function>.
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Output Support Functions</term>
	    <listitem>
	      <para>
                Should Glade output a file,
                <filename>support.c</filename>, which contains utility
                functions for such tasks as creating a pixmap, or
                looking for a widget by name?
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Output Build Files</term>
	    <listitem>
	      <para>
                Should Glade output files to support configuring your
                project through automake/autoconf? This option will
                create several files:
	      </para>
	      <simplelist>
		<member><filename>AUTHORS</filename> - Authorship file for contributors.</member>
		<member><filename>ChangeLog</filename> - Log describing changes you've made.</member>
		<member><filename>Makefile.am</filename> - Automake template for the project.</member>
		<member><filename>NEWS</filename> - Announcements for new releases.</member>
		<member><filename>README</filename> - Describes general information about the project.</member>
		<member><filename>acconfig.h</filename> - Defines default preprocessor symbols for autoconf.</member>
		<member><filename>autogen.sh</filename> - Script for building a configure script.</member>
		<member><filename>configure.in</filename> - Template for building a configure script.</member>
		<member><filename>macros/</filename> - Directory containing automake macros for Glade, GNOME, etc.</member>
		<member><filename>stamp-h.in</filename> - Timestamp file.</member>
		<member><filename>src/Makefile.am</filename> - Automake template for src/ directory.</member>
	      </simplelist>
	    </listitem>
	  </varlistentry>

	</variablelist>

      </sect3>

      <sect3 id="proejct-options-c-interface">
	<title>Interface Creation Functions</title>

	<variablelist>

	  <varlistentry>
	    <term>Source File</term>
	    <listitem>
	      <para>
                When emitting user interface code, store
                it in this file.
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Header File</term>
	    <listitem>
	      <para>
                When emitting user interface code, store
                the function prototypes, etc., in this file.
	      </para>
	    </listitem>
	  </varlistentry>

	</variablelist>

      </sect3>

      <sect3 id="proejct-options-c-signal">
	<title>Signal Handler &amp; Callback Functions</title>

	<variablelist>

	  <varlistentry>
	    <term>Source File</term>
	    <listitem>
	      <para>
                When emitting signal handler code, store
                it in this file.
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Header File</term>
	    <listitem>
	      <para>
                When emitting signal handler code, store
                the function prototypes, etc., in this file.
	      </para>
	    </listitem>
	  </varlistentry>

	</variablelist>

      </sect3>

      <sect3 id="proejct-options-c-support">
	<title>Support Functions</title>

	<variablelist>

	  <varlistentry>
	    <term>Source File</term>
	    <listitem>
	      <para>
                When emitting the support function code,
                store it in this file.
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Header File</term>
	    <listitem>
	      <para>
                When emitting the support function code,
                store the function prototypes, etc., in this file.
	      </para>
	    </listitem>
	  </varlistentry>

	</variablelist>

      </sect3>

    </sect2> <!-- C Options -->

    <sect2>
      <title>Libglade Options</title>

      <figure>
	<title>Libglade Options</title>
	<screenshot>
	  <graphic fileref="figures/options-libglade.png" format="PNG"
           srccredit="mkv"/>
	</screenshot>
      </figure>

      <sect3 id="project-options-libglade-trans">
	<title>Save Translatable Strings</title>

	<para>
	  If you wish to internationalize your application, and want
          to use libglade to construct the interface, you may wish to
          save the translatable trings into a file. This option tells
          Glade if you wish to do this.
	</para>

      </sect3>

    </sect2> <!-- Libglade options -->

  </sect1> <!-- Project options -->

<!-- WINDOWS -->

  <sect1 id="windows">
    <title>Windows</title>

    <sect2 id="windows-main">
      <title>Main Window</title>

      <figure>
	<title>Main window</title>
	<screenshot>
	  <graphic fileref="figures/window-main.png" format="PNG"
           srccredit="mkv"/>
	</screenshot>
      </figure>

      <sect3 id="windows-main-menu">
	<title>Menu</title>

	<para>
          Menus are documented <link linkend="menus">
          here</link>.
        </para>

      </sect3>

      <sect3 id="windows-main-toolbar">
	<title>Toolbar</title>

	<para>
          The toolbar is documented <link linkend="toolbar">
          here</link>.
        </para>

      </sect3>

      <sect3 id="windows-main-list">
	<title>Top-Level Window List</title>

	<para>
          The main window displays a list of the top-level Gtk+ and
          GNOME windows that are defined for the current project. This
          includes:
	</para>

	<itemizedlist>
	  <listitem><para><structname>GtkWindow</structname></para></listitem>
	  <listitem><para><structname>GtkDialog</structname></para></listitem>
	  <listitem><para><structname>GtkFileSelection</structname></para></listitem>
	  <listitem><para><structname>GtkColorSelectionDialog</structname></para></listitem>
	  <listitem><para><structname>GtkFontSelectionDialog</structname></para></listitem>
	  <listitem><para><structname>GtkInputDialog</structname></para></listitem>
	  <listitem><para><structname>GnomeApp</structname></para></listitem>
	  <listitem><para><structname>GnomeDialog</structname></para></listitem>
	  <listitem><para><structname>GnomeMessageBox</structname></para></listitem>
	  <listitem><para><structname>GnomeAbout</structname></para></listitem>
	  <listitem><para><structname>GnomePropertyBox</structname></para></listitem>
	</itemizedlist>

      </sect3>

    </sect2>

    <sect2 id="windows-palette">
      <title>Palette</title>

      <para>
        The palette allows you to pick widgets to be added to your
        current Glade proejct. There are three major modes of
        operation to the palette. The first mode is selection, and can
        be used by clicking on the large black arrow with "Selector"
        labeled next to it. In this mode mouse clicks will select
        already existing widgets from your project, allowing you to
        edit them using the property editor. Selection mode is also
        indicated by an arrow cursor.
      </para>

      <para>
        The second mode of operation is widget placement. When
        selecting most widgets, Glade will change the cursor to a
        cross and then allow you to place widgets inside of
        containers, top-level widgets, etc. After placing a widget
        Glade returns to selection mode.
      </para>

      <para>
        The third mode of operation is top level placement. For
        certain <link linkend="windows-main-list">top-level
        widgets</link>, selecting them in the palette will cause them
        to instantly appear on your desktop for editing. This
        contrasts with the usual mode of widget placement described
        above. After selecting a top-level widget the mode is changed
        back to selection.
      </para>

      <para>
        The palette groups widgets into three distinct sections: Gtk+
        Basic, Gtk+ Additional, and Gnome. The Gtk+ Basic category
        contains often used Gtk+ widgets such as
        <structname>GtkWindow</structname>, <structname>GtkLabel</structname>, etc. Gtk+
        Additional contains widgets such as
        <structname>GtkAlignment</structname>, <structname>GtkPacker</structname>,
        and <structname>GtkCalendar</structname>. The Gnome category includes
        all of the GNOME widgets that Glade supports.
      </para>

      <para>
        A list of all widgets supported is provided below. In order to
        determine exactly what a widget is in the palette (i.e., the
        picture provided is not obvious), you can get a tooltip with a
        description by resting your cursor over the widget in question.
      </para>

      <sect3 id="windows-palette-basic">
	<title>Gtk+ Basic</title>

	<para>

	  <inlinemediaobject>
	    <imageobject>
	      <imagedata fileref="figures/window-palette-basic.png"/>
	    </imageobject>
	  </inlinemediaobject>

          <table>
	    <title>Gtk+ Basic</title>
	    <tgroup cols="5" align="left">
	      <tbody>
		<row>
		  <entry>
		  </entry>
		</row>
		<row>
		  <entry><structname>GtkWindow</structname></entry>
		  <entry><structname>GtkMenuBar</structname></entry>
		  <entry><structname>GtkToolbar</structname></entry>
		  <entry><structname>GtkHandleBox</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkLabel</structname></entry>
		  <entry><structname>GtkEntry</structname></entry>
		  <entry><structname>GtkCombo</structname></entry>
		  <entry><structname>GtkText</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkButton</structname></entry>
		  <entry><structname>GtkToggleButton</structname></entry>
		  <entry><structname>GtkCheckButton</structname></entry>
		  <entry><structname>GtkRadioButton</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkList</structname></entry>
		  <entry><structname>GtkTree</structname></entry>
		  <entry><structname>GtkCList</structname></entry>
		  <entry><structname>GtkCTree</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkOptionMenu</structname></entry>
		  <entry><structname>GtkSpinButton</structname></entry>
		  <entry><structname>GtkProgressBar</structname></entry>
		  <entry><structname>GtkStatusbar</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkHSeparator</structname></entry>
		  <entry><structname>GtkVSeparator</structname></entry>
		  <entry><structname>GtkPixmap</structname></entry>
		  <entry><structname>GtkDrawingArea</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkDialog</structname></entry>
		  <entry><structname>GtkFileSelection</structname></entry>
		  <entry><structname>GtkColorSelectionDialog</structname></entry>
		  <entry><structname>GtkFontSelectionDialog</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkHBox</structname></entry>
		  <entry><structname>GtkVBox</structname></entry>
		  <entry><structname>GtkTable</structname></entry>
		  <entry><structname>GtkFixed</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkHButtonBox</structname></entry>
		  <entry><structname>GtkVButtonBox</structname></entry>
		  <entry><structname>GtkHPaned</structname></entry>
		  <entry><structname>GtkVPaned</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkNotebook</structname></entry>
		  <entry><structname>GtkFrame</structname></entry>
		  <entry><structname>GtkScrolledWindow</structname></entry>
		  <entry><structname>GtkViewport</structname></entry>
		</row>
	      </tbody>
	    </tgroup>
	  </table>

        </para>

      </sect3>

      <sect3 id="windows-palette-add">
	<title>Gtk+ Additional</title>

	<para>

          <inlinemediaobject>
	    <imageobject>
	      <imagedata fileref="figures/window-palette-add.png"/>
	    </imageobject>
	  </inlinemediaobject>

	  <table>
	    <title>Gtk+ Additional</title>
	    <tgroup cols="4" align="left">
	      <tbody>
		<row>
		  <entry><structname>GtkHScale</structname></entry>
		  <entry><structname>GtkVScale</structname></entry>
		  <entry><structname>GtkHRuler</structname></entry>
		  <entry><structname>GtkVRuler</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkAlignment</structname></entry>
		  <entry><structname>GtkEventBox</structname></entry>
		  <entry><structname>GtkAccelLabel</structname></entry>
		  <entry><structname>GtkCalendar</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkLayout</structname></entry>
		  <entry><structname>GtkPacker</structname></entry>
		  <entry><structname>GtkAspectFrame</structname></entry>
		  <entry><structname>GtkPopopMenu</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkCurve</structname></entry>
		  <entry><structname>GtkGammaCurve</structname></entry>
		  <entry><structname>GtkHScrollbar</structname></entry>
		  <entry><structname>GtkVScrollbar</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkImage</structname></entry>
		  <entry><structname>GtkPreview</structname></entry>
		  <entry><structname>GtkColorSelection</structname></entry>
		  <entry><structname>GtkFontSelection</structname></entry>
		</row>
		<row>
		  <entry><structname>GtkInputDialog</structname></entry>
		  <entry>Custom Widget</entry>
		  <entry><structname>GtkArrow</structname></entry>
		</row>
	      </tbody>
	    </tgroup>
	  </table>

        </para>

      </sect3>

      <sect3 id="windows-palette-gnome">
	<title>GNOME</title>

	<para>

	  <inlinemediaobject>
	    <imageobject>
	      <imagedata fileref="figures/window-palette-gnome.png"/>
	    </imageobject>
	  </inlinemediaobject>

	  <table>
	    <title>Gnome</title>

	    <tgroup cols="4" align="left">
	      <tbody>
		<row>
		  <entry><structname>GnomeApp</structname></entry>
		  <entry><structname>GnomeDialog</structname></entry>
		  <entry><structname>GnomeMessageBox</structname></entry>
		  <entry><structname>GnomeAbout</structname></entry>
		</row>
		<row>
		  <entry><structname>GnomeColorPicker</structname></entry>
		  <entry><structname>GnomeFontPicker</structname></entry>
		  <entry><structname>GnomeIconEntry</structname></entry>
		  <entry><structname>GnomeHRef</structname></entry>
		</row>
		<row>
		  <entry><structname>GnomeEntry</structname></entry>
		  <entry><structname>GnomeFileEntry</structname></entry>
		  <entry><structname>GnomeNumberEntry</structname></entry>
		  <entry><structname>GnomePixmapEntry</structname></entry>
		</row>
		<row>
		  <entry><structname>GnomeDateEdit</structname></entry>
		  <entry><structname>GtkDial</structname></entry>
		  <entry><structname>GtkClock</structname></entry>
		  <entry><structname>GnomeAppBar</structname></entry>
		</row>
		<row>
		  <entry><structname>GnomeCalculator</structname></entry>
		  <entry><structname>GnomeLess</structname></entry>
		  <entry><structname>GnomePaperSelector</structname></entry>
		  <entry><structname>GnomeSpell</structname> (deprecated)</entry>
		</row>
		<row>
		  <entry><structname>GnomeCanvas</structname></entry>
		  <entry><structname>GnomeIconList</structname></entry>
		  <entry><structname>GnomeIconSelection</structname></entry>
		  <entry><structname>GnomePropertyBox</structname></entry>
		</row>
		<row>
		  <entry><structname>GnomeDruid</structname></entry>
		  <entry><structname>GnomePixmap</structname></entry>
		  <entry><structname>GnomeAnimator</structname></entry>
		</row>
	      </tbody>
	    </tgroup>
	  </table>

	</para>

      </sect3>

    </sect2> <!-- Palette -->

    <sect2 id="windows-editor">
      <title>Property Editor</title>

      <para>
        FIXME
      </para>

    </sect2>

    <sect2 id="windows-tree">
      <title>Widget Tree</title>

      <para>
        FIXME
      </para>

    </sect2>

    <sect2 id="windows-clipboard">
      <title>Clipboard</title>

      <para>
        FIXME
      </para>

    </sect2>

  </sect1> <!-- Windows -->

<!-- OUTPUT -->

  <sect1 id="output">
    <title>Output</title>

    <para>
      Please write me.
    </para>

  </sect1>

<!-- LIBGLADE -->

  <sect1 id="libglade">
    <title>Libglade</title>

    <para>
      Please write me.
    </para>

 </sect1>

<!-- QUICKSTART -->

  <sect1 id="quickstart">
    <title>Quick Start</title>

    <para>
      Please write me.
    </para>

  </sect1>

<!-- HELLOWORLD -->

  <sect1 id="helloworld">
    <title>Hello, World - A Simple Project</title>

    <para>
      Please write me.
    </para>

  </sect1>

<!-- AUTHORS -->

  <sect1 id="authors">
    <title>Authors</title>

    <para>
      Glade was written by Damon Chaplin
      <email>damon@gnome.org</email>. To find more information
      about Glade, please visit the Glade
      <ulink url="http://glade.gnome.org" type="http">web page</ulink>.
    </para>

    <para>
      Please send all comments, suggestions, and bug reports to the
      Glade mailing list. Information on
      how to join this list is available at <ulink
      url="http://glade.gnome.org/lists.html" type="http">this
      page</ulink>.
    </para>

    <para>
      This reference manual is maintained by Michael Vance
      <email>briareos@lokigames.com</email>. Please send all
      comments, suggestions, and bug reports regarding the manual his
      way.
    </para>

    <para>

      <variablelist>
	<title>Contributors</title>

        <varlistentry>
	  <term>Ray Barker <email>fatray@home.com</email></term>
	  <listitem>
	    <para>
              Contributed menu dialog, file output documentation
            </para>
	  </listitem>
        </varlistentry>

	<varlistentry>
	  <term>
            Paul J. Drongowski <email>pjd@ives.lkg.dec.com</email>
          </term>
	  <listitem>
	    <para>
              Contributed quick start tutorial
            </para>
	  </listitem>
	</varlistentry>

      </variablelist>
    </para>

    <para>
      You can also add your comments online by using <ulink
      type="http" url="http://www.gnome.org/gdp/doctable/">GNOME
      Documentation Status Table</ulink>. 
    </para>

  </sect1>

</article>
