<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY toolversion "0.35">
  <!ENTITY manrevision "0.35">
  <!ENTITY date "June 2004">
  <!ENTITY tool "Services administration tool">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 06, 2003
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>&tool; Manual V&manrevision;</title> 
    <copyright>
      <year>2004</year>
      <holder>Carlos Garnacho Parro</holder>
    </copyright>

<!-- translators: uncomment this:
  <copyright>
   <year>2003</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>
   -->

    <publisher> 
	 <publishername>Carlos Garnacho Parro</publishername> 
    </publisher> 

&legal;
<!-- This file  contains link to license for the documentation (GNU FDL), and 
     other legal stuff such as "NO WARRANTY" statement. Please do not change 
     any of this. -->

    <authorgroup> 
      <author>
        <firstname>Carlos</firstname>
        <surname>Garnacho Parro</surname>
      </author>
      <!-- This is appropriate place for other contributors: translators,
           maintainers,  etc. Commented out by default.
        <othercredit role="translator">
	      <firstname>Latin</firstname> 
	      <surname>Translator 1</surname> 
	      <affiliation> 
	      	<orgname>Latin Translation Team</orgname> 
	       	<address> <email>translator@gnome.org</email> </address> 
	      </affiliation>
	      <contrib>Latin translation</contrib>
        </othercredit>
-->
    </authorgroup>

    <revhistory>
	 <revision>
	   <revnumber>&tool; Manual V&manrevision;</revnumber>
	   <date>&date;</date>
	   <revdescription>
          <para role="author">carlosg@gnome.org (Carlos Garnacho Parro)</para>
          <para role="publisher">carlosg@gnome.org (Carlos Garnacho Parro)</para>
	   </revdescription>
	 </revision>
    </revhistory>

    <releaseinfo>This manual describes version &toolversion; of &tool;.</releaseinfo> 

    <legalnotice> 
	 <title>Feedback</title> 
	 <para> To report a bug or make a suggestion regarding the &tool; or this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>. </para>
    </legalnotice> 
  </articleinfo> 

  <indexterm zone="index"> 
    <primary>Services Administration Tool</primary> 
  </indexterm> 

  <!-- ============= Document Body ============================= -->
  <sect1 id="tool-introduction"> 
    <title>Introduction</title> 
    <para>The <application>&tool;</application> allows you to specify which services will be started during the system boot process, as well as starting or stopping them instantly.</para> 
  </sect1>

  <sect1 id="tool-getting-started">
    <title>Getting started</title>

    <para>You can start <application>&tool;</application> in the following ways:</para>

    <variablelist>
	 <varlistentry>
	   <term><guimenu>Applications</guimenu> menu</term>
	   <listitem>
		<para>Choose <menuchoice><guisubmenu>System Tools</guisubmenu><guimenuitem>Services</guimenuitem></menuchoice>.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Command line</term>
	   <listitem>
		<para>Execute the following command: <command>services-admin</command></para>
	   </listitem>
	 </varlistentry>
    </variablelist>

    <para>When you start <application>&tool;</application>, you will be prompted for the administrator password, this is necessary because the changes done with this tool will affect the whole system.</para>

    <para>After entering the administrator password, the following window is displayed.</para>

    <figure id="services-main-window">
	 <title>&tool; main window</title>
	 <screenshot>
	   <mediaobject>
		<imageobject>
		  <imagedata fileref="figures/services-tool.png" format="PNG"/>
		</imageobject>
		<textobject>
		  <phrase>Shows &tool; main window.</phrase>
		</textobject>
	   </mediaobject>
	 </screenshot>
    </figure>

    <para>The <application>&tool;</application> main window contains the following elements:</para>

    <variablelist>
	 <varlistentry>
	   <term>Runlevels menu</term>
	   <listitem>
		<para>This drop-down menu allows you to tune your services' behavior by expressly telling them under which circumstances do they must start (i.e: enabled in graphical mode, while disabled in text mode). This menu may not exist if your system has not the concept of runlevels.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Services list</term>
	   <listitem>
		<para>This is a list of all the services installed in the system, telling whether they're active in the runlevel selected in the runlevels menu.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Ordering checkbox</term>
	   <listitem>
		<para>By default the services list has alphabetical order, turn on this checkbox to order the services by priority. This item may not exist if your system has not the concept of priority.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Service properties button</term>
	   <listitem>
		<para>This button displays more information about the selected service.</para>
	   </listitem>
	 </varlistentry>
    </variablelist>

    <figure id="service-properties-window">
	 <title>Service properties</title>
	 <screenshot>
	   <mediaobject>
		<imageobject>
		  <imagedata fileref="figures/service-properties.png" format="PNG"/>
		</imageobject>
		<textobject>
		  <phrase>Shows the service properties window.</phrase>
		</textobject>
	   </mediaobject>
	 </screenshot>
    </figure>
  </sect1>

  <sect1 id="tool-usage">
    <title>Usage</title>

    <sect2>
	 <title>To enable or disable a service at boot time</title>
	 <para>Turn up or down the checkbox beside the service in the services list.</para>
    </sect2>

    <sect2>
	 <title>To enable or disable a service inmediately</title>
	 <para>Select a service, click on the <guilabel>Service properties</guilabel> button and click on the <guilabel>Start</guilabel> or <guilabel>Stop</guilabel> buttons.</para>
    </sect2>

    <sect2>
	 <title>To change a service startup sequence</title>
	 <para>Select a service, click on the <guilabel>Service properties</guilabel> button and change the priority. If you have selected the <guilabel>Order list by startup sequence</guilabel> checkbox, you will see the selected service moving through the list. If your system does not have the concept of priorities, the spinbutton will not exist</para>
    </sect2>
  </sect1>
</article> 
