<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                      "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY % global_entities SYSTEM "global.ent">
%global_entities;
]>
<!-- PROCESSING INSTRUCTION FOR GNOME YELP  -->
<!-- comment in order to validate, uncomment for use in Yelp -->
<?yelp:chunk-depth 4?>
<book id="index">
    <title>&appfull;</title>
    <subtitle>User Manual</subtitle>
    <bookinfo>
        <title>&appfull; Manual &manrevision;</title>
        <abstract>
            <simpara>This is the User Manual &manrevision; to the
                <application>&appfull;</application> &appversion;, a free software that
                provides a user-friendly tool for editing <ulink
                url="&oasisopen;">DocBook</ulink> and other document types created in the
                    <glossterm>Extensible Markup Language Format</glossterm>
                (<acronym>XML</acronym>). It aims to hide the complexity and jargon of
                <acronym>XML</acronym> behind a friendly Graphical User Interface (<acronym>GUI</acronym>).</simpara>
        </abstract>
        <author>
            <firstname>Sean</firstname>
            <surname>Wheller</surname>
        </author>
        <copyright>
            <year>1999-2004</year>
            <holder>The Conglomerate Team</holder>
        </copyright>
        <revhistory>
            <revision>
                <revnumber>0.1</revnumber>
                <date>2003-12-30</date>
                <authorinitials>SW</authorinitials>
                <revdescription>
                    <remark>Manual V0.0.1 correlates to software V0.7.10</remark>
                </revdescription>
            </revision>
        </revhistory>
        <releaseinfo>
            <remark>This manual describes version &appversion; of <application>&app;</application>.</remark>
        </releaseinfo> &noticefdl; &noticegpl; </bookinfo>
    <preface id="preface">
        <title>Preface</title>
        <sect1 id="about_the_project">
            <title>About the &app; Project</title>
            <para>text</para>
        </sect1>
        <sect1 id="get_involved">
            <title>Getting Involved</title>
            <para>The <application>&app;</application> project is managed as an open source
                initiative to develop the ultimate user-friendly <acronym>XML</acronym> editing
                system. As such, help in the form of productive contribution is always welcomed.</para>
            <para>The first step in joining the project, is to join the <ulink
                    url="&devmail;">conglomerate-devel mailing list</ulink>. This is where our
                development discussion happens.</para>
            <para>Next, it is recommended that you join the <ulink
                    url="&bugmail;">conglomerate-auto mailing list</ulink>, which receives email
                every time something changes in our bug database.</para>
            <para>Then proceed to download a copy of the latest source code as described in <xref linkend="installation"/>.</para>
            <itemizedlist>
                <title>Things you can do to help:</title>
                <listitem>
                    <para>
                        <emphasis role="bold">Development:</emphasis> Add support for new XML
                        document types, fix bugs and implement new features. If you're a programmer,
                        looking for something to get stuck into, we've prepared a list of
                        easy-to-fix bugs, which should let you become familiar with the code without
                        having to look at all of it at once.</para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis role="bold">Testing:</emphasis> Test the various functions of the
                        editor, report replicable bugs not already listed in the bug tracking
                        system, please refer to the <ulink url="&bugs;">list of things</ulink>
                        we already know about.</para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis role="bold">Localization (I10n):</emphasis> Localize
                        <application>&app;</application> into your own language. Localization is
                        being co-ordinated by the <ulink url="&i10n;">Gnome Translation Project</ulink>.</para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis role="bold">Translation (I18n):</emphasis> Translate the
                        <application>&app;</application> User Manual and other documents into
                        your own language.</para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis role="bold">Documentation:</emphasis> Write articles, add new
                        sections, and improve on exiting sections within the documentation.</para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis role="bold">General:</emphasis> Suggest new features that would
                        make it easier to use get your work done - or are just simply cool!</para>
                </listitem>
            </itemizedlist>
        </sect1>
        <sect1 id="acknowledgements">
            <title>Acknowledgments</title>
            <para>Text</para>
        </sect1> &conventions; </preface>
    <chapter id="introduction">
        <title>Introduction</title>
        <para>The <application>&appfull;</application> is a free, user-friendly XML editor, for
                <ulink url="&oasisopen;">DocBook</ulink> and other XML document types. It aims
            to hide the complexity and jargon of XML behind a friendly GUI.</para>
        <para>
            <application>&appfull;</application> is one part of the
            <application>&app;</application> project to create a complete structured information
            authoring, management, archival, revision control and transformation system. The
            <application>&appfull;</application> uses XML semantics and powerful graphical
            editing, coupled with a centralised storage model and a flexible transformation language
            to create an environment that is easy to use, produces high-quality structured output,
            and lets the user target several formatted output file types from a single XML source.</para>
        <sect1 id="requirements">
            <title id="requirements.title">Requirements</title>
            <para>The <application>&appfull;</application> can be run on any Linux system that
                has Gnome 2.4 or higher installed. When this condition is met &app; can be run
                under the <ulink url="&gnomehome;">Gnome</ulink> or <ulink
                url="&kdehome;">KDE</ulink> desktops.</para>
            <para>&app; is dependant of the following libraries and their development versions:</para>
            <itemizedlist>
                <listitem>
                    <para>libxml-2.0 &gt;= 2.0.0</para>
                </listitem>
                <listitem>
                    <para>libxslt &gt;= 2.0.0 </para>
                </listitem>
                <listitem>
                    <para>libbonobo-2.0 &gt;= 2.0.0</para>
                </listitem>
                <listitem>
                    <para>libbonoboui-2.0 &gt;= 2.0.0</para>
                </listitem>
                <listitem>
                    <para>libgnomeui-2.0 &gt; 2.0.0</para>
                </listitem>
                <listitem>
                    <para>libglade-2.0 &gt;= 2.0.0</para>
                </listitem>
                <listitem>
                    <para>intltool-0.2.8 &gt; 0.2.8</para>
                </listitem>
            </itemizedlist>
            <warning>
                <para>
                    <application>&app;</application> &appversion; is an unstable release.
                    Current releases are intended as previews that some people may find useful.</para>
            </warning>
        </sect1>
        <sect1 id="installation">
            <title>Installation</title>
            <para>If <application>&app;</application> was shipped with your distro then you
                should be able to install it from the distibution source using a Software Installer.
                Please refer to your distro documentation for information on how to install new packages.</para>
            <para>Alternative methods of installation include installation from <link
                    linkend="installation_from_tarball" endterm="installation_from_tarball.title"/>
                or <link linkend="installation_from_cvs" endterm="installation_from_cvs.title"/>.</para>
            <sect2 id="installation_from_tarball">
                <title id="installation_from_tarball.title">Installation from tarball</title>
                <para>Releases are frequently packaged into tarballs and placed on the <ulink
                        url="&tarball;">project CVS</ulink> at SourceForge.</para>
                <note>
                    <para>When a new release is announced the tarball may take upto 24 hours to
                        display in the Web based CVS interface.</para>
                </note>
                <procedure>
                    <title>General installation overview</title>
                    <step>
                        <para>
                            <action>Start</action> a <application>Bash</application> session.</para>
                    </step>
                    <step>
                        <para>Login as root.</para>
                    </step>
                    <step>
                        <para>
                            <action>Copy</action> the tarball to a location such as <filename
                            class="directory">/usr/src/packages/</filename>. </para>
                        <para>
                            <command>cp filename-0.2.3.tar.gz /usr/src/packages/</command>
                        </para>
                    </step>
                    <step>
                        <para>
                            <action>Change</action> to this directory.</para>
                        <para>
                            <command>cd /usr/src/packages/</command>
                        </para>
                    </step>
                    <step>
                        <para>
                            <action>Extract</action> the tarball. This will create a new folder
                                <filename class="directory">filename-0.2.3</filename>
                        </para>
                        <para>
                            <command>tar xzvf filename-0.2.3.tar.gz</command>
                        </para>
                    </step>
                    <step>
                        <para>
                            <action>Change</action> to the new folder.</para>
                        <para>
                            <command>cd filename-0.2.3</command>
                        </para>
                    </step>
                    <step>
                        <para>
                            <action>Type</action> the following, followed by <keycap>Enter</keycap>.</para>
                        <para>
                            <command>./configure</command>
                        </para>
                    </step>
                    <step>
                        <para>If there are no errors, <action>type</action> the following, followed
                            by <keycap>Enter</keycap>.</para>
                        <para>
                            <command>make</command>
                        </para>
                        <para>If there are errors, resolve them if required.</para>
                    </step>
                    <step>
                        <para>
                            <action>Type</action> the following, followed by <keycap>Enter</keycap>.</para>
                        <para>
                            <command>make install</command>
                        </para>
                        <para>This will install to the default path <filename
                            class="directory">/usr/local/bin</filename> which should already be in
                            your environment <varname>PATH</varname>, type <command>echo
                            $PATH</command> to view your <varname>PATH</varname> if you are not sure.</para>
                    </step>
                </procedure>
            </sect2>
            <sect2 id="installation_from_cvs">
                <title id="installation_from_cvs.title">Installation from CVS</title>
                <para>If you don't mind running on the &quot;bleeding-edge&quot; of
                    development, you may also run your installation from the project
                        <glossterm>Concurrent Versioning System</glossterm> (<acronym>CVS</acronym>)
                    located at <ulink url="&cvshome;">Gnome</ulink>.</para>
                <note>
                    <para>As a result of the ongoing application of patches and addition of new
                        components to the source, installation from CVS is not guaranteed to work.</para>
                </note>
            </sect2>
        </sect1>
        <sect1 id="getting_started">
            <title>Getting Started</title>
            <para>You can start <application>&app;</application> in the following ways: </para>
            <!-- This procedure is different under various desktops -->
            <variablelist>
                <varlistentry>
                    <term>
                        <emphasis role="bold"> From the <guimenu>Applications</guimenu> menu</emphasis>
                    </term>
                    <listitem>
                        <para>Choose <menuchoice>
                                <guimenu>Main Menu</guimenu>
                                <guisubmenu>Utilities</guisubmenu>
                                <guisubmenu>Texteditor</guisubmenu>
                                <guimenuitem>Conglomerate XML Editor</guimenuitem>
                            </menuchoice>.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">From the Command Prompt</emphasis>
                    </term>
                    <listitem>
                        <para>To start <application>&app;</application> from the command prompt,
                            type <command>conglomerate</command>, then press <keycap>Enter</keycap>.</para>
                        <para>You can also open an XML file directly from the command by passing the
                            name of the XML file to open when <application>&app;</application>
                            starts, like this <command>conglomerate filename.xml</command>.</para>
                    </listitem>
                </varlistentry>
            </variablelist>
            <para>When you start <application>&app;</application>, the following window is displayed.</para>
            <figure id="fig_mainwindow">
                <title>&app; Start Up Window</title>
                <screenshot>
                    <mediaobject>
                        <imageobject>
                            <imagedata fileref="figures/cong_start_window.png" format="PNG"
                                depth="6cm" scalefit="1"/>
                        </imageobject>
                    </mediaobject>
                </screenshot>
            </figure>
            <para>This is the main window of the <application>&appfull;</application>. It
                provides basic options that can be used to create, open and import files when the
                <application>&app;</application> is first started. It also provides options to
                close the main window, exit the <application>&app;</application> and to access
                the user manual and about dialog which displays version and related information
                about the <application>&app;</application>. The main window becomes the editing
                interface when a new document is created or an exiting document is opened. New
                options will then be displayed, they are described in <xref linkend="editor_window"/>.</para>
            <para>If you want to quickly get a glimpse of the editor window, create a new document
                as follows. Documents are create with the help of templates, skeleton files that
                provide a basic structure from which to start documenting.
                <application>&app;</application> provides several templates, to get us started
                we will use the &quot;Docbook Article&quot; template.</para>
            <procedure id="proc_create_new_document">
                <title id="proc_create_new_document.title">Create a new document</title>
                <step>
                    <para>Choose <menuchoice>
                            <guimenu>
                                <accel>F</accel>ile</guimenu>
                            <guimenuitem>
                                <accel>N</accel>ew</guimenuitem>
                        </menuchoice> (<keycombo>
                            <keycap>Ctrl</keycap>
                            <keycap>N</keycap>
                        </keycombo>). A wizard dialog is displayed. This will assist you in
                        selecting a template to start your document.</para>
                </step>
                <step>
                    <para>
                        <action>Click</action>
                        <guibutton>Forward</guibutton> to display the list of available templates.</para>
                </step>
                <step>
                    <para>
                        <action>Select</action> the <option>Docbook Article</option>, then <action>click</action>
                        <guibutton>Forward</guibutton>. The wizard now has all the information
                        required to create a new Docbook XML Document of the type &quot;Article&quot;.</para>
                </step>
                <step>
                    <para>
                        <action>Click</action>
                        <guibutton>Apply</guibutton> to create the Article. This will open the <link
                            linkend="editor_window" endterm="editor_window.title"/>.</para>
                </step>
            </procedure>
            <para>Congratulations you have just created your first document with
                <application>&app;</application>. Now you will have to learn to get arround the
                    <link linkend="editor_window" endterm="editor_window.title"/> and perform common
                operations such as <link linkend="save_a_document"
                endterm="save_a_document.title"/>, <link linkend="inspect_document_properties"
                endterm="inspect_document_properties.title"/>, and generally <link linkend="markup"
                endterm="markup.title"/> your text.</para>
        </sect1>
        <sect1 id="supported_document_types">
            <title>Supported XML Document Types</title>
            <para>Ulimately the <application>&appfull;</application> is being developed to
                support creation and editing of any XML wide variety of data or document orientated
                XML instances.</para>
            <para>The following XML document types are currently supported, with time more will be added:</para>
            <itemizedlist>
                <listitem>
                    <para>
                        <link linkend="docbook_xml" endterm="docbook_xml.title"/>
                    </para>
                </listitem>
            </itemizedlist>
            <note>
                <para>A full list of the the XML Document Types supported can be found in <xref
                    linkend="doc_type_support"/>. This document also provides an introduction to
                    each of the document types and references where you can find more information.</para>
            </note>
        </sect1>
    </chapter>
    <chapter id="editor_window">
        <title id="editor_window.title">Editor Window</title>
        <para>As the name implies, the editor window is used to edit documents. This window is
            displayed when a new document is created or an exiting document is opened and has more
            options than the main window. The figure below shows the editor window after a new
            &quot;Docbook Article&quot; has been created.</para>
        <figure id="fig_editorwindow">
            <title>&app; Editor window</title>
            <screenshot>
                <mediaobject>
                    <imageobject>
                        <imagedata fileref="figures/cong_editor_window.png" format="PNG" depth="8cm" scalefit="1"/>
                    </imageobject>
                </mediaobject>
            </screenshot>
        </figure>
        <para>The editor window is comprise of the following elements:</para>
        <variablelist>
            <varlistentry>
                <term>
                    <emphasis role="bold">Window titlebar</emphasis>
                </term>
                <listitem>
                    <para>The window titlebar shows the filename of the document being edited. If
                        the document has not been saved to a file the default document name will be
                        <literal>(Untitled)</literal>. The window titlebar also provides the
                        standard menus and controls of the <application>Window Manager</application>.</para>
                    <screenshot>
                        <mediaobject>
                            <imageobject>
                                <imagedata fileref="figures/cong_editor_window_titlebar.png" format="PNG"/>
                            </imageobject>
                        </mediaobject>
                    </screenshot>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>
                    <emphasis role="bold">Menubar</emphasis>
                </term>
                <listitem>
                    <para>The Menubar provides menus that arrange and provide access to all the
                        functional operations of the <application>&appfull;</application>. The
                        menu options are described in the <link linkend="editor_window_menus" endterm="editor_window_menus.title"/>.</para>
                    <screenshot>
                        <mediaobject>
                            <imageobject>
                                <imagedata fileref="figures/cong_editor_window_menubar.png" format="PNG"/>
                            </imageobject>
                        </mediaobject>
                    </screenshot>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>
                    <emphasis role="bold">Toolbar</emphasis>
                </term>
                <listitem>
                    <para>The Toolbar provides quick access to the most commonly used operations of
                        the <application>&appfull;</application>. The menu options are described
                        in the <link linkend="editor_window_toolbar" endterm="editor_window_toolbar.title"/>.</para>
                    <screenshot>
                        <mediaobject>
                            <imageobject>
                                <imagedata fileref="figures/cong_editor_window_toolbar.png" format="PNG"/>
                            </imageobject>
                        </mediaobject>
                    </screenshot>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>
                    <emphasis role="bold">Document Area</emphasis>
                </term>
                <listitem>
                    <para>The Document Area is the main workspace.</para>
                    <screenshot>
                        <mediaobject>
                            <imageobject>
                                <imagedata fileref="figures/cong_editor_window_doc_area.png" format="PNG"/>
                            </imageobject>
                        </mediaobject>
                    </screenshot>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>
                    <emphasis role="bold">Status bar</emphasis>
                </term>
                <listitem>
                    <para>The Status Bar shows the &quot;Document Type&quot; of the open
                        document and provides a window &quot;Resize&quot; control with which
                        to increase or decrease the size of the editor window.</para>
                    <screenshot>
                        <mediaobject>
                            <imageobject>
                                <imagedata fileref="figures/cong_editor_window_statusbar.png" format="PNG"/>
                            </imageobject>
                        </mediaobject>
                    </screenshot>
                </listitem>
            </varlistentry>
        </variablelist>
        <sect1 id="editor_window_menus">
            <title id="editor_window_menus.title">Editor Window Menus</title>
            <para>The Menubar provides menus that arrange and provide access to all the functional
                operations of the <application>&appfull;</application>. The following options
                are available:</para>
            <variablelist>
                <title>Editor Window Menus and Options</title>
                <varlistentry>
                    <term>
                        <emphasis role="bold">
                            <guimenu>
                                <accel>F</accel>ile</guimenu>
                        </emphasis>
                    </term>
                    <listitem>
                        <para>Use the <guimenu>File</guimenu> menu, to perform the following tasks:</para>
                        <itemizedlist>
                            <listitem>
                                <para>
                                    <link linkend="create_a_document" endterm="create_a_document.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="open_a_document" endterm="open_a_document.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="save_as_document" endterm="save_as_document.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="save_a_document" endterm="save_a_document.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="import_a_document" endterm="import_a_document.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="export_a_document" endterm="export_a_document.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="inspect_document_properties" endterm="inspect_document_properties.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="close_a_window" endterm="close_a_window.title"/>
                                </para>
                            </listitem>
                        </itemizedlist>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">
                            <guimenu>
                                <accel>E</accel>dit</guimenu>
                        </emphasis>
                    </term>
                    <listitem>
                        <para>Use the <guimenu>Edit</guimenu> menu, to perform the following tasks:</para>
                        <itemizedlist>
                            <listitem>
                                <para>
                                    <link linkend="undo" endterm="undo.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="redo" endterm="redo.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="cut_text" endterm="cut_text.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="copy_text" endterm="copy_text.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="paste_text" endterm="paste_text.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="view_xml_source" endterm="view_xml_source.title"/>
                                </para>
                            </listitem>
                        </itemizedlist>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">
                            <guimenu>
                                <accel>T</accel>ools</guimenu>
                        </emphasis>
                    </term>
                    <listitem>
                        <para>Use the <guimenu>Tools</guimenu> menu, to perform the following tasks:</para>
                        <itemizedlist>
                            <listitem>
                                <para>
                                    <link linkend="validate_a_document" endterm="validate_a_document.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="cleanup_xml_source" endterm="cleanup_xml_source.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="dump_xds" endterm="dump_xds.title"/>
                                </para>
                            </listitem>
                            <listitem>
                                <para>
                                    <link linkend="edit_xds" endterm="edit_xds.title"/>
                                </para>
                            </listitem>
                        </itemizedlist>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">
                            <guimenu>
                                <accel>H</accel>elp</guimenu>
                        </emphasis>
                    </term>
                    <listitem>
                        <para>Use the <guimenu>Help</guimenu> menu, to display the
                            <application>&appfull;</application> &quot;About&quot;
                            dialog and access the Online Help.</para>
                    </listitem>
                </varlistentry>
            </variablelist>
        </sect1>
        <sect1 id="editor_window_toolbar">
            <title id="editor_window_toolbar.title">Editor Window Toolbar</title>
            <para>The Toolbar provides quick access to the most commonly used operations of the
                <application>&appfull;</application>. The following options are available:</para>
            <variablelist>
                <title>Editor Window Toolbar Options</title>
                <varlistentry>
                    <term>
                        <emphasis role="bold">Open</emphasis>
                    </term>
                    <listitem>
                        <para>Use the <guibutton>Open</guibutton> button, to <link
                                linkend="open_a_document" endterm="open_a_document.title"/> that
                            already exists.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">Save</emphasis>
                    </term>
                    <listitem>
                        <para>Use the <guibutton>Save</guibutton> button, to <link
                                linkend="save_a_document" endterm="save_a_document.title"/> that is
                            already save to a new file with a different filename.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">Undo</emphasis>
                    </term>
                    <listitem>
                        <para>Use the <guibutton>Undo</guibutton> button, to <link linkend="undo" endterm="undo.title"/>.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">Redo</emphasis>
                    </term>
                    <listitem>
                        <para>Use the <guibutton>Redo</guibutton> button, to <link linkend="redo" endterm="redo.title"/>.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">Cut</emphasis>
                    </term>
                    <listitem>
                        <para>Use the <guibutton>Cut</guibutton> button, to <link linkend="cut_text" endterm="cut_text.title"/>.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">Copy</emphasis>
                    </term>
                    <listitem>
                        <para>Use the <guibutton>Copy</guibutton> button, to <link
                                linkend="copy_text" endterm="copy_text.title"/>.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">Paste</emphasis>
                    </term>
                    <listitem>
                        <para>Use the <guibutton>Paste</guibutton> button, to <link
                                linkend="paste_text" endterm="paste_text.title"/>.</para>
                    </listitem>
                </varlistentry>
            </variablelist>
        </sect1>
        <sect1 id="editor_window_document_area">
            <title id="editor_window_document_area.title">Editor Window Document Area</title>
            <para>The document area is the main workspace. It provides two views of the open document:</para>
            <itemizedlist>
                <listitem>
                    <para>
                        <link linkend="outline_view" endterm="outline_view.title"/> (left-pane)</para>
                </listitem>
                <listitem>
                    <para>
                        <link linkend="page_view" endterm="page_view.title"/> (right-pane)</para>
                </listitem>
            </itemizedlist>
            <para>Each view is shown in a pane. The separator between the panes can be used to
                adjust how much of the document area is taken up by each of the views.</para>
            <sect2 id="outline_view">
                <title id="outline_view.title">Outline view</title>
                <para>Shows the structure of the document in a &quot;Tree View&quot;
                    control. The outline view provides two XML tree perspectives of the open document:</para>
                <itemizedlist>
                    <listitem>
                        <para>
                            <link linkend="overview" endterm="overview.title"/> (left-tab) </para>
                    </listitem>
                    <listitem>
                        <para>
                            <link linkend="raw_xml" endterm="raw_xml.title"/> (right-tab) </para>
                    </listitem>
                </itemizedlist>
                <para>Both perspectives enable the tree structure of the open document to be
                    navigated. Starting from the root node of the tree, elements that have
                    &quot;child&quot; or &quot;sibling-elements&quot; can be
                    expanded and collapsed.</para>
                <para>A context-sensitive pop-up menu is available when a selected node is
                    <action>right-clicked</action> with the mouse.</para>
                <para>The options displayed on the pop-up are dependent on the selected node type.
                    For example, when nodes that are representative of the tree root,
                    <acronym>XML</acronym> declaration, or document type declaration are selected,
                    the <guimenuitem>Cut</guimenuitem>, <guimenuitem>Copy</guimenuitem>,
                        <guimenuitem>Paste into</guimenuitem>, <guimenuitem>Paste
                    before</guimenuitem>, and <guimenuitem>Paste after</guimenuitem> options are not
                    displayed. When nodes that are representative of an <acronym>XML</acronym>
                    element that forms part of the vocabulary of the &quot;Document
                    Type&quot; are selected, these options will be available as shown in the
                    figure below.</para>
                <figure id="fig_outline_view_popup_menu">
                    <title>Outline view pop-up menu</title>
                    <screenshot>
                        <mediaobject>
                            <imageobject>
                                <imagedata fileref="figures/cong_editor_outlineview_popup_menu.png"
                                    format="PNG" depth="5cm" scalefit="1"/>
                            </imageobject>
                        </mediaobject>
                    </screenshot>
                </figure>
                <para>Use the outline view pop-up menu to perform the following tasks:</para>
                <itemizedlist>
                    <listitem>
                        <para>
                            <link linkend="modify_element_properties" endterm="modify_element_properties.title"/>
                        </para>
                    </listitem>
                    <listitem>
                        <para>
                            <link linkend="cut_text" endterm="cut_text.title"/>
                        </para>
                    </listitem>
                    <listitem>
                        <para>
                            <link linkend="copy_text.title" endterm="copy_text.title"/>
                        </para>
                    </listitem>
                    <listitem>
                        <para>
                            <link linkend="paste_into.title" endterm="paste_into.title"/>
                        </para>
                    </listitem>
                    <listitem>
                        <para>
                            <link linkend="paste_before.title" endterm="paste_before.title"/>
                        </para>
                    </listitem>
                    <listitem>
                        <para>
                            <link linkend="paste_after.title" endterm="paste_after.title"/>
                        </para>
                    </listitem>
                    <listitem>
                        <para>Insert a <link linkend="insert_sibling_elements"
                            endterm="insert_sibling_elements.title"/> after the current element.</para>
                    </listitem>
                    <listitem>
                        <para>Insert a <link linkend="insert_sub_elements"
                            endterm="insert_sub_elements.title"/> directly under the current element.</para>
                    </listitem>
                </itemizedlist>
                <note>
                    <para>This pop-up menu is also available when an <acronym>XML</acronym> element
                        is <action>right-clicked</action> in the <link linkend="page_view" endterm="page_view.title"/>.</para>
                </note>
                <sect3 id="overview">
                    <title id="overview.title">Overview tree perspective</title>
                    <para>In Overview perspective the tree nodes of the open document are shown by
                        their Docbook element name using a logical view. The value, or text,
                        contained by the element is not displayed. For this reason, paragraph or
                            <sgmltag class="starttag">para</sgmltag> elements within the tree cannot
                        be expanded.</para>
                    <para>The element name shown in the tree view is not always the same as that
                        shown in the <link linkend="page_view" endterm="page_view.title"/>. This is
                        because &app; renames elements according to the information provided by
                        a &quot;Display Specification&quot; which can define an alternate
                        bame for any element type. These names are not valid element names and are
                        therefore not used to created <acronym>XML</acronym> elements within the
                        <acronym>XML</acronym> source file. Instead they are mapped to valid Docbook
                        elements which are what is created in the open <acronym>XML</acronym> source
                        file or document. If they were to be inserted using the names provided by
                        <application>&app;</application>, the document would be invalid against
                        the rules specified by the documents <glossterm>Document Type
                        Definition</glossterm> (<acronym>DTD</acronym>). A listing of the mappings
                        for various document types is provided in <xref linkend="display_spec_element_map_ref"/>.</para>
                    <figure id="fig_outline_overview">
                        <title>Outline view in Overview perspective</title>
                        <screenshot>
                            <mediaobject>
                                <imageobject>
                                    <imagedata
                                        fileref="figures/cong_editor_outlineview_overview.png"
                                        format="PNG" depth="5cm" scalefit="1"/>
                                </imageobject>
                            </mediaobject>
                        </screenshot>
                    </figure>
                </sect3>
                <sect3 id="raw_xml">
                    <title id="raw_xml.title">Raw XML tree perspective</title>
                    <para>In Raw XML perspective the tree nodes of the open document are shown using
                        the full XML syntax, so the &quot;greater-than&quot; (&lt;) and
                        &quot;less-than&quot; (&gt;) characters the surround element
                        names are shown. The value of the element, the tagged text, is also shown
                        alongside the element in inverted commas (see <xref linkend="fig_outline_raw_xml"/>).</para>
                    <figure id="fig_outline_raw_xml">
                        <title>Outline view in Raw XML perspective</title>
                        <screenshot>
                            <mediaobject>
                                <imageobject>
                                    <imagedata fileref="figures/cong_editor_outlineview_raw.png"
                                        format="PNG" depth="5cm" scalefit="1"/>
                                </imageobject>
                            </mediaobject>
                        </screenshot>
                    </figure>
                </sect3>
            </sect2>
            <sect2 id="page_view">
                <title id="page_view.title">Page view</title>
                <para>The page view shows the content of the open document and the elements in which
                    various content typesare tagged.</para>
                <para>Block elements such as <sgmltag class="starttag">article</sgmltag>, <sgmltag
                    class="starttag">sect1</sgmltag>, <sgmltag class="starttag">sect2</sgmltag>, and
                        <sgmltag class="starttag">figure</sgmltag> are shown in &quot;structural
                    element borders&quot; and inline elements are displayed with a line beneath
                    the tagged text (see <xref linkend="fig_page_view_doc_edit"/>).</para>
                <para>The &quot;structural element borders&quot; for nested block structures
                    are alternately colored to help readability. The captions used, correspond to
                    the <application>&app;</application> equivalent of the Document Type
                    elements. For example, in the following figure the
                    <application>&app;</application> &quot;Paragraph&quot; caption will
                    correspond with the Docbook <literal>&lt;para&gt;</literal> element. For
                    inline elements the caption name is written in the center of the line beneath
                    the tagged text. A listing of the <application>&app;</application> names is
                    provided in <xref linkend="display_spec_element_map_ref"/> for each of the <link
                        linkend="doc_type_support" endterm="doc_type_support.title"/>.</para>
                <figure id="fig_page_view_doc_edit">
                    <title>Page view display of elements</title>
                    <screenshot>
                        <mediaobject>
                            <imageobject>
                                <imagedata fileref="figures/cong_editor_window_doc_edit.png"
                                    format="PNG" depth="5cm" scalefit="1"/>
                            </imageobject>
                        </mediaobject>
                    </screenshot>
                </figure>
                <para>Wrapped captions can be expanded or collapsed by <action>clicking</action> the
                    mouse on the caption label. In <xref linkend="fig_wrapped_caption_states"/> both
                    states are shown. Notice that the content for &quot;Subtitle&quot;,
                    &quot;Title&quot; under the <sgmltag
                    class="starttag">articleinfo</sgmltag>, and the &quot;Author&quot; has
                    been hidden. Inline elements cannot be collapsed.</para>
                <figure id="fig_wrapped_caption_states">
                    <title>Wrapped caption states - expanded and collapsed</title>
                    <screenshot>
                        <mediaobject>
                            <imageobject>
                                <imagedata
                                    fileref="figures/cong_editor_window_doc_edit_collapse.png"
                                    format="PNG" depth="5cm" scalefit="1"/>
                            </imageobject>
                        </mediaobject>
                    </screenshot>
                </figure>
                <para>Two pop-up menus are available in the page view, each is associated with a
                    different object:</para>
                <variablelist>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Block Element Menu</emphasis>
                        </term>
                        <listitem>
                            <para>This is the same menu that is available when an XML element is
                                <action>right-clicked</action> in the <link linkend="outline_view"
                                endterm="outline_view.title"/>, only this time the menu is displayed
                                when the caption label is <action>right-clicked</action>. Use the
                                block element menu to:</para>
                            <itemizedlist>
                                <listitem>
                                    <para>
                                        <link linkend="modify_element_properties" endterm="modify_element_properties.title"/>
                                    </para>
                                </listitem>
                                <listitem>
                                    <para>
                                        <link linkend="cut_text" endterm="cut_text.title"/>
                                    </para>
                                </listitem>
                                <listitem>
                                    <para>
                                        <link linkend="copy_text" endterm="copy_text.title"/>
                                    </para>
                                </listitem>
                                <listitem>
                                    <para>
                                        <link linkend="paste_into" endterm="paste_into.title"/>
                                    </para>
                                </listitem>
                                <listitem>
                                    <para>
                                        <link linkend="paste_before" endterm="paste_before.title"/>
                                    </para>
                                </listitem>
                                <listitem>
                                    <para>
                                        <link linkend="paste_after" endterm="paste_after.title"/>
                                    </para>
                                </listitem>
                                <listitem>
                                    <para>Insert a <link linkend="insert_sibling_elements"
                                        endterm="insert_sibling_elements.title"/> after the current element.</para>
                                </listitem>
                                <listitem>
                                    <para>Insert a <link linkend="insert_sub_elements"
                                        endterm="insert_sub_elements.title"/> directly under the
                                        current element.</para>
                                </listitem>
                            </itemizedlist>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Text Menu</emphasis>
                        </term>
                        <listitem>
                            <para>This menu is displayed when text contained in a block element is
                                <action>right-clicked</action>. It displays a list of options that
                                allow you to:</para>
                            <itemizedlist>
                                <listitem>
                                    <para>
                                        <link linkend="cut_text" endterm="cut_text.title"/>
                                    </para>
                                </listitem>
                                <listitem>
                                    <para>
                                        <link linkend="copy_text" endterm="copy_text.title"/>
                                    </para>
                                </listitem>
                                <listitem>
                                    <para>
                                        <link linkend="insert_inline_elements" endterm="insert_inline_elements.title"/>
                                    </para>
                                </listitem>
                                <listitem>
                                    <para>
                                        <link linkend="insert_inline_elements" endterm="insert_inline_elements.title"/>
                                    </para>
                                </listitem>
                            </itemizedlist>
                        </listitem>
                    </varlistentry>
                </variablelist>
            </sect2>
        </sect1>
        <sect1 id="window_management">
            <title>Window Management</title>
            <para>The <application>&appfull;</application> uses your chosen <application>Window
                Manager</application> to create the main and editor windows. Multiple instances of
                <application>&app;</application> can be run at the same time and multiple editor
                windows can be opened, each editor window displaying a single document. With so many
                windows open, window management can become a problem. Fortunately, most desktops
                like <ulink url="&gnomehome;">GNOME</ulink> and <ulink
                url="&kdehome;">KDE</ulink> have a <application>Taskbar</application> with
                powerful desktop management features. These should enable you to maximize the usage
                of your screen real-estate. The standard window controls of your desktop environment
                will also help you to define the behavior of your
                <application>&app;</application> windows.</para>
            <para>Within <application>&app;</application> there are two options for window and
                application management:</para>
            <itemizedlist>
                <listitem>
                    <para>
                        <link linkend="close_a_window" endterm="close_a_window.title"/>
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <link linkend="exit_cong" endterm="exit_cong.title"/>
                    </para>
                </listitem>
            </itemizedlist>
            <sect2 id="close_a_window">
                <title id="close_a_window.title">Close</title>
                <para>As multiple editor windows can be opened, editor windows can also be
                    individually closed by selecting <menuchoice>
                        <guimenu>
                            <accel>F</accel>ile</guimenu>
                        <guimenuitem>
                            <accel>C</accel>lose</guimenuitem>
                    </menuchoice> or using the keyboard combination <keycombo>
                        <keycap>Ctrl</keycap>
                        <keycap>W</keycap>
                    </keycombo>.</para>
                <caution>
                    <para>This option should not be confused with the <option>Exit</option> option,
                        which will close all <application>&app;</application> windows associated
                        with a <application>&app;</application> instance and terminate the application.</para>
                </caution>
            </sect2>
            <sect2 id="exit_cong">
                <title id="exit_cong.title">Exit</title>
                <para>Selecting <menuchoice>
                        <guimenu>
                            <accel>F</accel>ile</guimenu>
                        <guimenuitem>
                            <accel>Q</accel>uit</guimenuitem>
                    </menuchoice> or using the keyboard combination <keycombo>
                        <keycap>Ctrl</keycap>
                        <keycap>Q</keycap>
                    </keycombo> on the main window and any editor window will close all windows
                    associated with the <application>&app;</application> instance and exit the application.</para>
            </sect2>
        </sect1>
    </chapter>
    <chapter id="performing_tasks">
        <title>Performing Tasks</title>
        <sect1 id="file_management">
            <title>File Management</title>
            <sect2 id="create_a_document">
                <title id="create_a_document.title">Create a document</title>
                <para>When <application>&app;</application> is first started main window does
                    not provide editing functionality. To display the editor window Create or <link
                        linkend="open_a_document" endterm="open_a_document.title"/>.</para>
                <procedure>
                    <title>Creating a Document</title>
                    <step>
                        <para>From the main window menu <action>select</action>
                            <menuchoice>
                                <guimenu>File</guimenu>
                                <guimenuitem>New</guimenuitem>
                            </menuchoice>. The <application>Create New File</application> wizard is started.</para>
                        <screenshot>
                            <mediaobject>
                                <imageobject>
                                    <imagedata fileref="figures/cong_create_new_file_wiz1.png"
                                        depth="5cm" scalefit="1"/>
                                </imageobject>
                            </mediaobject>
                        </screenshot>
                    </step>
                    <step>
                        <para>
                            <action>Click</action> the <guibutton>Forward</guibutton> button. The
                            wizard displays alist of document type templates.</para>
                        <screenshot>
                            <mediaobject>
                                <imageobject>
                                    <imagedata fileref="figures/cong_create_new_file_wiz2.png"
                                        depth="5cm" scalefit="1"/>
                                </imageobject>
                            </mediaobject>
                        </screenshot>
                    </step>
                    <step>
                        <para>
                            <action>Select</action> a suitable template from the list, then
                            <action>click</action> the <guibutton>Forward</guibutton> button. The
                            final dialog of the wizard is displayed.</para>
                    </step>
                    <step>
                        <para>
                            <action>Click</action> the <guibutton>Apply</guibutton> button. The
                            Editor Window is displayed with the selected template ready for editing.</para>
                        <screenshot>
                            <mediaobject>
                                <imageobject>
                                    <imagedata fileref="figures/cong_editor_window.png" depth="5cm" scalefit="1"/>
                                </imageobject>
                            </mediaobject>
                        </screenshot>
                    </step>
                </procedure>
            </sect2>
            <sect2 id="open_a_document">
                <title id="open_a_document.title">Open a document</title>
                <para>The option to open an exiting document can be performed from the main and
                    editor windows. The following procedure is performed from the main window.</para>
                <procedure>
                    <title>Opening a Document</title>
                    <step>
                        <para>From the Menubar <action>select</action>
                            <menuchoice>
                                <guimenu>File</guimenu>
                                <guimenuitem>Open</guimenuitem>
                            </menuchoice>. The Select an XML File dialog is displayed.</para>
                        <screenshot>
                            <mediaobject>
                                <imageobject>
                                    <imagedata fileref="figures/cong_open_dialog.png" depth="5cm" scalefit="1"/>
                                </imageobject>
                            </mediaobject>
                        </screenshot>
                    </step>
                    <step>
                        <para>Use the Folders list view to <action>Navigate</action> to the folder
                            containing the required file.</para>
                    </step>
                    <step>
                        <para>Use the Files list view to <action>select</action> the file, then <action>click</action>
                            <guibutton>OK</guibutton>.</para>
                    </step>
                    <step>
                        <para>The selected file is opened in the editor window.</para>
                    </step>
                </procedure>
            </sect2>
            <sect2 id="save_a_document">
                <title id="save_a_document.title">Save a document</title>
                <para>The first time you save a document you will be required to provide a file name
                    and select a location where the file will be written to disk (see <xref
                    linkend="save_as_document"/>). Once a document is saved to disk, the save
                    operation will write directly to the open file.</para>
                <tip>
                    <para>Save your document before you start and regularly there after to avoid
                        loosing work due to unexpected software failure.</para>
                </tip>
            </sect2>
            <sect2 id="save_as_document">
                <title id="save_as_document.title">Save As new document</title>
                <para>It is sometimes convenient to save an exiting file to a copy using a new
                    filename or to a different location.</para>
                <para>Assuming that a document is already open proceed as follows.</para>
                <procedure>
                    <title>Save As new document</title>
                    <step>
                        <para>
                            <action>Select</action>
                            <menuchoice>
                                <guimenu>File</guimenu>
                                <guimenuitem>Save As</guimenuitem>
                            </menuchoice> (<keycombo>
                                <keycap>Ctrl+Shft+S</keycap>
                            </keycombo>). The Save XML As dialog is displayed.</para>
                        <screenshot>
                            <mediaobject>
                                <imageobject>
                                    <imagedata fileref="figures/cong_save_as_dialog.png" depth="5cm"
                                        scalefit="1" format="PNG"/>
                                </imageobject>
                            </mediaobject>
                        </screenshot>
                    </step>
                    <step>
                        <para>Use the Folders list to navigate to the folder where the new copy of
                            the file will be saved.</para>
                    </step>
                    <step>
                        <para>Enter a filename in the Selection field.</para>
                    </step>
                    <step>
                        <para>
                            <action>Click</action>
                            <guibutton>OK</guibutton> to save a new copy of the file.</para>
                    </step>
                </procedure>
            </sect2>
            <sect2 id="import_a_document">
                <title id="import_a_document.title">Import a document</title>
                <para>text</para>
            </sect2>
            <sect2 id="export_a_document">
                <title id="export_a_document.title">Export a document</title>
                <para>text</para>
            </sect2>
            <sect2 id="inspect_document_properties">
                <title id="inspect_document_properties.title">Inspect document properties</title>
                <para>text</para>
            </sect2>
        </sect1>
        <sect1 id="editing">
            <title>Editing</title>
            <sect2 id="typing_text">
                <title>Typing text</title>
                <para>text</para>
            </sect2>
            <sect2 id="undo">
                <title id="undo.title">Undo actions</title>
                <para>Text</para>
            </sect2>
            <sect2 id="redo">
                <title id="redo.title">Redo actions</title>
                <para>Text</para>
            </sect2>
            <sect2 id="cut_text">
                <title id="cut_text.title">Cut text and elements</title>
                <para>text</para>
            </sect2>
            <sect2 id="copy_text">
                <title id="copy_text.title">Copy text and elements</title>
                <para>text</para>
            </sect2>
            <sect2 id="paste_text">
                <title id="paste_text.title">Paste text and elements</title>
                <para>text</para>
            </sect2>
            <sect2 id="paste_into">
                <title id="paste_into.title">Paste into an element</title>
                <para>text</para>
            </sect2>
            <sect2 id="paste_before">
                <title id="paste_before.title">Paste before an element</title>
                <para>text</para>
            </sect2>
            <sect2 id="paste_after">
                <title id="paste_after.title">Paste after an element</title>
                <para>text</para>
            </sect2>
            <sect2 id="view_xml_source">
                <title id="view_xml_source.title">View XML source</title>
                <para>text</para>
            </sect2>
        </sect1>
        <sect1 id="markup">
            <title id="markup.title">Markup</title>
            <para>text</para>
            <sect2 id="insert_elements">
                <title>Insert Elements</title>
                <para>text</para>
                <sect3 id="insert_sibling_elements">
                    <title id="insert_sibling_elements.title">New sibling-element</title>
                    <para>text</para>
                </sect3>
                <sect3 id="insert_sub_elements">
                    <title id="insert_sub_elements.title">New sub-element</title>
                    <para>text</para>
                </sect3>
                <sect3 id="insert_inline_elements">
                    <title id="insert_inline_elements.title">Insert inline elements</title>
                    <para>text</para>
                </sect3>
                <sect3 id="remove_inline_elements">
                    <title id="remove_inline_elements.title">Remove inline elements</title>
                    <para>text</para>
                </sect3>
            </sect2>
            <sect2 id="cleanup_xml_source">
                <title id="cleanup_xml_source.title">Cleanup XML source</title>
                <para>text</para>
            </sect2>
            <sect2 id="modify_element_properties">
                <title id="modify_element_properties.title">Modify Element Properties</title>
                <para>text</para>
                <sect3 id="about_xpath">
                    <title>About XPath</title>
                    <para>text</para>
                </sect3>
                <sect3 id="scope">
                    <title>Scope</title>
                    <para>text</para>
                </sect3>
                <sect3 id="language">
                    <title>Language</title>
                    <para>text</para>
                </sect3>
                <sect3 id="revisions">
                    <title>Revisions</title>
                    <para>text</para>
                </sect3>
                <sect3 id="advanced">
                    <title>Advanced</title>
                    <para>text</para>
                </sect3>
            </sect2>
        </sect1>
        <sect1 id="validating">
            <title>Validating</title>
            <para>text</para>
            <sect2 id="about_validation">
                <title>About validation</title>
                <para>text</para>
            </sect2>
            <sect2 id="validate_a_document">
                <title id="validate_a_document.title">Validate a document</title>
                <para>text</para>
            </sect2>
        </sect1>
    </chapter>
    <chapter id="design_display_definitions">
        <title id="design_display_definitions.title">Designing Display Definitions</title>
        <para>Display specifications are <acronym>XML</acronym> files saved with the extension
                <filename>XDS</filename>. They hold various types of information,
            that annotate a one or more Document Types that may be edited with the &appfull;.</para>
        <para>Display specifications do not take the place of <acronym>DTD</acronym>, XML Schema, or
            <acronym>XSL</acronym> files. Their function is only to provide information to
            <application>&app;</application> when editing a given <acronym>XML</acronym> instance.</para>
        <para>Because display specifications are <acronym>XML</acronym>, they can be easily modified
            in order to customize the <application>&app;</application> editing environment to
            the particluar requirements of a user or a specific <acronym>XML</acronym> file.</para>
        <para>A complete definition of the &app; XDS DTD is available in <xref linkend="xds_dtd_def"/>.</para>
        <para>The following operations can be performed on XDS files:</para>
        <itemizedlist>
            <listitem>
                <para>
                    <link linkend="edit_xds" endterm="edit_xds.title"/>
                </para>
            </listitem>
            <listitem>
                <para>
                    <link linkend="dump_xds" endterm="dump_xds.title"/>
                </para>
            </listitem>
        </itemizedlist>
        <sect1 id="edit_xds">
            <title id="edit_xds.title">Edit a Display Spec</title>
            <para>text</para>
        </sect1>
        <sect1 id="dump_xds">
            <title id="dump_xds.title">Dump a Display Spec</title>
            <para>text</para>
        </sect1>
    </chapter> <!--&faq;--> &doctype_supp; &xds_ele_ref; &xds_dtd_def; <glossary role="auto">
        <glossentry>
            <glossterm>Dummy</glossterm>
            <glossdef>
                <para>Now you see me, next you won't</para>
            </glossdef>
        </glossentry>
    </glossary>
</book>
