<!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.0.97.1"> 
]>

<!-- 
      (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>Gnome-Core</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 &percnt;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>, 
    <guilabel>X-server setup</guilabel>, <guilabel>Login sessions</guilabel>, 
     and <guilabel>Miscellaneous</guilabel> tabs.
  </para>
  <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>

  <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>
    <varlistentry>
      <term><guimenuitem>Displays per host
      </guimenuitem></term>
      <listitem>
        <para>
          Specifies the number of displays that can run on any one host to be
          set.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Ping interval
      </guimenuitem></term>
      <listitem>
        <para>
          Specifies the interval, in minutes, that the gdm waits between 
          issuing pings to make sure the display is still alive.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>
      </guimenuitem></term>
      <listitem>
        <para>
          Allows the specification of a script to run to set the willing 
          headers sent by the manager.
        </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>Servers
       </guimenuitem></term>
      <listitem>
        <para>
           Displays a list of server definitions. From the buttons on the
           right, one can create aliases for a specific server setup. Enabling
           a server as <guimenuoption>Flexible</guimenuoptions>, indicates that
           the server can be started on demand.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Static Servers
       </guimenuitem></term>
      <listitem>
        <para>
          Allows the selection of servers which run always run. By picking
          one of the server definitions via the buttons on the right, one can
          setup the desired static server(s).
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Always restart X servers</guimenuitem></term>
      <listitem>
        <para>
          Enable the X server to restart after every logout.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Standard X server
      </guimenuitem></term>
      <listitem>
	<para>
	  Indicates the X server to be used and its respective path.
	</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Xnest server
      </guimenuitem></term>
      <listitem>
	<para>
	  Indicates the Xnest server to be used and its respective path.
	</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Maximum number of flexible servers
      </guimenuitem></term>
      <listitem>
	<para>
	  Indicates the maximum number of flexible servers, that may be 
          running at any one given time.
	</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Failsafe X server
      </guimenuitem></term>
      <listitem>
	<para>
	  Indicates the Failsafe X server to be used and its respective path.
	</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Script to run when X is crashing
      </guimenuitem></term>
      <listitem>
	<para>
	  Indicates a script to run in the event on's X session keeps crashing.
	</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>X configurator binaries to try
      </guimenuitem></term>
      <listitem>
	<para>
	  Indicates which binaries to use when an X session, or X itself, 
          crashes.
	</para>
      </listitem>
    </varlistentry>
  </variablelist>

  <variablelist><title>Login sessions</title>
    <varlistentry><term></term>
      <listitem>
        <figure id="loginsession-fig">
	  <title>The Login sessions tab</title>
	  <screenshot>
	    <screeninfo>The Login sessions tab</screeninfo>
	    <graphic fileref="figures/GDM_login_sessions" format="png"
	     srccredit="Trevor Curtis">
            </graphic>
	  </screenshot>
        </figure> 
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Session
       directory</guimenuitem></term>
      <listitem>
        <para>
          The directory that contains script(s) to be run at the begining 
          of a session
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Available Sessions</guimenuitem></term>
      <listitem>
        <para>
          List the available sessions in which to choose from. The selected 
          session will appear in the <guimenuitem>Selected session name
          </guimenuitem> field. Under this field, the session script is 
          displayed.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Gnome Chooser</guimenuitem></term>
      <listitem>
        <para>
          If a session named Gnome is present, enable the Gnome Chooser 
          session to be displayed.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Gnome Failsafe</guimenuitem></term>
      <listitem>
        <para>
          Enable the Gnome Failsafe session to be displayed.          
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Xterm Failsafe</guimenuitem></term>
      <listitem>
        <para>
          Enable the Xterm Failsafe session to be displayed.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Enable debugging
      output</guimenuitem></term>
      <listitem>
	<para>
	  Allow debugging information to be displayed
	</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Add session</guimenuitem></term>
      <listitem>
	<para>
	  Create and add a new session to be made available.
	</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Remove session</guimenuitem></term>
      <listitem>
	<para>
	  Delete the session selected in the <guimenuitem>Available 
          Sessions</guimenuitem> menu.
	</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Set as default</guimenuitem></term>
      <listitem>
	<para>
	  Enable the selected session in the <guimenuitem>Available 
          Sessions</guimenuitem> menu to be the default.
	</para>
        <note><title>Default session</title>
          <para>The current default session is indicated by a light blue 
            highlight under the <guimenuitem>Available Sessions</guimenuitem> 
            menu.
          </para> 
        </note>
      </listitem>
    </varlistentry>
  </variablelist>

  <variablelist><title>Miscellaneous</title>
    <varlistentry><term></term>
      <listitem>
        <figure id="misc-fig">
	  <title>The Miscellaneous tab</title>
	  <screenshot>
	    <screeninfo>The Miscellaneous tab</screeninfo>
	    <graphic fileref="figures/GDM_expert_misc" format="png"
	     srccredit="Trevor Curtis">
            </graphic>
	  </screenshot>
        </figure> 
      </listitem>
    </varlistentry>
    <varlistentry>
      <term><guimenuitem>Enable debugging output</guimenuitem></term>
      <listitem>
        <para>
          Enable the debugging output to be logged into the 
          syslog file.
        </para>  
        <caution>
          <title>Debug output to syslog</title>
          <para>
          Though a convieniant method to help track problems, this option, when
          selected, can fill up a system's log files rather quickly. This is 
          not recommended for normal use
          </para>
        </caution>
      </listitem>
    </varlistentry>
  </variablelist>

</sect1>

<sect1 id="system">
  <title>The System Options</title>
  <para>
  System menus
  </para>
	  
  <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>tcurtis@somaradio.ca</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>
