<?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 appletversion "2.3.6">
  <!ENTITY manrevision "2.1">
  <!ENTITY date "August 2003">
  <!ENTITY applet "Wireless Link Monitor">
]>
<!-- 
      (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>&applet; Applet Manual V&manrevision;</title> 
        <copyright>
            <year>2003</year>
            <holder>Sun Microsystems</holder>
        </copyright>

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

	 <publisher> 
		<publishername>GNOME Documentation Project</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>Sun</firstname>
               <surname>GNOME Documentation Team</surname>
               <affiliation>
                  <orgname>Sun Microsystems</orgname>
              </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>&applet; Applet 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>Wireless Link Monitor Applet Manual V2.0</revnumber> 
		  <date>August 2003</date> 
		  <revdescription> 
                    <para role="author">Sun GNOME Documentation Team</para>
                    <para role="publisher">GNOME Documentation Project</para>
		  </revdescription> 
		</revision> 
	 </revhistory> 

	 <releaseinfo>This manual describes version &appletversion; of &applet;.
		</releaseinfo> 

	 <legalnotice> 
		<title>Feedback</title> 
		<para> To report a bug or make a suggestion regarding the &applet; applet 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>Wireless Link Monitor</primary> 
  </indexterm> 
  <indexterm zone="index"> 
	 <primary>wireless link monitor</primary> 
  </indexterm>
<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
  <sect1 id="wireless-introduction"> 
	 <title>Introduction</title> 
	 <figure id="wireless-fig-conn"> 
		<title>&applet; Applet With Connection</title> 
		<screenshot> 
		  <mediaobject> 
			 <imageobject><imagedata fileref="figures/wireless_applet_conn.png"
				format="PNG"/> 
			 </imageobject>
			 <textobject> 
				<phrase>Shows &applet; applet with connection.</phrase> 
			 </textobject> 
		  </mediaobject> 
		</screenshot> 
	 </figure> 
	 <figure id="wireless-fig-no-conn"> 
		<title>&applet; Applet With No Connection</title> 
		<screenshot> 
		  <mediaobject> 
			 <imageobject><imagedata fileref="figures/wireless_applet_no_conn.png"
				format="PNG"/> 
			 </imageobject>
			 <textobject> 
				<phrase>Shows &applet; applet with no connection.</phrase> 
			 </textobject> 
		  </mediaobject> 
		</screenshot> 
	 </figure> 
    <!-- ==== End of Figure ======================================= -->
	 <para>The <application>&applet;</application> applet provides a convenient way to monitor connections to wireless devices.
		</para> 
	 <para>To add <application>&applet;</application> to a panel, right-click on the panel to open the panel popup menu, then choose 
		<menuchoice> 
		  <guimenu>Add to Panel</guimenu> 
		  <guisubmenu>Internet</guisubmenu> 
		  <guimenuitem>Wireless Link Monitor</guimenuitem> 
		</menuchoice>.</para> 
  </sect1>

<!-- ================ Usage ================================ -->
  <sect1 id="wireless-usage"> 
	 <title>Usage</title> 
	 <para>When no wireless device has a connection, the &applet; displays the text <literal>NA</literal>, and the applet boxes are transparent.</para>
	 <para>When a wireless device has a connection, the &applet; displays the text <literal>Wi Fi</literal>. The color of the boxes in the panel applet indicates whether a link is established, as follows:</para>
         <variablelist>
           <varlistentry>
             <term>Green</term>
             <listitem>
               <para>The wireless device has established a link.</para>
               <para>The strength of the link is indicated by the number of green boxes: the greater the number of green boxes, the stronger the link.</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term>Red</term>
             <listitem>
               <para>The wireless device has not established a link.</para>
             </listitem>
           </varlistentry>
         </variablelist>
	 <para>You can also display the signal strength as a percentage. For more information on how to configure &applet; to show the signal strength as a percentage, see <xref linkend="wireless-prefs"/>.</para>
	 <para>Each instance of &applet; can monitor only one wireless device. You must start an instance of &applet; for each wireless device that you want to monitor.
</para>
  </sect1>

<!-- ============= Customization ============================= -->
<!-- Use this section to describe how to customize the applet. -->
  <sect1 id="wireless-prefs"> 
	 <title>Settings</title> 
	 <para>To configure <application>&applet;</application>, right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem> from the popup menu.</para> 
	 <para>The <guimenuitem>Preferences</guimenuitem> dialog contains the following components: </para> 
	 <variablelist> 
	   <varlistentry> 
	     <term><guilabel>Monitored Device</guilabel></term> 
	     <listitem> 
	       <para>Use this drop-down list to select the wireless device that you want to monitor.</para> 
	     </listitem> 
	   </varlistentry> 
	   <varlistentry> 
	     <term><guilabel>Show signal strength in percentage</guilabel></term> 
	     <listitem> 
	       <para>Select this option to display the signal strength as a percentage. 
               </para> 
	     </listitem> 
	   </varlistentry> 
	 </variablelist>
  </sect1>

</article> 
