<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<article>
	<articleinfo>
		<title>Emacspeak User's Guide</title>
		<author>
			<firstname>Jennifer</firstname>
			<surname>Jobst</surname>
			<affiliation>
				<address><email>jobst@us.ibm.com</email></address>
			</affiliation>
		</author>
		<abstract>
			<para>
			This document helps Emacspeak
			users become familiar with Emacs as an audio desktop and
			provides tutorials on many common tasks and
			the Emacs applications available to perform those tasks. 
			</para>
		</abstract>
		<pubdate>December 4, 2001</pubdate>
		<revhistory>
			<revision>
				<revnumber>1.2</revnumber>
				<date>December 3, 2001</date>
				<authorinitials>JEJ</authorinitials>
				<revremark>Changed license to GFDL</revremark>
			</revision>
			
			<revision>
				<revnumber>1.1</revnumber>
				<date>November 12, 2001</date>
				<authorinitials>JEJ</authorinitials>
			</revision>

			<revision>
				<revnumber>1.0 DRAFT</revnumber>
				<date>October 19, 2001</date>
				<authorinitials>JEJ</authorinitials>
			</revision>
		</revhistory>
	</articleinfo>


<sect1 id="legal-notice">
<title>Legal Notice</title>

	<para>
	This document is Copyright &copy 2001 IBM. Permission is
	granted to copy, distribute and/or modify this document under
	the terms of the GNU Free Documentation License, Version 1.1
	or any later version published by the Free Software Foundation with no Invariant Sections, no
	Front-Cover Texts, and no Back-Cover Texts. A copy of the
	license can be found at <ulink url="http://www.gnu.org/license/fdl.txt"></ulink>.
	</para>
</sect1>

<sect1 ID="introduction">
<title>Introduction</title>

<sect2 ID="what-is-emacspeak">
<title>What is Emacspeak?</title>

	<para> 
	Many users are familiar with Emacs as a text editor and have
	used it extensively in that capacity.  But Emacs is not just a
	text editor -- it is actually a desktop, in some ways like the
	graphical desktops that many use today. As a
	desktop, Emacs comes with all kinds of built-in functions, much
	like the Windows &trade desktop, including an e-mail
	application, calendar/appointment program, cd-player, games,
	and more. And like Windows &trade, there are many additional
	applications that you can download and add to Emacs that
	expand its functionality -- web browsers, the LaTeX text
	editor, mp3 players, and others. Unlike Windows, all of these powerful
	tools are under the GPL (Gnu Public License), so you can use them free of charge.
	</para>

	<para>
	For visually impaired users, adding Emacspeak to Emacs might
	be compared to adding Jaws to Windows, except that instead of
	simply reading the screen to you as a standard "screenreader"
	might do, Emacspeak treats speech as first-class
	output. Because Emacspeak interacts directly with Emacs instead of just being an add-on, it provides much more context-specific
	information about what is going on than a typical
	screenreader would. In addition, there are many special
	commands just for Emacspeak that enhance interaction with a variety
	of Emacs applications.
	</para>
</sect2>

<sect2 ID="about-this-tutorial">
<title>About this tutorial</title>

	<para>
	Because Emacs and Emacspeak are unlike any environments you
	may have used before, it helps to know a little bit about how
	they work. This tutorial assumes that you have either used and
	are
	familiar with Emacs and Emacspeak or that you have completed some
	of the Emacs and Emacspeak tutorials. For a list of
	recommended tutorials, please refer to <xref linkend=getting-started>.
	</para>

	<para>
	This tutorial is organized by task and sub-task.  For example,
	the Internet section contains sub-sections on browsing the
	Internet, using email, chatting online, and other tasks. The
	File Manipulation section contains information on downloading
	and installing files, finding files, etc. For a complete
	listing of the available tasks, refer to the table of contents.
	</para>

	<para>
	Within this tutorial, you will find references to a number of
	Emacspeak-enabled applications, some that are included within
	the Emacs application, and some that are add-ons and must
	be downloaded.  Please note that the applications listed in
	this tutorial should not be considered a complete collection of applications but only a
	small subset. The complete list of Emacspeak-enabled
	applications is available at <ulink
	url="http://emacspeak.sourceforge.net/applications.html"></ulink>.
	</para>
</sect2>
</sect1>


<sect1 ID="before-you-begin">
<title>Before you begin</title>

<sect2 ID="getting-started">
<title>Getting started with Emacs and Emacspeak</title>

	<para>
	Before you get started with Emacs and Emacspeak, you must
	install both. Most distributions come with Emacs, or you can
	download it from the Emacs home page at <ulink
	url="http://www.gnu.org/software/emacs/emacs.html"></ulink>.
	If you have not already installed Emacspeak, you can download
	it from <ulink url="http://emacspeak.sourceforge.net/"></ulink>. For Emacspeak installation
	information, please refer to the
	Emacspeak Installation HOWTO available at the Emacspeak home
	page, <ulink
	url="http://emacspeak.sourceforge.net"></ulink>. 
	</para>

	<para>
	If you've never used Emacs or Emacspeak before, you'll probably want to
	try some of the following tutorials:</para>

	<itemizedlist mark=bullet>
		<listitem>
			<para> 
			"A gentle introduction to Emacspeak," by Gary
			Lawrence Murphy,<ulink
			url="http://emacspeak-guide.sourceforge.net/tutorial.html/"></ulink>.
			Gary provides a lighthearted but thorough introduction to
			Emacs and Emacspeak, focusing on users who are
			not familiar with either application.  This
			introduction is
			recommend as a starting point, even before you
			do the Emacs tutorial (see next item).
			</para>
		</listitem>

		<listitem>
			<para>
			"The (Official) Emacs Tutorial," by the Free
			Software Foundation. I call this the
			"official" tutorial because it is included
			with Emacs. To access this tutorial, start Emacs, then type <command>C-h
			t</command> (Control h t).  This tutorial discusses the
			basic Emacs commands, including navigation,
			using Emacs as a text editor, and a bit about
			how Emacs works "under the hood." For
			new users this tutorial is strongly recommended, and
			even those users who are familiar with Emacs might find
			something they didn't already know.
			</para>
		</listitem>

		<listitem>
			<para>
			"Emacspeak Tutorial," by Nita Van Zandt,
			available at <ulink
			url="http://www.mv.com/ipusers/vanzandt/emacspeak-tutorial-1.0.tar.gz"></ulink>.
			This tutorial helps new Emacspeak users get up
			and running and includes plenty of examples
			and step-by-step instructions.  Once you've
			gotten a grasp of Emacs, this tutorial
			is a must.
			</para>		
		</listitem>

		<listitem>
			<para>
			"The Emacs Beginner's HOWTO," by Jeremy
			D. Zawodny. It is available at <ulink
			url="http://www.linuxdoc.org/HOWTO/Emacs-Beginner-HOWTO.html"></ulink>
			and is also bundled into some of the newer
			Linux distributions. The Beginner's HOWTO
			discusses many of the topics discussed in the
			Emacs tutorial, and also includes overviews of some
			of the more popular Emacs packages, including
			VM, Gnus, BBDB, and AucTeX (some of which are
			discussed in this HOWTO).
			</para>		
		</listitem>
	</itemizedlist>

	<para>
	Finally, you might want to peruse <ulink
	url="http://www.gnusoftware.com/WebRing/zone.cgi?list"></ulink>,
	which provides a list of Emacs resource sites.
	</para>
</sect2>

