<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY libmateui-MateAbout SYSTEM "xml/mate-about.xml">
<!ENTITY libmateui-MateMDIChild SYSTEM "xml/mate-mdi-child.xml">
<!ENTITY libmateui-MateClient SYSTEM "xml/mate-client.xml">
<!ENTITY libmateui-MateColorPicker SYSTEM "xml/mate-color-picker.xml">
<!ENTITY libmateui-MateDateEdit SYSTEM "xml/mate-dateedit.xml">
<!ENTITY libmateui-MateDruidPageEdge SYSTEM "xml/mate-druid-page-edge.xml">
<!ENTITY libmateui-MateFileEntry SYSTEM "xml/mate-file-entry.xml">
<!ENTITY libmateui-MateDruidPageStandard SYSTEM "xml/mate-druid-page-standard.xml">
<!ENTITY libmateui-MateDruidPage SYSTEM "xml/mate-druid-page.xml">
<!ENTITY libmateui-MateDruid SYSTEM "xml/mate-druid.xml">
<!ENTITY libmateui-MateEntry SYSTEM "xml/mate-entry.xml">
<!ENTITY libmateui-MateFontPicker SYSTEM "xml/mate-font-picker.xml">
<!ENTITY libmateui-MateHRef SYSTEM "xml/mate-href.xml">
<!ENTITY libmateui-MateIconList SYSTEM "xml/mate-icon-list.xml">
<!ENTITY libmateui-MateIconLookup SYSTEM "xml/mate-icon-lookup.xml">
<!ENTITY libmateui-MateIconTheme SYSTEM "xml/mate-icon-theme.xml">
<!ENTITY libmateui-MateThemeFile SYSTEM "xml/mate-theme-parse.xml">
<!ENTITY libmateui-MateThumbnail SYSTEM "xml/mate-thumbnail.xml">
<!ENTITY libmateui-MateApp SYSTEM "xml/mate-app.xml">
<!ENTITY libmateui-MateMDIGenericChild SYSTEM "xml/mate-mdi-generic-child.xml">
<!ENTITY libmateui-MateMDI SYSTEM "xml/mate-mdi.xml">
<!ENTITY libmateui-MateAppBar SYSTEM "xml/mate-appbar.xml">
<!ENTITY libmateui-MateAuthentication SYSTEM "xml/mate-authentication.xml">
<!ENTITY libmateui-MateDialog SYSTEM "xml/mate-dialog.xml">
<!ENTITY libmateui-MateIce SYSTEM "xml/mate-ice.xml">
<!ENTITY libmateui-MateIconEntry SYSTEM "xml/mate-icon-entry.xml">
<!ENTITY libmateui-MateIconItem SYSTEM "xml/mate-icon-item.xml">
<!ENTITY libmateui-MateIconSelection SYSTEM "xml/mate-icon-sel.xml">
<!ENTITY libmateui-MateMessageBox SYSTEM "xml/mate-messagebox.xml">
<!ENTITY libmateui-MateMultiScreen SYSTEM "xml/mate-multi-screen.xml">
<!ENTITY libmateui-MatePassword SYSTEM "xml/mate-password.xml">
<!ENTITY libmateui-MatePixmapEntry SYSTEM "xml/mate-pixmap-entry.xml">
<!ENTITY libmateui-MatePixmap SYSTEM "xml/mate-pixmap.xml">
<!ENTITY libmateui-MatePropertyBox SYSTEM "xml/mate-propertybox.xml">
<!ENTITY libmateui-MateScores SYSTEM "xml/mate-scores.xml">
<!ENTITY libmateui-mate-app-helper SYSTEM "xml/mate-app-helper.xml">
<!ENTITY libmateui-mate-app-util SYSTEM "xml/mate-app-util.xml">
<!ENTITY libmateui-mate-mdi-session SYSTEM "xml/mate-mdi-session.xml">
<!ENTITY libmateui-mate-ui-init SYSTEM "xml/mate-ui-init.xml">
<!ENTITY libmateui-mate-dialog-util SYSTEM "xml/mate-dialog-util.xml">
<!ENTITY libmateui-mate-stock-icons SYSTEM "xml/mate-stock-icons.xml">
<!ENTITY libmateui-mate-types SYSTEM "xml/mate-types.xml">
<!ENTITY libmateui-mate-uidefs SYSTEM "xml/mate-uidefs.xml">
<!ENTITY libmateui-mate-vfs-util SYSTEM "xml/mate-vfs-util.xml">
<!ENTITY libmateui-mate-window SYSTEM "xml/mate-window.xml">
<!ENTITY libmateui-mate-window-icon SYSTEM "xml/mate-window-icon.xml">
<!ENTITY libmateui-mate-popup-menu SYSTEM "xml/mate-popup-menu.xml">
<!ENTITY libmateui-matetypebuiltins SYSTEM "xml/matetypebuiltins.xml">
<!ENTITY libmateui-object-index SYSTEM "xml/tree_index.sgml">
<!ENTITY version SYSTEM "version.xml">
]>
<book id="index">
  <bookinfo>
    <title>MATE UI Library Reference Manual</title>
    <releaseinfo>for libmateui &version;</releaseinfo>
  </bookinfo>

  <part>
    <title>MATE UI Library (libmateui)</title>

    <chapter id="initialization">
      <title>Initialization and Session Management</title>
      <para>
      This section includes functions and parameters used to initialise MATE
      applications which use <application>libmateui</application> and to
      handle interactions with whatever session manager is running when the
      application starts up.
      </para>
      <para>
      A typical application will call <function>mate_program_init</function>
      (from <filename>libmate/libmate.h</filename>) with parameters from the
      mate-ui-init section and will then possibly have further interactions
      (beyond the initial default setup performed by
      <function>mate_program_init</function>) with the session manager.
      </para>
      &libmateui-mate-ui-init;
      &libmateui-MateClient;
    </chapter>

    <chapter id="application-mgmt">
      <title>Application Management</title>
      <para>
      After initializing <application>libmateui</application>, a typical
      application will need to create its main application window, possibly
      with some non-standard decorations, create its credit (or About) box and
      get ready to enter the main loop. The functions in this section provide
      the facility for carrying out all of these operations.
      </para>
      &libmateui-MateApp;
      &libmateui-MateAppBar;
      &libmateui-mate-app-helper;
      &libmateui-MateMultiScreen;
      &libmateui-MateAuthentication;
      &libmateui-MatePassword;
    </chapter>

    <chapter id="druids">
      <title>Druids</title>
      <para>
      Druids (sometimes called <emphasis>Wizards</emphasis> on other systems)
      are a series of dialog boxes that lead the user through a task that is
      serial in nature (that is, it has a natural beginning, sequence through
      the pages and an end).
      </para>
      <para>
      Some applications (for example MATE Lokkit -- for setting up simple
      firewall settings) are purely a series of screens that extract some
      information from the user and then performs an action based on that data.
      Other applications may be more traditional in nature, however they may
      wish to run the user through a series of question the first time they run
      the application; such as to set things up correctly or to import
      settings from another program. Both these types of programs can use the
      various druid functions to make their implementation easier.
      </para>
      &libmateui-MateDruid;
      &libmateui-MateDruidPage;
      &libmateui-MateDruidPageEdge;
      &libmateui-MateDruidPageStandard;
    </chapter>

    <chapter id="fixme">
      <title>Miscellaneous Widgets</title>
      &libmateui-MateDateEdit;
      &libmateui-MateHRef;
      &libmateui-MateIce;
      &libmateui-MateIconEntry;
      &libmateui-MateIconLookup;
      &libmateui-MateIconSelection;
      &libmateui-MateThumbnail;
    </chapter>

    <chapter id="miscellaneous">
      <title>Miscellaneous Utility Functions and Macros</title>
      <para>
      This section collects together a number of useful auxillary functions
      that do not really fit into any other place in the hierarchy. These
      include the standard constants for icons, some standard type macros,
      function templates and functions for loading images.
      </para>
      &libmateui-mate-stock-icons;
      &libmateui-matetypebuiltins;
      &libmateui-mate-types;
      &libmateui-mate-uidefs;
      &libmateui-mate-vfs-util;
    </chapter>

    <chapter id="deprecated">
      <title>Deprecated Modules</title>
      &libmateui-MateAbout;
      &libmateui-mate-app-util;
      &libmateui-MateColorPicker;
      &libmateui-MateDialog;
      &libmateui-mate-dialog-util;
      &libmateui-MateEntry;
      &libmateui-MateFileEntry;
      &libmateui-MateFontPicker;
      &libmateui-MateIconList;
      &libmateui-MateIconItem;
      &libmateui-MateIconTheme;
      &libmateui-MateMDI;
      &libmateui-MateMDIChild;
      &libmateui-MateMDIGenericChild;
      &libmateui-mate-mdi-session;
      &libmateui-MateMessageBox;
      &libmateui-MatePixmap;
      &libmateui-MatePixmapEntry;
      &libmateui-mate-popup-menu;
      &libmateui-MatePropertyBox;
      &libmateui-MateScores;
      &libmateui-MateThemeFile;
      &libmateui-mate-window;
      &libmateui-mate-window-icon;
    </chapter>

    <chapter id="libmateui-objects">
      <title>Object Hierarchy</title>
      &libmateui-object-index;
    </chapter>
  </part>

  <index>
    <title>Index</title>
  </index>
  <index role="deprecated">
    <title>Index of deprecated symbols</title>
  </index>
  <index role="2.2">
    <title>Index of new symbols in 2.2</title>
  </index>
  <index role="2.4">
    <title>Index of new symbols in 2.4</title>
  </index>
  <index role="2.6">
    <title>Index of new symbols in 2.6</title>
  </index>
  <index role="2.8">
    <title>Index of new symbols in 2.8</title>
  </index>
  <index role="2.10">
    <title>Index of new symbols in 2.10</title>
  </index>
  <index role="2.12">
    <title>Index of new symbols in 2.12</title>
  </index>
  <index role="2.14">
    <title>Index of new symbols in 2.14</title>
  </index>
  <index role="2.16">
    <title>Index of new symbols in 2.16</title>
  </index>

</book>
