<!DOCTYPE article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
        <!-- if not using PNG graphic, replace reference above with
             .....PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
	     .....PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
         -->
<!ENTITY version "2.2.2"> 
]>

<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 1.0.3
  Template last modified: Nov 16, 2000
-->

<article id="index"> 
  <artheader>
    <title>Gdmconfig Manual</title>
    <copyright>
      <year>2001</year>
      <holder>Trevor Curtis</holder>
    </copyright>

  <!-- translators: uncomment this:

  <copyright>
   <year>2000</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
  <!-- Use this legal notice for online documents which depend on -->
  <!-- core GNOME packages.                                       -->
  <legalnotice id="legalnotice">
   <para>
    Permission is granted to copy, distribute and/or modify this document
    under the terms of the <ulink type="help" 
    url="gnome-help:fdl"><citetitle>GNU Free Documentation
    License</citetitle></ulink>, Version 1.1 or any later version 
    published by the Free Software Foundation with no Invariant Sections, 
    no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
    can be found <ulink type="help" url="gnome-help:fdl">here</ulink>.
   </para>
   <para>
    Many of the names used by companies to distinguish their products and
    services are claimed as trademarks. Where those names appear in any
    GNOME documentation, and those trademarks are made aware to the members
    of the GNOME Documentation Project, the names have been printed in caps
    or initial caps.
   </para>
  </legalnotice>

   <!-- Use this legal notice for documents which are placed on  -->
  <!-- the web, shipped in any way other than online documents  -->
  <!-- (eg. PS, PDF, or RTF), or which do not depend on the     -->
  <!-- core GNOME distribution.                                 -->
  <!--                                                          -->
  <!-- If you use this version, you must place the following    -->
  <!-- line in the document declaration at the top of your      -->
  <!-- document:                                                -->
  <!--   <!ENTITY FDL SYSTEM "fdl.sgml">                        -->
  <!-- and the following line at the bottom of your document    -->
  <!-- after the last </sect1>.                                 -->
  <!--   &FDL;                                                  -->
  <!--
 

  <legalnotice id="legalnotice">
   <para>
    Permission is granted to copy, distribute and/or modify this document
    under the terms of the <link linkend="fdl"><citetitle>GNU
    Free Documentation License</citetitle></link>, Version 1.1 or any later
    version published by the Free Software Foundation with no Invariant
    Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the
    license can be found in <xref linkend="fdl">.
   </para>
   <para>
    Many of the names used by companies to distinguish their products and
    services are claimed as trademarks. Where those names appear in any
    GNOME documentation, and those trademarks are made aware to the members
    of the GNOME Documentation Project, the names have been printed in caps
    or initial caps.
   </para>
  </legalnotice>
  -->

    <releaseinfo>
       This is version 1.0 of manual.
    </releaseinfo>

  </artheader>

  <sect1 id="intro">
    <title>Introduction</title>

    <para>
     <application>GDM Configurator, (GNOME Display Manager
     Configurator)</application>  is a configuration application
     for the GDM (Gnome Display Manager). Typically, when running your
     system in a
     graphical login mode, the GDM is the application that facilites
     logins. <application>GDM Configurator</application> allows for easy
     configuration of the GDM at various levels of detail.
     Customizations affect both operations and appearances.
    </para>

    <para>
      To run <application>GDM Configurator</application>, select
      <menuchoice>
	<guisubmenu>System</guisubmenu>
	<guimenuitem>GDM Configurator</guimenuitem>
      </menuchoice>
      from the <guimenu>Main Menu</guimenu>, or type
      <command>gdmconfig</command> on the command line.
    </para>

    <note><title>Root access required</title>
    <para><application>GDM Configurator</application> requires root access to run.
    </para> </note>

    <para>
      <application>GDM Configurator</application> is included in the
      <filename>GDM</filename> package, which is part of the
      GNOME desktop environment. This document describes version
      &version; of <application>GDM Configurator</application>.
    </para>
  </sect1>

  <sect1 id="usage">
    <title>Using Gnome Display Manager Configurator</title>
    <para>
      <application>GDM Configurator</application> can be used to
      change the login apperance, and behaviour as well as
      security and environment options of the GDM to varying
      degrees of detail. This section describes basic usage of
      <application>GDM Configurator</application>.
    </para>

    <sect2 id="mainwin">
      <title>Basic usage</title>
      <para>
        Starting <application>GDM Configure</application> opens the
        <interface>Main window</interface>, shown in <xref
        linkend="mainwindow-fig">. This window contains all
        options relating to the GDM's configuration.
      </para>

        <figure id="mainwindow-fig">
	  <title>GDM Configurator Main Window</title>
	  <screenshot>
	    <screeninfo>GDM Configurator Main Window</screeninfo>
	    <graphic fileref="figures/GDM_full.png" format="png" srccredit="Trevor
	    Curtis">
            </graphic>
	  </screenshot>
	</figure>
   </sect2>

   <sect2 id="menubar">
      <title>Toolbar</title>
      <para>
        Toolbar Menus
      </para>

      <figure id="menu-fig">
	  <title>The login appearance tab</title>
	  <screenshot>
	    <screeninfo>The login appearance tab</screeninfo>
	    <graphic fileref="figures/GDM_menubar" format="png" srccredit="Trevor
	    Curtis">
            </graphic>
	  </screenshot>
	</figure>
       <variablelist><title><guimenu>Configuration
	</guimenu></title>
	  <varlistentry>
	    <term><guimenuitem>Revert settings</guimenuitem></term>
	    <listitem>
	      <para>
                Reset current changes to initial settings
              </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guimenuitem>Apply</guimenuitem></term>
	    <listitem>
	      <para>
                Apply current changes  
              </para>
	    </listitem>
	  </varlistentry>
	</variablelist>
       
       <para>
       <variablelist><title><guimenu>Help</guimenu></title>
         <varlistentry>
           <term><guimenuitem>GDM
             Configurator
             users guide</guimenuitem>
           </term>
	   <listitem>
	     <para>How to get this document from within <application>GDM
	       Configurator</application>.
	     </para>
	   </listitem>
	 </varlistentry>
	 <varlistentry>
	   <term><guimenuitem>About...</guimenuitem></term>
	   <listitem>
	     <para>A little bit of kudos for all of the very hard
	       working guys/gals who made it all possible	
	     </para>
	   </listitem>
	 </varlistentry>
       </variablelist>
       </para>
    </sect2>

      <sect2 id="options">
	<title>Options</title>
	<para>
          The <guilabel>Options</guilabel> box in the upper left hand
          corner controls the level of detail and customization
          offered on the tabs to its right. Below the Options box
          is a brief description of the level chosen, and what can be
          done in that level. The levels are explained below.
        </para>
	<para>
                <variablelist>
	    <varlistentry>
	      <term><guilabel>Basic</guilabel></term>
	      <listitem>
		<para>
                  This exposes the <guilabel>Login
                  appearance</guilabel>, <guilabel>Login
                  behaviour</guilabel>, and <guilabel>Face
                  browser</guilabel> tabs to the right
                  of the <guilabel>Options</guilabel> box.
                </para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
            <term><guilabel>Expert</guilabel></term>
	    <listitem>
	      <para>
	        This exposes the <guilabel>Security</guilabel>,
                <guilabel>XDMCP</guilabel>, and <guilabel>X-server 
                setup</guilabel> tabs to the right
                of the <guilabel>Options</guilabel> box.               
	      </para>
	    </listitem>
            </varlistentry>
	    <varlistentry>
	      <term><guilabel>System</guilabel></term>
	      <listitem>
	      <para>
	        This exposes the <guilabel>Paths</guilabel>,
                <guilabel>Environment</guilabel>, and <guilabel>
		Chooser</guilabel> tabs to the right
                of the <guilabel>Options</guilabel> box.             
              </para>
	    </listitem>
            </varlistentry>
	  </variablelist>
          </para>
	
	<caution>
	  <title>Expert option and security</title>
	  <para>
	    Enabling the expert option, allows for changes in GDM's
	    security to be made. Improper configuration may lead to
	    vulnerabilities for attackers.
          </para>
	</caution>
	<warning>
	  <title>System option and system health</title>
	  <para>
	    Enabling the system option, allows for very specific changes
	    which can impact the operation of your system. This option
	    is only recommended for those who know exactly what they
	    are doing.
	  </para>
	</warning>
      </sect2>
  </sect1>


      <sect1 id="basic">
	<title>The Basic Options</title>
	<para>
	  Below are the options for the <guilabel>Login
	  appearance</guilabel>, <guilabel>Login behaviour</guilabel>
	  ,<guilabel>Face browser</guilabel>, and <guilabel> Automatic
         login</guilabel> tabs.
        </para>
 <variablelist><title><guilabel>Login appearance</guilabel></title>
	    <varlistentry>
	      <term></term>
	      <listitem>
	<figure id="loginappearance-fig">
	  <title>The login appearance tab</title>
	  <screenshot>
	    <screeninfo>The login appearance tab</screeninfo>
	    <graphic fileref="figures/GDM_login_appear" format="png" srccredit="Trevor
	    Curtis">
            </graphic>
	  </screenshot>
	</figure>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><guibutton>Minimised Icon:</guibutton></term>
	      <listitem>
	        <para>
		  Change the icon that represents the login screen
		  when minimized.
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guilabel>Logo</guilabel></term>
	      <listitem>
	        <para>
		  Change the image that is displayed in the login
		  window
		</para>
              </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guilabel>Gtk+ RC file</guilabel></term>
	      <listitem>
	        <para>
		  Specify the location of <filename>.gtkrc</filename>
		</para>
	      </listitem>
	    </varlistentry>
	 </variablelist>

	 <variablelist><title><guilabel>Login behaviour</guilabel></title>
	    <varlistentry>
	      <term></term>
	      <listitem>
   	        <figure id="loginbehaviour-fig">
	          <title>The login behaviour tab</title>
	          <screenshot>
	            <screeninfo>The login behaviour tab</screeninfo>
	            <graphic fileref="figures/GDM_login_behav"
		      format="png" srccredit="Trevor Curtis">
                    </graphic>
	          </screenshot>
	        </figure>

	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guibutton>Quiver on failure</guibutton></term>
	      <listitem>
	        <para>
		  If login fails, make the login window shake.
		</para>
              </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guilabel>Exclude these users</guilabel></term>
	      <listitem>
	        <para>
		  Do not show the users in the user menu, on the login box.
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guibutton>Default font:</guibutton></term>
	      <listitem>
	        <para>
		  The font to display and default to.
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guilabel>Welcome message</guilabel></term>
	      <listitem>
	        <para>
		  The text message to display in the login screen.
		</para>
		<note><title>Display machine name</title> 
		  <para>To have GDM display your machine name you can
		  type %n in the <guilabel>Welcome message</guilabel>
		  field, and it will
		  always be replaced with whatever your machine's name 
		  is.
		  </para> 
	        </note>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guilabel>Background Program</guilabel></term>
	      <listitem>
	        <para>This allows you to run a given script, or
	        application in the background whilst the login prompt
	        is displayed.
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guilabel>Default locale</guilabel></term>
	      <listitem>
	        <para>The locale that should be set as default in the
	        GDM
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guibutton>Lock position</guibutton></term>
	      <listitem>
	        <para>Lock the login box, such that it cannot be moved
	          within the login screen.
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guibutton>Manually set
	        position</guibutton></term>
	      <listitem>
	        <para>Allow for the login box to be moved manually
	          within the login screen
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guilabel>X position</guilabel></term>
	      <listitem>
	        <para>The x coordinate for the login box placement
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guilabel>Y position</guilabel></term>
	      <listitem>
	        <para>The y coordinate for the login box placement
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guilabel>Xinerama screen</guilabel></term>
	      <listitem>
	        <para>This option allows one to specify on which monitor,
	        in a multi-monitor setup, the GDM login screen will be
	        displayed.
		</para>
              </listitem>
	    </varlistentry>
	 </variablelist>

         <variablelist><title><guilabel>Face browser</guilabel>
	                    </title>
	  <varlistentry>
	    <term></term>
	    <listitem>
               <figure id="facebrowser-fig">
	         <title>The face browser tab</title>
	         <screenshot>
	           <screeninfo>The face browser tab</screeninfo>
	           <graphic fileref="figures/GDM_face_brow" format="png"
		     srccredit="Trevor Curtis">
                   </graphic>
	         </screenshot>
	       </figure>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term>Show choosable user images</term>
	    <listitem>
	       <para>Customization of user images in the face
	         browser
	       </para>
	     </listitem>
	   </varlistentry>
	   <varlistentry>
	     <term><guilabel>Default face image</guilabel></term>
             <listitem>
	       <para>Change the image used for default users in the
	       face browser
	       </para>
	     </listitem>
	   </varlistentry>
	   <varlistentry>
	     <term><guilabel>Global faces
	     directory</guilabel></term>
	     <listitem>
	       <para>The directory where the face images reside
	       </para>
	     </listitem>
	   </varlistentry>
	   <varlistentry>
	     <term><guilabel>Maximum face width</guilabel></term>
	     <listitem>
	       <para>The maximum width any given face image may be
	       </para>
	     </listitem>
	   </varlistentry>
	   <varlistentry>
	     <term><guilabel>Maximum face height</guilabel></term>
	     <listitem>
	       <para>The maximum height any given face image may be
	       </para>
	     </listitem>
	   </varlistentry>
	 </variablelist>

         <variablelist><title><guimenu>Background</guimenu></title>
                <varlistentry><term></term><listitem>
             <figure id="background-fig">
	         <title>The background tab</title>
	         <screenshot>
	           <screeninfo>The background tab</screeninfo>
	           <graphic fileref="figures/GDM_background" format="png"
		     srccredit="Trevor Curtis">
                   </graphic>
	         </screenshot>
	       </figure>
                </listitem>
                </varlistentry>
           <varlistentry>
           <term><guimenuitem>Background type</guimenuitem></term>
           <listitem>
             <para>
                Selection of background type. Options are backgrounds by 
                colour, image, or none at all.
             </para>
           </listitem>
         </varlistentry>
         <varlistentry>
           <term><guilabel>Scale background image to fit</guilabel></term>
           <listitem>
             <para>
                Allow an image, if selected above, to be scaled to fit alloted
                space.
             </para>
           </listitem>
         </varlistentry>
         <varlistentry>
           <term><guilabel>Only color on remote displays</guilabel></term>
           <listitem>
              <para>
                Enable a colour to be displayed only on remote systems
              </para>
           </listitem>
         </varlistentry>
         <varlistentry>
           <term><guilabel>Background program</guilabel></term>
           <listitem>
             <para>
               Allow a program to be run in the background
             </para>
           </listitem>
         </varlistentry>
        </variablelist>



        
         <variablelist><title><guimenu>Automatic login</guimenu></title>
                <varlistentry><term></term><listitem>
           <figure id="autologin-fig">
	         <title>The automatic login tab</title>
	         <screenshot>
	           <screeninfo>The automatic login tab</screeninfo>
	           <graphic fileref="figures/GDM_auto_login" format="png"
		     srccredit="Trevor Curtis">
                   </graphic>
	         </screenshot>
	       </figure>
                </listitem></varlistentry>
           <varlistentry>
           <term><guimenuitem>Login a user automatically on first bootup
           </guimenuitem></term>
           <listitem>
             <para>
                Enable logging in as the specified user when first starting
                the system.
             </para>
           </listitem>
         </varlistentry>
         <varlistentry>
           <term><guimenuitem>Login a user automatically after a specified 
                number of seconds.</guimenuitem></term>
           <listitem>
             <para>
                Allow the GDM to automatically login after the specified number                 of seconds using the specified user name.
              </para>
           </listitem>
         </varlistentry>
         <varlistentry>
           <term><guimenuitem>Timed login</guimenuitem></term>
           <listitem>
             <para>
                The specified user to be used to login automaticaly.
              </para>
           </listitem>
         </varlistentry>
         <varlistentry>
           <term><guimenuitem>Seconds before login</guimenuitem></term>
           <listitem>
             <para>
                The specified number of seconds before the GDM automatically 
                logs in.
              </para>
           </listitem>
         </varlistentry>
        </variablelist>

      </sect1>
      
      <sect1 id="expert">
        <title>The Expert Options</title>
	<para>
	  Below are the options for the <guilabel>Security
	  </guilabel>, <guilabel>XDMCP</guilabel>
	  and <guilabel>X-server setup</guilabel> tabs.
	</para>

    <!-- add screenshot here -->
        <variablelist><title><guimenu>Security</guimenu></title>
                <varlistentry><term></term><listitem>
         <figure id="security-fig">
	         <title>The security tab</title>
	         <screenshot>
	           <screeninfo>The security tab</screeninfo>
	           <graphic fileref="figures/GDM_security" format="png"
		     srccredit="Trevor Curtis">
                   </graphic>
	         </screenshot>
	       </figure>  
                </listitem></varlistentry>
	  <varlistentry>
	    <term><guimenuitem>Allow root to login with GDM
	    </guimenuitem></term>
	    <listitem>
	      <para>
	        Allow priviledged users, such as root, to login via
	        the GDM.
		<note><title>PAM supported systems</title>
		  <para>On systems that support PAM, this option is
		    ignored, and it becomes the responsiblity of the PAM
		    libraries to determine whether the user will be on the
		    local display or not.
		  </para>
		</note>
	      </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guimenuitem>Kill 'init'
	      clients</guimenuitem></term>
	    <listitem>
	      <para>
	        Allow the GDM to kill X clients that start from
	        initialization scripts when a user logs in.
	      </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guimenuitem>Authentication errors should be
	    verbose</guimenuitem></term>
	    <listitem>
	      <para>
	        Enable errors in authentication to be displayed to the
	        user(s) in the GDM display.
	      </para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><guimenuitem>Permissions:</guimenuitem></term>
	    <listitem>
	      <para>
	        Determine the permission levels in relation to writable
	        directories and files of other users. The
	        <guimenuitem>World writable</guimenuitem> selection
	        allows the GDM to view world writable files and
	        directories. The <guimenuitem>Group
	        writable</guimenuitem> selection allows the GDM to
	        view only group writable files and
	        directories. Finally, the
	        <guimenuitem>Paranoia</guimenuitem> selection will
	        only accept files and directories that the user owns.
	      </para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guimenuitem>GDM runs as this
	      user</guimenuitem></term>
	      <listitem>
	        <para>
		  Allows the GDM to be run as the specified user.
		</para>
              </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guimenuitem>GDM runs as this
	      group</guimenuitem></term>
	      <listitem>
	        <para>
	          Allows the GDM to be run as the specified group.
		</para>
              </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guimenuitem>User 'auth'
	      directory</guimenuitem></term>
	      <listitem>
	        <para>
		  Allow the directory which contains the user's .Xauthority 
                  file to be specified
		</para>
              </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guimenuitem>User 'auth' FB
	      directory</guimenuitem></term>
	      <listitem>
	        <para>
		  In case the gdm fails to update the user's .Xauthority file, 
                  a cookie will be created in the specified directory.
		</para>
              </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guimenuitem>User 'auth'
	      File</guimenuitem></term>
	      <listitem>
	        <para>
		  Specify the name of the file in which to store a user's
                  cookies. 
		</para>
              </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guimenuitem>Retry delay</guimenuitem></term>
	      <listitem>
	        <para>
		  Specify the number of seconds the GDM should wait
		  before reactivating the entry field after a failed
		  login attempt.
		</para>
              </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guimenuitem>Maximum user file length</guimenuitem></term>
	      <listitem>
	        <para>
		  Allows the maximum size of the largest
		  readable/writable file to be specified. The GDM will
		  refuse to read or write to a file bigger than the
		  given value. The value is specified in bytes.
		</para>
              </listitem>
	    </varlistentry>
	  </variablelist>

