<?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 "Users 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>Users Administration Tool</primary> 
  </indexterm> 

  <!-- ============= Document Body ============================= -->
  <sect1 id="tool-introduction"> 
    <title>Introduction</title> 
    <para>The <application>&tool;</application> allows you add, delete and modify the existing users and groups in your system.</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>Users and groups</guimenuitem></menuchoice>.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Command line</term>
	   <listitem>
		<para>Execute the following command: <command>users-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="users-main-window">
	 <title>&tool; main window</title>
	 <screenshot>
	   <mediaobject>
		<imageobject>
		  <imagedata fileref="figures/users-tool.png" format="PNG"/>
		</imageobject>
		<textobject>
		  <phrase>Shows &tool; main window.</phrase>
		</textobject>
	   </mediaobject>
	 </screenshot>
    </figure>

    <para>
	 The <application>&tool;</application> main window contains two tabbed sections:
    </para>

    <variablelist>
	 <varlistentry>
	   <term><guilabel>Users</guilabel></term>
	   <listitem>
		<para>Shows the list of users and enables you to add new users and to modify or delete the current ones.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term><guilabel>Groups</guilabel></term>
	   <listitem>
		<para>Shows the list of groups and enables you to add new groups and to modify or delete the current ones.</para>
	   </listitem>
	 </varlistentry>
    </variablelist>
  </sect1>

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

    <sect2 id="tool-add-new-user">
	 <title>To add a new user</title>
	 <para>Press the <guilabel>Add</guilabel> button, a new window will appear asking for the new user data. For adding a new user, you must provide at least the username and password (automatically generated or by hand). Optionally you can specify or modify real name, office location, work phone, home phone, main group, used shell, home directory, user ID and a list of the secondary groups for the user.</para>

	 <para>Main group, used shell, home directory and user ID are automatically guessed depending on the selected profile, so you may be interested in creating different profiles for different groups of users.</para>
    </sect2>

    <sect2>
	 <title>To modify an existing user</title>
	 <para>Select the user you want to modify and press the <guilabel>Properties</guilabel> button, A window similar to the used for adding new users will appear with all the user data, allowing you to modify them.</para>
    </sect2>

    <sect2>
	 <title>To delete an existing user</title>
	 <para>Select the user or users that you want to delete and press the <guilabel>Delete</guilabel> button in the <guilabel>Users</guilabel> tab, due to the importance of this data, you will be asked for confirmation for every user you want to delete.</para>

	 <para>For security reasons, the home directory of the deleted users will not be deleted.</para>
    </sect2>

    <sect2 id="tool-add-new-group">
	 <title>To add a new group</title>
	 <para>Press the <guilabel>Add</guilabel> button, a new window will appear asking for the new group data. For adding a new group, you must provide at least the group name and the group ID. Optionally you can specify the users that will belong to this group.</para>
    </sect2>

    <sect2>
	 <title>To modify an existing group</title>
	 <para>Select the group you want to modify and press the <guilabel>Properties</guilabel> button, A window will appear with the group's data allowing you to modify them.</para>
    </sect2>

    <sect2>
	 <title>To delete an existing group</title>
	 <para>Select the group or groups that you want to delete and press the <guilabel>Delete</guilabel> button in the <guilabel>Groups</guilabel> tab, due to the importance of this data, you will be asked for confirmation for every group you want to delete.</para>
    </sect2>

    <para></para>

    <sect2 id="tool-add-new-profile">
	 <title>To create new profile</title>
	 <para>For opening the profiles window, you must press the <guilabel>Edit user profiles</guilabel> that is inside the new users window, then press the <guilabel>Add</guilabel> button, a new window will appear asking you for the new profile data. For creating a new profile, you must at least provide the profile name, the default home directory, the default shell and the default maximum/minimum user/group ID.</para>

	 <para>If you want to replace any part of the default home directory with the user name, you can use the $user keyword (i.e.: /home/$user).</para>
    </sect2>

    <sect2>
	 <title>To modify an existing profile</title>
	 <para>In the profiles window, select the profile you want to modify and press the <guilabel>Properties</guilabel> button, a new window will appear with the profile data, allowing you to modify them.</para>
    </sect2>

    <sect2>
	 <title>To delete an existing profile</title>
	 <para>Select the profile or profiles that you want to delete and press the <guilabel>Delete</guilabel> button in the profiles window, note that at least the default profile is needed, so you can not delete it.</para>
    </sect2>
  </sect1>
</article> 
