<?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 "2.15.2">
  <!ENTITY manrevision "2.15.2">
  <!ENTITY date "August 2006">
  <!ENTITY tool "Shared Folders 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</title> 
    <copyright>
      <year>2006</year>
      <holder>Carlos Garnacho Parro</holder>
    </copyright>

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

    <publisher role="maintainer"> 
	 <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>
    <abstract role="description">
      <para>The &tool; allows you to share folders to other computers in your network or in the internet.</para>
    </abstract> 
  </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 share folders to other computers in your network or in the internet.</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>System</guimenu> menu</term>
	   <listitem>
		<para>Choose <menuchoice><guisubmenu>Administration</guisubmenu><guimenuitem>Shared Folders</guimenuitem></menuchoice>.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Nautilus Context Menu</term>
	   <listitem>
		<para>Press the right mouse button on any local folder and choose <menuchoice><guisubmenu>Share folder</guisubmenu></menuchoice> to share or stop sharing the folder.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>Command line</term>
	   <listitem>
		<para>Execute the following command: <command>shares-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="shares-main-window">
	 <title>&tool; main window</title>
	 <screenshot>
	   <mediaobject>
		<imageobject>
		  <imagedata fileref="figures/shares-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>Shared folders</term>
	   <listitem>
		<para>This allows you to specify which folders are going to be shared through the network.</para>
	   </listitem>
	 </varlistentry>

	 <varlistentry>
	   <term>General properties</term>
	   <listitem>
		<para>Specifies global settings for a group of shared folders.</para>
	   </listitem>
	 </varlistentry>
    </variablelist>
  </sect1>

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

    <sect2>
      <title>To share a folder</title>
	 <para>There are 3 ways of sharing a folder:</para>
	 <orderedlist>
	   <listitem><para>In the <guilabel>Shared Folders</guilabel> tab press the <guilabel>Add</guilabel> button. In the <guilabel>Share Folders</guilabel> dialog fill in the folder you wish to share.</para></listitem>
	   <listitem><para>Right click on a local folder and select the option <menuchoice><guisubmenu>Share folder</guisubmenu></menuchoice>.</para></listitem>
	   <listitem><para>Drag a folder and drop it in the shared folders list in the main window.</para></listitem>
	 </orderedlist>
    </sect2>

    <sect2>
      <title>To stop sharing a folder</title>
	 <para> There are 2 ways to stop sharing a folder:</para>
	 <orderedlist>
	   <listitem><para>In the <guilabel>Shared Folders</guilabel> tab select the folder you want to stop sharing and press the <guilabel>Delete</guilabel> button.</para></listitem>
	   <listitem><para>Right click on a local folder and select the option <menuchoice><guisubmenu>Share folder</guisubmenu></menuchoice>, then select not to share in the <guilabel>Share through</guilabel> combobox.</para></listitem>
	 </orderedlist>
    </sect2>

    <sect2>
      <title>To modify a folder sharing properties</title>
	 <para>In the <guilabel>Shared Folders</guilabel> tab select the folder you want to modify and press the <guilabel>Properties</guilabel> button.</para>
    </sect2>

    <sect2>
      <title>To modify global sharing properties</title>
	 <para>In the <guilabel>General Properties</guilabel> tab modify any of the values.</para>
    </sect2>
  </sect1>
</article> 