<!-- add screenshot -->
          <variablelist><title>XDMCP</title>
                <varlistentry><term></term><listitem>
                <figure id="xdmcp-fig">
	         <title>The XDMCP tab</title>
	         <screenshot>
	           <screeninfo>The XDMCP tab</screeninfo>
	           <graphic fileref="figures/GDM_xdmcp" format="png"
		     srccredit="Trevor Curtis">
                   </graphic>
	         </screenshot>
	       </figure>
                </listitem></varlistentry>
	    <varlistentry>
	      <term><guimenuitem>Enable XDMCP</guimenuitem></term>
	      <listitem>
	        <para>
		  Allow a remote X-terminal to request a session from
		  the current host. Enabling this option makes visible
		  the connection settings.(X Display Manager Control
		  Protocol)
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guimenuitem>Honour indirect
	      requests</guimenuitem></term>
	      <listitem>
	        <para>
		  Enable choosing for X-terminals which don't supply
		  their own display browser.
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guimenuitem>Listen on UDP
	      port</guimenuitem></term>
	      <listitem>
	        <para>
		  Listen to UDP(user datagram protocol) requests on
		  the specified port.
		</para>
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term><guimenuitem>Maximum pending
	      requests</guimenuitem></term>
	      <listitem>
	        <para>
		  Restrict the GDM to a fixed size queue of the
		  specified pending connections.
		  <warning><title>Denial of Service
		  Attacks</title>
		    <para>
		      This option has been included to avoid
		      DOS(Denial of Service Attacks). This parameter
		      only limits the number of allowed displays
		      initiating a connection at any one given time,
		      and does not limit the number of total remote
		      displays which can be managed.
		    </para>
		  </warning>
		</para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Max pending indirect
	        requests</guimenuitem></term>
		<listitem>
		  <para>
		    Allow only the specified number of displays with
		    the host chooser at any one given time.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Maximum remote
	        sessions</guimenuitem></term>
		<listitem>
		  <para>
		    Allow only the specified number of remote displays
		    to be able to use the host.
		  </para>
		</listitem>
              </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Maximum wait
	        time</guimenuitem></term>
		<listitem>
		  <para>
		    Wait for the specified amount of time in seconds
		    before the requesting display is removed from the
		    pending queue.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Maximum indirect wait
	        time</guimenuitem></term>
		<listitem>
		  <para>
		    Wait for the specified amount of time, in seconds,
		    between when a display requests a chooser and the
		    completion of the protocol negotiation before
		    removing display from the pending list.
		  </para>
		</listitem>
              </varlistentry>
	    </variablelist>
	 

	    <variablelist><title>X-server setup</title>
                <varlistentry><term></term><listitem>
               <figure id="xservsetup-fig">
	         <title>The xserver setup tab</title>
	         <screenshot>
	           <screeninfo>The xserver setup tab</screeninfo>
	           <graphic fileref="figures/GDM_xserv_setup" format="png"
		     srccredit="Trevor Curtis">
                   </graphic>
	         </screenshot>
	       </figure> 
                </listitem></varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Server
	        Definitions</guimenuitem></term>
		<listitem>
		  <para>
		    The local display number(s), and the command that
		    needs to be run to start the X server(s). <guibutton>Add</guibutton>
		    server brings up a dialog to enter X server and
		    any parameters that may need to be passed. <guibutton>Edit</guibutton>
		    server brings up a dialog box to edit the
		    highlighted entry. <guibutton>Delete
		    server</guibutton> deletes the hightlighted
		    entry.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Enable debugging
	        output</guimenuitem></term>
		<listitem>
		  <para>
		    Allow debugging information to be displayed
		  </para>
		</listitem>
	      </varlistentry>
	    </variablelist>
	  </sect1>



