<?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 app "Dictionary">
<!ENTITY appversion "2.8.1">
<!ENTITY date "September 2004">
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY manrevision "2.8">
]>
<!-- This file describes the Dictionary applet and application. -->
<!-- 
      (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 11 April, 2002
  
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="en">
<!-- please do not change the id; for translations, change language to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>&app; Manual V&manrevision;</title>  
    <copyright>
      <year>2004, 2003, 2002, 2000</year>
      <holder>John Fleck</holder>
    </copyright>
    
    <copyright> 
      <year>2004, 2002</year> 
      <holder>Sun Microsystems</holder> 
    </copyright> 
    
<!-- translators: uncomment this:

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

   -->
    <publisher> 
      <publishername> GNOME Documentation Project </publishername> 
    </publisher> 

   &legal;

    <authorgroup> 
      <author> 
	<firstname>Sun</firstname> 
	<surname>GNOME Documentation Team</surname> 
	<affiliation> 
	  <orgname>Sun Microsystems</orgname> 
	   
	</affiliation> 
      </author> 
      <author> 
	<firstname>John</firstname> 
	<surname>Fleck</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	  <address> <email>jfleck@inkstain.net</email> </address> 
	</affiliation> 
      </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>&app; Manual V&manrevision;</revnumber> 
	<date>&date;</date> 
	<revdescription> 
	  <para role="author">Sun GNOME Documentation Team
	    
	  </para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision><revision>
	<revnumber>&app; Manual V2.4 </revnumber>
	<date>July 2003</date>
	<revdescription>
	  <para role="author">John Fleck
	    <email>jfleck@inkstain.net</email>
	  </para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription>
      </revision><revision>
	<revnumber>&app; Manual V2.3 </revnumber>
	<date>November 2002</date>
	<revdescription>
	  <para role="author">John Fleck
	    <email>jfleck@inkstain.net</email>
	  </para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription>
      </revision>
      <revision> 
	<revnumber>&app; Manual V 2.2</revnumber> 
	<date>August</date> 
	<revdescription> 
	  <para role="author">Sun GNOME Documentation Team</para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision><revision> 
	<revnumber>&app; Manual V 2.1</revnumber> 
	<date>May 2002</date> 
	<revdescription> 
	  <para role="author">Sun GNOME Documentation Team</para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision> 
      <revision> 
	<revnumber>&app; Manual V2.0</revnumber> 
	<date>May 2002</date> 
	<revdescription> 
	  <para role="author">Sun GNOME Documentation Team</para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision>
      <revision> 
	<revnumber>GDict Manual</revnumber> 
	<date>2000</date> 
	<revdescription> 
	  <para role="author">John Fleck
	    <email>jfleck@inkstain.net</email>
	  </para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo>This manual describes version &appversion; of &app;.
    </releaseinfo> 
    <legalnotice> 
      <title>Feedback</title> 
      <para>To report a bug or make a suggestion regarding the &app; application or
	this manual, follow the directions in the 
	<ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>. 
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm> 
    <primary>Dictionary</primary> 
  </indexterm> 

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->

  <sect1 id="gdict-introduction"> 
    <title>Introduction</title> 
    <para>The <application>&app;</application> application enables you to look up an online dictionary for 
	definitions and correct spellings of words.</para> 
  </sect1>

  <sect1 id="gdict-getting-started">
    <title>Getting Started</title> 
    
    <sect2 id="gdict-to-start">
    <title>To Start &app;</title>
    <para>You can start <application>&app;</application> in the following ways:</para> 
    <variablelist>
    	<varlistentry>
    		<term><guimenu>Applications</guimenu> menu</term>
    		<listitem>
    		<para>Choose <menuchoice><guisubmenu>Accessories</guisubmenu><guimenuitem>Dictionary</guimenuitem></menuchoice>.</para>
    		</listitem>
    	</varlistentry>
    	<varlistentry>
    		<term>Command line</term>
    		<listitem>
    		<para>Type <command>gnome-dictionary -a</command>, then press <keycap>Return</keycap>.</para>
    		<para> 		 
    		</para> 
    		</listitem>
    	</varlistentry>
    	<varlistentry>
    		<term>As a panel applet</term>
    		<listitem>
    		<para>To add the <application>GDict</application> applet to a panel, right-click on the panel, then choose 
    		<menuchoice>
    		<guimenu>Add to Panel</guimenu>
    		<guimenuitem>Dictionary Lookup</guimenuitem>
    		</menuchoice>.</para> 
    		<figure id="gdict-applet-fig"> 
				<title>GDict Applet</title> 
				<screenshot> 
		  			<mediaobject> 
			 		<imageobject><imagedata fileref="figures/gdict_applet.png" format="PNG"/> 
			 		</imageobject>
			 		<textobject> 
						<phrase>Shows GDict applet.</phrase> 
			 		</textobject> 
		  			</mediaobject> 
				</screenshot> 
	 		</figure> 
	    <para>To start the <application>&app;</application> application, click on the <guibutton>Lookup</guibutton> button.</para>
    		</listitem>
    	</varlistentry>
    </variablelist>
    
    <note><para>If your computer is behind a firewall, you might need to use the SOCKS protocol to access the dictionary server 
    and run the application successfully. Contact your system administrator for more information.</para></note>
    </sect2>
    
    <sect2 id="gdict-when-you-start">
    <title>When You Start &app;</title>
	
    <para>When you start <application>&app;</application>, the following window is displayed.</para>

    <!-- ==== Figure ==== -->
      <figure id="gdict-fig"> 
	<title>&app; Window</title> 
	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/gdict_window.png" format="PNG"/> 
	    </imageobject>
	    <textobject> 
	      <phrase>Shows &app; main window. Contains titlebar, menubar, Word text box, and Look Up Word button. </phrase> 
	    </textobject> 
	  </mediaobject> 
	</screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->
    
    <para>The <guilabel>&app;</guilabel> window consists of the following elements:</para>
    <variablelist>
		<varlistentry>
		<term>Menubar </term>
		<listitem>
		<para>Contains standard menus.</para>
		</listitem>
		</varlistentry>
		<varlistentry>
		<term> <guilabel>Word</guilabel> field</term>
		<listitem>
		<para>Use this field to enter the word that you want to look up in the dictionary.</para>
		</listitem>
		</varlistentry>
		<varlistentry>
		<term><guibutton>Look Up Word</guibutton> button </term>
		<listitem>
		<para>Click on this button to look up the definition of the word in the <guilabel>Word</guilabel> field.</para>
		</listitem>
		</varlistentry>
		<varlistentry>
		<term>Display area </term>
		<listitem>
		<para><application>&app;</application> displays the definition of a word in this area of the window.</para>
		</listitem>
		</varlistentry>
		<varlistentry>
		<term>Statusbar </term>
		<listitem>
		<para><application>&app;</application> displays status messages in the statusbar.</para>
		</listitem>
		</varlistentry>
	</variablelist>
    </sect2>

  </sect1>

<!-- ================ Usage ================================ -->

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

    <sect2 id="gdict-lookup">
    	<title>To Look Up the Definition of a Word</title>
    	<para>To look up the definition of a word, perform the following steps:</para>
    	<orderedlist>
    		<listitem><para>Type the word that you want to look up in the <guilabel>Word</guilabel>
    		text box.</para></listitem>
    		<listitem><para>Click <guibutton>Look Up Word</guibutton>. <application>&app;</application> 
    		performs one of the following actions:</para>
    		<itemizedlist>
    			<listitem><para>If <application>&app;</application> finds a definition for the word, the application
    			displays the definition in the display area. </para></listitem>
    			<listitem><para>If <application>&app;</application> does not find a definition for the word, the application
    			opens the <guilabel>Check spelling</guilabel> dialog and checks the spelling of the word. You can select a
    			word in the <guilabel>Check spelling</guilabel> dialog, then click <guibutton>Look Up Word</guibutton>. </para></listitem>
    		</itemizedlist>
    		</listitem>	
    		<listitem><para>Use the scrollbar to scroll through the definition.</para></listitem>
    	</orderedlist>    
    </sect2>
    
    <sect2 id="gdict-spell">
    	<title>To Check the Spelling of a Word</title>
    	<para>To check the spelling of a word, perform the following steps:</para>
    	<orderedlist>
    		<listitem><para>Choose <menuchoice><guimenu>Dictionary</guimenu><guimenuitem>Check Spelling</guimenuitem>
    		</menuchoice>.</para></listitem>
    		<listitem><para>In the <guilabel>Word</guilabel> text box of the <guilabel>Check spelling</guilabel> 
    		dialog, type the word that you want to check.</para></listitem>
    		<listitem><para>Select the <guilabel>Search Strategy</guilabel> that you want to use.</para></listitem>
    		<listitem><para>Click <guibutton>Spell</guibutton>. <application>&app;</application> displays 
    		correct spellings for the word in the display area.</para></listitem>
    		<listitem><para>Use the scrollbar to scroll through the spellings.</para></listitem>
    		<listitem><para>To look up the definition of a word that is displayed in the 
    		display area, select the word, then click <guibutton>Look Up Word</guibutton>. 
    		The application displays the dictionary definition in the display area of the 
    		<guilabel>Dictionary</guilabel> dialog.</para></listitem>
    	</orderedlist> 
    </sect2>
    
    <sect2 id="gdict-clear">
    	<title>To Clear the Display Area</title>
    	<para>To clear the display area of the <guilabel>Dictionary</guilabel> dialog, choose <menuchoice><guimenu>Edit</guimenu>
    	<guimenuitem>Clear</guimenuitem></menuchoice>.</para> 
    </sect2>
    
    <sect2 id="gdict-select">
    	<title>To Copy Text to Another Application</title>
    	<para>To copy the text in the display area to another application, perform one of the following tasks:</para>
    	<itemizedlist>
    		<listitem><para>To copy all of the text, choose 
    		<menuchoice><guimenu>Edit</guimenu><guimenuitem>Select All</guimenuitem></menuchoice>, then choose
    		<menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice>.</para></listitem>
    		<listitem><para>To copy some of the text, select the lines that you want to copy, then  choose
    		<menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice>.</para></listitem>
    	</itemizedlist> 
    </sect2>
    
    <sect2 id="gdict-find">
    	<title>To Find Text in the Display Area</title>
    	<para>To find text in the display area, perform the following steps:</para>
    	<orderedlist>
    		<listitem><para>Choose <menuchoice><guimenu>Edit</guimenu>
    		<guimenuitem>Find</guimenuitem></menuchoice>.</para> </listitem>
    		<listitem><para>Type the string that you want to find in the <guilabel>Search for</guilabel> text box of the <guilabel>Find</guilabel> dialog,
    		then press <keycap>Return</keycap>. You cannot use wildcards.</para></listitem>
    		<listitem><para>To find the next occurrence of the word, choose <menuchoice><guimenu>Edit</guimenu>
    		<guimenuitem>Find Next</guimenuitem></menuchoice>.</para></listitem>
    	</orderedlist>	
    </sect2>

  </sect1>
  
  
<!-- ============= Preferences  ================================ -->
  <sect1 id="gdict-settings">
	<title>Preferences</title>
	<para>To configure <application>&app;</application>, choose 
	<menuchoice>
	<guimenu>Edit</guimenu>
	<guimenuitem>Preferences</guimenuitem>
	</menuchoice>. </para>
	<variablelist>
		<varlistentry>
		<term><guilabel>Server</guilabel> </term>
		<listitem>
		<para>Use this text box to specify the online server that <application>&app;</application> accesses. Click 
		<guibutton>Default Server</guibutton> to revert to the default setting.</para>
		<para>Default: dict.org.</para>
		</listitem>
		</varlistentry>
		<varlistentry>
		<term><guilabel>Port</guilabel> </term>
		<listitem>
		<para>Use this text box to specify the port number that <application>&app;</application> uses to access the dictionary server. Click 
		<guibutton>Default Port</guibutton> to revert to the default setting.</para>
		<para>Default: 2628.</para>
		</listitem>
		</varlistentry>
		<varlistentry>
		<term><guilabel>Smart lookup</guilabel> </term>
		<listitem>
	  <para>When selected, this option launches a search for alternative spellings if no instances of the entered spelling are found..</para>
		<para>Default: selected.</para>
		</listitem>
		</varlistentry>
		<varlistentry>
		<term><guilabel>Database</guilabel> </term>
		<listitem>
		<para>When <application>&app;</application> accesses the dictionary server, <application>&app;</application> downloads
		a list of the dictionary databases that are available. Use this drop-down list box to select the databases that you want to use. </para>
		<para>Default: Search all databases.</para>
		</listitem>
		</varlistentry>
		<varlistentry>
		<term><guilabel>Default strategy</guilabel> </term>
		<listitem>
		<para>When <application>&app;</application> accesses the dictionary server, <application>&app;</application> downloads
		a list of the search strategies that are available on the server. Use this drop-down list box to select the search strategy that you want to use.</para>
		<para>Default: Match words within Levenshtein distance one.</para>
		</listitem>
		</varlistentry>
	</variablelist>
  </sect1>

</article>
