<?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.1.3">
  <!ENTITY manrevision "2.3">
  <!ENTITY date "January 2003">
  <!ENTITY applet "Stock Ticker">
]>

<!-- 
      (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 Mar 12, 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>Sun Microsystems</holder> 
	 </copyright> 
<!-- translators: uncomment this:

  <copyright>
   <year>2002</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> 
			 <address> <email>gdocteam@sun.com</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>&applet; Applet Manual V&manrevision;</revnumber> 
		  <date>&date;</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team
				<email>gdocteam@sun.com</email></para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
		<revision> 
		  <revnumber>Stock Ticker Applet Manual V2.2</revnumber> 
		  <date>August 2002</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team
				<email>gdocteam@sun.com</email></para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision>
		<revision> 
		  <revnumber>Stock Ticker Applet Manual V2.1</revnumber> 
		  <date>July 2002</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team
				<email>gdocteam@sun.com</email></para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
		<revision> 
		  <revnumber>Stock Ticker Applet Manual V2.0</revnumber> 
		  <date>May 2002</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team
				<email>gdocteam@sun.com</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> 
	 <primary>Stock Ticker</primary> 
  </indexterm> 
    <indexterm> 
	 <primary>ticker, stock</primary> 
  </indexterm> 
<!-- ============= Document Body ============================= -->

<sect1 id="gtik-introduction">
<title>Introduction</title>
	 <!-- ==== Figure ============================================= -->
	 <figure id="stockticker-fig"> 
		<title>&applet; Applet</title> 
		<screenshot> 
		  <mediaobject> 
			 <imageobject><imagedata fileref="figures/gtik_applet.png"
 format="PNG"/> 
			 </imageobject>
			 <textobject> 
				<phrase>Shows Stock Ticker applet. Contains scrolling display area, back and forward buttons.</phrase> 
			 </textobject> 
		  </mediaobject> 
		</screenshot> 
	 </figure> 
    	 <!-- ==== End of Figure ======================================= -->
<para>The <application>&applet;</application> applet downloads current stock quotes from the Internet and displays the quotes in a scrolling display in the applet. The applet downloads the stock information from Yahoo! Finance. </para>
<para>To add <application>&applet;</application> to a panel, right-click on the panel, then choose 
<menuchoice>
<guimenu>Add to Panel</guimenu> 
<guisubmenu>Accessories</guisubmenu> 
<guimenuitem>Stock Ticker</guimenuitem>
</menuchoice>.</para>
<note id="proxies-note-1">
<para>If your computer is located behind a firewall you must use a proxy server to run <application>&applet;</application> successfully. 
For more information about how to specify a proxy server, see <xref linkend="gtik-set-proxy"/> .</para>
</note>
<para><application>&applet;</application> displays the following information for each stock symbol that is defined in the applet preferences:</para>
<itemizedlist>
<listitem><para>The stock symbol that represents the company.</para></listitem>
<listitem><para>The current quote.</para></listitem>
<listitem><para>An arrow to indicate an increase or decrease in the quote.</para></listitem>
<listitem><para>The amount of the increase or decrease in the quote.</para></listitem>
<listitem><para>The percentage of the increase or decrease in the quote.</para></listitem>
</itemizedlist>
</sect1>

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

<sect2 id="gtik-move-forward-back">
<title>To Move Forwards or Backwards in the Stock Display</title>
<para>To move forwards or backwards in the scrolling display, use the arrow buttons located at the right and left of the applet display. </para>
</sect2>

<sect2 id="gtik-add-stocks">
<title>To Add Company Stock Quotes to the Applet</title>
<para>See <xref linkend="gtik-settings-symbols"/> for information about how to add stock quotes to the applet display. </para>
</sect2>

<sect2 id="gtik-refresh">
<title>To Update the Display</title>
<para><application>&applet;</application> automatically updates the stock information at the frequency that 
is specified in the applet preferences. See <xref linkend="gtik-settings-behavior"/> for more information 
about the applet preferences. To update the information that is displayed in the applet immediately, 
right-click on the applet, then choose <guimenuitem>Update</guimenuitem>. </para>
</sect2>

</sect1>

<sect1 id="gtik-settings">
<title>Preferences</title>

<sect2 id="gtik-set-proxy">
<title>To Set a Proxy Server</title>
<para>If your computer is located behind a firewall you must use a proxy server to run <application>&applet;</application> successfully. 
To configure GNOME to use a proxy server, choose 
<menuchoice>
<guimenu>Applications</guimenu>
<guisubmenu>Desktop Preferences</guisubmenu> 
<guimenuitem>Network Proxy</guimenuitem>
</menuchoice>.</para>
</sect2>

<sect2 id="gtik-configure">
<title>To Configure &applet;</title>
<para>To configure <application>&applet;</application>, right-click on the applet, then choose <guimenu>Preferences</guimenu>. 
The <guilabel>Stock Ticker Preferences</guilabel> dialog contains the following tabbed sections:</para>
<itemizedlist>
<listitem><para><xref linkend="gtik-settings-symbols"/></para></listitem>
<listitem><para><xref linkend="gtik-settings-behavior"/></para></listitem>
<listitem><para><xref linkend="gtik-settings-appearance"/></para></listitem>
</itemizedlist>

<sect3 id="gtik-settings-symbols">
<title>Symbols</title>
<para>The <guilabel>Symbols</guilabel> tabbed section enables you to add and remove stock quotes from the applet display.</para>
<para>To add a stock quote to the applet, perform the following steps:</para>
<orderedlist>
<listitem><para>Ascertain the stock symbol for the company. </para></listitem>
<listitem><para>Type the stock symbol for the company in the <guilabel>New Symbol</guilabel> text box.</para></listitem>
<listitem><para>Click <guibutton>Add</guibutton> to add the symbol to the list of symbols for which the applet displays quotes.</para></listitem>
<listitem><para>Click <guibutton>OK</guibutton> to save the change and close the dialog.</para></listitem>
</orderedlist>

<para>To remove a stock quote from the applet, perform the following steps:</para>
<orderedlist>
<listitem><para>Select the stock symbol for the company.</para></listitem>
<listitem><para>Click <guibutton>Remove Selected</guibutton> to remove the symbol from the list of symbols for which the applet displays quotes.</para></listitem>
<listitem><para>Click <guibutton>OK</guibutton> to save the change and close the dialog.</para></listitem>
</orderedlist>

</sect3>

<sect3 id="gtik-settings-behavior">

<title>Behavior</title>
<variablelist>
<varlistentry>
<term><guilabel>Stock update frequency in minutes</guilabel> </term>
<listitem>
<para>Use this spin box to increase or decrease the frequency at which the applet downloads the latest stock information from the Internet. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Scroll speed</guilabel> </term>
<listitem>
<para>Use this spin box to increase or decrease the speed at which the applet displays the quotes in the scrolling display.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Enable scroll buttons</guilabel> </term>
<listitem>
<para>Select this option to display forward and back arrow buttons on the applet to enable you to move forwards or backwards in the applet display. </para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="gtik-settings-appearance">
<title>Appearance</title>
<variablelist>

<varlistentry>
<term><guilabel>Width</guilabel> </term>
<listitem>
<para>Use this spin box to increase or decrease the width of the applet in the panel.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Display only symbols and price</guilabel> </term>
<listitem>
<para>Select this option to only display the company symbol and the current stock quote in the applet display.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Scroll left to right</guilabel> </term>
<listitem>
<para>Select this option to reverse the direction in which the applet display scrolls. If you select this option, the display scrolls from left to right instead of from right to left. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>+ Color</guilabel> </term>
<listitem>
<para>Click on this button to select a color to display stock quotes that increased since the previous stock quote. Click on the color button to display a color selector dialog. Use the color wheel or sliders on the color selector dialog to choose a color. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>- Color</guilabel> </term>
<listitem>
<para>Click on this button to select a color to display stock quotes that decreased since the previous stock quote. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Unchanged Color</guilabel> </term>
<listitem>
<para>Click on this button to select a color to display stock quotes that are unchanged since the previous stock quote.  </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Background Color</guilabel> </term>
<listitem>
<para>Click on this button to select a background color for the display area of the applet. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Font</guilabel> </term>
<listitem>
<para>Click on this button to choose the font to use to display the stock symbol and current price. </para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

</sect2>

</sect1>

</article> 