<!-- System section now -->

          <sect1 id="system">
	    <title>The System Options</title>
	    <para>
	      System menus
	    </para>
	  
<!-- screenshot -->
            <variablelist><title><guimenuitem>Paths</guimenuitem></title>
                <varlistentry><term></term><listitem>
              <figure id="paths-fig">
	         <title>The paths tab</title>
	         <screenshot>
	           <screeninfo>The paths tab</screeninfo>
	           <graphic fileref="figures/GDM_paths" format="png"
		     srccredit="Trevor Curtis">
                   </graphic>
	         </screenshot>
	       </figure>
                </listitem></varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Chooser
	        command</guimenuitem></term>
		<listitem>
		  <para>
		    Allow selection and customization of the command
		    that will activate the chooser.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Greeter
	        command</guimenuitem></term>
		<listitem>
		  <para>
		    Allow selection and customization of the command
		    that will activate the greeter.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Halt command</guimenuitem></term>
		<listitem>
		  <para>
		    Allow the specified command to halt the host
		    machine
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Reboot
	        command</guimenuitem></term>
		<listitem>
		  <para>
		    Allow the specified command to reboot the host
		    machine
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Display initialization
	        directory</guimenuitem></term>
		<listitem>
		  <para>
		    Display the directory that contains the scripts
		    needed for the GDM initilization.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Logging
	        directory</guimenuitem></term>
		<listitem>
		  <para>
		    Output logging information into a file(s) residing
		    in the specified directory.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Session
	        directory</guimenuitem></term>   
		<listitem>
		  <para>
		    Set the specified directory as the directory that
		    contains the scripts to start a session.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>PRE session scripts
	        directory</guimenuitem></term>
		<listitem>
		  <para>
		    Look for scripts in the specified directory to run
		    before starting a session.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>POST session scripts
	        directory</guimenuitem></term>
		<listitem>
		  <para>
		    Look for scripts in the specified directory to run
		    after ending a session.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>PID file</guimenuitem></term>
		<listitem>
		  <para>
		    Place the PID file(s) in the specified directory
		  </para>
		</listitem>
	      </varlistentry>
	    </variablelist>

	    <variablelist><title><guimenu>Environment</guimenu></title>
                <varlistentry><term></term><listitem>
                <figure id="enviro-fig">
	         <title>The environment tab</title>
	         <screenshot>
	           <screeninfo>The environment tab</screeninfo>
	           <graphic fileref="figures/GDM_enviro" format="png"
		     srccredit="Trevor Curtis">
                   </graphic>
	         </screenshot>
	       </figure>
                </listitem></varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Default $PATH</guimenuitem</term>
		<listitem>
		  <para>
		    Set the default PATH variable ($PATH)
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Root $PATH</guimenuitem></term>
		<listitem>
		  <para>
		    Set the PATH of the Root user to the specified
		    directories.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Locale file</guimenuitem></term>
		<listitem>
		  <para>
		    Set the specified file as the main locale file.
		  </para>
		</listitem>
	      </varlistentry>
	    </variablelist>
	    
	    <variablelist><title><guimenu>Chooser</guimenu></title>
                <varlistentry><term></term><listitem>
                <figure id="chooser-fig">
	         <title>The chooser tab</title>
	         <screenshot>
	           <screeninfo>The chooser tab</screeninfo>
	           <graphic fileref="figures/GDM_chooser" format="png"
		     srccredit="Trevor Curtis">
                   </graphic>
	         </screenshot>
	       </figure>
                </listitem></varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Directory for host
	        images</guimenuitem></term>
		<listitem>
		  <para>
		    Set the specified directory as the directory to
		    contain the images to represent hosts.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Default host
	        image</guimenuitem></term>
		<listitem>
		  <para>
		    Set the selected image as the default image to
		    represent hosts.
		  </para>
		</listitem>
	      </varlistentry>
	      <varlistentry>
	        <term><guimenuitem>Scan every 'x'
	        seconds</guimenuitem></term>
		<listitem>
		  <para>
                    Select the number of seconds after which host images are 
                    scanned
		  </para>
		</listitem>
	      </varlistentry>
	    </variablelist>
	  </sect1>

 <sect1 id="bugs">
  <title>Known Bugs and Limitations</title>
  <para>
   This application has no known bugs.
  </para>
 </sect1>

 <sect1 id="authors">
  <title>Authors</title>
  <para>
   <application>GDM Configure</application> was written by Lee Mallabone
   (<email>lee@fonicmonkey.net</email>). To find more information about
   <application>GDM Configure</application>, please visit the <ulink
   url="http://www.my-gnome-app.org" type="http">MY-GNOME-APP Web
   page</ulink>.  Please send all comments, suggestions, and bug
   reports to the <ulink url="http://bugzilla.gnome.org" type="http">GNOME
   bug tracking database</ulink>.  (Instructions for submitting bug
   reports can be found <ulink
   url="http://bugzilla.gnome.org/Reporting.html" type="http">
   on-line</ulink>.)  You can also use <application>Bug Report
   Tool</application> (<command>bug-buddy</command>), available in the
   <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
   Menu</guimenu>, for submitting bug reports.
  </para>

  <para>
   This manual was written by Trevor Curtis
   (<email>trevor.curtis@home.com</email>). Please send all comments and
   suggestions regarding this manual to the <ulink type="http"
   url="http://developer.gnome.org/projects/gdp">GNOME Documentation
   Project</ulink> by sending an email to
   <email>docs@gnome.org</email>. You can also add your comments
   online by using the <ulink type="http"
   url="http://developer.gnome.org/projects/gdp/doctable/">GNOME
   Documentation Status Table</ulink>.
  </para>

  <!-- For translations: uncomment this:

  <para>
   Latin translation was done by ME
   (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
   suggestions regarding this translation to SOMEWHERE.
  </para>
  -->

  </sect1>

 <sect1 id="license">
  <title>License</title>
  <para>
   This program is free software; you can redistribute it and/or
   modify it under the terms of the  <ulink type="help" url="gnome-help:gpl">
    <citetitle>GNU General Public License</citetitle></ulink> as
   published by the Free Software Foundation; 
   either version 2 of the License, or (at your option) any later
   version.
  </para>
  <para>
   This program is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   <citetitle>GNU General Public License</citetitle> for more details.
  </para>
  <para>
   A copy of the <citetitle>GNU General Public License</citetitle> is
   included as an appendix to the <citetitle>GNOME Users
   Guide</citetitle>.  You may also obtain a copy of the
   <citetitle>GNU General Public License</citetitle> from the Free
   Software Foundation by visiting <ulink type="http"
   url="http://www.fsf.org">their Web site</ulink> or by writing to
   <address>
    Free Software Foundation, Inc.
    <street>59 Temple Place</street> - Suite 330
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
    <country>USA</country>
   </address>
  </para>
 </sect1>
</article>
