<?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.3">
  <!ENTITY date "August 2003">
  <!ENTITY applet "CD Player">
]>
<!-- 
      (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>2002</year> 
		<year>2003</year> 
		<holder>Sun Microsystems</holder> 
	 </copyright> 
	 <copyright> 
		<year>2000</year> 
		<holder>Chris Lyttle</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></address> 
		  </affiliation> 
		</author> 
		<author> 
		  <firstname>Chris</firstname> 
		  <surname>Lyttle</surname> 
		  <affiliation> 
			 <orgname>GNOME Documentation Project</orgname> 
			 <address> <email>chris@wilddev.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>&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>CD Player Applet Manual V2.2</revnumber> 
		  <date>January 2003</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
		<revision> 
		  <revnumber>CD Player Applet Manual V2.1</revnumber> 
		  <date>August 2002</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
		<revision> 
		  <revnumber>CD Player Applet 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>CD Player Applet</revnumber> 
		  <date>2000</date> 
		  <revdescription> 
			 <para role="author">Chris Lyttle
				<email>chris@wilddev.net</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>CD Player Applet</primary> 
  </indexterm> 

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
  <sect1 id="cdplayer_applet_introduction"> 
	 <title>Introduction</title> 
	 <!-- ==== Figure ============================================= -->
	 <figure id="applet-fig"> 
		<title>&applet; Applet</title> 
		<screenshot> 
		  <mediaobject> 
			 <imageobject><imagedata fileref="figures/cdplayer_applet.png"
				format="PNG"/> 
			 </imageobject>
			 <textobject> 
				<phrase>Shows &applet; applet. Contains Stop, Play, Eject, Previous Track, and Next Track buttons.
				</phrase> 
			 </textobject> 
		  </mediaobject> 
		</screenshot> 
	 </figure> 
    	<!-- ==== End of Figure ======================================= -->
	<para>The <application>&applet;</application> applet enables you to play
	audio Compact Discs (CDs) on your computer. </para>
	<para>To add <application>&applet;</application> to a panel, right-click on the panel, then choose <menuchoice>
	<guimenu>Add to Panel</guimenu>
	<guisubmenu>Multimedia</guisubmenu>
	<guimenuitem>CD Player</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>
  </sect1>

  <sect1 id="cdplayer_applet_usage">
	<title>Usage</title>

	<sect2 id="cdplayer_applet_play">
	<title>To Play a CD</title>
	<para>To play a CD, insert the CD in the CD drive of your computer, then click on the 
	<inlinemediaobject>
	<imageobject><imagedata fileref="figures/cdplayer_applet_play.png" format="PNG"/></imageobject>
	<textobject><phrase>Shows Play button. </phrase></textobject>
	
</inlinemediaobject> button. </para>
	<figure id="fig-cd-playing"> 
		<title>&applet; Applet While a CD is Playing</title> 
		<screenshot> 
		  <mediaobject> 
			 <imageobject><imagedata fileref="figures/cdplayer_applet_playing.png" format="PNG"/> 
			 </imageobject>
			 <textobject> 
				<phrase>Shows &applet; applet with a CD playing.
				</phrase> 
			 </textobject> 
		  </mediaobject> 
		</screenshot> 
	 </figure> 
	<para>The applet displays the following information, as shown in <xref linkend="fig-cd-playing"/>: </para>
	<itemizedlist>
		<listitem><para>The time elapsed on the current track.</para></listitem>
		<listitem><para>The number of the track that is currently playing.</para></listitem>
	</itemizedlist>
	</sect2>

	<sect2 id="cdplayer_applet_pause">
	<title>To Pause a CD</title>
	<para>To pause a CD that is playing, click on the 
	<inlinemediaobject>
	<imageobject><imagedata fileref="figures/cdplayer_applet_pause.png" format="PNG"/></imageobject>
	<textobject><phrase>Shows Pause button. </phrase></textobject>	
	</inlinemediaobject> button. 
	When you pause a CD, the time elapsed on the current track flashes until you resume playing the CD. To resume playing the CD, click on the 
	<inlinemediaobject>
	<imageobject><imagedata fileref="figures/cdplayer_applet_playafterpause.png" format="PNG"/></imageobject>
	<textobject><phrase>Shows Play (after Pause) button. </phrase></textobject>	
	</inlinemediaobject> button. </para>
	</sect2>

	<sect2 id="cdplayer_applet_movetracks">
	<title>To Move Through Tracks</title>
	<para>To move to the next track on the CD, click on the 
	<inlinemediaobject>
	<imageobject><imagedata fileref="figures/cdplayer_applet_nexttrack.png" format="PNG"/></imageobject>
	<textobject><phrase>Shows Next Track button. </phrase></textobject>	
	</inlinemediaobject> button. 
	To continue moving through the next tracks on the CD, continue to click on the 
	<inlinemediaobject>
	<imageobject><imagedata fileref="figures/cdplayer_applet_nexttrack.png" format="PNG"/></imageobject>
	<textobject><phrase>Shows Next Track button. </phrase></textobject>	
	</inlinemediaobject> button.</para>
	<para>To move to the previous track on the CD, click on the 
	<inlinemediaobject>
	<imageobject><imagedata fileref="figures/cdplayer_applet_prevtrack.png" format="PNG"/></imageobject>
	<textobject><phrase>Shows Previous Track button. </phrase></textobject>	
	</inlinemediaobject> button. To continue moving through the previous tracks on the CD, continue to click on the 
	<inlinemediaobject>
	<imageobject><imagedata fileref="figures/cdplayer_applet_prevtrack.png" format="PNG"/></imageobject>
	<textobject><phrase>Shows Previous Track button. </phrase></textobject>	
	</inlinemediaobject> button.</para>
	</sect2>

	<sect2 id="cdplayer_applet_stop">
	<title>To Stop a CD</title>
	<para>To stop a CD, click on the 
	<inlinemediaobject>
	<imageobject><imagedata fileref="figures/cdplayer_applet_stop.png" format="PNG"/></imageobject>
	<textobject><phrase>Shows Stop button. </phrase></textobject>	
	</inlinemediaobject> button.</para>
	</sect2>

	<sect2 id="cdplayer_applet_eject">
	<title>To Eject a CD</title>
	<para>To eject the CD, click on the 
	<inlinemediaobject>
	<imageobject><imagedata fileref="figures/cdplayer_applet_eject.png" format="PNG"/></imageobject>
	<textobject><phrase>Shows Eject button. </phrase></textobject>	
	</inlinemediaobject> button. 
	The applet ejects the CD from the CD drive. Remove the CD, then close the drive. </para>
	</sect2>

	<sect2 id="cdplayer_additional_features">
	<title>To Access Additional Features</title>
	<para>To access additional features for playing audio CDs, such as to edit
	track information or to adjust the volume, you can start
	the <application>CD Player</application> application. To start the <application>
	CD Player</application> application from the CD Player, right-click on the
	applet, then choose <guimenuitem>Open CD Player</guimenuitem>. </para>
	</sect2>

  </sect1>

<!-- ============= Preferences ============================= -->
  <sect1 id="cdplayer_applet_prefs"> 
	 <title>Preferences</title> 

	 <sect2 id="cdplayer-applet_specify_cd">
	 <title>To Specify the CD Device</title>
	 <para>To specify the CD device that the applet accesses, right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem>.
	 Type the path to the CD device in the <guilabel>Device path</guilabel> text box. To use the default CD device for the system, click <guibutton>Use Default</guibutton>.
	 To save the change and close the <guilabel>CD Player Preferences</guilabel> dialog, click <guibutton>Close</guibutton>.  </para>
	 </sect2> 
	 
  </sect1> 

</article> 
