xemacs-beta: man/w3.texi comparison

comparison man/w3.texi @ 20:859a2309aef8 r19-15b93

Import from CVS: tag r19-15b93

author	cvs
date	Mon, 13 Aug 2007 08:50:05 +0200
parents	0293115a14e9
children	8fc7fe29b841

comparison

equal deleted inserted replaced

-:ac1f612d5250
+:859a2309aef8
 \input texinfo
+@c
+@c Please note that this file uses some constructs not supported by earlier
+@c versions of TeXinfo.  You must be running one of the newer TeXinfo
+@c releases (I currently use version 3.9 from ftp://prep.ai.mit.edu/pub/gnu
+@c
+@c Please do not send in bug reports about not being able to format the
+@c document with 'makeinfo' or 'tex', just upgrade your installation.
+@c
+@c Info formatted files are provided in the distribution, and you can
+@c retrieve dvi, postscript, and PDF versions from the web site or ftp
+@c site: http://www.cs.indiana.edu/elisp/w3/docs.html
+@c
 @setfilename w3.info
 @settitle Emacs-W3 User's Manual
 @iftex
 @finalout
 @end iftex
 * W3: (w3).                       Emacs-W3 World Wide Web browser.
 @end direntry
 @ifinfo
 This file documents the Emacs-W3 World Wide Web browser.
-Copyright (C) 1993, 1994, 1995 William M. Perry
+Copyright (C) 1993, 1994, 1995, 1996 William M. Perry
-Copyright (C) 1996 Free Software Foundation
+Copyright (C) 1996, 1997 Free Software Foundation
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
 are preserved on all copies.
 @center @titlefont{Emacs-W3}
 @center @titlefont{User's Manual}
 @sp 4
 @center Third Edition, Emacs-W3 Version 3.0
 @sp 1
-@center December 1996
+@center February 1997
 @sp 5
 @center William M. Perry
 @center @i{wmperry@@cs.indiana.edu}
 @page
 @vskip 0pt plus 1filll
 Copyright @copyright{} 1993, 1994, 1995 William M. Perry@*
-Copyright @copyright{} 1996 Free Software Foundation
+Copyright @copyright{} 1996, 1997 Free Software Foundation
 Permission is granted to make and distribute verbatim copies of@*
 this manual provided the copyright notice and this permission notice@*
 are preserved on all copies.
 @end titlepage
 @page
 @ifinfo
-@node Top, Introduction,, (DIR)
+@node Top, Getting Started,, (DIR)
-This manual documents the Emacs-W3 World Wide Web browser, a Lisp program
+Users can browse the World Wide Web from within Emacs by using Emacs-W3.
-which runs as a subsystem under Emacs.  The manual is divided into the
+All of the widely used (and even some not very widely used) @sc{url}
-following chapters.
+schemes are supported, and it is very easy to add new methods as the
+need arises.
+Emacs-W3 provides some core functionality that can be readily re-used
+from any program in Emacs.  Users and other package writers are
+encouraged to @i{Web-enable} their applications and daily work routines
+with the library.
+Emacs-W3 is completely customizable, both from Emacs-Lisp and from
+stylesheets @xref{Style Sheets}  If there is any aspect of Emacs-W3 that
+cannot be modified to your satisfaction, please send mail to the
+@t{w3-beta@@indiana.edu} mailing list with any suggestions.
+@xref{Reporting Bugs}
 @menu
-* Introduction::                Overview of Emacs-W3.
 * Getting Started::             Getting up and running with Emacs-W3
 * Basic Usage::                 Basic movement and usage of Emacs-W3.
 * Compatibility::               Explanation of compatibility with
-other web browsers.
+other browsers.
-* Controlling Formatting::	How to control HTML formatting
+* Stylesheets::	                How to control the look of web pages
-* MIME Support::                Support for MIME
+* MIME Support::                Support for @sc{mime}
-* Security::                    Various forms of security
+* Security::                    Various security methods supported
 * Non-Unix Operating Systems::	Special considerations necessary to get
 up and running correctly under non-unix
 OS's.
+* Speech Integration::          Outputting to a speech synthesizer.
 * Advanced Features::           Some of the more arcane features.
 * More Help::                   How to get more help---mailing lists,
 newsgroups, etc.
 * Future Directions::           Plans for future revisions
 Appendices:
 * Reporting Bugs::              How to report a bug in Emacs-W3
-* Installing SSL::              Turning on SSL support
+* Installing SSL::              Turning on @sc{ssl} support
-* Using PGP/PEM::               Turning on PGP/PEM encryption support
 * Mailcap Files::               An explanation of Mailcap files
 Indices:
 * General Index::               General Index
 * Key Index::                   Menus of command keys and their references
 @end menu
 @end ifinfo
-@node Introduction, Getting Started, Top, Top
+@node Getting Started, Basic Usage, Top, Top
-@chapter Introduction
-@cindex World Wide Web
-:: WORK :: Basic info on what Emacs-W3 is, including copyrights, etc.
-@ifinfo
-Here is some more specific information about what languages and
-protocols Emacs-W3 supports.
-@menu
-* Markup Languages Supported::	Markup languages supported by Emacs-W3
-* Stylesheets::                 Stylesheet languages supported by Emacs-W3
-* Supported Protocols::		Network protocols supported by Emacs-W3
-@end menu
-@end ifinfo
-@node Markup Languages Supported, Stylesheets, Introduction, Introduction
-@chapter Supported Markup Languages
-Several different markup languages, and various extensions to those
-languages, are supported by Emacs-W3.
-@ifinfo
-@center ----------
-@center HTML 2.0
-@center ----------
-@end ifinfo
-@iftex
-@section HTML 2.0
-@end iftex
-@cindex HTML 2.0
-:: WORK :: Reference to the HTML 2.0 RFC
-:: WORK :: Basic explanation of HTML, tag structure, etc.
-@ifinfo
-@center ----------
-@center HTML 3.2
-@center ----------
-@end ifinfo
-@iftex
-@section HTML 3.2
-@end iftex
-@cindex HTML 3.2
-The HTML 3.2 language is an extension of HTML, with a large degree of
-backward compatibility with HTML 2.0.  This basically documents current
-practice as of January, 1996.
-@ifinfo
-@center ----------
-@center SGML Features
-@center ----------
-@end ifinfo
-@iftex
-@section SGML Features
-@end iftex
-@cindex SGML Features
-@cindex Entity Definitions
-@cindex Marked Sections
-:: WORK :: Document marked sections, SGML features
-@ifinfo
-@center ----------
-@center Extras
-@center ----------
-@end ifinfo
-@iftex
-@section Extra Markup
-@end iftex
-@cindex Easter Eggs
-@cindex Fluff
-@cindex Pomp & Circumstance
-There are several different markup elements that are not officially part
-of HTML or HTML 3.2 that Emacs-W3 supports.  These are either items that
-were dropped from HTML 3.@var{x} after I had implemented them, things I
-find just completely hilarious, or experimental parts of HTML that
-should not be counted as "official" or long lived.
-@itemize @bullet
-@item
-FLAME support.  For truly interesting dynamic documents.  This is
-replaced with a random quote from Mr. Angry (see @kbd{M-x flame} for a
-sample).
-@item
-The top ten tags that did not make it into netscape.  These tags were
-posted to the newsgroup comp.infosystems.www.misc by Laura Lemay
-(@i{lemay@@netcom.com}).  Much thanks to her for the humor.
-@table @b
-@item <wired>...</wired>
-Renders the enclosed text in a suitably ugly font/color combination.  If
-no default has been set up by the user, this is the default font, with
-red text on a yellow background.
-@item <roach>...</roach>
-When selected, the enclosed text runs and hides under the nearest
-window.  OR, giggles a lot and demands nachos, depending on the
-definition of "roach." (the formal definition, of course, to be
-determined by the Official Honorary Internet Standards Committee For
-Moving Really Slowly.)
-@item <pinhead>
-Inserts "zippyisms" into the enclosed text.  Perfect for those professional
-documents.  This is sure to be a favorite of mine!
-@item <secret>...</secret>
-Must use secret spy decoder glasses (available direct from Netscape for
-a reasonable fee) in order to read the enclosed text.  Can also be read
-by holding the computer in front of a full moon during the autumn
-solstice.
-In Emacs-W3, this displays the text using rot13 encoding.
-@item <hype>
-Causes Marc Andreesen to magically appear and grant an interview (wanted
-or not).  Please use this tag sparingly.
-@item <peek>....</peek>
-@item <poke>...</poke>
-Need more control over screen layout in HTML?  Well, here ya go.
-n
-Actually, <peek> could almost be considered useful.  The VARIABLE
-attribute can be used to insert the value of an emacs variable into the
-current document.  Things like 'Welcome to my page, <peek
-variable=user-mail-address>' can be useful in spreading fear,
-uncertainty, and doubt among users.
-@item <yogsothoth>
-@cindex Gates Bill
-@cindex Yogsothoth
-Summons the elder gods to suck away your immortal soul.  Or Bill Gates,
-if the elder gods are busy.  Unpredictable (but amusing) results occur
-when the <YOGSOTHOTH> and <HYPE> tags are used in close proximity.
-@item <blink>...</blink>
-Causes the enclosed text to .... ooops that one made it in.
-@end table
-@end itemize
-@node Stylesheets, Supported Protocols, Markup Languages Supported,Introduction
-@chapter Stylesheets
-@cindex Stylesheets
-@cindex Cascading Style Sheets
-@cindex Aural Cascading Style Sheets
-@cindex CSS
-@cindex DSSSL
-:: WORK :: Document CSS support
-CSS Information at http://www.w3.org/pub/WWW/TR/REC-CSS1
-Style guide at http://www.htmlhelp.com/reference/css/
-:: WORK :: Document ACSS support
-ACSS Information at http://www.w3.org/pub/WWW/Style/CSS/Speech/NOTE-ACSS
-:: WORK :: Document DSSSL support
-@node Supported Protocols, , Stylesheets, Introduction
-@chapter Supported Protocols
-@cindex Network Protocols
-@cindex Protocols Supported
-@cindex Supported Protocols
-Emacs-W3 supports the following protocols
-@table @b
-@item Usenet News
-Can either display an entire newsgroup or specific articles by
-Message-ID: header.  Instead of rewriting a newsreader, this integrates
-with the Gnus newsreader.  It requires at least Gnus 5.0, but it is
-always safest to use the latest version.  Gnus supports some very
-advanced features, including virtual newsgroups, mail and news
-integration, and reading news from multiple servers.  @inforef{Gnus,
-Top,gnus}, for more info.
-To be more in line with the other URL schemes, the hostname and port of
-an NNTP server can be specified.  URLs of the form
-news://hostname:port/messageID work, but might not work in some other
-browsers.
-@item HTTP
-Supports the HTTP/0.9, HTTP/1.0, and parts of the HTTP/1.1 protocols.
-@item Gopher
-Support for all gopher types, including CSO queries.
-@item Gopher+
-Support for Gopher+ retrievals. Support for converting ASK blocks into
-HTML 3.0 FORMS and submitting them back to the server.
-@item FTP
-FTP is handled by either ange-ftp or efs.
-@inforef{Ange-FTP,Top,ange-ftp}, for more information on Ange-FTP, or
-@inforef{EFS, Top,efs}, for information on EFS.
-@item Local files
-Local files are of course handled, and MIME content-types are derived
-from the file extensions.
-@item telnet, tn3270, rlogin
-Telnet, tn3270, and rogin are handled by running the appropriate program
-in an emacs buffer, or running an external process.
-@item mailto
-Causes a mail message to be started to a specific address.  Supports the
-Netscape @i{extensions} to specify arbitrary headers on the message.
-@item data
-A quick and easy way to `inline' small pieces of information that you do
-not necessarily want to download over the net separately.  Can speed up
-display of small icons, stylesheet information, etc.  See the internet
-draft draft-masinter-url-data-02.txt for more information.
-@item mailserver
-A more powerful version of mailto, which allows the author to specify
-the subject and body text of the mail message.  This type of link is
-never fully executed without user confirmation, because it is possible
-to insert insulting or threatening (and possibly illegal) data into the
-message.  The mail message is displayed, and the user must confirm the
-message before it is sent.
-@item x-exec
-A URL can cause a local executable to be run, and its output interpreted
-as if it had come from an HTTP server.  This is very useful, but is
-still an experimental protocol, hence the X- prefix.  This URL protocol
-is deprecated, but might be useful in the future.
-@item NFS
-Retrieves information over NFS.  This requires that your operating
-system support auto-mounting of NFS volumes.
-@item finger
-Retrieves information about a user via the 'finger' protocol.
-@item Info
-Creates a link to an GNU-style info file.  @inforef{Info,Top,info}, for more
-information on the Info format.
-@item SSL
-SSL requires a set of patches to the Emacs C code and SSLRef 2.0, or an
-external program to run in a subprocess (similar to the @file{tcp.el}
-package that comes with GNUS.  @xref{Installing SSL}
-@end table
-@node Getting Started, Getting Emacs, Introduction, Top
 @chapter Getting Started
 @cindex Clueless in Seattle
 @cindex Getting Started
-This section of the manual deals with getting, compiling, and
+@kindex M-x w3
-configuring @i{Emacs-W3}.
+@vindex w3-default-homepage
-:: WORK :: Introduction to 'Getting Started'
+@findex w3
+If installed correctly, starting Emacs-W3 is quite painless.  Just type
-@ifinfo
+@kbd{M-x w3} in a running Emacs sessions.  This will retrieve the
+default page that has been configured - by default the documentation for
+Emacs-W3 at Indiana University.
+If the default page is not retrieved correctly at startup, you will have
+to do some customization.
 @menu
-* Getting Emacs::               Where to get Emacs
+* Using the Network::           Tell Emacs about your network setup.
-* Getting Emacs-W3::            Where to get Emacs-W3
+* Proxy Gateways::              Using an @sc{http} proxy
-* Basic Setup::                 Basic setup that most people want to do
+* Startup Files::               What is where, and why.
-* Firewalls::                   Integrating Emacs-W3 with a firewall setup.
+* Preferences Panel::           Quick configuration of common options.
-* Proxy Gateways::              Using a proxy server
 @end menu
-@end ifinfo
+@node Using the Network, Proxy Gateways, Getting Started, Getting Started
-@node Getting Emacs, Getting Emacs-W3, Getting Started, Getting Started
+@section Using the Network
-@section Getting Emacs
+By default, Emacs can support standard @sc{tcp}/@sc{ip} network
-@cindex Getting Emacs
+connections on almost all the platforms it runs on (Unix, @sc{vms},
-@cindex Source code availability
+Windows, etc).  However, there are several situations where it is not
-:: WORK :: Explanation of Emacs, XEmacs, and where to get both
+sufficient.
-@node Getting Emacs-W3, Basic Setup, Getting Emacs, Getting Started
-@section Getting Emacs-W3
-@cindex FTP'in the distribution
-@cindex Source code availability
-:: WORK :: Explanation of Emacs, XEmacs, and where to get both
-@node Basic Setup, Firewalls, Getting Emacs-W3, Getting Started
-@section Basic Setup
-For most people, Emacs-W3 will be ready to run straight out of the box.
-Once the user is more familiar with the web and how it integrates with
-Emacs, there are a few basic configuration variables that most people
-will want to personalize.
-@table @code
-@item w3-default-homepage
-@vindex w3-default-homepage
-The URL to open at startup.  This defaults to the environment variable
-WWW_HOME if it is not set it in the users @file{.emacs} file. If
-WWW_HOME is undefined, then it defaults to the hypertext documentation
-for Emacs-W3.
-@item w3-delay-image-loads
-@vindex w3-delay-image-loads
-Controls the loading of inlined images.  If non-@code{nil}, images are
-not loaded.  If the correct image converters are not installed or the
-network connection is very slow, it is best to set this to @code{t}.
-Defaults to @code{nil}.
-@item url-global-history-file
-@vindex url-global-history-file
-The global history file used by both Mosaic/X and Emacs-W3.  This file
-contains a list of all the URLs that have been visited.  This file is parsed
-at startup and used to provide URL completion.  Emacs-W3 can read and
-write Mosaic/X or Netscape 1.x style history files, or use its own
-internal format (faster).  The file type is determined automatically, or
-prompted for if the file does not exist.
-@item w3-hotlist-file
-@vindex w3-hotlist-file
-Hotlist filename.  This should be the name of a file that is stored in
-NCSA's Mosaic/X or Netscape's format.  It is used to keep a listing of
-commonly accessed URLs.
-@item w3-personal-annotation-directory
-@vindex w3-personal-annotation-directory
-The directory where Emacs-W3 looks for personal annotations.  This is a
-directory that should hold the personal annotations stored in a
-Mosaic/X-compatible format.
-@item url-pgp/pem-entity
-@findex user-real-login-name
-@findex system-name
-The name by which the user is known to PGP and/or PEM entities.  If this
-is not set when Emacs-W3 is loaded, it defaults to
-@code{user-mail-address} if it is set, otherwise @code{(user-real-login-name)}@@@code{(system-name)}.
-@item url-personal-mail-address
-@vindex url-personal-mail-address
-@vindex url-pgp/pem-entity
-User's full email address.  This is what is sent to HTTP/1.0 servers as
-the FROM header.  If this is not set when Emacs-W3 is loaded, then it
-defaults to the value of @code{url-pgp/pem-entity}.
-@item w3-right-border
-@vindex w3-right-border
-@findex window-width
-Amount of space to leave on right margin of WWW buffers.  This amount is
-subtracted from the width of the window for each new WWW buffer and used
-as the new @code{fill-column}.
-@item w3-track-mouse
-@vindex w3-track-mouse
-Controls whether to track the mouse and message the url under the mouse.
-If this is non-@code{nil}, then a description of the hypertext area
-under the mouse is shown in the minibuffer.  This shows what type of
-link (inlined image, form entry area, delayed image, delayed MPEG, or
-hypertext reference) is under the cursor, and the destination.
-@item w3-echo-link
-@vindex w3-echo-link
-Controls how a URL is shown when a link is reached with @key{f},
-@key{b}, or the mouse moves over it.  Possible values are:
 @table @b
-@item url
-Displays the URL (ie: @samp{http://www.cs.indiana.edu/}).
-@item text
-Displays the text of the link (ie: @samp{A link to Indiana University}).
-@item title
-Displays the title of the link, if any, otherwise behaves the same as @code{url}.
-@item nil
-Show nothing.
-@end table
-@item w3-use-forms-index
-@vindex w3-use-forms-index
-@cindex ISINDEX handling
-@cindex Forms based searching
-@cindex Searching with forms
-Non-@code{nil} means translate <ISINDEX> tags into a hypertext form.  A
-single text entry box is shown where the ISINDEX tag appears.
-@item url-use-hypertext-gopher
-@vindex url-use-hypertext-gopher
-@cindex Gopher+
-Controls how gopher documents are retrieved.  If non-@code{nil}, the
-gopher pages are converted into HTML and parsed just like any other
-page.  If @code{nil}, the requests are passed off to the
-@file{gopher.el} package by Scott Snyder.  Using the @file{gopher.el}
-package loses the gopher+ support, and inlined searching.
-@item url-xterm-command
-@vindex url-xterm-command
-Command used to start a windowed shell, similar to an xterm.  This
-string is passed through @code{format}, and should expect four strings:
-the title of the window, the program name to execute, and the server and
-port number.  The default is for xterm, which is very UNIX and
-XWindows-centric.
-@end table
-@node Firewalls, Proxy Gateways, Basic Setup, Getting Started
-@section Firewalls
-@cindex Gateways
-There are several different reasons why the gateway support might be
-required.
-@enumerate
 @cindex Firewalls
-@item
+@item Firewalls
-Stuck behind a firewall.  This is usually the case at large corporations
+It is becoming more and more common to be behind a firewall or some
-with paranoid system-administrators.
+other system that restricts your outbound network activity, especially
+if you are like me and away from the wonderful world of academia.
-@cindex TERM
+Emacs-W3 has several different methods to get around firewalls (not to
-@item
+worry though - none of them should get you in trouble with the local
-Using TERM @footnote{TERM is a user-level protocol for emulating IP over
+@sc{mis} department.)
-a serial line.  More information is available at
-ftp://sunsite.unc.edu/pub/Linux/apps/comm/term} for slip-like access to
+@item Emacs cannot resolve hostnames.
-the internet.
-NOTE: XEmacs and Emacs 19.22 or later have patches to enable native TERM
-networking.  To enable it, #define TERM in the appropriate s/*.h file
-for the operating system, then change the SYSTEM_LIBS define to include
-the @file{termnet} library that comes with the latest versions of TERM.
-@item
 @cindex Faulty hostname resolvers
-@cindex Broken SUN libc
+@cindex Broken SunOS libc
-@cindex Can't resolve hostnames
+@cindex Hostname resolution
-Emacs cannot resolve hostnames.  This happens quite often on Sun
+This happens quite often on SunOS workstations and some ULTRIX machines.
-workstations and some ULTRIX machines.  Some C libraries do not include
+Some C libraries do not include the hostname resolver routines in their
-the hostname resolver routines in their static libraries.  If Emacs was
+static libraries.  If Emacs was linked statically, and was not linked
-linked statically, this means it won't be able to get to any machines
+with the resolver libraries, it wil not be able to get to any machines
 off the local network.  This is characterized by being able to reach
 someplace with a raw ip number, but not its hostname
-(http://129.79.254.191/ works, but http://www.cs.indiana.edu/ doesn't).
+(@url{http://129.79.254.191/} works, but
+@url{http://www.cs.indiana.edu/} doesn't).
-If for some reason it is not feasible to recompile Emacs with the
-@file{-lresolv} library or dynamic linking, it is just like being behind
+The best solution for this problem is to recompile Emacs, making sure to
-a firewall.  Another alternative is to set the variable
+either link dynamically (if available on your operating system), or
-@code{url-broken-resolution} - this will use the support in ange-ftp or
+include the @file{-lresolv}.
-EFS to use @file{nslookup} in a subprocess to do all hostname resolving.
-See the variables @code{efs-nslookup-program},
+@cindex url-gateway-broken-resolution
-@code{efs-nslookup-on-connect}, and @code{efs-nslookup-threshold} if are
+If you do not have the disk space or the appropriate permissions to
-using EFS, or @code{ange-ftp-nslookup-program} if using Ange-FTP.
+recompile Emacs, another alternative is using the @file{nslookup}
+program to do hostname resolution.  To turn this on, set the variable
-@end enumerate
+@code{url-gateway-broken-resolution} in your @file{~/.emacs} file.  This
+runs the program specified by @code{url-gateway-nslookup-program} (by
+default "@code{nslookup}" to do hostname resolution.  This program should
+expect a single argument on the command line - the hostname to resolve,
+and should produce output similar to the standard Unix @file{nslookup}
+program:
+@example
+Name: www.cs.indiana.ed
+Address: 129.79.254.191
+@end example
+@cindex @sc{term}
+@item Using @sc{term} (or @sc{term}-like) Networking Software
+@sc{term} @footnote{@sc{term} is a user-level protocol for emulating
+@sc{ip} over a serial line.  More information is available at
+@url{ftp://sunsite.unc.edu/pub/Linux/apps/comm/term}} for slip-like
+access to the internet.
+@sc{note}: XEmacs and Emacs 19.22 or later have patches to enable native
+@sc{term} networking.  To enable it, @code{#define TERM} in the
+appropriate s/*.h file for the operating system, then change the
+@code{SYSTEM_LIBS} definition to include the @file{termnet} library that
+comes with the latest versions of @sc{term}.
+If you run into any problems with the native @sc{term} networking
+support in Emacs or XEmacs, please let @t{wmperry@@cs.indiana.edu} know,
+as he is responsible for the original support.
+@end table
 @vindex url-gateway-local-host-regexp
 Emacs-W3 has support for using the gateway mechanism for certain
-domains, and directly connecting to others.  To use this, change the
+domains, and directly connecting to others.  The variable
-value of @code{url-gateway-local-host-regexp}.  This should be a regular
+@code{url-gateway-local-host-regexp} controls this behaviour.  This is a
-expression @footnote{Please see the full Emacs distribution for a
+regular expression @footnote{Please see the full Emacs distribution for
-description of regular expressions} that matches local hosts that do not
+a description of regular expressions} that matches local hosts that do
-require the use of a gateway.  If @code{nil}, then all connections are
+not require the use of a gateway.  If @code{nil}, then all connections
-made through the gateway.
+are made through the gateway.
 @vindex url-gateway-method
-Emacs-W3 supports several methods of getting around gateways.  The variable
+Emacs-W3 supports several methods of getting around gateways.  The
-@code{url-gateway-method} controls which of these methods is used.  This
+variable @code{url-gateway-method} controls which of these methods is
-variable can have several values (use these as symbol names, not
+used.  This variable can have several values (use these as symbol names,
-strings):
+not strings), ie: @samp{(setq url-gateway-method 'telnet)}.  Possible
+values are:
 @table @dfn
-@item program
+@item telnet
-Run a program in a subprocess to connect to remote hosts (examples are
+Use this method if you must first telnet and log into a gateway host,
-@i{itelnet}@footnote{Itelnet is a standard name for a telnet executable
+and then run telnet from that host to connect to outside machines.
-that is capable of escaping the firewall.  Check with system
-administrators to see if anything similar is available}, an
+:: WORK :: document telnet gw variables
-@i{expect}@footnote{Expect is a scripting language that allows control
+This section needs more information, specifically documenting the
-of interactive programs (like telnet) very easily.  It is available from
+following variables.  For now, please do @key{C-h v} on the variable for
-gatekeeper.dec.com:/pub/GNU/expect-3.24.0.tar.gz} script, etc.).
+more information.
+@table @code
+@item url-gateway-telnet-host
+@item url-gateway-telnet-parameters
+@item url-gateway-telnet-password-prompt
+@item url-gateway-telnet-puser-name
+@item url-gateway-prompt-pattern
+@end table
+@item rlogin
+This method is identical to the @code{telnet} method, but uses
+@file{rlogin} to log into the remote machine without having to send the
+username and password over the wire every time.
+:: WORK :: document rlogin gw variables
+This section needs more information, specifically documenting the
+following variables.  For now, please do @key{C-h v} on the variable for
+more information.
+@table @code
+@item url-gateway-rlogin-host
+@item url-gateway-rlogin-parameters
+@item url-gateway-rlogin-user-name
+@item url-gateway-prompt-pattern
+@end table
 @item tcp
-Masanobu UMEDA (@i{umerin@@mse.kyutech.ac.jp}) has written a very nice
+Masanobu UMEDA (@i{umerin@@mse.kyutech.ac.jp}) has written a very small
-replacement for the standard networking in Emacs.  This does basically
+application that you can run in a subprocess to do the network
-the same thing that a method of @code{program} does, but is slightly
+connections.
-more transparent to the user.
+@item @sc{socks}
+Use if the firewall has a @sc{socks} gateway running on it.
+:: WORK :: document socks variables
+This section needs more information, specifically documenting the
+following variables.  For now, please do @key{C-h v} on the variable for
+more information.
+@table @code
+@item socks-host
+@item socks-password
+@item socks-username
+@item socks-port
+@item socks-timeout
+@end table
+@c @item ssl
+@c This probably shouldn't be documented
 @item native
-This means that Emacs-W3 should use the builtin networking code of Emacs.
+This means that Emacs-W3 should use the builtin networking code of
-This should be used only if there is no firewall, or the Emacs source
+Emacs.  This should be used only if there is no firewall, or the Emacs
-has already been hacked to get around the firewall.
+source has already been hacked to get around the firewall.
 @end table
-One of these needs a bit more explanation than that:
-@vindex url-gateway-telnet-ready-regexp
-@vindex url-gateway-telnet-program
-When running a program in a subprocess to emulate a network connection,
-a few extra variables need to be set.  The variable
-@code{url-gateway-telnet-program} should point to an executable that
-accepts a hostname and port # as its arguments, and passes standard
-input to the remote host.  This can be either the full path to the
-executable or just the basename.  The variable
-@code{url-gateway-telnet-ready-regexp} controls how long Emacs-W3 should
-wait after spawning the subprocess to start sending to its standard
-input.  This gets around a bug where telnet would miss the beginning of
-requests becausse it did not buffer its input before opening a
-connection.  This should be a regular expression to watch for that
-signifies the end of the setup of @code{url-gateway-telnet-program}.
-The default should work fine for telnet.
 Emacs-W3 should now be able to get outside the local network.  If none
 of this makes sense, its probably my fault.  Please check with the
 network administrators to see if they have a program that does most of
 this already, since somebody somewhere at the company has probably been
 through something similar to this before, and would be much more
 helpful/knowledgeable about the local setup than I would be.  But feel
 free to mail me as a last resort.
+@node Proxy Gateways, Startup Files , Using the Network, Getting Started
-@node Proxy Gateways, Basic Usage, Firewalls, Getting Started
 @section Proxy Gateways
 @vindex url-proxy-services
 @cindex Proxy Servers
 @cindex Proxies
 @cindex Proxies, environment variables
 @cindex HTTP Proxy
 In late January 1993, Kevin Altis and Lou Montulli proposed and
 implemented a new proxy service.  This service requires the use of
 environment variables to specify a gateway server/port # to send
-protocol requests to.  Each protocol (HTTP, WAIS, gopher, FTP, etc.@:)
+protocol requests to.  Each protocol (@sc{http}, @sc{wais}, gopher,
-can have a different gateway server.  The environment variables are
+@sc{ftp}, etc.) can have a different gateway server.  The environment
-@var{PROTOCOL}_proxy, where @var{PROTOCOL} is one of the supported
+variables are @code{PROTOCOL}_proxy, where @code{PROTOCOL} is one of the
-network protocols (gopher, file, HTTP, FTP, etc.)
+supported network protocols (gopher, file, @sc{http}, @sc{ftp}, etc.)
 @cindex No Proxy
 @cindex Proxies, exclusion lists
 @vindex NO_PROXY
 For companies with internal intranets, it will usually be helpful to
 define a list of hosts that should be contacted directly, @b{not} sent
-through the proxy.  The @var{NO_PROXY} environment variable controls
+through the proxy.  The @code{NO_PROXY} environment variable controls
 what hosts are able to be contacted directly.  This should be a comma
 separated list of hostnames, domain names, or a mixture of both.
 Asterisks can be used as a wildcard.  For example:
 @example
 @vindex url-proxy-services
 @cindex Proxies, setting from lisp
 For those adventurous souls who enjoy writing regular expressions, all
 the proxy settings can be manipulated from Emacs-Lisp.  The variable
 @code{url-proxy-services} controls this.  This is an assoc list, keyed
-on the protocol type (http, gopher, etc) in all lowercase.  The
+on the protocol type (@sc{http}, gopher, etc) in all lowercase.  The
-@code{cdr} of each entry should be the fully-specified URL of the proxy
+@code{cdr} of each entry should be the fully-specified @sc{url} of the proxy
 server to contact, or, in the case of the special "no_proxy" entry, a
 regular expression that matches any hostnames that should be contacted
 directly.
 @example
 (setq url-proxy-services '(("http"     . "http://proxy.aventail.com/")
 ("no_proxy" . "^.*\\(aventail\\|seanet\\)\.com")))
 @end example
-@node Basic Usage, , Proxy Gateways, Top
+@node Startup Files, Preferences Panel, Proxy Gateways, Getting Started
+@section Startup Files
+@cindex Startup files
+@cindex Default stylesheet
+:: WORK :: startup files
+This section should document where emacs-w3 looks for its startup files,
+and what each one does.  'profile' 'stylesheet' 'hotlist' 'history' etc.
+@node Preferences Panel, , Startup Files, Getting Started
+@section Preferences Panel
+@cindex Preferences
+@kindex M-x w3-edit-preferences
+:: WORK :: pref panel
+This should document the quick preferences panel.  M-x w3-edit-preferences
+@node Basic Usage, Movement , Getting Started, Top
 @chapter Basic Usage
-Emacs-W3 is similar to the Info package all Emacs users hold near and dear to
+@cindex Basic Usage
-their hearts (@xref{Top,,Info,info, The Info Manual}, for a description
+@kindex space
-of Info).  Basically, @kbd{space} and @kbd{backspace} control scrolling,
+@kindex backspace
-and @kbd{return} or @kbd{mouse2} follows a hypertext link.  The @kbd{f}
+@kindex return
-and @kbd{b} keys maneuver around the various links on the page.
+@kindex tab
+@kindex M-tab
-@b{NOTE:} To enter data into a form entry area, select it using
+Emacs-W3 is similar to the Info package all Emacs users hold near and
-@kbd{return} or the middle mouse button, just like a hypertext link.
+dear to their hearts (@xref{Top,,Info,info, The Info Manual}, for a
+description of Info).  Basically, @kbd{space} and @kbd{backspace}
+control scrolling, and @kbd{return} or the middle mouse button follows a
+hypertext link.  The @kbd{tab} and @kbd{Meta-tab} keys maneuver around the
+various links on the page.
+@b{NOTE:} Starting with Emacs-W3 3.0, form entry areas in a page can be
+typed directly into.  This is one of the main differences in navigation
+from version 2.0.  If you are used to using the @kbd{f} and @kbd{b} keys
+to navigate around a buffer, I suggest training yourself to always use
+@kbd{tab} and @kbd{M-tab} - it will save time and frustration on pages
+with lots of form fields.
 By default, hypertext links are surrounded by '[[' and ']]' on
 non-graphic terminals (VT100, DOS window, etc.).  On a graphics
-terminal, the links are in shown in different colors.  @xref{Controlling
+terminal, the links are in shown in different colors.
-Formatting} for information on how to change this, or for help on
+@xref{Stylesheets} for information on how to change this.
-getting the highlighting to work on graphics terminals.
 There are approximately 50 keys bound to special Emacs-W3 functions.
 The basic rule of thumb regarding keybindings in Emacs-W3 is that a
 lowercase key takes an action on the @b{current document}, and an
 uppercase key takes an action on the document pointed to by the
 There are several areas that the keybindings fall into: movement,
 information, action, and miscellaneous.
 @ifinfo
 @menu
-* Movement::		Moving around in a Emacs-W3 buffer
+* Movement::		Moving around in the buffer.
-* Information::		Getting information about the Emacs-W3 document being
+* Information::		Getting information about a document.
-			viewed, and/or links within that document.
+* Action::		Following links, printing, etc.
-* Action::		Taking actions in a Emacs-W3 buffer (following links,
+* Miscellaneous::	Everything else.
-			printing, etc.)
-* Miscellaneous::	Miscellaneous keybindings
 @end menu
 @end ifinfo
 @node Movement, Information, Basic Usage, Basic Usage
 @section Movement
-:: WORK :: Document the 'h' and 'a' keymaps
+All the standard Emacs bindings for movement are still in effect, with a
+few additions for convenience.
 @table @kbd
-@findex scroll-up
+@findex w3-scroll-up
-@kindex SPC
+@kindex space
-@item SPC
+@item space
 Scroll downward in the buffer.  With prefix arg, scroll down that many
 screenfuls.
-@kindex DEL
+@kindex backspace
 @findex scroll-down
-@item DEL
+@item backspace
 Scroll upward in the buffer.  With prefix arg, scroll up that many
 screenfuls.
 @kindex <
 @findex w3-start-of-document
 @item <
 @kindex >
 @findex w3-end-of-document
 @item >
 Goes to the end of document
 @kindex b
-@kindex Shift-TAB
+@kindex Meta-tab
-@findex w3-back-link
+@findex w3-widget-backward
-@item Shift-TAB, b
+@item Meta-tab, b
 Attempts to move backward one link area in the current document.
 Signals an error if no previous links are found.
-@kindex hl
+@kindex f
-@findex w3-show-hotlist
+@kindex tab
-@item hl
+@kindex n
-Displays a complete listing of the items in the hotlist.
+@findex w3-widget-forward
-@kindex hu
+@item tab, f, n
-@findex w3-use-hotlist
+Attempts to move forward one link area in the current document.  Signals
-@item hu
+an error if no more links are found.
-Go to a link in the hotlist.
+@kindex B
+@findex w3-backward-in-history
+@item B
+Move backwards in the history stack.
+@kindex F
+@findex w3-forward-in-history
+@item F
+Move forwards in the history stack.
+@kindex l
+@findex w3-goto-last-buffer
+@item l
+Return to the last buffer shown before this buffer.
+@kindex q
+@findex w3-quit
+@item q
+Kill this buffer.
+@kindex Q, u
+@findex w3-leave-buffer
+Bury this buffer, but don't kill it
+@end table
+@node Information, Action, Movement, Basic Usage
+@section Information
+These functions relate information about one or more links on the
+current document.
+@table @kbd
+@kindex v
+@findex url-view-url
+@item v
+This shows the @sc{url} of the current document in the minibuffer.
+@kindex V
+@findex w3-view-this-url
+@item V
+This shows the @sc{url} of the hypertext link under point in the
+minibuffer.
+@kindex i
+@findex w3-document-information
+@item i
+Shows miscellaneous information about the currently displayed document.
+This includes the @sc{url}, the last modified date, @sc{mime} headers,
+the @sc{http} response code, and any relationships to other documents.
+Any security information is also displayed.
+@kindex I
+@findex w3-document-information-this-url
+@item I
+Shows information about the @sc{url} at point.
+@kindex s
+@findex w3-source-document
+@item s
+This shows the @sc{html} source of the current document in a separate buffer.
+The buffer's name is based on the document's @sc{url}.
+@kindex S
+@findex w3-source-document-at-point
+@item S
+Shows the @sc{html} source of the hypertext link under point in a separate
+buffer.  The buffer's name is based on the document's @sc{url}.
+@kindex k
+@findex w3-save-url
+@item k
+This stores the current document's @sc{url} in the kill ring, and also in the
+current window-system's clipboard, if possible.
+@kindex K
+@findex w3-save-this-url
+@item K
+Stores the @sc{url} of the document under point in the kill ring, and also in
+the current window-system's clipboard, if possible.
+@end table
+@node Action, Miscellaneous, Information, Basic Usage
+@section Action
+First, here are the keys and functions that bring up a new hypertext
+page, usually creating a new buffer.
+@table @kbd
 @kindex m
 @findex w3-complete-link
 @item m
 Choose a link from the current buffer and follow it.  A completing-read
 is done on all the links, so @kbd{space} and @kbd{TAB} can be used for
 completion.
-@kindex f
-@kindex TAB
-@kindex n
-@findex w3-forward-link
-@item TAB, f, n
-Attempts to move forward one link area in the current document.  Signals
-an error if no more links are found.
-@end table
-@node Information, Action, Movement, Basic Usage
-@section Information
-These functions relate information about one or more links on the
-current document.
-@table @kbd
-@kindex v
-@findex url-view-url
-@item v
-This shows the URL of the current document in the minibuffer.
-@kindex V
-@findex w3-view-this-url
-@item V
-This shows the URL of the hypertext link under point in the minibuffer.
-If there is not a hypertext link under point, then it shows the type of
-form entry area under point.  If there is no form entry area under
-point, then it shows the inlined image's URL that is under point, if
-any.
-@kindex i
-@findex w3-document-information
-@item i
-Shows miscellaneous information about the currently displayed document.
-This includes the URL, the last modified date, MIME headers, the HTTP
-response code, and any relationships to other documents.  Any security
-information is also displayed.
-@kindex I
-@findex w3-document-information-this-url
-@item I
-Shows information about the URL at point.
-@kindex s
-@findex w3-source-document
-@item s
-This shows the HTML source of the current document in a separate buffer.
-The buffer's name is based on the document's URL.
-@kindex S
-@findex w3-source-document-at-point
-@item S
-Shows the HTML source of the hypertext link under point in a separate
-buffer.  The buffer's name is based on the document's URL.
-@kindex k
-@findex w3-save-url
-@item k
-This stores the current document's URL in the kill ring, and also in the
-current window-system's clipboard, if possible.
-@kindex K
-@findex w3-save-this-url
-@item K
-Stores the URL of the document under point in the kill ring, and also in
-the current window-system's clipboard, if possible.
-@end table
-@node Action, Miscellaneous, Information, Basic Usage
-@section Action
-First, here are the keys and functions that bring up a new hypertext
-page, usually creating a new buffer.
-@table @kbd
 @kindex return
 @findex w3-follow-link
 @item return
 Pressing return when over a hyperlink attempts to follow the link
 under the cursor.  With a prefix argument (@kbd{C-u}), this forces the
 file to be saved to disk instead of being passed off to other viewers
-or being parsed as HTML.
+or being parsed as @sc{html}.
-Pressing return when over a form input field will prompt in the
+Pressing return when over a form input field can cause auto-submission
+of the form.  This is for Mosaic and Netscape compatibility.  If there
+is only one item in the form other than submit or reset buttons, then
 minibuffer for the data to insert into the input field.  Type checking
 is done, and the data is only entered into the form when data of the
 correct type is entered (ie: cannot enter 44 for 'date' field, etc).
 @kindex Middle Mouse Button
 @kindex p
 @findex w3-print-this-url
 @item p
 Prints out the current buffer in a variety of formats, including
-PostScript, HTML source, or formatted text.
+PostScript, @sc{html} source, or formatted text.
 @kindex P
 @findex w3-print-url-under-point
 @item P
-Prints out the URL under point in a variety of formats, including
+Prints out the @sc{url} under point in a variety of formats, including
-PostScript, HTML source, or formatted text.
+PostScript, @sc{html} source, or formatted text.
 @kindex m
 @findex w3-complete-link
 @item m
 Selects a destination from a list of all the hyperlinks in the current
 buffer.  Use @kbd{space} and @kbd{tab} to complete on the links.
 unconditional reload from the remote server - the locally cached copy is
 not consulted.
 @kindex C-o
 @findex w3-fetch
 @item C-o
-Prompts for a URL in the minibuffer, and attempts to fetch
+Prompts for a @sc{url} in the minibuffer, and attempts to fetch
 it.  If there are any errors, or Emacs-W3 cannot understand the type of link
 requested, the errors are displayed in a hypertext buffer.
 @kindex o
 @findex w3-open-local
 @vindex url-use-hypertext-dired
 @findex w3-search
 @item M-s
 Perform a search, if this is a searchable index.  Searching requires a
 server - Emacs-W3 can not do local file searching, as there are too many
 possible types of searches people could want to do.  Generally, the only
-URL types that allow searching are HTTP, gopher, and X-EXEC.
+@sc{url} types that allow searching are @sc{http}, gopher, and X-EXEC.
 @kindex Hv
 @findex w3-show-history-list
 @vindex w3-keep-history
 @item Hv
 If @code{url-keep-history} is non-@code{nil}, then Emacs-W3 keeps track
-of all the URLs visited in an Emacs session.  This function takes all
+of all the @sc{url}s visited in an Emacs session.  This function takes all
 the links that are in that internal list, and formats them as hypertext
 links in a list.
 @end table
 @cindex Buffer movement
 @table @kbd
 @kindex M-m
 @findex w3-mail-current-document
 @item M-m
 Mails the current document to someone.  Choose from several different
-formats to mail: formatted text, HTML source, PostScript, or LaTeX source.
+formats to mail: formatted text, @sc{html} source, PostScript, or LaTeX source.
-When the HTML source is mailed, then an appropriate <base> tag is inserted
+When the @sc{html} source is mailed, then an appropriate <base> tag is inserted
 at the beginning of the document so that relative links may be followed
 correctly by whoever receives the mail.
 @kindex M-M
 @findex w3-mail-document-under-point
 @item M-M
 Mails the document pointed to by the hypertext link under point to someone.
-Choose from several different formats to mail: formatted text, HTML source,
+Choose from several different formats to mail: formatted text, @sc{html} source,
-PostScript, or LaTeX source.  When the HTML source is mailed, then an
+PostScript, or LaTeX source.  When the @sc{html} source is mailed, then an
 appropriate <base> tag is inserted at the beginning of the document so that
 relative links may be followed correctly by whoever receives the
 mail.
 @kindex p
 @findex w3-print-this-url
 @item p
 Prints the current document.  Choose from several different formats to
-print: formatted text, HTML source, PostScript (with ps-print), or by using
+print: formatted text, @sc{html} source, PostScript (with ps-print), or by using
 LaTeX and dvips).
 @findex lpr-buffer
 @vindex lpr-command
 @vindex lpr-switches
 When the formatted text is printed, the normal @code{lpr-buffer} function
 is called, and the variables @code{lpr-command} and @code{lpr-switches}
 control how the document is printed.
-When the HTML source is printed, then an appropriate <base> tag is
+When the @sc{html} source is printed, then an appropriate <base> tag is
 inserted at the beginning of the document.
 @vindex w3-print-commnad
 @vindex w3-latex-docstyle
-When postscript is printed, then the HTML source of the document is
+When postscript is printed, then the @sc{html} source of the document is
 converted into LaTeX source.  There are several variables controlling
 what the final LaTeX document looks like.
 :: WORK :: Document the new LaTeX backend
 If non-@code{nil}, configures the LaTeX engine to use the LaTeX2e
 syntax.  A @code{nil} value indicates that LaTeX 2.0.9 compabibility
 will be used instead.
 @item w3-latex-docstyle
 @vindex w3-latex-docstyle
-The document style to use when printing or mailing converted HTML files
+The document style to use when printing or mailing converted @sc{html} files
 in LaTeX.  Good defaults are: @{article@}, [psfig,twocolumn]@{article@},
 etc.
 @item w3-latex-packages
 @vindex w3-latex-packages
 List of LaTeX packages to include.  Currently this is only used if
 @vindex w3-latex-use-maketitle
 If non-@code{nil}, the LaTeX engine will use real LaTeX title pages for
 document titles.
 @item w3-latex-print-links
 @vindex w3-latex-print-links
-If non-@code{nil}, prints the URLs of hypertext links as endnotes at the
+If non-@code{nil}, prints the @sc{url}s of hypertext links as endnotes at the
-end of the document.  If set to @code{footnote}, prints the URL's as
+end of the document.  If set to @code{footnote}, prints the @sc{url}'s as
 footnotes on each page.
 @end table
 @kindex P
 @findex w3-print-url-under-point
 Prints the document pointed to by the hypertext link under point.
 Please see the previous item for more information.
 @kindex M-x w3-insert-formatted-url
 @findex w3-insert-formatted-url
 @item M-x w3-insert-formatted-url
-Insert a fully formatted HTML link into another buffer.  This gets the
+Insert a fully formatted @sc{html} link into another buffer.  This gets the
-name and URL of either the current buffer, or, with a prefix arg, of the
+name and @sc{url} of either the current buffer, or, with a prefix arg, of the
 link under point, and construct the appropriate <a...>...</a> markup and
 insert it into the desired buffer.
 @kindex M-tab
 @findex w3-insert-this-url
 @item M-tab
-Inserts the URL of the current document into another buffer.  Buffer is
+Inserts the @sc{url} of the current document into another buffer.  Buffer is
-prompted for in the minibuffer.  With prefix arg, uses the URL of the
+prompted for in the minibuffer.  With prefix arg, uses the @sc{url} of the
 link under point.
 @kindex U
 @findex w3-use-links
 @item U
 Selects one of the <LINK> tags from this document and fetch it.  Links
 * Session History::             Keeping a history of documents visited
 				in one Emacs sessions allows the use of
 				'forward' and 'back' buttons easily.
 * Global History::		Keeping a history of all the places ever
 				visited on the web.
-* Annotations::                 Annotations allow comments on other
-				people's Web documents without needing
-				to change the document.
 @end menu
 @end ifinfo
 @node Emulation, Hotlist Handling, Compatibility, Compatibility
 @section Emulation
 @cindex Browser emulation
 @findex turn-on-lynx-emulation
 @findex w3-netscape-emulation-minor-mode
 @findex w3-lynx-emulation-minor-mode
 @vindex w3-mode-hook
 :: WORK :: Document lynx emulation
+@table @key
+@item Down arrow
+Highlight next topic
+@item Up arrow
+Highlight previous topic
+@item Right arrow, Return, Enter
+Jump to highlighted topic
+@item Left arrow
+Return to previous topic
+@item +
+Scroll down to next page (Page-Down)
+@item -
+Scroll up to previous page (Page-Up)
+@item SPACE
+Scroll down to next page (Page-Down)
+@item b
+Scroll up to previous page (Page-Up)
+@item C-A
+Go to first page of the current document (Home)
+@item C-E
+Go to last page of the current document (End)
+@item C-B
+Scroll up to previous page (Page-Up)
+@item C-F
+Scroll down to next page (Page-Down)
+@item C-N
+Go forward two lines in the current document
+@item C-P
+Go back two lines in the current document
+@item )
+Go forward half a page in the current document
+@item (
+Go back half a page in the current document
+@item #
+Go to Toolbar or Banner in the current document
+@item ?, h
+Help (this screen)
+@item a
+Add the current link to a bookmark file
+@item c
+Send a comment to the document owner
+@item d
+Download the current link
+@item e
+Edit the current file
+@item g
+Goto a user specified @sc{url} or file
+@item i
+Show an index of documents
+@item j
+Execute a jump operation
+@item k
+Show a list of key mappings
+@item l
+List references (links) in current document
+@item m
+Return to main screen
+@item o
+Set your options
+@item p
+Print the current document
+@item q
+Quit
+@item /
+Search for a string within the current document
+@item s
+Enter a search string for an external search
+@item n
+Go to the next search string
+@item v
+View a bookmark file
+@item V
+Go to the Visited Links Page
+@item x
+Force submission of form or link with no-cache
+@item z
+Cancel transfer in progress
+@item [backspace]
+Go to the history Page
+@item =
+Show file and link info
+@item \
+Toggle document source/rendered view
+@item !
+Spawn your default shell
+@item *
+Toggle image_links mode on and off
+@item [
+Toggle pseudo_inlines mode on and off
+@item ]
+Send an @sc{http} @sc{head} request for the current doc or link
+@item C-R
+Reload current file and refresh the screen
+@item C-W
+Refresh the screen
+@item C-U
+Erase input line
+@item C-G
+Cancel input or transfer
+@item C-T
+Toggle trace mode on and off
+@item C-K
+Invoke the Cookie Jar Page
+@end table
 :: WORK :: Document netscape emulation
+Uh, turn this into pretty tables about what keys are emulated.
+@example
+(define-key w3-netscape-emulation-minor-mode-map "\M-s" 'w3-save-as)
+(define-key w3-netscape-emulation-minor-mode-map "\M-m" 'w3-mailto)
+(define-key w3-netscape-emulation-minor-mode-map "\M-n" 'make-frame)
+(define-key w3-netscape-emulation-minor-mode-map "\M-l" 'w3-fetch)
+(define-key w3-netscape-emulation-minor-mode-map "\M-o" 'w3-open-local)
+(define-key w3-netscape-emulation-minor-mode-map "\M-p" 'w3-print-this-url)
+(define-key w3-netscape-emulation-minor-mode-map "\M-q" 'w3-quit)
+(define-key w3-netscape-emulation-minor-mode-map "\M-f" 'w3-search-forward)
+(define-key w3-netscape-emulation-minor-mode-map "\M-g" 'w3-search-again)
+(define-key w3-netscape-emulation-minor-mode-map "\M-r" 'w3-reload-document)
+(define-key w3-netscape-emulation-minor-mode-map "\M-i" 'w3-load-delayed-images)
+(define-key w3-netscape-emulation-minor-mode-map "\M-a" 'w3-hotlist-add-document)
+(define-key w3-netscape-emulation-minor-mode-map "\M-b" 'w3-show-hotlist)
+(define-key w3-netscape-emulation-minor-mode-map "\M-h" 'w3-show-history-list)
+@end example
 @node Hotlist Handling, Session History, Emulation, Compatibility
 @section Hotlist Handling
 :: WORK :: Document that it supports different types of hotlist formats
 :: WORK :: Make sure everything hotlist related can be accessed via 'h'
 In order to avoid having to traverse many documents to get to the same
 document over and over, Emacs-W3 supports a ``hotlist'' like Mosaic.  This is
-a file that contains URLs and aliases.  Hotlists allow quick access to any
+a file that contains @sc{url}s and aliases.  Hotlists allow quick access to any
 document in the Web, providing it has been visited and added to the hotlist.
 The variable @code{w3-hotlist-file} determines where this information
 is saved.  The structure of the file is compatible with Mosaic's
 hotlist file, so this defaults to @file{~/.mosaic-hotlist-default}.
 @findex w3-hotlist-add-document
 @vindex w3-hotlist-file
 @item a
 Adds the current document to the hotlist, with the buffer name as its
 identifier.  Modifies the file specified by @code{w3-hotlist-file}.  If
-this is given a @var{prefix-argument} (via @kbd{C-u}), the title is
+this is given a prefix-argument (via @kbd{C-u}), the title is prompted
-prompted for instead of automatically defaulting to the
+for instead of automatically defaulting to the document title.
-document title.
 @findex w3-hotlist-refresh
 @vindex w3-hotlist-file
 @kindex hR
 @item hR
 @key{tab} key shows partial completions.
 @item hv
 @kindex hv
 @findex w3-show-hotlist
-Converts the hotlist into HTML and displays it.
+Converts the hotlist into @sc{html} and displays it.
 @item ha
 @kindex ha
 @findex w3-hotlist-apropos
 Shows the hotlist entries matching a regular expression.
 @item hA
 Appends another hotlist file to the one currently in memory.
 @end table
 @node Session History, Global History, Hotlist Handling, Compatibility
 @section History
 @cindex History Lists
-Almost all web browsers keep track of the URLs followed from a page, so
+Almost all web browsers keep track of the @sc{url}s followed from a page, so
 that it can provide @b{forward} and @b{back} buttons to keep a @i{path}
-of URLs that can be traversed easily.
+of @sc{url}s that can be traversed easily.
 @vindex url-keep-history
 If the variable @code{url-keep-history} is @code{t}, then Emacs-W3
-keeps a list of all the URLs visited in a session.
+keeps a list of all the @sc{url}s visited in a session.
 @findex w3-show-history
 To view a listing of the history for this session of Emacs-W3, use
 @code{M-x w3-show-history} from any buffer, and Emacs-W3 generates an
-HTML document showing every URL visited since Emacs started (or
+@sc{html} document showing every @sc{url} visited since Emacs started (or
 cleared the history list), and then format it.  Any of the links can
 be chosen and followed to the original document.  To clear the history
 list, choose 'Clear History' from the 'Options' menu.
 @findex w3-forward-in-history
 @findex w3-backward-in-history
 @findex w3-fetch
 Another twist on the history list mechanism is the fact that all
-Emacs-W3 buffers remember what URL, buffer, and buffer position of the
+Emacs-W3 buffers remember what @sc{url}, buffer, and buffer position of the
 last document, and also keeps track of the next location jumped @b{to}
 from that buffer.  This means that the user can go forwards and
 backwards very easily along the path taken to reach a particular
 document.  To go forward, use the function @code{w3-forward-in-history},
 to go backward, use the function @code{w3-backward-in-history}.
-@node Global History, Annotations, Session History, Compatibility
+@node Global History, , Session History, Compatibility
 @section Global History
 :: WORK :: Document that the global history can have diff. formats
-Most web browsers also support the idea of a ``history'' of URLs the
+Most web browsers also support the idea of a ``history'' of @sc{url}s the
 user has visited, and it displays them in a different style than normal
-URLs.
+@sc{url}s.
 @vindex url-keep-history
 @vindex url-global-history-file
 If the variable @code{url-keep-history} is @code{t}, then Emacs-W3
-keeps a list of all the URLs visited in a session.  The file is
+keeps a list of all the @sc{url}s visited in a session.  The file is
 automatically written to disk when exiting emacs.  The list is added to
 those already in the file specified by @code{url-global-history-file},
 which defaults to @file{~/.mosaic-global-history}.
-If any URL in the list is found in the file, it is not saved, but new
+If any @sc{url} in the list is found in the file, it is not saved, but new
 ones are added at the end of the file.
 The function that saves the global history list is smart enough to
 notice what style of history list is being used (Netscape, Emacs-W3, or
 XMosaic), and writes out the new additions appropriately.
 @cindex Completion of URLs
 @cindex Usefulness of global history
 One of the nice things about keeping a global history files is that Emacs-W3
 can use it as a completion table.  When doing @kbd{M-x w3-fetch}, pressing
 the @kbd{tab} or @kbd{space} key will show all completions for a
-partial URL.  This is very useful, especially for very long URLs that
+partial @sc{url}.  This is very useful, especially for very long @sc{url}s that
 are not in a hotlist, or for seeing all the pages from a particular web
 site before choosing which to retrieve.
-@node Annotations, Group Annotations, Global History, Compatibility
+@node Stylesheets, General Formatting, Top, Top
-@section Annotations
+@chapter Stylesheets
-@cindex Annotations
-Mosaic can @i{annotate} documents.  Annotations are comments about the
-current document, and these annotations appear as a link to the comments
-at the end of the document.  The original file is not changed.
-@ifinfo
-@menu
-* Group Annotations::             Annotations accessible by everyone
-* Personal Annotations::          Private annotations only accessible
-				  to the user who created them
-@end menu
-@end ifinfo
-@node Group Annotations, Personal Annotations, Annotations, Annotations
-@subsection Group Annotations
-@cindex Group Annotations
-@b{@i{NOTE}}: The group annotation experiment has been terminated.  It
-will be replaced with support on the server side for adding <LINK> tags
-to documents.
-@node Personal Annotations, , Group Annotations, Annotations
-@subsection Personal Annotations
-@cindex Personal Annotations
-@vindex w3-personal-annotation-directory
-Emacs-W3 looks in the directory specified by
-@code{w3-personal-annotation-directory} (defaults to
-@file{~/.mosaic-personal-annotations}).  Any personal annotations for a
-document are automatically appended when it is retrieved.
-:: WORK :: Document the new 'a' prefix keymap
-:: WORK :: Tell where the annotations are stored
-@findex w3-add-personal-annotation
-@vindex w3-annotation-mode
-To add a new personal annotation, type @kbd{M-x
-w3-add-personal-annotation}.  This creates a new buffer, in the mode
-specified by @code{w3-annotation-mode}.  This defaults to
-@code{html-mode}.  If this variable is @code{nil}, or it points to an
-undefined function, then @code{default-major-mode} is consulted.
-A minor mode redefines @kbd{C-c C-c} to complete the annotation and
-store it on the local disk.
-@findex w3-delete-personal-annotation
-To delete a personal annotation, it must be the current page.  Once
-reading the annotation, @kbd{M-x w3-delete-personal-annotation} will
-remove it.  This deletes the file containing the annotation, and any
-references to it in the annotation log file.
-Editing personal annotations is not yet supported.
-@node Controlling Formatting, General Formatting, Top, Top
-@chapter Controlling Formatting
 @cindex Customizing formatting
 @cindex Specifying Fonts
 @cindex Fonts
+@cindex Stylesheets
 @cindex Colors
 How Emacs-W3 formats a document is very customizable.  All control over
 formatting is now controlled by a default stylesheet set by the user
-with the @code{w3-default-sheet} variable.
+with the @code{w3-default-stylesheet} variable.
 The following sections describe in more detail how to change the
 formatting of a document.
 @ifinfo
 OS/2, etc.)
 * Inlined images::                     How to specify how Emacs-W3
 handles inlined images/mpegs.
 @end menu
 @end ifinfo
-@node General Formatting, Character based terminals, Controlling Formatting, Controlling Formatting
+@node General Formatting, Character based terminals, Stylesheets, Stylesheets
 @section General formatting conventions
 @iftex
 @heading Setting the fill column
 @end iftex
 @ifinfo
 @center Formatting of directory listings
 @center --------------------
 @end ifinfo
 @vindex url-use-hypertext-dired
 When Emacs-W3 encounters a link to a directory (whether by local file access
-or via FTP), it can either create an HTML document on the fly, or use
+or via @sc{ftp}), it can either create an @sc{html} document on the fly, or use
 @code{dired-mode} to peruse the listing.  The variable
 @code{url-use-hypertext-dired} controls this behavior.
 If the value is @code{t}, Emacs-W3 uses @code{directory-files} to list them
 out and transform the directory into a hypertext document, then pass it
 @end ifinfo
 @vindex w3-use-hypertext-gopher
 @cindex Gopher+
 @cindex ASK blocks
 There are two different ways of viewing gopher links.  The built-in
-support that converts gopher directories into HTML, or the
+support that converts gopher directories into @sc{html}, or the
 @file{gopher.el} package by Scott Snyder (@i{snyder@@fnald0.fnal.gov}).
 The variable that controls this is @code{w3-use-hypertext-gopher}.  If
 set to @code{nil}, then @file{gopher.el} is used.  Any other value
 causes Emacs-W3 to use its internal gopher support.  If using
 @file{gopher.el}, all the hypertext capabilities of Emacs-W3 are lost.
 @center --------------------
 @center Creating a horizontal rule
 @center --------------------
 @end ifinfo
 @vindex w3-horizontal-rule-char
-Horizontal rules (@b{<HR>} tags in HTML[+]) are used to separate chunks
+Horizontal rules (@b{<HR>} tags in @sc{html}[+]) are used to separate chunks
 of a document, and is meant to be rendered as a solid line across the
 page.  Some terminals display characters differently, so the variable
 @code{w3-horizontal-rule-char} controls which character is used to draw
 a horizontal bar.  This variable must be the ASCII value of the
 character, @b{not a string}.  The variable is passed through
 @code{make-string} whenever a horizontal rule of a certain width is
 necessary.
-@node Character based terminals, Graphics workstations, General Formatting, Controlling Formatting
+@node Character based terminals, Graphics workstations, General Formatting, Stylesheets
 @section On character based terminals
 @vindex w3-delimit-emphasis
 On character based terminals, there is no easy way to show that a
 certain range of text is in bold or italics.  If the variable
 @code{w3-delimit-emphasis} is non-@code{nil}, then Emacs-W3 can insert
-characters before and after character formatting commands in HTML
+characters before and after character formatting commands in @sc{html}
 documents.  The defaul value of @code{w3-delimit-emphasis} is
 automatically set based on the type of window system and version of
 Emacs being used.
 @vindex w3-header-chars-assoc
 @code{w3-header-chars-assoc} is an assoc list of header tags and a list
 of formatting instructions.  The @code{car} of the list is the level of
 the header (1--6).  The rest of the list should contain three items.
 The first item is text to insert before the header.  The second item is
 text to insert after the header.  Both should have reserved characters
-converted to their HTML[+] entity definitions.  The third item is a
+converted to their @sc{html}[+] entity definitions.  The third item is a
 function to call on the area the header is in.  This function is called
 with arguments specifying the start and ending character positions of
 the header.  The starting point is always first.  To convert a region to
 upper case, please use @code{w3-upcase-region} instead of
 @code{upcase-region}, so that entities are converted properly.
-@node Graphics workstations, Inlined images, Character based terminals, Controlling Formatting
+@node Graphics workstations, Inlined images, Character based terminals, Stylesheets
 @section With graphics workstations
 Starting with the first public release of version 2.3.0, all formatting
 is controlled by the use of stylesheets.
 :: WORK :: Graphic workstation stuff - redo for stylesheets
-@node Inlined images, , Graphics workstations, Controlling Formatting
+@node Inlined images, , Graphics workstations, Stylesheets
 @cindex Inlined images
 @cindex Images
 @cindex Movies
 @cindex Inlined MPEGs
 @cindex MPEGs
 To do this, the @b{netpbm utilities}@footnote{Available via anonymous
 ftp from ftp.x.org:/R5contrib/netpbm-1mar1994.tar.gz, and most large ftp
 sites.} programs are normally used.  This is a suite of freeware image
 conversion tools.  The variable @code{w3-graphic-converter-alist}
 controls how each image type is converted.  This is an assoc list, keyed
-on the MIME content-type.  The @code{car} is the content-type, and the
+on the @sc{mime} content-type.  The @code{car} is the content-type, and
-@code{cdr} is a string suitable to pass to @code{format}.  A %s in this
+the @code{cdr} is a string suitable to pass to @code{format}.  A %s in
-string will be replaced with a converter from the ppm image format to an
+this string will be replaced with a converter from the ppm image format
-XPixmap (or XBitmap, if being run on a monochrome display).  By default,
+to an XPixmap (or XBitmap, if being run on a monochrome display).  By
-the Emacs-W3 browser has converters for:
+default, the Emacs-W3 browser has converters for:
 @enumerate
 @item
 image/x-xbitmap
 @item
 @code{w3-load-delayed-images}.  Its counterpart for delayed movies is
 @code{w3-load-delayed-mpegs}
 @node MIME Support, Adding MIME types based on file extensions, , Top
 @chapter MIME Support
-MIME is an emerging standard for multimedia mail.  It offers a very
+@sc{mime} is an emerging standard for multimedia mail.  It offers a very
 flexible typing mechanism.  The type of a file or message is specified
 in two parts, separated by a '/'.  The first part is the general
 category of the data (text, application, image, etc.).  The second part
 is the specific type of data (postscript, gif, jpeg, etc.).  So
-@samp{text/html} specifies an HTML document, whereas
+@samp{text/html} specifies an @sc{html} document, whereas
 @samp{image/x-xwindowdump} specifies an image of an Xwindow taken with
 the @file{xwd} program.
-This typing allows much more flexibility in naming files.  HTTP/1.0
+This typing allows much more flexibility in naming files.  @sc{http}/1.0
 servers can now send back content-type headers in response to a request,
-and not have the client second-guess it based on file extensions.  HTML
+and not have the client second-guess it based on file extensions.  @sc{html}
 files can now be named @file{something.gif} (not a great idea, but
 possible).
 @ifinfo
 @menu
 @node Adding MIME types based on file extensions, Specifying Viewers, MIME Support, MIME Support
 @section Adding MIME types based on file extensions
 @vindex mm-mime-extensions
 For some protocols however, it is still necessary to guess the content
 of a file based on the file extension.  This type of guess-work should
-only be needed when accessing files via FTP, local file access, or old
+only be needed when accessing files via @sc{ftp}, local file access, or old
-HTTP/0.9 servers.
+@sc{http}/0.9 servers.
 Instead of specifying how to view things twice, once based on
 content-type and once based on the file extension, it is easier to map
 file extensions to MIME content-types.  The variable that controls this
 is @code{mm-mime-extensions}.
 files.  If a content-type is defined for the document, then this is
 over-ridden.  Regular expressions can @b{NOT} be used.
 @cindex mime-types file
 @findex mm-parse-mimetypes
-Both Mosaic and the NCSA HTTP daemon rely on a separate file for mapping
+Both Mosaic and the NCSA @sc{http} daemon rely on a separate file for mapping
 file extensions to MIME types.  Instead of having the users of Emacs-W3
 duplicate this in lisp, this file can be parsed using the
 @code{url-parse-mimetypes} function.  This function is called each time
 w3 is loaded.  It tries to locate mimetype files in several places. If
 the environment variable @code{MIMETYPES} is nonempty, then this is
 @file{/usr/local/etc/mime-types}
 @item
 @file{/usr/local/www/conf/mime-types}
 @end enumerate
-Each line contains information for one http type.  These types resemble
+Each line contains information for one @sc{http} type.  These types resemble
 MIME types.  To add new ones, use subtypes beginning with x-, such as
 application/x-myprogram.  Lines beginning with # are comment lines, and
 suitably ignored.  Each line consists of:
 type/subtype ext1 ext2 ...  ext@var{n}
 of space-separated filename extensions which correspond to the MIME
 type.
 @node Specifying Viewers, ,Adding MIME types based on file extensions, MIME Support
 @section Specifying Viewers
-Not all files look as they should when parsed as an HTML document
+Not all files look as they should when parsed as an @sc{html} document
 (whitespace is stripped, paragraphs are reformatted, and lots of little
 changes that make the document look unrecognizable).  Files may be
 passed to external programs or Emacs Lisp functions to be viewed.
 Not all files can be viewed accurately from within an Emacs session (GIF
 @findex mm-add-mailcap-entry
 As an alternative, the function @code{mm-add-mailcap-entry} can also be
 used from an appropriate hook.@xref{Hooks}  This functions takes three
 arguments, the major type ("@i{image}"), the minor type ("@i{gif}"), and
-an assoc list of information about the viewer.  Please see the URL
+an assoc list of information about the viewer.  Please see the @sc{url}
 documentation for more specific information on what this assoc list
 should look like.
 @node Security, Non-Unix Operating Systems, , Top
 @chapter Security
 @cindex Gag Puke Retch
 @cindex Exportability
 @cindex Export Restrictions
 SSL is the @code{Secure Sockets Layer} interface developed by Netscape
 Communications @footnote{http://www.netscape.com/}.  Emacs-W3 supports
-HTTP transfers over an SSL encrypted channel, if the appropriate files
+@sc{http} transfers over an SSL encrypted channel, if the appropriate files
 have been installed.@xref{Installing SSL}
-@item PGP/PEM
-@cindex HTTP/1.0 Authentication
-@cindex Public Key Cryptography
-@cindex Authentication, PGP
-@cindex Authentication, PEM
-@cindex RIPEM
-@cindex Public Key Cryptography
-@cindex PGP
-@cindex Pretty Good Privacy
-@cindex Encryption
-@cindex Security
-@cindex ITAR must die
-@cindex Stupid export restrictions
-@cindex Support your local crypto-anarchist
-@cindex NSA freaks
-A few servers still support this method of authentication, but it has
-been superseded by SSL and Secure-HTTP.@xref{Using PGP/PEM}
 @end table
 @node Non-Unix Operating Systems, VMS, Security, Top
 @chapter Non-Unix Operating Systems
 @cindex Non-Unix Operating Systems
 @ifinfo
 @menu
 * VMS::                 The wonderful world of VAX|AXP-VMS!
 * OS/2::                The next-best thing to Unix.
 * MS-DOS::              The wonderful world of MS-DOG!
-* 32-Bit Windows::      Windows NT, Chicago/Windows 95.
+* Windows::             Windows NT, Chicago/Windows 95.
-* Amiga::               The Amiga, for those who still love them.
 @end menu
 @end ifinfo
 @node VMS, OS/2, Non-Unix Operating Systems, Non-Unix Operating Systems
 @section VMS
 @section OS/2
 @cindex OS/2
 @cindex Warp
 :: WORK :: OS/2 Specific instructions
-@node MS-DOS, 32-Bit Windows, OS/2, Non-Unix Operating Systems
+@node MS-DOS, Windows, OS/2, Non-Unix Operating Systems
 @section MS-DOS
 @cindex MS-DOS
 @cindex Microsloth
 @cindex DOS
 @cindex MS-DOG
 :: WORK :: DOS Specific instructions
-@node 32-Bit Windows, Amiga, MS-DOS, Non-Unix Operating Systems
+@node Windows, Speech Integration , MS-DOS, Non-Unix Operating Systems
-@section 32-Bit Windows
+@section Windows
 @cindex Windows (32-Bit)
 @cindex 32-Bit Windows
 @cindex Microsloth
 @cindex Windows '95
 :: WORK :: 32bit Windows Specific instructions
-@node Amiga, Advanced Features, 32-Bit Windows, Non-Unix Operating Systems
+@node Speech Integration, Advanced Features, Windows, Top
-@section Amiga
+@chapter Speech Integration
-@cindex Amiga
+:: WORK :: Emacspeak integration
-@cindex Commodore
-:: WORK :: Amiga specific instructions
+@node Advanced Features, Style Sheets, Speech Integration, Top
-@node Advanced Features, Style Sheets, Amiga, Top
 @chapter Advanced Features
 @ifinfo
 @menu
 * Style Sheets::        Formatting control, the right way
 * Disk Caching::        Improving performance by using a local disk cache
 * Interfacing to Mail/News::	How to make VM understand hypertext links
 * Debugging HTML::      How to make Emacs-W3 display warnings about invalid
-HTML/HTML+ constructs.
+@sc{html}/@sc{html}+ constructs.
 * Native WAIS Support:: How to make Emacs-W3 understand WAIS links without
 using a gateway.
 * Rating Links::        How to make Emacs-W3 put an 'interestingness' value
 next to each link.
 * Gopher Plus Support:: How Emacs-W3 makes use of the Gopher+ protocol.
 @cindex <style>
 To include a stylesheet into a document, simply use the <style> tag.
 Use the @b{notation} attribute to specify what language the stylesheet
 is specified in.  The default is @b{css}.  The data between the <style>
-and </style> tags is the stylsheet proper - no HTML parsing is done to
+and </style> tags is the stylsheet proper - no @sc{html} parsing is done to
 this data - it is treated similar to an <XMP> section of text.  To
 reference an external stylesheet, use the <link> tag.
 @example
 <link rel="stylesheet" href="/bill.style">
 @end example
-If these two mechanisms are mixed, then the URL is resolved first, and
+If these two mechanisms are mixed, then the @sc{url} is resolved first, and
 the contents of the <style> tag take precedence if there are any
 conflicting directives.
 @cindex DSSSL
 @cindex DSSSL-lite
 @cindex Caching options
 @cindex Alternate caching method
 Emacs-W3 caches files under the temporary directory specified by
 @code{url-temporary-directory}, in a user-specific subdirectory
 (determined by the @code{user-real-login-name} function).  The cache
-files are stored under their original names, so a URL like:
+files are stored under their original names, so a @sc{url} like:
 http://www.aventail.com/foo/bar/baz.html would be stored in a cache file
 named: /tmp/wmperry/com/aventail/www/foo/bar/baz.html.  Sometimes,
 espcially with gopher links, there will be name conflicts, and an error
 will be signalled.  This cannot be avoided, and still have reasonable
 performance at startup time (reading in an index file of all the cached
 @cindex Using Emacs-W3 with VM
 @cindex GNUS
 @cindex Using Emacs-W3 with Gnus
 @cindex RMAIL
 @cindex Using Emacs-W3 with RMAIL
-More and more people are including URLs in their signatures, and within
+More and more people are including @sc{url}s in their signatures, and within
 the body of mail messages.  It can get quite tedious to type these into
 the minibuffer to follow one.
 @vindex browse-url-browser-function
 With the latest versions of VM (the 5.9x series of betas) and Gnus
-(5.x), URLs are automatically highlighted, and can be followed with the
+(5.x), @sc{url}s are automatically highlighted, and can be followed with the
-mouse or the return key.  How the URLs are viewed is determined by the
+mouse or the return key.  How the @sc{url}s are viewed is determined by the
 variable @code{browse-url-browser-function}, and it should be set to the
 symbol @code{browse-url-w3}.
-To access URLs from within RMAIL, the following hook should do the
+To access @sc{url}s from within RMAIL, the following hook should do the
 trick.
 @example
 (add-hook 'rmail-mode-hook
 	  (function
 	   (lambda ()
 @cindex Invalid HTML
 @cindex Bad HTML
 @vindex w3-debug-buffer
 @vindex w3-debug-html
 For those people that are adventurous, or are just as anal as I am about
-people writing valid HTML, set the variable @code{w3-debug-html} to
+people writing valid @sc{html}, set the variable @code{w3-debug-html} to
 @code{t} and see what happens.
-If a Emacs-W3 thinks it has encountered invalid HTML, then a debugging
+If a Emacs-W3 thinks it has encountered invalid @sc{html}, then a debugging
 message is displayed.
 :: WORK :: Need to list the different values w3-debug-html can have, and
 :: WORK :: what they do ::
 @vindex url-wais-gateway-port
 The variable @code{url-waisq-prog} must point to this executable, and
 one of @code{url-wais-gateway-server} or @code{url-wais-gateway-port}
 should be @code{nil}.
-When a WAIS URL is encountered, a form will be automatically generated
+When a WAIS @sc{url} is encountered, a form will be automatically generated
 and displayed.  After typing in the search term, the query will be sent
 to the server by running the @code{url-waisq-prog} in a subprocess.  The
-results will be converted into HTML and displayed.
+results will be converted into @sc{html} and displayed.
 @node Rating Links, Gopher Plus Support, Native WAIS Support, Advanced Features
 @section Rating Links
-The @code{w3-link-info-display-function} variable can be used to 'rate' a URL
+The @code{w3-link-info-display-function} variable can be used to 'rate' a @sc{url}
-when it shows up in an HTML page.  If non-@code{nil}, then this should
+when it shows up in an @sc{html} page.  If non-@code{nil}, then this should
 be a list specifying (or a symbol specifying the name) of a function.
-This function should expect one argument, a fully specified URL, and
+This function should expect one argument, a fully specified @sc{url}, and
 should return a string.  This string is inserted after the link
 text.
 If a user has decided that all links served from blort.com are too laden
 with images, and wants to be warned that a link points at this host,
 @node Gopher Plus Support, Hooks, Rating Links, Advanced Features
 @section Gopher+ Support
 @cindex Gopher+
 The gopher+ support in Emacs-W3 is limited to the conversion of ASK
-blocks into HTML 3.0 forms, and the usage of the content-length given by
+blocks into @sc{html} 3.0 forms, and the usage of the content-length given by
 the gopher+ server to give a nice status bar on the bottom of the
 screen.
 This will hopefully be extended to include the Gopher+ method of
 content-type negotiation, but this may be a while.
 of functions) that are called consecutively.
 @table @code
 @vindex w3-load-hooks
 @item w3-load-hooks
-These hooks are run by @code{w3-do-setup} the first time a URL is
+These hooks are run by @code{w3-do-setup} the first time a @sc{url} is
 fetched.  All the w3 variables are initialized before this hook is
 run.
 @item w3-file-done-hooks
 These hooks are run by @code{w3-prepare-buffer} after all parsing on a
 document has been done.  All @code{url-current-}@var{*} and
 @code{w3-current-}@var{*} variables are initialized when this hook is run.
 This is run before the buffer is shown, and before any inlined images
 are downloaded and converted.
 @item w3-file-prepare-hooks
 These hooks are run by @code{w3-prepare-buffer} before any parsing is
-done on the HTML file.  The HTTP/1.0 headers specified by
+done on the @sc{html} file.  The @sc{http}/1.0 headers specified by
-@code{w3-show-headers} have been inserted, the syntax table has been set
+@code{w3-show-headers} have been inserted, and the syntax table has been
-to @code{w3-parse-args-syntax-table}, and any personal annotations have
+set to @code{w3-parse-args-syntax-table} by the time this hook is run.
-been inserted by the time this hook is run.
 @item w3-mode-hooks
 These hooks are run after a buffer has been parsed and displayed, but
 before any inlined images are downloaded and converted.
 @item w3-source-file-hooks
 These hooks are run after displaying a document's source
 @table @code
 @item url-bad-port-list
 @vindex url-bad-port-list
 List of ports to warn the user about connecting to.  Defaults to just
-the mail and NNTP ports so a malicious HTML author cannot spoof mail or
+the mail and @sc{nntp} ports so a malicious @sc{html} author cannot spoof mail or
 news to other people.
 @item url-confirmation-func
 @vindex url-confirmation-func
 What function to use for asking yes or no functions.  Possible values
 are @code{'yes-or-no-p} or @code{'y-or-n-p}, or any function that takes
 @code{yes} means assume the user wants to always reuse the buffer.  A
 value of @code{no} means assume the user always wants to re-fetch the
 document.
 @item w3-show-headers
 @vindex w3-show-headers
-This is a list of HTTP/1.0 headers to show at the end of a buffer.  All
+This is a list of @sc{http}/1.0 headers to show at the end of a buffer.  All
 the headers should be in lowercase.  They are inserted at the end of the
 buffer in a <UL> list.  Alternatively, if this is simply @code{t}, then
-all the HTTP/1.0 headers are shown.  The default value is
+all the @sc{http}/1.0 headers are shown.  The default value is
 @code{nil}.
 @item w3-show-status, url-show-status
 @vindex url-show-status
 @vindex w3-show-status
 Whether to show progress messages in the minibuffer.
 binary, x-compress, x-hqx, and quoted-printable.
 @item url-uncompressor-alist
 @vindex url-uncompressor-alist
 An assoc list of file extensions and the appropriate uncompression
 programs for each.  This is used to build the Accept-encoding header for
-HTTP/1.0 requests.
+@sc{http}/1.0 requests.
 @item url-waisq-prog
 @vindex url-waisq-prog
 Name of the waisq executable on this system.  This should be the
 @file{waisq} program from think.com's wais8-b5.1 distribution.
 @end table
 @appendix Reporting Bugs
 @cindex Reporting Bugs
 @cindex Bugs
 @cindex Contacting the author
-:: WORK :: Reporting bugs needs work.
+If any bugs are discovered in Emacs-W3, please report them to the
+mailing list @t{w3-beta@@indiana.edu} - this is where the brave souls
-@node Installing SSL, Using PGP/PEM, Reporting Bugs, Top
+who beta test the latest versions of Emacs-W3 reside, and are generally
+very responsive to bug reports.
+@kindex w
+Please make sure to use the bug submission feature of Emacs-W3, so that
+all relevant information will be sent along with your bug report.  By
+default this is bound to the `@key{w}' key when in an Emacs-W3 buffer,
+or you can use @key{M-x w3-submit-bug} from anywhere within Emacs.
+For problems that are causing emacs to signal and error, please send a
+backtrace.  You can get a backtrace by @kbd{M-x setvariable RET
+debug-on-error RET t RET}, and then reproduce the error.
+If the problem is visual, please capture a copy of the output and mail
+it along with the bug report (preferably as a MIME attachment, but
+anything will do).  You can use the @code{xwd} program under X-windows
+for this, or @key{Alt-PrintScreen} under Windows 95/NT.  Sorry, but I
+don't remember what the magic incarnation is for doing a screen dump
+under NeXTstep or OS/2.
+If the problem is actually causing Emacs to crash, then you will need to
+also mail the maintainers of the various Emacs distributions with the
+bug.  Please use the @t{gnu.emacs.bug} newgroup for reporting bugs with
+GNU Emacs 19, and @t{comp.emacs.xemacs} for reporting bugs with XEmacs
+19 or XEmacs 20.  I am actively involved with the beta testing of the
+latest versions of both branches of Emacs, and if I can reproduce the
+problem, I will do my best to see it gets fixed in the next release.
+It is also important to always maintain as much context as possible in
+your responses.  I get so much email from my various Emacs-activities
+and work, that I cannot remember everything.  If you send a bug report,
+and I send you a reply, and you reply with 'no that didn't work', then
+odds are I will have no clue what didn't work, much less what that was
+trying to fix in the first place.  It will be much quicker and less
+painful if I don't have to waste a round-trip email exchange saying
+'what are you talking about'.
+@node Installing SSL, Mailcap Files, Reporting Bugs, Top
 @appendix Installing SSL
 @cindex HTTP/1.0 Authentication
 @cindex Secure Sockets Layer
 @cindex SSL
 @cindex Gag Puke Retch
 This should be all the configuration necessary.  In the future, I will
 be distributing a set of patches to Emacs 19.xx and XEmacs 19.xx to
 SSL-enable them, for the sake of speed.
-@node Using PGP/PEM, Mailcap Files, Installing SSL, Top
+@node Mailcap Files, General Index, Installing SSL, Top
-@appendix Using PGP/PEM
-@cindex HTTP/1.0 Authentication
-@cindex Public Key Cryptography
-@cindex Authentication, PGP
-@cindex Authentication, PEM
-@cindex RIPEM
-@cindex Public Key Cryptography
-@cindex PGP
-@cindex Pretty Good Privacy
-@cindex Encryption
-@cindex Security
-@cindex ITAR must die
-@cindex Stupid export restrictions
-@cindex Support your local crypto-anarchist
-@cindex NSA freaks
-Most of this chapter has been reproduced from the original documentation
-written by Rob McCool (@i{robm@@netscape.com})@footnote{See
-http://hoohoo.ncsa.uiuc.edu/docs/PEMPGP.html for the original}.
-RIPEM is 'Riordan's Internet Privacy Enhanced Mail', and is currently on
-version 1.2b3.  US citizens can ftp it from
-ftp://ripem.msu.edu/pub/crypt/ripem.
-PGP is 'Pretty Good Privacy', and is currently on version 2.6.  The
-legal controversies that plagued earlier versions have been resolved, so
-this is a competely legal program now.  There is also a legal version
-for european users, called 2.6ui (the Unofficial International
-version).
-PGP and PEM are programs that allow two parties to communicate in a way
-which does not allow third parties to read them, and which certify that
-the person who sent the message is really who they claim they are.
-PGP and PEM both use RSA encryption.  The U.S.  government has strict
-export controls over foreign use of this technology, so people outside
-the U.S.  may have a difficult time finding programs which perform the
-encryption.
-A working copy of either Pretty Good Privacy or RIPEM is required.  You
-should be familiar with the program and have generated a public/private
-key pair.
-Currently, the protocol has been implemented with PEM and PGP using
-local key files on the server side, and on the client side with PEM
-using finger to retrieve the server's public key.
-Parties who wish to use Emacs-W3 with PEM or PGP encryption will need to
-communicate beforehand and find a tamper-proof way to exchange their
-public keys.
-Pioneers get shot full of arrows.  This work is currently in the
-experimental stages and thus may have some problems that I have
-overlooked.  The only known problem that I know about is that the
-messages are currently not timestamped.  This means that a malicious
-user could record the encrypted message with a packet sniffer and repeat
-it back to the server ad nauseum.  Although they would not be able to
-read the reply, if the request was for something being charged for, this
-could be very inconvenient.
-This protocol is almost word-for-word a copy of Tony Sander's RIPEM
-based scheme, generalized a little.  Below, wherever PEM is used,
-replace it with PGP, and the behaviour should remain the same.
-@example
-*Client:*
-GET /docs/protected.html HTTP/1.0
-UserAgent: Emacs-W3/2.1.x
-*Server:*
-HTTP/1.0 401 Unauthorized
-WWW-Authenticate: PEM entity="webmaster@@hoohoo.ncsa.uiuc.edu"
-Server: NCSA/1.1
-*Client:*
-GET / HTTP/1.0
-Authorization: PEM entity="robm@@ncsa.uiuc.edu"
-Content-type: application/x-www-pem-request
---- BEGIN PRIVACY-ENHANCED MESSAGE ---
-this is the real request, encrypted
---- END PRIVACY-ENHANCED MESSAGE ---
-*Server:*
-HTTP/1.0 200 OK
-Content-type: application/x-www-pem-reply
---- BEGIN PRIVACY-ENHANCED MESSAGE ---
-this is the real reply, encrypted
---- END PRIVACY-ENHANCED MESSAGE ---
-That's it.
-@end example
-@cindex Mailcrypt
-Emacs-W3 uses the excellent @i{mailcrypt}@footnote{Available from
-http://www.cs.indiana.edu/LCD/cover.html?mailcrypt} package written by
-Jin S Choi (@i{jsc@@mit.edu}).  This package takes care of calling ripem
-and/or pgp with the correct arguments.  Please see the documentation at
-the top of mailcrypt.el for instructions on using mailcrypt.  All bug
-reports about mailcrypt should go to Jin S Choi, but bugs about how I
-use it in Emacs-W3 should of course be directed to me.
-@node Mailcap Files, General Index, Using PGP/PEM, Top
 @appendix Mailcap Files
 NCSA Mosaic and almost all other WWW browsers rely on a separate file
 for mapping MIME types to external viewing programs.  This takes some of
 the burden off of browser developers, so each browser does not have to
 support all image formats, or postscript, etc.  Instead of having the
 @node Key Index, , General Index, Top
 @appendix Key Index
 @printindex ky
 @contents
 @bye
+@c @ifinfo
+@c Here is some more specific information about what languages and
+@c protocols Emacs-W3 supports.
+@c @menu
+@c * Markup Languages Supported::	Markup languages supported by Emacs-W3
+@c * Stylesheets::                 Stylesheet languages supported by Emacs-W3
+@c * Supported Protocols::		Network protocols supported by Emacs-W3
+@c @end menu
+@c @end ifinfo
+@c @node Markup Languages Supported, Stylesheets, Introduction, Introduction
+@c @chapter Supported Markup Languages
+@c Several different markup languages, and various extensions to those
+@c languages, are supported by Emacs-W3.
+@c @ifinfo
+@c @center ----------
+@c @center HTML 2.0
+@c @center ----------
+@c @end ifinfo
+@c @iftex
+@c @section HTML 2.0
+@c @end iftex
+@c @cindex HTML 2.0
+@c :: WORK :: Reference to the HTML 2.0 RFC
+@c :: WORK :: Basic explanation of HTML, tag structure, etc.
+@c @ifinfo
+@c @center ----------
+@c @center HTML 3.2
+@c @center ----------
+@c @end ifinfo
+@c @iftex
+@c @section HTML 3.2
+@c @end iftex
+@c @cindex HTML 3.2
+@c The HTML 3.2 language is an extension of HTML, with a large degree of
+@c backward compatibility with HTML 2.0.  This basically documents current
+@c practice as of January, 1996.
+@c @ifinfo
+@c @center ----------
+@c @center SGML Features
+@c @center ----------
+@c @end ifinfo
+@c @iftex
+@c @section SGML Features
+@c @end iftex
+@c @cindex SGML Features
+@c @cindex Entity Definitions
+@c @cindex Marked Sections
+@c :: WORK :: Document marked sections, SGML features
+@c @ifinfo
+@c @center ----------
+@c @center Extras
+@c @center ----------
+@c @end ifinfo
+@c @iftex
+@c @section Extra Markup
+@c @end iftex
+@c @cindex Easter Eggs
+@c @cindex Fluff
+@c @cindex Pomp & Circumstance
+@c There are several different markup elements that are not officially part
+@c of HTML or HTML 3.2 that Emacs-W3 supports.  These are either items that
+@c were dropped from HTML 3.@var{x} after I had implemented them, things I
+@c find just completely hilarious, or experimental parts of HTML that
+@c should not be counted as "official" or long lived.
+@c @itemize @bullet
+@c @item
+@c FLAME support.  For truly interesting dynamic documents.  This is
+@c replaced with a random quote from Mr. Angry (see @kbd{M-x flame} for a
+@c sample).
+@c @item
+@c The top ten tags that did not make it into netscape.  These tags were
+@c posted to the newsgroup comp.infosystems.www.misc by Laura Lemay
+@c (@i{lemay@@netcom.com}).  Much thanks to her for the humor.
+@c @table @b
+@c @item <wired>...</wired>
+@c Renders the enclosed text in a suitably ugly font/color combination.  If
+@c no default has been set up by the user, this is the default font, with
+@c red text on a yellow background.
+@c @item <roach>...</roach>
+@c When selected, the enclosed text runs and hides under the nearest
+@c window.  OR, giggles a lot and demands nachos, depending on the
+@c definition of "roach." (the formal definition, of course, to be
+@c determined by the Official Honorary Internet Standards Committee For
+@c Moving Really Slowly.)
+@c @item <pinhead>
+@c Inserts "zippyisms" into the enclosed text.  Perfect for those professional
+@c documents.  This is sure to be a favorite of mine!
+@c @item <secret>...</secret>
+@c Must use secret spy decoder glasses (available direct from Netscape for
+@c a reasonable fee) in order to read the enclosed text.  Can also be read
+@c by holding the computer in front of a full moon during the autumn
+@c solstice.
+@c In Emacs-W3, this displays the text using rot13 encoding.
+@c @item <hype>
+@c Causes Marc Andreesen to magically appear and grant an interview (wanted
+@c or not).  Please use this tag sparingly.
+@c @item <peek>....</peek>
+@c @item <poke>...</poke>
+@c Need more control over screen layout in HTML?  Well, here ya go.
+@c n
+@c Actually, <peek> could almost be considered useful.  The VARIABLE
+@c attribute can be used to insert the value of an emacs variable into the
+@c current document.  Things like 'Welcome to my page, <peek
+@c variable=user-mail-address>' can be useful in spreading fear,
+@c uncertainty, and doubt among users.
+@c @item <yogsothoth>
+@c @cindex Gates Bill
+@c @cindex Yogsothoth
+@c Summons the elder gods to suck away your immortal soul.  Or Bill Gates,
+@c if the elder gods are busy.  Unpredictable (but amusing) results occur
+@c when the <YOGSOTHOTH> and <HYPE> tags are used in close proximity.
+@c @item <blink>...</blink>
+@c Causes the enclosed text to .... ooops that one made it in.
+@c @end table
+@c @end itemize
+@c @node Stylesheets, Supported Protocols, Markup Languages Supported,Introduction
+@c @chapter Stylesheets
+@c @cindex Stylesheets
+@c @cindex Cascading Style Sheets
+@c @cindex Aural Cascading Style Sheets
+@c @cindex CSS
+@c @cindex DSSSL
+@c :: WORK :: Document CSS support
+@c CSS Information at http://www.w3.org/pub/WWW/TR/REC-CSS1
+@c Style guide at http://www.htmlhelp.com/reference/css/
+@c :: WORK :: Document ACSS support
+@c ACSS Information at http://www.w3.org/pub/WWW/Style/CSS/Speech/NOTE-ACSS
+@c :: WORK :: Document DSSSL support
+@c @node Supported Protocols, , Stylesheets, Introduction
+@c @chapter Supported Protocols
+@c @cindex Network Protocols
+@c @cindex Protocols Supported
+@c @cindex Supported Protocols
+@c Emacs-W3 supports the following protocols
+@c @table @b
+@c @item Usenet News
+@c Can either display an entire newsgroup or specific articles by
+@c Message-ID: header.  Instead of rewriting a newsreader, this integrates
+@c with the Gnus newsreader.  It requires at least Gnus 5.0, but it is
+@c always safest to use the latest version.  Gnus supports some very
+@c advanced features, including virtual newsgroups, mail and news
+@c integration, and reading news from multiple servers.  @inforef{Gnus,
+@c Top,gnus}, for more info.
+@c To be more in line with the other @sc{url} schemes, the hostname and port of
+@c an @sc{nntp} server can be specified.  @sc{url}s of the form
+@c news://hostname:port/messageID work, but might not work in some other
+@c browsers.
+@c @item @sc{http}
+@c Supports the @sc{http}/0.9, @sc{http}/1.0, and parts of the @sc{http}/1.1 protocols.
+@c @item Gopher
+@c Support for all gopher types, including CSO queries.
+@c @item Gopher+
+@c Support for Gopher+ retrievals. Support for converting ASK blocks into
+@c HTML forms and submitting them back to the server.
+@c @item @sc{ftp}
+@c @sc{ftp} is handled by either ange-ftp or efs.
+@c @inforef{Ange-FTP,Top,ange-ftp}, for more information on Ange-FTP, or
+@c @inforef{EFS, Top,efs}, for information on EFS.
+@c @item Local files
+@c Local files are of course handled, and MIME content-types are derived
+@c from the file extensions.
+@c @item telnet, tn3270, rlogin
+@c Telnet, tn3270, and rogin are handled by running the appropriate program
+@c in an emacs buffer, or running an external process.
+@c @item mailto
+@c Causes a mail message to be started to a specific address.  Supports the
+@c Netscape @i{extensions} to specify arbitrary headers on the message.
+@c @item data
+@c A quick and easy way to `inline' small pieces of information that you do
+@c not necessarily want to download over the net separately.  Can speed up
+@c display of small icons, stylesheet information, etc.  See the internet
+@c draft draft-masinter-url-data-02.txt for more information.
+@c @item mailserver
+@c A more powerful version of mailto, which allows the author to specify
+@c the subject and body text of the mail message.  This type of link is
+@c never fully executed without user confirmation, because it is possible
+@c to insert insulting or threatening (and possibly illegal) data into the
+@c message.  The mail message is displayed, and the user must confirm the
+@c message before it is sent.
+@c @item x-exec
+@c A @sc{url} can cause a local executable to be run, and its output interpreted
+@c as if it had come from an @sc{http} server.  This is very useful, but is
+@c still an experimental protocol, hence the X- prefix.  This @sc{url} protocol
+@c is deprecated, but might be useful in the future.
+@c @item @sc{nfs}
+@c Retrieves information over @sc{nfs}.  This requires that your operating
+@c system support auto-mounting of @sc{nfs} volumes.
+@c @item finger
+@c Retrieves information about a user via the 'finger' protocol.
+@c @item Info
+@c Creates a link to an GNU-style info file.  @inforef{Info,Top,info}, for more
+@c information on the Info format.
+@c @item SSL
+@c SSL requires a set of patches to the Emacs C code and SSLRef 2.0, or an
+@c external program to run in a subprocess (similar to the @file{tcp.el}
+@c package that comes with GNUS.  @xref{Installing SSL}
+@c @end table

Mercurial > hg > xemacs-beta

comparison man/w3.texi @ 20:859a2309aef8 r19-15b93