<?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.6.0">
  <!ENTITY manrevision "2.1">
  <!ENTITY date "January 2004">
  <!ENTITY applet "Modem Lights">
  <!-- Information about the entities.
       The legal.xml file contains legal information, there is no need to edit the file. 
       Use the appletversion entity to specify the version of the applet.
       Use the manrevision entity to specify the revision number of this manual.
       Use the date entity to specify the release date of this manual.
       Use the applet entity to specify the name of the applet. -->

]>
<!-- 
  This is a GNOME documentation template, designed by the GNOME
  Documentation Project Team. Please use it for writing GNOME
  documentation, making obvious changes. In particular, all the words
  written in UPPERCASE (with the exception of GNOME) should be
  replaced. As for "legalnotice", please leave the reference
  unchanged.

  Remember that this is a guide, rather than a perfect model to follow
  slavishly. Make your manual logical and readable.  And don't forget
  to remove these comments in your final documentation!  ;-)
-->
<!-- 
      (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 Apr 11, 2002
-->

<!-- =============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>Chee Bin HOH</holder> 
    </copyright> 

<!--	
    <copyright> 
    <year>1999</year> 
    <year>2000</year> 
      <holder>DOCUMENTATION WRITER 1</holder> 
    </copyright>
-->
<!-- translators: uncomment this:
    <copyright>
    <year>2002</year>
    <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
    </copyright>
-->

<!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
    <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>Chee Bin</firstname> 
	<surname>HOH</surname> 
	<affiliation> 
	  <orgname>GNOME Documentation Project</orgname> 
	  <address> <email>cbhoh@mimos.my</email> </address> 
	</affiliation> 
      </author> 
<!--
      <author> 
        <firstname>Documentation</firstname> 
        <surname>Writer 1</surname> 
        <affiliation> 
          <orgname>GNOME Documentation Project</orgname> 
          <address> <email>cbhoh@mimos.my</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>

<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
<!-- Remember to remove the &manrevision; entity from the revision entries other -->
<!-- than the current revision. -->
<!-- The revision numbering system for GNOME manuals is as follows: -->
<!-- * the revision number consists of two components -->
<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
<!-- to V3.0, and so on. -->  
    <revhistory>
      <revision> 
	<revnumber>&applet; Applet Manual V&manrevision;</revnumber> 
	<date>&date;</date> 
	<revdescription> 
	  <para role="author">Chee Bin HOH
	    <email>cbhoh@gnome.org</email>
          </para> 
	  <para role="publisher">GNOME Documentation Project</para> 
	</revdescription> 
      </revision> 
      <revision> 
        <revnumber>&applet; Applet Manual V2.0</revnumber> 
        <date>July 2003</date> 
        <revdescription> 
          <para role="author">Chee Bin HOH
            <email>cbhoh@mimos.my</email></para> 
          <para role="publisher">GNOME Documentation Project</para> 
        </revdescription> 
      </revision> 
      <!--	
      <revision> 
        <revnumber>Full title of previous manual.</revnumber> 
        <date>Release date of previous manual.</date> 
        <revdescription> 
          <para role="author">Documentation Writer 1
            <email>docwriter2@gnome.org</email></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>&applet; Applet</primary> 
  </indexterm> 
  <indexterm zone="index"> 
    <primary>&applet;</primary> 
  </indexterm>


<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what
     the applet is and what it does. -->
  <sect1 id="modemlights-introduction"> 
    <title>Introduction</title> 
    <!-- ==== Figure ============================================= -->
    <figure id="figs-modemlights-applet"> 
      <title>&applet; Applet</title> 
      <screenshot> 
        <mediaobject> 
	  <imageobject><imagedata fileref="figures/modemlights_applet.png"
			 format="PNG"/> 
          </imageobject>
          <textobject> 
            <phrase>Shows &applet; applet. Contains a dial up button and modem status indicators.
            </phrase> 
          </textobject> 
        </mediaobject> 
      </screenshot> 
    </figure> 
    <!-- ==== End of Figure ======================================= -->
    <para>The <application>&applet;</application> applet enables you to dial up to internet and monitor your modem status. 
    </para>
    <para>To add <application>&applet;</application> to a panel, right-click on the panel, then choose <menuchoice>
          <guimenu>Add to Panel</guimenu>
          <guisubmenu>Internet</guisubmenu>
          <guimenuitem>&applet;</guimenuitem>
          </menuchoice>.
          The layout of the <application>&applet;</application> applet varies depending on the size and type
          of panel in which the applet resides.
    </para>
    <para>The <application>&applet;</application> applet is included in the gnome-applets package, which is
          part of the GNOME desktop environment. This document describes version &appletversion; of
         <application>&applet;</application> applet.
    </para>
  </sect1>

<!-- ================ Usage ================================ -->
<!-- Use this section to describe how to use the applet to perform the tasks for 
     which the applet is designed. -->
  <sect1 id="modemlights-usage"> 
    <title>Usage</title> 
    <sect2 id="modemlights-connect">
      <title>To Dial Up</title>
      <para>To dial up, click on the 
            <inlinemediaobject>
              <imageobject>
                <imagedata fileref="figures/modemlights_applet_button.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase>Shows &applet; applet connect/disconnect button.</phrase>
              </textobject> 
            </inlinemediaobject> button of the applet. The <guilabel>Connection Confirmation</guilabel> dialog
	    is displayed. Click on the <guibutton>Connect</guibutton> button to connect to the internet.
      </para>
      <para>Depending on the applet preferences setting, you are able to dial up or disconnect without 
            confirmation. See 
            <xref linkend="modemlights-prefs"/> for information about how to modify the properties of 
            the &applet; applet.
      </para>
      <para>
      <itemizedlist>
        <listitem>
          <para>While connecting, the &applet; applet will display the status as shown in 
                <xref linkend="fig-applet-awaiting"/>.
            <figure id="fig-applet-awaiting"> 
              <title>&applet; Applet While Awaiting Connection</title> 
              <screenshot> 
                <mediaobject> 
                  <imageobject>
                    <imagedata fileref="figures/modemlights_applet_awaiting" format="PNG"/> 
                  </imageobject>
                  <textobject> 
                    <phrase>Shows &applet; applet while awaiting connection.</phrase> 
                  </textobject> 
                </mediaobject> 
              </screenshot> 
            </figure>
          </para>
	</listitem>
        <listitem>
          <para>Once connected, the &applet; applet will display the status as shown in
                <xref linkend="fig-applet-connected"/>.
            <figure id="fig-applet-connected"> 
              <title>&applet; Applet While Connected</title> 
              <screenshot> 
                <mediaobject> 
                  <imageobject>
                    <imagedata fileref="figures/modemlights_applet_connected" format="PNG"/> 
                  </imageobject>
                  <textobject> 
                    <phrase>Shows &applet; applet connected.</phrase> 
                  </textobject> 
                </mediaobject> 
              </screenshot> 
            </figure>
          </para>
        </listitem>
      </itemizedlist>
      </para>
      <tip>
        <title>Tip</title>
        <para>Point to the applet, a tooltip will display the amount of data received and sent, and time 
              connected to the internet.
        </para>
      </tip>
    </sect2>
    <sect2 id="modemlights-disconnect">
      <title>To Disconnect</title>
      <para>To disconnect, click on the 
            <inlinemediaobject>
              <imageobject>
                <imagedata fileref="figures/modemlights_applet_button_2.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase>Shows connect/disconnect button.</phrase>
              </textobject>
            </inlinemediaobject> button of the applet. The <guilabel>Disconnection confirmation</guilabel>
	    dialog is displayed. Click on the <guibutton>Disconnect</guibutton> button to stop the connection.
      </para>
      <warning>
        <title>Warning</title>
        <para>You might need to modify the connection and disconnection commands that the applet uses, see 
              <xref linkend="modemlights-prefs"/> for information about how to modify the properties
              of the &applet; applet.
        </para>
      </warning>
    </sect2>
  </sect1>

<!-- ============= Preferences =========================== -->
  <sect1 id="modemlights-prefs">
    <title>Preferences</title>
    <para>To modify the properties of <application>&applet;</application>, right-click on the
          applet, then choose <guimenuitem>Preferences</guimenuitem> from the popup menu.
    </para> 
    <sect2 id="modemlights-prefs-general">
      <title>General</title>
      <para>The <guilabel>General</guilabel> tabbed section allows you to modify the display and connections, 
            as shown in <xref linkend="fig-prefs-general"/>.
      </para>
      <figure id="fig-prefs-general">
      <title>General tabbed section</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/modemlights_applet_general.png" format="PNG"/>
            </imageobject>
            <textobject> 
              <phrase>Shows &applet; applet; preferences dialog, general tabbed section</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      <variablelist> 
        <varlistentry>
          <term><guilabel>Display</guilabel></term>
          <listitem> 
	    <itemizedlist>
              <listitem>
		<para>Use the Spin box to specify the interval that &applet; applet updates the display.
                </para>
              </listitem>
              <listitem>
		<para>Select the <guilabel>Show connect time and throughput</guilabel> option to 
                      show connection time and throughput of the modem.
                </para>
              </listitem>
              <listitem>
                <para>Select the <guilabel>Blink connection status when connecting</guilabel> option
                      to blink connection status when connecting.
                </para>
              </listitem>
            </itemizedlist>
          </listitem>
  	</varlistentry>
        <varlistentry>
          <term><guilabel>Connections</guilabel></term>
          <listitem> 
            <para> 
              <itemizedlist>
                <listitem>
                  <para>To specify the command that &applet; applet uses to dial up, type the 
                        connection command in the <guilabel>Connection command</guilabel> text box.
                  </para>
                </listitem>
                <listitem>
                  <para>To specify the command that &applet; applet uses to stop the connection, type the 
                        disconnection command in the <guilabel>Disconnection command</guilabel> text box.
                  </para>
                </listitem>
                <listitem>
                  <para>Select the <guilabel>Confirm connection</guilabel> option to display
                        a confirmation dialog box before dialup or disconnect.
                  </para>
                </listitem>
	      </itemizedlist>
            </para>
          </listitem>
        </varlistentry>
      </variablelist> 
    </sect2>

    <sect2 id="modemlights-prefs-color">
      <title>Colors</title>
      <para>The <guilabel>Colors</guilabel> tabbed section allows you to specify colors for the display of 
            the modem status on the applet.
      </para>
      <para>Click on any color selector buttons to specify the colors.
      </para>
    </sect2>

    <sect2 id="modemlights-prefs-advanced">
      <title>Advanced</title>
      <para>The <guilabel>Advanced</guilabel> tabbed section allows you to specify Modem options, as shown
            in <xref linkend="fig-prefs-advanced"/>.
      </para>
      <figure id="fig-prefs-advanced"> 
        <title>Advanced tabbed section</title>       
        <screenshot> 
          <mediaobject> 
            <imageobject>
              <imagedata fileref="figures/modemlights_applet_advanced.png" format="PNG"/> 
            </imageobject>
	    <textobject> 
              <phrase>Shows &applet; applet preferences dialog; Advanced tabbed section.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure> 
      <variablelist>
        <varlistentry>
          <term>Modem Options</term>
          <listitem>
	    <itemizedlist>
              <listitem>
		<para>To specify the modem device that &applet; applet uses, type the device name in the 
                      <guilabel>Device</guilabel> text box.
                </para>
              </listitem>
	      <listitem>
		<para>To specify the lock file that &applet; applet uses, type the path to the lock 
                      file in the <guilabel>Lock file</guilabel> text box.
                </para>
	      </listitem>
              <listitem>
                <para>Select the <guilabel>Verify owner of lock file</guilabel> option to verify
                      the lock file ownership.
                </para>
              </listitem>
	      <listitem>
                <para>Select the <guilabel>Use ISDN</guilabel> option to use ISDN modem.
                </para>
	      </listitem>
	    </itemizedlist>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
  </sect1>

<!-- ============= Bugs ================================== -->
<!-- This section is optional and is commented out by default. 
     You can use it to describe known bugs and limitations of the 
	  program if there are any - please be frank and list all
     problems you know of. 
  
  <sect1 id="myapplet-bugs">
  <title>Known Bugs and Limitations</title>
  <para> </para>
 </sect1>
-->

<!-- ============= About ================================== -->
<!-- This section contains info about the program (not docs), such as
     author's name(s), web page, license, feedback address. This
     section is optional: primary place for this info is "About.." box of
     the program. However, if you do wish to include this info in the
     manual, this is the place to put it. Alternatively, you can put this 
     information in the title page.-->

  <sect1 id="modemlights-about">
    <title>About &applet;</title>
    <para>
        <application>&applet;</application> was written by John Ellis
        (<email>johne@bellatlantic.net</email>) and Martin Baulig 
        (<email>martin@home-of-linux.org</email>) for ISDN. To find more 
        information about <application>&applet;</application>, please visit 
        the <ulink url="http://www.gnome.org/softwaremap/projects/gnome-applets" type="http">
        The GNOME Applets website</ulink>. 
    </para>  
    <para>
       If you have some comments or suggestions regarding this
       application or documentation, need help, or want to report a
       bug, please contact us! Instructions for doing so are given in
       <ulink type="help" url="ghelp:gnome-feedback"><citetitle>Reporting GNOME bugs
       and other feedback</citetitle></ulink> document, which you can
       find in the <guilabel>Help</guilabel> tab of
       <application>Nautilus</application> file manager.
    </para>

<!-- For translations: uncomment this:
    <para>
      Latin translation was done by ME
     (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
     suggestions regarding this translation to SOMEWHERE.
    </para>
-->

    <para>
      This program is distributed under the terms of the GNU General
      Public license as published by the Free Software Foundation;
      either version 2 of the License, or (at your option) any later
      version. A copy of this license can be found at this <ulink
      type="help" url="ghelp:gpl">link</ulink>, or in the file COPYING
      included with the source code of this program. 
    </para>
  </sect1> 

</article> 