<sect2 ID="emacs-conventions">
<title>Emacs Command Conventions</title>

	<para>
	Emacs commands are denoted by holding down either the
	<command>Control</command> key or the <command>Meta</command> key, then pressing one or
	more alphanumeric keys. On today's keyboards, the
	<command>Alt</command> key provides the same functionality as
	the old <command>Meta</command> key, or alternatively you can
	press the <command>Esc</command> key followed by the
	alphanumeric keys (you don't have to hold down the
	<command>Esc</command> key). Because different documents
	sometimes use different notation to denote these sequences, this section
	explains the notation used in this HOWTO.  For consistency,
	this HOWTO uses the same notation as is used in the Emacs menus. 
	</para>

	<para>
	There are a few different types of key sequences you may
	see. The first is commonly written in the form <command>C-x
	C-s</command>.  The letter "C," followed by a hypen, literally
	means "hold down the Control key" (the letter "M" would denote
	the Meta (Alt or Esc) key), and the additional letters denote
	specific commands.  This example, which saves the current
	file, should be interpreted as, "Hold down the Control key,
	press the letter x followed by the letter s, then release the Control key."
	</para> 

	<para>
	Another common  sequence is written in the form <command>C-x
	d</command>. Again, the letter "C" followed by a hyphen
	denotes holding down the Control key.  However, because the
	second letter of the sequence does not have a "C-" in front of
	it, you do not hold down the Control key while pressing the
	second letter. Thus, this command should be interpreted as,
	"Hold down the Control key and type x, then release the Control key and type d."
	Sometimes you may see commands with more than one letter after
	them, such as <command>C-e d w</command>. The same rules
	apply: you should hold down the Control key, press "e,"
	release the Control key, then press "d" and "w". 
	</para>

	<para>
	Finally, you may see commands that use actual words, such as
	<command>M-x
	emacspeak-toggle-word-echo</command>. Fortunately, most of
	these longer commands have a shorthand command (in this case,
	<command>C-e d w</command>.  However, should you opt to type
	the entire command, you would hold down the Meta or Alt key,
	type x, release the Meta key, then type
	emacspeak-toggle-word-echo. 
	</para>
</sect2>

<sect2 id="getting-help.sgml">
<title>Getting Help</title>

	<para>
	There are several different types of help you can get from
	within Emacs. If you are unfamiliar with Emacs or Emacspeak,
	refer to Getting Started with Emacs and Emacspeak in <xref linkend="getting-started"> for
	information on several tutorials that can help get you up and
	running.  If you've completed those tutorials and are looking
	for more in-depth help on specific topics, consider the
	following sources.
	</para>

<sect3>
<title>Getting help in Emacs</title>

	<para>
	The most comprehensive source for Emacs is the GNU Emacs
	Manual, available at <ulink
	url="http://www.delorie.com/gnu/docs/emacs/emacs_toc.html"></ulink>.
	Not only does this document contain information on using Emacs
	as a text editor, but it also contains information on how to use
	many of the Emacs applications. 
	</para>

	<para>
	In addition, there are many help options within Emacs, all of
	which can be accessed using <command>C-h</command>. Some of
	these options, and the types of help they provide, are listed below.
	</para>

	<variablelist>
		<varlistentry>
			<term><command>C-h i</command></term>
				<listitem>
					<para>
					Invokes the
					online hypertext help system,
					also called "info." Not only
					does info contain
					Emacs-specific help, it also
					contains the man page help
					(refer to <xref
					linkend=man-pages>, Viewing
					the Linux online man pages,
					for more information). When in
					info, you can type
					<command>h</command> to open a
					primer for first-time
					users. Type
					<command>q</command> to quit.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>C-h a</command></term>
				<listitem>
					<para>
					Runs "apropos"
					and asks for a word to search
					on. It then gives you a list
					of all commands that contain that word.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>C-h C-f</command></term>
				<listitem>
					<para>
					When you enter a
					command name, info jumps to
					the documentation for that
					command.</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>C-h c</command></term>
				<listitem>
					<para>
					When you press
					any key or key sequence, info
					provides the name of the
					function that key invokes.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>C-h k</command></term>
				<listitem>	
					<para>
					Similar to the <command>C-h c</command>
					command but provides more
					detailed information about the
					function or action that occurs
					when you press a key or sequence of keys.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>C-h w</command></term>
				<listitem>
					<para>
					Similar to the
					<command>C-h c</command> and
					<command>C-h k</command> commands,
					except that when you type in
					the name of a command, it
					returns the key sequence
					needed to invoke that command.
					For example, if you type
					<command>C-h w</command>, then
					finder-by-keyword, it will
					return <command>C-h
					p</command>.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>C-h p</command></term>
				<listitem>
					<para>
					Lists all the
					packages available in Emacs.
					Packages are defined by the
					applications they contain, for
					example hypermedia, games,
					tools (for programming), etc.
					</para>
				</listitem>
		</varlistentry>
	
		<varlistentry>
			<term><command>C-h n</command></term>
				<listitem>
					<para>
					Opens a history
					of user-visible changes to
					Emacs.
					</para>
				</listitem>
		</varlistentry>
	
		<varlistentry>
			<term><command>C-h F</command></term>
				<listitem>
					<para>
					Displays the
					Emacs frequently asked
					questions. Should you have
					questions about or problems
					with Emacs, you are urged to
					review the FAQ in an effort to
					cut down on noise in the
					Emacs-related newsgroups.
					Note that this FAQ is only for
					Emacs, and not Emacspeak.
					</para>
				</listitem>
		</varlistentry>
	</variablelist>
</sect3>

<sect3>
<title>Getting help on Emacspeak commands</title>

	<para>
	When you install Emacspeak,
	additional Emacspeak-specific help is also installed.  In general,
	Emacspeak commands begin with <command>C-e</command>. The more
	commonly used help commands are listed below:</para>

	<variablelist>

		<varlistentry>
			<term><command>C-h C-e</command></term>
				<listitem>
					<para>
					Lists the
					Emacspeak commands that are available.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>C-e F</command></term>
				<listitem>
					<para>
					Opens the
					Emacspeak FAQ.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>C-e C-h</command></term>
				<listitem>
					<para>
					Enters a special
					mode where every key stroke
					you type is spoken but nothing
					actually happens.  You can use
					this mode if you're new to
					Emacspeak and want to test out
					a few keystrokes. When you're
					finished, you can exit this
					mode using
					<command>C-g</command>.
					</para>
				</listitem>
		</varlistentry>

	</variablelist>

	<para>
	In addition to the general Emacs commands that are Emacspeak
	enabled, many applications have their own Emacspeak-enabled
	commands.  To get a list of these commands, invoke the
	application of choice (for example, W3 for viewing web sites)
	and then type <command>C-h k</command> for a list of key
	bindings, or <command>C-h m</command> to list the commands
	associated with the cirretn active modes.
	</para> 

</sect3>

<sect3 id="man-pages">
<title>Viewing the Linux online man pages</title>

	<para>
	Linux comes with an extensive manual, better known as the
	"man" pages. These pages cover just about every Linux command.  The only
	drawback to using the man pages is that you must know the name of the command you
	want information about.  To read a man entry:
	</para>

	<orderedlist>
		<listitem>
			<para>
			From inside Emacs, type <command>M-x
			man</command>. You will be prompted for the manual
			entry you want to view.
			</para>
		</listitem>
	
		<listitem>
			<para>
			Type the manual entry name (for example,
			<command>mount</command>). The entry for that
			option will open in Emacs.
			</para>
		</listitem>
	</orderedlist>

	<para>
	For more information on man pages themselves, you can type
	<command>man</command> when prompted for the manual entry name.</para>

</sect3>
</sect2>
</sect1>

<sect1 ID="system-administration">
<title>System Administration</title>

	<para>
	This section contains information on common system
	administration tasks. It is by no means an
	exhaustive list of what goes on in Linux system administration but
	rather a collection of a few common tasks that a new user may
	find useful. If you would like more information on Linux
	system administration, refer to the online Linux System
	Administrators' Guide, found at <ulink
	url="http://www.linuxdoc.org/LDP/sag/book1.html"></ulink>.
	</para>

<sect2 ID="changing-your-password">
<title>Changing your password</title>
 
	<para>
	Every time you log onto a Linux system, you must provide a
	password for your account. Occasionally you may wish to change
	your password, and many systems require that you do so regularly
	for added security.
	</para>

	<para>
	Changing your password is done in the Emacs shell. Normally,
	changing your password in the Emacs shell displays it on the
	screen and also speaks it aloud. However, Emacspeak adds a line to your
	<filename>.emacs</filename> file that keeps Emacs from echoing
	your password either visually or orally. Of course, it's still
	a good idea to change your password in a secure area where
	no-one is likely to watch you type it in. To change your
	password: 
	</para> 

	<orderedlist>
		<listitem>
			<para>
			From inside Emacs, type <command>M-x
			shell</command> to launch an Emacs shell.
			</para>
		</listitem>

		<listitem>
			<para>
			At the prompt, type
			<command>passwd</command>. You will be prompted for both your
			current password and your new password. 
			</para>
		</listitem>
	</orderedlist>


	<para>
	Note that some systems require passwords to be a certain
	length or contain certain characters such as numbers. If your
	password entry is rejected for some reason, keep trying.  In general,
	most 6-8 letter passwords that contain at least one number
	work well. Of course, be sure it's easy for you to remember!
	</para>	
</sect2>

<sect2 id="installing-applications">
<title>Installing applications</title>

<sect3 ID="about-emacs-applications">
<title>About Emacs applications</title>

	<para>
	As an Emacs user, you can
	mentally divide applications into two categories: those
	that are native to Emacs (that is, those applications written
	specifically for Emacs),
	and those that are not (for example, command-line applications). If an application is not
	Emacs-native, you can still run it from the Emacs shell
	command line.  To run the application, type the command
	<command>M-x shell</command> to start the shell then the appropriate command to start the
	application. If the application is native to Emacs, you can
	type <command>M-x name-of-application</command> to start the
	application. The application will run directly in the Emacs
	buffer.
	</para>

	<para>
	Sometimes, even though an application wasn't designed
	specifically for Emacs, you can install a special wrapper
	file that makes Emacs think the application is Emacs-native. These
	special files have a <filename>.el</filename>, or
	Emacs-lisp, extension. After you've downloaded and
	installed a new application, if a <filename>.el</filename> file exists for it, you
	can download that file too.  Place it in the correct
	directory, add the appropriate line to your
	<filename>.emacs</filename> file so that Emacs will recognize
	the application, and
	you'll be able to run the application as if it were native to Emacs.  
	</para>

	<para>
	As an Emacspeak user, you'll also want to know which
	applications are Emacspeak-enabled. These Emacspeak-enabled applications have a second
	special <filename>.el</filename> wrapper file that contains Emacspeak-specific commands that provide
	audio feedback just for that application. For a complete list
	of Emacspeak-enabled applications, see <ulink
	url="http://emacspeak.sourceforge.net/applications.html"></ulink>.
	All avaliable <filename>emacspeak-*.el</filename> files are
	included with Emacspeak, so you won't have to download them.
	</para>

	<para>
	So, when you install a new application,
	you'll need the following three things:
	</para>
		<itemizedlist mark=bullet>
			<listitem>
				<para>
				The application.
				</para>
			</listitem>

			<listitem>
				<para>
				A <filename>.el</filename> file for
				that application, if you want to run
				it directly from Emacs instead of from
				the Emacs shell command line.
				</para>
			</listitem>

			<listitem>
				<para>
				An
				<filename>emacspeak-*.el</filename>
				file for the application, if you want
				to run it directly from Emacs and have
				it Emacspeak-enabled. Check
				in the /emacspeak/lisp directory
				to see if one exists for your
				application.
				</para>
			</listitem>
		</itemizedlist>

	<para>
	Whenever possible, this HOWTO tells you specifically
	whether or not an application is Emacs-native, and if not,
	where to get the special <filename>.el</filename> wrapper files if they are
	available.
	</para>
</sect3>

<sect3 ID="downloading-applications">
<title>Downloading your application</title>

	<para>
	Once you've chosen a new application to install, you'll need
	to download it. Typically you'll use either
	<application>FTP</application> application or the
	<application>wget</application> application to download your new Linux
	application, since most of them are distributed only on the
	Internet. If you are unfamiliar with the
	<application>FTP</application> and
	<application>wget</application> applications, refer to <xref
	linkend=downloading-files>, Downloading files, for information
	on how to use these applications to get your files.
	</para>

	<para>
	Usually, the files you download will have some sort of extension (the letters after the "dot"
	or "period" in the file name) that denotes what type of file it
	is. If your file has a .gz or .tar extension, refer to <xref
	linkend=uncompressing-files> on uncompressing files.  If your file has a .rpm
	extension, refer to <xref linkend=installing-rpms> on
	installing RPMs.
	</para>
</sect3>

<sect3 ID="uncompressing-files">
<title>Uncompressing files</title>

	<para>
	Most files are compressed in at least one (and
	sometimes multiple) ways. You can tell how a file was
	compressed, and thus how to uncompress it, by the extensions
	on the file.  The most common extensions are .tar and .gz,
	though there are others.
	</para>

	<para>
	If your downloaded file has multiple extensions, you'll have
	to uncompress it one step at a time, uncompressing the last
	extension first.  For example, if the file is named
	<filename>foo.tar.gz</filename>, complete the following steps:
	</para>	

	<orderedlist>
		<listitem>
			<para>
			Start the <application>Emacs</application>
			shell using the command <command>M-x shell</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			If necessary, use the <command>cd</command>
			(change directory) command to move to the
			directory that contains your downloaded file.
			</para>
		</listitem>
	
		<listitem>
			<para>
			At the Emacs shell command prompt, type
			<command>gunzip foo.tar.gz</command>. The
			file will be unzipped, leaving you
			with a file called
			<filename>foo.tar</filename> in your
			directory. Files with a .tar extension are commonly known as "tarballs."
			</para>
		</listitem>

		<listitem>
			<para>
			At the command prompt, type <command>tar -xvf
			foo.tar</command>. The tarball will be uncompressed, usually
			leaving either a single file or a new
			directory that contains a number of files.
			</para>

			<para>
			Some recent versions of the
			<command>tar</command> command will both
			uncompress and untar a file if you add the
			<command>-z</command> option. Thus, the
			command <command>tar -xvfz
			foo.tar.gz</command> would both uncompress and
			untar the file.
			</para>
		</listitem>
	</orderedlist>

	<para>
	If you ended up with a new directory after you uncompressed
	your files, it probably contains
	files with names like <filename>INSTALL</filename>,
	<filename>NOTES</filename>, or <filename>README</filename>,
	among others. These files usually include instructions for
	installing that specific application. As each application may
	have a different installation process, you should read these
	files carefully and follow any instructions they may
	provide. You'll
	probably need to be the root user to actually install any
	applications, as only root usually has the necessary permissions. 
	</para>

	<para>
	If you ended up with a single file after uncompressing, it
	probably has either a .rpm extension or some other type of
	extension, such as .el. If it has a .rpm extension, refer to
	<xref linkend=installing-rpms> on installing RPMs. If the file has
	some other extension, refer to the website where you
	downloaded it for more information.
	</para>
</sect3>

<sect3 ID="installing-rpms">
<title>Installing RPMs</title>

	<para>
	If you downloaded or uncompressed a file that has a .rpm
	extension, you're in luck! It is a Red Hat Package Manager
	file that contains all the information it needs to install itself
	automatically. Assuming that your distribution supports RPMs,
	you can install the file as follows:
	</para>

	<orderedlist>
		
		<listitem>
			<para>
			Open a root shell using the command <command>M-x
			emacspeak-root</command>, which is bound to
			<command>C-e C-r</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			At the command prompt, type <command>rpm -xfv
			foo.rpm</command>. A number of messages will scroll by,
			and you'll be returned to the command prompt
			once RPM finishes installing the files.
			</para>
		</listitem>
	</orderedlist>

	<para>
	For additional information on RPMs, refer to Red Hat's
	official website, <ulink url="http://www.redhat.com"></ulink>
	or the official Red Hat Linux reference guide, at <ulink
	url="http://www.redhat.com/support/manuals/RHL-7-Manual/ref-guide/ch-rpm.html"></ulink>.
	</para>
</sect3>
</sect2>
</sect1>

<sect1 ID="working-with-files">
<title>Working with files</title>

	<para>
	In addition to performing common file manipulation tasks, such
	as moving, copying, and deleting, you'll also want to download
	files from the Internet, search for files in your directories,
	and FTP files. Some of these functions are built into Emacs,
	while some of these tasks require additional applications that
	can be downloaded.
	</para>

<sect2 ID="downloading-files">
<title>Downloading files</title>

	<para>
	Once you know the URL of the file to download, you can use the
	<command>wget</command> command from within the Emacs shell to
	retrieve the file.  If you do not know the URL of the file to
	download, use the <application>W3</application> application to browse the web and find the URL of the file (refer
	to <xref linkend="browsing-the-internet"> for
	information on using the <application>W3</application> application). Then
	use the command <command>wget</command> to download it. For more
	information on the <command>wget</command> command, refer to the
	<command>wget</command> man page.
	</para>

	<para>
	To download a file:
	</para>

	<orderedlist>
		<listitem>
			<para>
			From inside Emacs, type <command>M-x
			shell</command> to start the shell.
			</para>
		</listitem>

		<listitem>
			<para>
			Since the <command>wget</command>
			command places
			the downloaded file into your current
			directory, change directories to the desired
			directory.
			</para>
		</listitem>
	
		<listitem>
			<para>
			When you are in the appropriate directory,
			type <command>wget [url]</command>, then press
			<keysym>Enter</keysym>.  Remember that you can
			copy and paste the URL of the file to download
			from the <application>W3</application> web
			browser application.
			</para>
		</listitem>
	</orderedlist>

	<para>
	As the file is being downloaded, one dot appears on the screen
	for each kilobyte of data
	received. The <command>wget</command> command lets you know when
	the download is complete. 
	</para>

	<para>
	Another option for downloading (or uploading) a file is via
	FTP. Refer to <xref linkend=ftping-a-file> on FTPing a file for more information.
	</para>
</sect2>

<sect2 ID="find-a-file">
<title>Finding a file</title>

	<para>
	There are several ways you can find a file. This section discusses two options.
	</para>

	<para>
	If you know the name of the file, or at least remember part of
	it, you can use the <command>find-file</command> command:
	</para>

	<orderedlist>
		<listitem>
			<para>
			In Emacs, type <command>M-x find-file</command>.
			</para>
			<para>
			Result: You will be prompted for the name of
			the file in the default working directory.
			</para>
		</listitem>

		<listitem>
			<para>
			Type the name of the file (or use wildcards) you wish to find.
			</para>
		</listitem>
	</orderedlist>

	<para>
	Alternatively, you may want to browse your directories to look
	for a file.  You can do this using the Emacs directory editor,
	<application>dired</application>.  To
	start <application>dired</application>: 
	</para>

	<orderedlist>
		<listitem>
			<para>
			In Emacs, type <command>C-x d</command> or
			<command>M-x dired</command>. You will be prompted for the name of
			the file.  You can type the name (or part of
			the name) of the file to find, using the Tab
			key to complete the file
			name. <application>dired</application> will
			list any files that match the name you
			entered.  Alternatively, you can view a full
			listing of the directory by providing a
			directory name (or pressing Return to view the
			current directory) when prompted.
			</para>
		</listitem>
	</orderedlist>

	<para>
	For more information on using the directory editor, refer to
	<xref linkend=using-the-directory-editor>.  For a complete listing of
	<application>dired's</application> features and capabilities,
	refer to <ulink
	url="http://www.delorie.com/gnu/docs/emacs/emacs_360.html"></ulink>.
	</para>
</sect2>

<sect2 ID="ftping-a-file">
<title>FTPing a file</title>

	<para>
	Emacs contains a built-in file transfer protocol, or FTP,
	application. The FTP application can be used to upload and download files to
	and from other machines. In order to use FTP,
	you will need to know the hostname of the machine to contact.
	</para>

	<para>
	To invoke the FTP application:
	</para>

	<orderedlist>
		<listitem>
			<para>
			Within Emacs, type <command>M-x ftp</command>.
			</para>
			<para>
			Result: You will be prompted for an ftp hostname.
			</para>
		</listitem>
	</orderedlist>

	<para>
	Alternatively, you can start an Emacs shell using <command>M-x
	shell</command> and use FTP from the command line.  There is a
	short tutorial on using the command line FTP at <ulink
	url="http://unix.about.com/library/weekly/aa121800a.htm?once=true&"></ulink>.
	</para>
</sect2>

<sect2 ID="file-manipulation">
<title>Manipulating files</title>
	<para>
	This section contains information on moving, copying,
	and deleting files from within Emacs. In general, there are
	two ways you can go about these tasks.  One option is to use the
	command line from an Emacs shell, and the other is to use
	<application> dired</application>. Both methods are discussed in this section.
	</para>

<sect3 ID="using-the-command-line">
<title>Using the command line</title>
	<para>
	If you are familiar with Unix command-line arguments, you may
	prefer to use the command line to manipulate files. To use the
	command line, open an Emacs command shell using
	<command>M-x shell</command>. The following list shows some
	basic file manipulation commands and what they do:
	</para>

	<variablelist>
		<varlistentry>
			<term><command>cp <filename>file1
					file2</filename></command></term>
				<listitem>
					<para>
					Copies file1 to a new file
					named file2.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>mv <filename>source
					target</filename></command></term>
				<listitem>
					<para>
					Moves a file from the source
					directory to the target directory.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>rm
					<filename>file</filename></command></term>
				<listitem>
					<para>
					Deletes a file.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>mkdir
			<filename>directoryname</filename></command></term>
				<listitem>
					<para>
					Creates a directory with the
					name
					<filename>directoryname</filename>.
					</para>
				</listitem>
		</varlistentry>
		
		<varlistentry>
			<term><command>rmdir
					<filename>directoryname</filename></command></term>
				<listitem>
					<para>
					Deletes the directory
					<filename>directoryname</filename>
					if it is empty.
					</para>
				</listitem>
		</varlistentry>
			
		<varlistentry>
			<term><command>ls</command></term>
				<listitem>
					<para>
					Lists all the files in the
					current directory.
					</para>
				</listitem>
		</varlistentry>
	</variablelist>

	<para>
	You can find more
	information on any of these commands (most can be run with
	various options that allow for more user control) by looking
	them up in the online man pages. Since the list presented here
	covers only the most basic commands, you may want to consult the
	Linux user's guide, available at <ulink
	url="http://www.ibiblio.org/pub/Linux/docs/linux-doc-project/users-guide/"></ulink>,
	for more information.
	</para>
</sect3>

<sect3 ID="using-the-directory-editor">
<title>Using the directory editor</title>
	<para>
	Although many Linux users use the command line to manipulate
	files, Emacs provides a powerful alternative, called
	<application>dired</application>.  <application>Dired</application> is the Emacs
	directory editor, and is great for manipulating files if you'd
	rather not use the command line or aren't familiar with it. To
	start <application>dired</application>:
	</para>

	<orderedlist>
		<listitem>
			<para>
			In Emacs, type <command>M-x
			dired</command>. You will be prompted for the
			directory to open.
			</para>
		</listitem>

		<listitem>
			<para>
			Type in the directory to display, or press
			<keysym>Return</keysym> to open the default
			directory.
			</para>
		</listitem>
	</orderedlist>

	<para>
	Once you've started <application>dired</application>, you can move around in the Emacs
	buffer to have the file names, permissions, owners, sizes, and
	dates created/edited read aloud.
	</para>

	<para>
	In dired, some commands mark files for manipulation (for
	example, you can mark several files, then delete them all),
	and some commands (such as the copy command) are executed
	immediately. Note that, in dired, case does make a difference
	for many commands. Some of the more common
	<application>dired</application> commands and what they do are
	listed below:
	</para>

	<variablelist>
		<varlistentry>
			<term>press the <command>Return</command>key</term>
				<listitem>
					<para>
					Pressing
					<command>Return</command> when
					the focus is on a particular
					file opens that file in the
					appropriate major mode.
					</para>
				</listitem>
		</varlistentry>
			
		<varlistentry>
			<term><command>d</command></term>
				<listitem>
					<para>
					Marks a single file for
					deletion, but doesn't actually
					delete the file. You can mark
					multiple files for deletion,
					then delete them all simultaneously.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>u</command></term>
				<listitem>
					<para>
					If a file is
					marked for deletion, this
					option unmarks it.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>x</command></term>
				<listitem>
					<para>
					Deletes all files marked for
					deletion. You will be prompted to make
					sure you want to delete the
					files in question; type
					<command>yes</command> or
					<command>no</command> as
					appropriate.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>C</command></term>
				<listitem>
					<para>
					Copies a file.  You will be
					asked for the name of the new
					file to create when you copy the old file.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>R</command></term>
				<listitem>
					<para>
					Renames a file.  You will be
					prompted for the name of the new
					file to create when you rename
					the file.
					</para>
				</listitem>
		</varlistentry>
	</variablelist>

	<para>
	Because <application>dired</application> is so extensive,
	including the full documentation for it here is not feasible.
	However, complete instructions can be found in the GNU Emacs
	Manual at <ulink
	url="http://www.delorie.com/gnu/docs/emacs/emacs_360.html"></ulink>.
	</para>

</sect3>
</sect2>
</sect1>

<sect1 ID="working-online">
<title>Working online</title>

	<para>
	This section explores many of the tasks you would commonly
	perform using the Internet, including browsing the web,
	chatting online, reading e-mail, etc.
	</para>

<sect2 ID="browsing-the-internet">
<title>Browsing the Internet</title>

	<para>
	The best way to browse the Internet from within Emacs is using
	<application>W3</application>. <application>W3</application>
	is a full-featured web browser written just for Emacs.
	It does not come with Emacs, but it can be downloaded from <ulink
	url="ftp://ftp.xemacs.org/pub/xemacs/emacs-w3/w3.tar.gz"></ulink>.
	The latest release of W3 is version 4.0, and you can get more
	information about it from the W3 at <ulink
	url="http://www.cs.indiana.edu/elisp/w3/docs.html"></ulink>. 
	</para>

	<para>
	Once you've downloaded W3, you'll need to perform the
	following tasks to install it:
	</para>

	<orderedlist>
		<listitem>
			<para>
			Open an Emacs shell as root, using the command
			<command>M-x emacspeak-root</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Use the <command>cd</command> command to
			change to the directory where the
			<filename>w3.tar.gz</filename> file is.
			</para>
		</listitem>

		<listitem>
			<para>
			Uncompress the
			<filename>w3.tar.gz</filename> file, using the
			following commands:
			</para>

			<orderedlist>
				<listitem>
					<para>
					At the root command prompt,
					type <command>gunzip
					w3.tar.gz</command>. You'll be left with a
					file called
					<filename>w3.tar</filename>.
					</para>
				</listitem>

				<listitem>
					<para>
					At the root command prompt,
					type <command>tar -xvf
					w3.tar</command>. You'll be left with a
					directory called
					<filename>w3-4.0pre.46</filename>.
					</para>
				</listitem>
			</orderedlist>
		</listitem>

		<listitem>
			<para>
			Change directories to the
			<filename>w3-4.0pre.46</filename> directory.
			</para>

			<para>
			Note that the next several steps are also
			covered in extensive detail in the INSTALL
			file included in the
			<filename>w3-4.0pre.46</filename> directory.
			If you'd like more detailed instructions,
			please refer to that file.
			</para>
		</listitem>

		<listitem>
			<para>
			At the command prompt, type
			<command>/.configure</command>. Your makefile
			will be configured as is
			appropriate for your system.
			</para>
		</listitem>

		<listitem>
			<para>
			When your machine has finished creating the
			makefile, type <command>make install</command>
			at the command prompt. The application will be
			compiled so that it
			can be executed. 
			</para>

			<para>
			<application> W3</application> is a native Emacs application. In
			addition, <application>W3</application> has
			already been speech-enabled, and the
			<filename>emacspeak-w3.el</filename> file that provides speech was
			pre-installed with Emacspeak into your
			<filename>/emacs/site-lisp/emacspeak/lisp/</filename> directory.
			</para>
		</listitem>

		<listitem>
			<para>
			Once your machine has finished making the
			application, open your
			<filename>.emacs</filename> file (located in
			your home directory) and add the following
			line:
			</para>

			<programlisting>
			(autoload 'w3 "w3" "Interface for w3 on Emacs." t)
			</programlisting>

			<para>
			Including this line in your
			<filename>.emacs</filename> file causes
			<application>W3</application> to load
			automatically when you start
			an Emacs session.
			</para>
		</listitem>

		<listitem>
			<para>
			Save and close your <filename>.emacs</filename> file
			when you are finished editing.
			</para>
		</listitem>

		<listitem>
			<para>
			To start using <application>w3</application>,
			type <command>M-x w3-fetch</command> and press
			Return.
			</para>
		</listitem>

		<listitem>
			<para>
			Supply the start URL.
			</para>
		</listitem>
	</orderedlist>

	<para>
	When browsing, you will find files that you want to download.
	Although it is possible to download files using
	<application>W3</application> by pressing "D" when the cursor
	is over a link, the <application>wget</application>
	application is a much
	better way to do downloads. Using
	the <command>wget</command> command to download files is discussed in <xref
	linkend=downloading-files>, Downloading files.
	</para>

	<para>
	As a web browser, <application>W3</application> has many functions that
	can be accessed by typing <command>M-x w3-</command> and then
	pressing the Tab key.  Emacs will provide you with a list of
	options to complete the string.
	</para>

	<para>
	Some of the common commands for navigating in
	<application>W3</application> are listed below:
	</para>

	<variablelist>
		<varlistentry>
			<term><command>Return</command></term>
				<listitem>
					<para>
					Pressing <command>Return</command> when over a
					hyperlink follows that
					hyperlink. Note that if the
					hyperlink goes to an FTP site,
					you may get an error.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>Tab</command></term>
				<listitem>
					<para>
					Tabs between the various links
					on the page.
					</para>
				</listitem>
		</varlistentry>
		
		<varlistentry>
			<term><command><</command></term>
				<listitem>
					<para>
					Goes to the beginning of the
					document.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>></command></term>
				<listitem>
					<para>
					Goes to the end of the
					document.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>M-s</command></term>
				<listitem>
					<para>
					Saves the current document to
					the local disk as HTML source,
					formatted text, LaTeX source,
					or binary.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>space</command></term>
				<listitem>
					<para>
					Scrolls down in the buffer.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>backspace</command></term>
				<listitem>
					<para>
					Scrolls up in the buffer.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>q</command></term>
				<listitem>
					<para>
					Kills the buffer.
					</para>
				</listitem>
		</varlistentry> 
	</variablelist>					

	<para>
	For a complete listing of <application>W3</application>
	commands, refer to the User's Manual located at <ulink
	url="http://www.cs.indiana.edu/elisp/w3/docs.html"></ulink>
	</para>

</sect2>

<sect2 id="chatting-online">
<title>Chatting online</title>

	<para>
	There are any number of IRC (Internet Relay Chat) applications
	that you can install, two of which are recommended: AOL
	Instant Messenger for Emacs (called TNT), and ERC.
	</para>

<sect3 id="aim">
<title>AOL Instant Messenger for Emacs (TNT)</title>

	<para>
	There's a special version of AOL Instant Messenger (AIM)
	written just for Emacs, called TNT. The main site for TNT is at <ulink
	url="http://sourceforge.net/projects/tnt/"></ulink>, and you
	can download the necessary files from <ulink
	url="http://download.sourceforge.net/tnt/tnt-2.3.2.tar.gz"></ulink>.
	Don't download any files from AOL's site, as you'll end up
	with the graphical version of AIM instead of the Emacs
	version. In addition to installing TNT, you'll also need to set up an
	Instant Messenger account with AOL, and you can do so at
	<ulink
	url="http://www.aol.com/aim/homenew.adp"></ulink>.
	</para>
	
	<para>
	Once you've signed up for an account and downloaded the files,
	you'll need to complete the following steps:
	</para>

	<orderedlist>
		<listitem>
			<para>
			Open an Emacs command shell as root, using the
			command <command>M-x emacspeak-root</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Change directories using the
			<command>cd</command> command to the directory
			containing the downloaded file.
			</para>
		</listitem>

		<listitem>
			<para>
			Unzip the file using the command
			<command>gunzip tnt-2.3.2.tar.gz</command>,
			then expand the resulting tarball using the
			command <command>tar -xvf tnt-2.3.2.tar</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Change directories into the new
			<filename>tnt-2.3.2</filename> directory.
			</para>

			<para>
			The next several steps are covered
			in detail in the INSTALL file that can be
			found in the <filename>tnt-2.3.2</filename>
			directory. If you'd like more details than are
			covered here, please refer to that file.
			</para>
		</listitem>

		<listitem>
			<para>
			Copy all the .el and .elc files into a
			directory that is in your Emacs
			load-path. Typically this directory is
			<filename>/emacs/site-lisp/</filename> (you should
			be able to see a number of other .el and .elc
			files in there). 
			</para>
		</listitem>

		<listitem>
			<para>
			Open your <filename>.emacs</filename> file and
			add the following lines:
			</para>

			<programlisting>
			(setq load-path (cons "/full/path/to/tnt" load-path))
    			(load "tnt")
			</programlisting>

			<para>
			When you add these lines to your
			<filename>.emacs</filename> file, be sure to
			change the <filename>"full/path/to/tnt"</filename> to the
			directory where you placed the .el and .elc files.
			</para>
		</listitem>

		<listitem>
			<para>
			Save and close your
			<filename>.emacs</filename> file.
			</para>
		</listitem>

		<listitem>
			<para>
			Restart Emacs so that the changes take place.
			</para>
		</listitem>
	</orderedlist>
			
	<para>
	To start
	TNT, type <command>M-x tnt</command> and follow the instructions.  You'll
	probably want to read the README file contained in the
	<filename>tnt-2.3.2</filename> directory, as it contains
	excellent descriptions of all the commands used by TNT.
	</para>
</sect3>

<sect3 ID="erc">
<title>ERC</title>

	<para>
	ERC is an IRC (Internet Relay Chat) client written especially for Emacs.  The main
	site for ERC is located at <ulink
	url="http://sourceforge.net/projects/erc"></ulink>, and you
	can download and install the appropriate files as follows:
	</para>
	
	<orderedlist>
		<listitem>
			<para>
			Go to <ulink
			url="http://prdownloads.sourceforge.net/erc/erc.el"></ulink>.
			Save the page
			(it is the ERC application) into a new file
			called <filename>erc.el</filename>.
			</para>
		</listitem>

		<listitem>
			<para>
			Place the new file in your Emacs load-path,
			typically in the directory
			<filename>/usr/share/emacs/site-lisp</filename>.
			</para>
		</listitem>

		<listitem>
			<para>
			Open your <filename>.emacs</filename> file and
			add the following line:
			</para>

			<programlisting>
			(require 'erc)
			</programlisting>
		</listitem>

		<listitem>
			<para>
			Save and close your
			<filename>.emacs</filename> file.
			</para>
		</listitem>

		<listitem>
			<para>
			Exit and restart Emacs so that the changes
			take place. You won't need to download any
			Emacspeak-enabled <filename>.el</filename> files, as those are already
			included in your
			<filename>/emacspeak/lisp</filename>
			directory.
			</para>
		</listitem>
	</orderedlist>

	<para>
	Once you have installed ERC, it can be started from Emacs
	using the command <command>M-x erc-select</command> to select
	an IRC server.
	</para>

	<para>
	For more documentation, refer to the <filename>erc.el</filename> file.  It
	contains installation and usage instructions in the comments at the top of the
	file.
	</para>
</sect3>
</sect2>

<sect2 ID="using-email">
<title>Using e-mail</title>

	<para>
	There are multiple mail programs available for e-mail
	purposes. One that is recommended is VM (View Mail), an Emacs-native application that allows you to do all the things you'd expect of
	an e-mail application. Alternatively, you can use
	<application>Rmail</application>, a slightly less
	sophisticated but built-in e-mail application. Both
	are speech-enabled and discussed in this section. 
	</para> 	

<sect3 ID="vm">
<title>VM</title>

	<para>
	Although VM is Emacs-native, it does not come with Emacs. You
	can download it from the VM homepage at <ulink
	url="http://www.wonderworks.com/vm"></ulink>.  This page also contains
	links to the VM user's manual, FAQ, and a list of sites where
	you can download VM, depending on your location. If
	you want to modifying source code, download one of the
	sources; otherwise,
	download one of the binaries as it will be easier to install.
	</para>

	<para>
	Assuming that you downloaded a binary, it's probably named
	<filename>vm.elc.gz</filename>.  To install, follow these steps:
	</para>
	
	<orderedlist>
		<listitem>
			<para>
			Open an Emacs shell using the command
			<command>M-x shell</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Unzip
			the file using the command <command>gunzip
			vm.elc.gz</command>.  You should be left with a file named
			<filename>vm.elc</filename>.
			</para>
		</listitem>

		<listitem>
			<para>
			Move the file <filename>vm.elc</filename> to
			a directory specified in your Emacs load-path,
			such as
			<filename>/usr/share/emacs/site-lisp/</filename>.
			</para>
		</listitem>

		<listitem>
			<para>
			Open your <filename>.emacs</filename> file and
			add the following line:
			</para>

			<programlisting>
			(autoload 'vm "vm" "Start VM on your primary inbox" t)
			</programlisting>
		</listitem>

		<listitem>
			<para>
			Save and close your
			<filename>.emacs</filename> file. Then restart
			Emacs so that the changes will take effect.
			</para>
		</listitem>
	</orderedlist>

	<para>
	If you decide to install the source files instead of the binary, you'll
	download <filename>vm.tar.gz</filename>.  Installation
	instructions are in the README file included in the download. 
	</para>

	<para>
	Once you've installed VM, you can start it using the command
	<command>M-x vm</command>.
	</para>

</sect3>

<sect3 ID="rmail">
<title>Rmail</title>

	<para>
	An alternative to <application>VM</application> is <application>Rmail</application>, a built-in Emacs mail
	reader. As such, you don't need to download or install
	anything to make it work. To start
	<application>Rmail</application>, use the command <command>M-x
	rmail</command>.
	</para>

	<para>
 	There is a chapter about Rmail in the GNU Emacs
	documentation, available at <ulink url="
	http://www.gnu.org/manual/emacs-20.3/html_chapter/emacs_31.html"></ulink>.
	This chapter includes all the information and commands you might need to
	use Rmail. 
	</para>

</sect3>
</sect2>
</sect1>

<sect1 ID="productivity">
<title>Productivity</title>

	<para>
	Emacs provides many applications that can help you get your
	work done. From coding to writing a dissertation to scheduling
	appointments, you can do just about anything from within
	Emacs.
	</para>

<sect2 ID="writing-code">
<title>Coding in Emacs</title>

	<para>
	Emacs has "major modes" (essentially editors) for Lisp,
	Scheme, Awk, C, C++, FORTRAN, Icon, Java, Objective-C, Pascal,
	Perl, and Tcl. You can invoke a major mode by creating and/or opening a file
	with the appropriate extension. For example, to invoke the
	c++ major mode, create a file with a <filename>.cpp</filename>
	extension and then open that file. You can
	also download additional major modes, such as SGML.
	</para>

	<para>
	Because of the breadth of coding options, it is beyond the
	scope of this document to cover them all.  However, there is
	an extensive section in the Gnu Emacs Manual on coding
	available at <ulink
	url="http://www.delorie.com/gnu/docs/emacs/emacs_238.html"></ulink>. 
	</para>
</sect2>

<sect2 ID="customization">
<title>Customizing Emacspeak</title>
	
	<para>
	Emacspeak contains many options for customization.  The
	most commonly requested options are covered here, but if
	there's something else that should be included, please do not
	hesitate to suggest it.
	</para>

<sect3 ID="changing-the-speech-rate">
<title>Changing the speech rate</title>

	<para>
	The default Emacspeak speech rate may be too slow or fast for
	your tastes, so you can customize it in your
	<filename>.emacs</filename> file.  To do so, add the following
	lines to your <filename>.emacs</filename> file: 
	</para>

	<programlisting>
	(setq dtk-default-speech-rate 410)
	(setq outloud-default-speech-rate 90)
	</programlisting>

	<para>
	The numerical values in these commands are the speech rate, in
	words per minute.  The examples above are for the Dectalk
	Express and the ViaVoice Outloud synthesizers.
	</para>

</sect3>

<sect3 ID="auditory-icons">
<title>Auditory Icons for Emacspeak</title>

	<para>
	Ann Parsons wrote a great explanation of the Emacspeak desktop
	and auditory icons that you can read at <ulink
	url="http://www.cs.vassar.edu/~priestdo/emacspeak/msg00256.html"></ulink>.
	In a nutshell, auditory icons provide you with feedback when
	you perform different tasks in Emacs.  You can get audible
	feedback when you change buffers, quit a program, enter the
	buffers list, edit C code, etc.
	</para>

	<para>
	If you want to use auditory icons and ViaVoice is your speech
	synthesizer, check to see whether or not you have a
	multi-channel sound card (try playing a CD and a .au file at
	the same time - if it works, you have a multi-channel
	card). If your card is not multi-channel, you must install the
	application <application>stdiom</application> as follows:
	</para>

	<orderedlist>
		<listitem>
			<para>
			Download the application
			<application>stdiosynth</application> from
			<ulink
			url="http://www.leb.net/pub/blinux/emacspeak/blinux/stdiom.tar.gz"></ulink>.  
			</para>
		</listitem>

		<listitem>
			<para>
			Log in to your machine as root, then change to
					the directory where you placed the
					downloaded file
					<filename>stdiom.tar.gz</filename>.
			</para>
		</listitem>

		<listitem>
			<para>
			Unzip the file using the command
			<command>gunzip stdiom.tar.gz</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Untar the resulting file using the command
			<command>tar -xvf stdiom.tar</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Change directories to the resulting
					<filename>stdio_musician1.0</filename>
					directory and type
					<command>make</command>. You
					should get a message that says,
					"stdiosynth is up to date."
			</para>
		</listitem>
	</orderedlist>

	<para>
	Currently there are two auditory icon themes that you can
	download from the Emacspeak website, called Chimes and
	Cartoons.  Chimes is made up of different chimes and
	short notes from various instruments. The icons are
	high-quality 44K-mono, and can be downloaded from <ulink
	url="http://emacspeak.sourceforge.net/chimes-mono.tar.gz"></ulink>.
	The Cartoons theme was contributed by Bryan Smart and is made
	up of 22K-mono sounds.  You can download it from <ulink
	url="http://emacspeak.sourceforge.net/cartoons-mono.tar.gz"></ulink>.
	</para>

	<para>
	To install either of these themes, download and unpack the
	archives into the emacspeak/sounds directory in your emacspeak
	installation. You can then select themes you have already
	installed by using the Emacspeak command <command>M-x
	emacspeak-sounds-select-theme</command>. Alternatively, you
	can add the following lines to your
	<filename>.emacspeak</filename> file:
	</para>

	<programlisting>
	(setq emacspeak-toggle-auditory-icons t)
	(when (emacspeak-sounds-theme-p "chimes-mono")
   		(emacspeak-sounds-select-theme "chimes-mono/" ))
	</programlisting>

	<para>
	Some people use sound cards that can play multiple channels to
	produce their auditory icons.  For this option, set
	<command>emacspeak-aumix-multichannel-capable-p</command> to
	<command>t</command> in your <filename>.emacs</filename> file:
	</para>

	<programlisting>
	(setq emacspeak-aumix-multichannel-capable-p t) 
	</programlisting>
</sect3>
</sect2>

<sect2 ID="reading-adobe-acrobat-files">
<title>Reading Adobe Acrobat files</title>

	<para>
	There are two ways to view an Adobe Acrobat PDF file with
	Emacspeak. The first option is to generate a text version of
	the PDF using <application>Xpdf</application>, then read the text version.  The second option is the
	use Adobe's PDF to HTML converter, then read the HTML file.
	</para>	

<sect3 ID="using-xpdf">
<title>Using Xpdf</title>

	<para>
	To generate a text version of the PDF, you'll need to download
	the <application>Xpdf</application> package.  The main website
	is at <ulink
	url="http://www.foolabs.com/xpdf/"></ulink>, and you can
	download a precompiled binary (unless, of course, you're
	interested in playing with the source code, in which case
	you'd download the source) from <ulink
	url="ftp://ftp.foolabs.com/pub/xpdf/xpdf-0.92-linux2.0.tgz"></ulink>.
	</para>

 	<para>
	Assuming that you downloaded the binary file
	<filename>xpdf-0.92-linux2.0.tgz</filename>, to install and run <application>Xpdf</application>: 
	</para>

	<orderedlist>

		<listitem>
			<para>
			Open an Emacs command shell using <command>M-x
			shell</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Change to the appropriate directory where the
			<filename>xpdf-0.92-linux2.0.tgz</filename>
			file is located, then
			unzip the file using <command>gunzip
			xpdf-0.92-linux2.0.tgz</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Decompress the resulting
			<filename>xpdf-0.92-linux2.0.tar</filename>
			file using the command <command>tar -xvf
			xpdf-0.92-linux2.0.tar</command>.
			</para>
		</listitem>
	</orderedlist>

	<para>
	The resulting directory will be called
	<filename>xpdf-0.92-linux2.0</filename>.  Within this
	directory are a number of applications, including
	<application>pdfimages</application>, <application>pdfinfo</application>,
	<application>pdftopbm</application>, <application>pdftops</application>,
	<application>pdftotext</application>, and
	<application>xpdf</application>. You can find out what each of
	these applications does from the README file also included in
	the directory. The only application we're interested in is
	<application>pdftotext</application> that you can run from
	the Emacs command shell as follows:
	</para>

	<orderedlist>
		<listitem>
			<para>
			Open an Emacs shell window using the command
			<command>M-x shell</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			At the prompt, type <command>pdftotext <filename>filename.pdf</filename></command>.
			</para>
			<para>
			Result: The file is converted to text.  You
			can read the resulting text file with Emacs.
			</para>
		</listitem>
	</orderedlist>
</sect3>

<sect3 ID="using-adobes-converter">
<title>Using Adobe's converter</title>

	<para>
	As an alternative to <application>Xpdf</application>, you can
	use Adobe's PDF to HTML converter if the PDF file you want to read has a URL.  To convert a file:
	</para>

	<orderedlist>
		<listitem>
			<para>
			Use <application>W3</application> to go to
			<ulink
			url="http://access.adobe.com/simple_form.html"></ulink>.
			</para>
		</listitem>

		<listitem>
			<para>
			Type in the URL of the PDF file to convert.
			</para>
			<para>
			Result: The file is converted it HTML.  You
			can use W3 to read and navigate within the file.
			</para>
		</listitem>
	</orderedlist>		

	<para>
	Tests show that this conversion works very well on some PDF
	documents, but not so well on others.  If the HTML file you
	end up with isn't readable, try using
	<application>Xpdf</application> to convert to a plain text
	file.
	</para>
</sect3>
</sect2>

<sect2 ID="calendar-and-appointments">
<title>Scheduling appointments and calendar events</title>

	<para>
	Emacs has a built-in desk calendar that includes a diary for
	planned events. The calendar and diary support both US and
	European date formats, but default to the US format. The diary
	keeps track of appointments and reminders using a diary file, a text file that contains a list of events and their
	dates. You can have Emacs send you an email every day with
	your schedule, or you can look at the calendar to view the
	day's events.
	</para>

	<para>
	To start the calendar application, use the
	command <command>M-x calendar</command>. Calendar navigation
	commands are, for the most part, identical to text navigation
	commands, and you can also use the arrow keys to navigate.
	</para>

	<para>
 	If you'd like to use the diary, you need to create a diary
	file that contains your events.  The diary file is a simple text file,
	and, by default, Emacs uses <filename>~/diary</filename> as the
	diary file. Although you'll need to create the file manually,
	there are commands that allow you to add, view, and change
	diary entries. Most of these commands are Emacspeak-enabled.
	</para>
 
	<para>
	Diary entries come in a number of formats and entries can be
	set to repeat.  Below are some examples:
	</para>
	
	<simplelist type=horiz columns=3>
		<member>12/22/2001	</member>		
		<member>Mom arrives for visit	</member>
		<member>Appears once on 12/22/2001</member>
		<member>October 17	</member>
		<member>Joe's birthday	</member>
		<member>Repeats yearly on October 17th</member>
		<member>Friday	</member>
		<member>Time cards due	</member>
		<member>Repeats every Friday</member>
	</simplelist>

	<para>
	Of course, there are many more options than those shown here.
	You can find a complete listing of diary features in the
	GNU Emacs manual, located at <ulink
	url="http://www.delorie.com/gnu/docs/emacs/emacs_376.html"></ulink>.
	</para>

	<para>
	You can view the diary entries for the current date using the
	command <command>M-x diary</command>. Alternatively, you can
	have the day's appointments automatically displayed when you
	enter Emacs by adding the following line to your
	<filename>.emacs</filename> file:
	</para>

	<programlisting>
	(diary)
	</programlisting>

	<para>
	You can also have your events emailed to you on a daily basis
	by running the command <command>M-x
	diary-mail-entries</command>.  You'll probably get an error
	message the first time you do this that says, "No buffer named *Fancy
	Diary Entries*." This error message was reported as a bug to
	the bug-gnu-emacs mailing list by Tim Hesterberg.
	However, the command does in fact work, so you can just ignore
	the error message. By default, you'll be e-mailed the
	calendar entries for the next seven days.  Also, when you
	enter Emacs it will automatically show you the calendar
	entries for the next seven days. According to the GNU Emacs
	Manual, there is a way to change the
	number of days the email covers, but according to Tim that
	feature also has bugs and doesn't seem to work. At the time of writing, these problems have not been
	addressed.
	</para>

	<para>
	For complete instructions on using the calendar and diary,
	refer to the section on the calendar and diary in the GNU
	Emacs Manual, located at <ulink
	url="http://www.delorie.com/gnu/docs/emacs/emacs_376.html"></ulink>.
	</para>
</sect2>

<sect2 ID="writing-text">
<title>Writing text in Emacs</title>

	<para>
	Emacs provides for many modes of text editing, and the tools
	you should use are task-dependent.
	</para>

<sect3 ID="writing-print-pdf-postscript">
<title>Writing for print, PDF, or postscript</title>

	<para>
	If you want to output your writing in print, postscript, or
	PDF, <application>LaTeX</application> is the way to go.
	<application>LaTeX</application> is essentially a markup
	language that produces high-quality print, PDF, or postscript
	output.  <application>LaTeX</application> was designed for the production of technical and
	scientific documentation, and in addition to allowing for
	detailed formatting, it also provides support for mathematical
	functions, automatic generation of bibliographies and indexes,
	graphics support, and much more. You can find out more about
	<application>LaTeX</application> from <ulink
	url="http://www.latex-project.org"></ulink>. In the
	documentation section at the <application>LaTeX</application>
	site, you will find an introduction to
	<application>LaTeX</application>, as well as a complete
	reference manual.
	</para>

	<para>
 	<application>AUC Tex</application> is the Emacs editing mode
	for <application>LaTeX</application>. The <application>AUC
	Tex</application> home page is located at 
	<ulink
	url="http://mirrors.sunsite.dk/auctex/www/auctex/"></ulink>.
	You can download <application>AUC
	Tex</application> from <ulink
	url="ftp://sunsite.dk/packages/auctex/auctex.tar.gz"></ulink>.
	Once you've downloaded the file, you'll need to install it as follows:
	</para>

	<orderedlist>
		<listitem>
			<para>
			Open an Emacs command shell as root, using the
			command <command>M-x emacspeak-root</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Change directories to where the downloaded
			file <filename>auctex.tar.gz</filename> is
			located.
			</para>
		</listitem>

		<listitem>
			<para>
 			Unzip the file using the command
			<command>gunzip auctex.tar.gz</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Unpack the resulting tarball using the command
			<command>tar -xvf auctex.tar</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Change directories into the new
			<filename>auctex-10.0g</filename> directory,
			then type the command
			<command>make</command>.
			</para>

			<para>
			The next several steps are covered
			in greater detail in the
			<filename>INSTALLATION</filename> file
			included in the
			<filename>auctex-10.0g</filename> directory.
			</para>
		</listitem>

		<listitem>
			<para>
			When the Makefile is finished building, type
			the command <command> make
			lispdir=/usr/local/share/emacs/site-lisp
			install</command>. If the Emacs path defined as
			"lispdir" in this command is not correct for
			your machine, supply the correct path to your
			Emacs installation.
			</para>
		</listitem>

		<listitem>
			<para>
			Check to make sure the <filename>tex-*.el</filename> files were placed
			in the directory specified in the
			<filename>lispdir</filename> command above.
			If not, copy them there.
			</para>
		</listitem>

		<listitem>
			<para>
			Add the following line to your
			<filename>.emacs</filename> file:
			</para>

			<programlisting>
			(require 'tex-site)
			</programlisting>

			<para>
			When you are finished, save and close your
			<filename>.emacs</filename> file.
			</para>
		</listitem>
		
		<listitem>
			<para>
			To invoke the <application>AUC
		Tex</application> editing mode, create a new file with
		a <filename>.tex</filename> extension.
			</para>
		</listitem>

	</orderedlist>

	<para>
	You'll probably also want to install the online
	documentation. This is located in the <filename>doc</filename>
	directory within the <filename>auctex-10.0g</filename>
	directory.  To install the documentation:
	</para>
	
	<orderedlist>
		<listitem>
			<para>
			Change directories to the
			<filename>doc</filename> directory.
			</para>
		</listitem>

		<listitem>
			<para>
			At the command prompt, type
			<command>make</command>. When the makefile is
			finished, type <command>make
			install</command>.
			</para>	
		
			<para>
			Result: The documentation is installed in the
			<filename>/usr/local/info/</filename>
			directory.
			</para>
		</listitem>
	</orderedlist>

	<para>
	You can also get this information in the online manual at <ulink
	url="http://mirrors.sunsite.dk/auctex/www/auctex/doc/"></ulink>.
	</para>

	<para>
	Since <application>AUC TeX</application> is a part of
	<application>LaTeX</application>, you'll need to know
	<application>LaTeX</application> to use it. There's a good
	<application>LaTeX</application> manual by David R. Wilkins
	called "Getting Started with LaTeX" located at
	<ulink url="http://www.maths.tcd.ie/~dwilkins/LaTeXPrimer/"></ulink>. 
	</para>

</sect3>

<sect3 ID="writing-for-online">
<title>Writing for online viewing</title>

	<para>
	If you're writing a document that will be read online, you have several
	choices: HTML, SGML, and XML, to name a few. Emacs comes with
	a built-in HTML editor, called
	<application>html-mode</application>. This editor provides you with
	additional commands for adding appropriate HTML tags to your
	document. To start <application>html-mode</application>, type
	<command>M-x html-mode</command>.
	</para>

	<para>
	If you do a lot of HTML coding, you may wish to use 
	<application>html-helper-mode</application>. This mode has a
	slightly different interface and many more features than
	<application>html-mode</application>. The home page for
	<application>html-helper-mode</application> is located at
	<ulink
	url="http://www.santafe.edu/~nelson/tools/"></ulink>. You can
	either download just the
	<filename>html-helper-mode.el</filename> file from <ulink
	url="http://www.santafe.edu/~nelson/tools/html-helper-mode.el"></ulink>,
	or you can download the entire distribution, including
	documentation, from <ulink
	url="ftp://ftp.reed.edu/pub/src/html-helper-mode.tar.gz"></ulink>.
	Installation instructions for both of these options are located
	at the <application>html-helper-mode</application> website at
	<ulink url="http://www.gest.unipd.it/~saint/hth.html"></ulink>. 
	</para>

	<para>
	If you're authoring larger documents or want to author in
	SGML, the PSGML mode for Emacs is recommended. The home page
	for PSGML is located at <ulink url="http://www.lysator.liu.se/projects/about_psgml.html"></ulink>.
	</para>

	<para>
	There's also an XML editor for Emacs, called
	<application>sxml-mode</application>.  The home page is
	located at <ulink
	url="http://koala.ilog.fr/plh/sxml.html"></ulink>. You must
	have a Java Virtual Machine, as well as PSGML 1.0.1 or better
	to run <application>sxml-mode</application>.  Complete
	instructions for downloading and installing are available on
	the web site.
	</para>
</sect3>
</sect2>
</sect1>

<sect1 ID="entertainment">
<title>Entertainment</title>
	
	<para>
	While Emacs provides lots of applications and functionality to
	help get work done, it also provides a medium to play
	games, listen to music, and do other fun activities.
	</para>

<sect2 ID="burning-a-cd">
<title>Burning a CD</title>

	<para>
	It's become almost necessary to have a CD burner these days,
	especially if you want to download iso images to install new
	versions of Linux. The <application>cdrecord</application>
	application is the
	recommended tool for burning both audio and data CDs, and it
	is included in many distributions. However, if you'd like to
	get the latest version, go to <ulink
	url="http://www.fokus.gmd.de/research/cc/glone/employees/joerg.schilling/private/cdrecord.html"></ulink>.
	</para>

	<para>
	<application>cdrecord</application> is a command-line
	application, so you'll need to open an Emacs command shell
	(<command>M-x shell</command>) to use it.
	</para>

	<para>
	The complete directions on how to use
	<application>cdrecord</application> burn a CD are beyond the
	scope of this document; however Winfried Trümper wrote an
	excellent HOWTO on making both data and audio CDs, which is
	available at <ulink url="http://www.linuxdoc.org/HOWTO/CD-Writing-HOWTO.html"></ulink>. If
	you are new to burning CDs in Linux, this document is
	indispensable. 
	</para>

</sect2>

<sect2 ID="playing-cds">
<title>Playing CDs</title>

	<para>
	The best tool for playing CDs in Emacs is
	<application>cd-tool</application>. An Emacspeak-enabled
	version is included with your Emacspeak
	distribution. 
	</para>

	<para>
	All of the commands that control
	<application>cd-tool</application> must be prefaced by the
	command <command>M-x cd-tool</command>. After you type this, you will be
	prompted to enter the command to execute.  For example, if you
	wanted to start playing a CD, you would type <command>M-x
	cd-tool</command>, then at the prompt type
	<command>p</command> (for 'play'). The CD will then start
	playing.
	</para>

	<para>
	The commands for <application>cd-tool</application> are listed
	below:
	</para>

	<variablelist>
		<varlistentry>
			<term><command>p</command></term>
				<listitem>
					<para>
					Play the CD.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>=</command></term>
				<listitem>
					<para>
					Play the CD in random order (shuffle).
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>+</command></term>
				<listitem>
					<para>
					Skip to the next track.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>-</command></term>
				<listitem>
					<para>
					Return to the previous track.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>SPC</command></term>
				<listitem>
					<para>
					Pause or resume play.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>i</command></term>
				<listitem>
					<para>
					Show the CD info.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>s</command></term>
				<listitem>
					<para>
					Stop playing the CD.
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>e</command></term>
				<listitem>
					<para>
					Eject the CD (must be stopped).
					</para>
				</listitem>
		</varlistentry>
	</variablelist>
</sect2>

<sect2 ID="mp3s">
<title>Playing mp3s</title>

	<para>
	To play an mp3 music file, you'll need the application
	<application>mpg123</application>.  Although the application is included in a number of
	distributions, the standard version is not Emacs-native, so
	you'll need to download an install the Emacs-enabled
	version. You can download the file
	<filename>mpg123-el-1.24-1.tar.gz</filename> (the latest
	Emacs-enabled version) from Debian at <ulink
	url="http://http.us.debian.org/debian/pool/main/m/mpg123-el/mpg123-el_1.24-1.tar.gz"></ulink>.  
	</para>

	<para>
	Once you've downloaded the file, you'll need to install it
	using the following steps:
	</para>

	<orderedlist>
		<listitem>
			<para>
			Open an Emacs shell using the command
			<command>M-x shell</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Change directories to the directory containing
			the new file.
			</para>
		</listitem>

		<listitem>
			<para>
			Unzip the file using the
			command <command>gunzip
			mpg123-el-1.24-1.tar.gz</command>.
			</para>
		</listitem>

		<listitem>
			<para>
			Untar the resulting
			<filename>mpg123-el-1.24-1.tar</filename>
			file using the command <command>tar -xvf
			mpg123-el-1.24-1.tar</command>. 
			</para>
		</listitem>

		<listitem>
			<para>
			Change directories into the resulting
			<filename>mpg123-el-1.24-1.tar</filename>
			directory. In this directory, you'll see the
			<filename>mpg123.el</filename> file. Copy this
			file into the
			<filename>/usr/shar/emacs/site-lisp</filename> directory.
			</para>
		</listitem>

		<listitem>
			<para>
			Open your <filename>.emacs</filename> file and
			add the following line:
			</para>

			<programlisting>
			(autoload 'mpg123 "mpg123" "A Front-end to
			mpg123" t)
			</programlisting>
		</listitem>

		<listitem>
			<para>
			Save and close your
			<filename>.emacs</filename> file. Then restart
			Emacs so that the changes will take effect.
			</para>
		</listitem>
	</orderedlist>

	<para>
	To start playing mp3s, use the command <command>M-x
	mpg123</command>.  You'll be asked for a file name to play.
	Type in the name of the mp3 to play, then press Return. It
	should start playing immediately.
	</para>

	<para>
	There are a number of commands that can be used with
	<application>mpg123</application>; a few of the more commonly
	used ones are listed below:
	</para>

	<variablelist>
		<varlistentry>
			<term><command>SPC</command></term>
				<listitem>
					<para>
					Play or pause
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>RET</command></term>
				<listitem>
					<para>
					Play
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>V</command></term>
				<listitem>
					<para>
					Volume up
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>v</command></term>
				<listitem>
					<para>
					Volume down
					</para>
				</listitem>
		</varlistentry>

		<varlistentry>
			<term><command>q</command></term>
				<listitem>
					<para>
					Quit
					</para>
				</listitem>
		</varlistentry>
	</variablelist>

	<para>
	For a full list of <application>mpg123</application> commands,
	you can scroll up and down within the application to have them
	read aloud.
	</para>

	<para>
	One note about volume in <application>mpg123</application>: in
	my tests, I found that often the system volume would go way
	down when I started <application>mpg123</application>, to the
	point where I could barely hear it. If I exited
	<application>mpg123</application>, the volume in Emacspeak would continue
	to be extremely low, regardless of how it was set before I
	started <application>mpg123</application>.  However, if I
	turned up the volume while in
	<application>mpg123</application>, not only was it at an
	acceptable level in <application>mpg123</application>, it was
	also loud after I quit <application>mpg123</application>.
	</para>

	<para>
	Another problem that I noticed when using
	<application>mpg123</application> is that sometimes when you
	quit the application, it doesn't seem to relinquish control of
	the sound card. You'll see evidence of this behavior if you
	try to play a CD or restart <application>mpg123</application>
	- you'll get an error message saying that your sound card is
	busy or that it's not installed correctly. If you check the
	list of open Emacs buffers, you'll see that
	<application>mpg123</application> is still there, although
	it's apparently in a questionable state. I have not yet
	figured out how to remedy this problem; if anyone has any
	suggestions, please let me know so it can be added to the
	HOWTO. 
	</para>

	<para>
	If you find yourself listening to a lot of MP3s, there is an
	mp3 jukebox written by Karl Dahlke available at <ulink
	url="http://www.eklhad.net/linux/app/jukebox"></ulink>, and a
	sample config file for the jukebox at <ulink
	url="http://www.eklhad.net/linux/app/sample.jukerc"></ulink>.
	At the time of writing, the jukebox was in version 1.0.
	</para>
	
	<para>
	If you want to rip your own MP3s, under Linux it is a
	two step process.  The first step is to convert the tracks on
	an audio CD to <filename>.wav</filename> format, then convert
	the <filename>.wav</filename> files to MP3s. There is a great
	web page by Nathan Robertson on how to do this, located at
	<ulink
	url="http://www.nathanr.net/thisout/articles/linux-mp3/"></ulink>.
	</para>
</sect2>

<sect2 ID="playing-a-game">
<title>Playing games</title>
	
	<para>
	Emacs has a number of popular games built into it, including
	Solitaire, Tetris, Dunnet (a text-based adventure game) and
	Gomoku.  For a
	complete listing of games:
	</para>

	<orderedlist>
		<listitem>
			<para>
			Type <command>C-h p</command>. A list of the
			available Emacs packages opens in the buffer.
			</para>
		</listitem>

		<listitem>
			<para>
			Scroll down to the games entry, then press
			Enter. A list of all the available games is
			displayed.
			</para>
		</listitem>
	</orderedlist>

	<para>
	To start a game:
	</para>

	<orderedlist>
		<listitem>
			<para>
			Type <command>M-x</command>, then the name of
			the game you want to play. For example, to
			play Dunnet, the text-based adventure game,
			you would type <command>M-x dunnet</command>.
			But only do this if you have plenty of time to
			spare!
			</para>
		</listitem>		
	</orderedlist>	
</sect2>
</sect1>

<sect1 id="acknowledgments">
<title>Acknowledgments</title>

	<para>
	As with any effort for the Linux project, there are a number of
	people who contributed to this HOWTO in a roundabout way.
	Without their help, this document would not exist.
	</para>

	<para>
	Dr. T.V. Raman, who not only suggested a task-oriented HOWTO,
	but who always answered my Emacspeak questions, no matter how
	odd.
	</para>

	<para>
	Mr. James Van Zandt, the original author of the Emacspeak
	HOWTO, who graciously allowed me maintainership of the
	original HOWTO from which this document stemmed.
	</para>

	<para>
	Robert J. Chassell, Saqib Shaikh, Doug Smith, Tyler Spivey,
	Kristin Thomas, and Jason White, for their comments,
	suggestions, and excellent proofreading skills.
	</para>

	<para>
	All the folks on the Emacspeak and blinux mailing lists who
	contributed suggestions, answered my questions, and gently
	showed me the errors in my ways.
	</para>

	<para>
	Throughout this document, I have tried to give
	credit to other authors when referring to their work. If I
	missed a citation, please let me know and I will be sure to
	correct it. If you did the work, you certainly deserve the
	credit!
	</para>
</sect1>

<sect1 id="wish-list">
<title>Wish list for version 2.0</title>

	<para>
	The following is a list of suggestions (in no particular
	order) that I did not have
	time to implement for this version of the User's Guide. I hope
	to include these items in a future release.
	</para>

	<itemizedlist mark=bullet>
		<listitem>
			<para>
			New section on remote Emacspeak.
			</para>
		</listitem>

		<listitem>
			<para>
			New section on getting Emacspeak and Speakup
			to work together.
			</para>
		</listitem>

		<listitem>
			<para>
			New section on using Real Audio.
			</para>
		</listitem>

		<listitem>
			<para>
			New section on the Emacs
			configuration/customization wizard (M-x
			customize, Applications group).
			</para>
		</listitem>

		<listitem>
			<para>
			Section on using the enriched package for
			working with RTF files.
			</para>
		</listitem>

		<listitem>
			<para>
			Information on what to add to your .emacs file
			for rmail or vm to know your smtp/pop3
			settings. Also information on how to tell W3
			to work with a proxy server.
			</para>
		</listitem>

		<listitem>
			<para>
			Add information on using M-x rpm to manipulate
			RPM files.
			</para>
		</listitem>

		<listitem>
			<para>
			Add information on using jide (java ide).
			</para>
		</listitem>

		<listitem>
			<para>
			New sections on using calc and bbdb.
			</para>
		</listitem>

		<listitem>
			<para>
			New section on spell checking using ispell.
			</para>
		</listitem>

		<listitem>
			<para>
			Add information on using M-x tar to manipulate
			tar files.
			</para>
		</listitem>

		<listitem>
			<para>
			Discuss the outline and folding-mode features
			of Emacs.
			</para>
		</listitem>

		<listitem>
			<para>
			Include key bindings along with the Emacs/Emacspeak
			command names.
			</para>
		</listitem>

		<listitem>
			<para>
			List or reference the Emacspeak-specific
			commands available in various Emacs
			applications like vm, W3, etc.
			</para>
		</listitem>
	</itemizedlist>
</sect1>

</article> 

