xemacs-beta: man/xemacs-faq.texi comparison

comparison man/xemacs-faq.texi @ 274:ca9a9ec9c1c1 r21-0b35

Import from CVS: tag r21-0b35

author	cvs
date	Mon, 13 Aug 2007 10:29:42 +0200
parents	c5d627a313b1
children	6330739388db

comparison

equal deleted inserted replaced

-:411aac7253ef
+:ca9a9ec9c1c1
 @c %**start of header
 @setfilename xemacs-faq.info
 @settitle Frequently asked questions about XEmacs
 @setchapternewpage off
 @c %**end of header
+@finalout
 @titlepage
 @title XEmacs FAQ
 @subtitle Frequently asked questions about XEmacs
-@subtitle Last Modified: 1997-12-04 02:05:05 EET
+@subtitle Last Modified: $Date: 1998/04/07 05:39:30 $
 @sp 1
 @author Tony Rossini <arossini@@stat.sc.edu>
 @author Ben Wing <wing@@666.com>
 @author Chuck Thompson <cthomp@@xemacs.org>
 @author Steve Baur <steve@@xemacs.org>
 @author Andreas Kaempf <andreas@@sccon.com>
+@author Christian Nyb@o{} <chr@@mediascience.no>
 @page
 @end titlepage
 @node Top, Introduction, (dir), (dir)
 @top XEmacs FAQ
 FAQ is distributed in the hope that it will be useful, but WITHOUT ANY
 WARRANTY; without even the implied warranty of MERCHANTABILITY or
 FITNESS FOR A PARTICULAR PURPOSE.
 If you have a Web browser, the official hypertext version is at
-<URL:http://www.sccon.com/~andreas/xemacs-faq.html> and also at
+@iftex
-<URL:http://www.xemacs.org/faq/xemacs-faq.html>.  This version is much
+@*
-nicer than the unofficial hypertext versions that are archived at
+@end iftex
-Utrecht, Oxford, Smart Pages, and other FAQ archives.
+@uref{http://www.xemacs.org/faq/xemacs-faq.html}.
+This version is somewhat nicer than the unofficial hypertext versions
+that are archived at Utrecht, Oxford, Smart Pages, and other FAQ
+archives.
 @menu
 * Introduction::        Introduction, Policy, Credits.
 * Installation::        Installation and Trouble Shooting.
 * Customization::       Customization and Options.
 * Q1.0.1::      What is XEmacs?
 * Q1.0.2::      What is the current version of XEmacs?
 * Q1.0.3::      Where can I find it?
 * Q1.0.4::      Why Another Version of Emacs?
 * Q1.0.5::      Why Haven't XEmacs and GNU Emacs Merged?
 * Q1.0.6::      Where can I get help?
 * Q1.0.7::      Where is the mailing list archived?
 * Q1.0.8::      How do you pronounce XEmacs?
 * Q1.0.9::      What does XEmacs look like?
 * Q1.0.10::     Is there a port of XEmacs to Microsoft ('95 or NT)?
 * Q1.0.11::     Is there a port of XEmacs to the Macintosh?
 * Q1.0.12::     Is there a port of XEmacs to NextStep?
 * Q1.0.13::     Is there a port of XEmacs to OS/2?
 * Q1.0.14::     Where can I get a printed copy of the XEmacs users manual?
 * Q1.1.2::      How do I become a Beta Tester?
 * Q1.1.3::      How do I contribute to XEmacs itself?
 Credits:
 * Q1.2.1::      Who wrote XEmacs?
 * Q1.2.2::      Who contributed to this version of the FAQ?
 * Q1.2.3::      Who contributed to the FAQ in the past?
 Internationalization:
 * Q1.3.1::      What is the status of XEmacs v20?
 * Q1.3.2::      What is the status of Asian-language support, aka @var{mule}?
 * Q1.3.3::      How do I type non-ASCII characters?
 * Q1.3.4::      Can XEmacs messages come out in a different language?
 * Q1.3.5::      Please explain the various input methods in MULE/XEmacs 20.0
 * Q1.3.6::      How do I portably code for MULE/XEmacs 20.0?
 * Q1.3.7::      How about Cyrillic Modes?
 Getting Started:
 * Q1.4.1::      What is a @file{.emacs} and is there a sample one?
 * Q1.4.2::      Can I use the same @file{.emacs} with the other Emacs?
 * Q1.4.3::      Any good XEmacs tutorials around?
 * Q1.4.6::      What's the difference between a macro and a function?
 * Q1.4.7::      Why options saved with 19.13 don't work with 19.14 or later?
 Installation and Trouble Shooting
 * Q2.0.1::      Running XEmacs without installing.
 * Q2.0.2::      XEmacs is too big.
 * Q2.0.3::      Compiling XEmacs with Netaudio.
 * Q2.0.4::      Problems with Linux and ncurses.
 * Q2.0.5::      Do I need X11 to run XEmacs?
 * Q2.0.6::      I'm having strange crashes.  What do I do?
 * Q2.0.7::      Libraries in non-standard locations.
 * Q2.0.8::      can't resolve symbol _h_errno
 * Q2.0.9::      Where do I find external libraries?
 * Q2.0.10::     After I run configure I find a coredump, is something wrong?
 * Q2.0.11::     XEmacs can't resolve host names.
 * Q2.0.12::     Why can't I strip XEmacs?
 * Q2.0.13::     Can't link XEmacs on Solaris with Gcc.
 * Q2.0.14::     Make on HP/UX 9 fails after linking temacs
 Trouble Shooting:
 * Q2.1.1::      XEmacs just crashed on me!
 * Q2.1.2::      Cryptic Minibuffer messages.
 * Q2.1.3::      Translation Table Syntax messages at Startup.
 * Q2.1.22::     XEmacs seems to take a really long time to do some things.
 * Q2.1.23::     Movemail on Linux does not work for XEmacs 19.15 and later.
 Customization and Options
 * Q3.0.1::      What version of Emacs am I running?
 * Q3.0.2::      How do I evaluate Elisp expressions?
 * Q3.0.3::      @code{(setq tab-width 6)} behaves oddly.
 * Q3.0.4::      How can I add directories to the @code{load-path}?
 * Q3.0.5::      How to check if a lisp function is defined?
 * Q3.0.6::      Can I force the output of @code{(face-list)} to a buffer?
 * Q3.0.7::      Font selections don't get saved after @code{Save Options}.
 * Q3.0.8::      How do I make a single minibuffer frame?
 * Q3.0.9::      What is @code{Customize}?
 X Window System & Resources:
 * Q3.1.1::      Where is a list of X resources?
 * Q3.1.3::      @code{(set-screen-width)} worked in 19.6, but not in 19.13?
 * Q3.1.4::      Specifying @code{Emacs*EmacsScreen.geometry} in @file{.emacs} does not work in 19.15?
 * Q3.1.5::      How can I get the icon to just say @samp{XEmacs}?
 * Q3.1.6::      How can I have the window title area display the full path?
 * Q3.1.7::      @samp{xemacs -name junk} doesn't work?
-* Q3.1.8::      @samp{-iconic} doesn't work.
+* Q3.1.8::      @samp{-iconic} it doesn't work.
 Textual Fonts & Colors:
 * Q3.2.1::      How can I set color options from @file{.emacs}?
 * Q3.2.2::      How do I set the text, menu and modeline fonts?
 * Q3.2.3::      How can I set the colors when highlighting a region?
 * Q3.2.4::      How can I limit color map usage?
 * Q3.2.5::      My tty supports color, but XEmacs doesn't use them.
 The Modeline:
 * Q3.3.1::      How can I make the modeline go away?
 * Q3.3.2::      How do you have XEmacs display the line number in the modeline?
 * Q3.3.3::      How do I get XEmacs to put the time of day on the modeline?
 * Q3.3.4::      How do I turn off current chapter from AUC TeX modeline?
 * Q3.3.5::      How can one change the modeline color based on the mode used?
 3.4 Multiple Device Support:
 * Q3.4.1::      How do I open a frame on another screen of my multi-headed display?
 * Q3.4.2::      Can I really connect to a running XEmacs after calling up over a modem?  How?
 3.5 The Keyboard:
 * Q3.5.1::      How can I bind complex functions (or macros) to keys?
 * Q3.5.2::      How can I stop down-arrow from adding empty lines to the bottom of my buffers?
 * Q3.5.3::      How do I bind C-. and C-; to scroll one line up and down?
 * Q3.5.4::      Globally binding @kbd{Delete}?
 * Q3.5.5::      Scrolling one line at a time.
 * Q3.5.6::      How to map @kbd{Help} key alone on Sun type4 keyboard?
 * Q3.5.7::      How can you type in special characters in XEmacs?
 * Q3.5.8::      Why does @code{(global-set-key [delete-forward] 'delete-char)} complain?
 * Q3.5.9::      How do I make the Delete key delete forward?
 * Q3.5.10::     Can I turn on @dfn{sticky} modifier keys?
 * Q3.9.2::      How can one use resources to change scrollbar colors?
 * Q3.9.3::      Moving the scrollbar can move the point; can I disable this?
 * Q3.9.4::      How can I get automatic horizontal scrolling?
 Text Selections:
 * Q3.10.1::     How can I turn off or change highlighted selections?
 * Q3.10.2::     How do I get that typing on an active region removes it?
 * Q3.10.3::     Can I turn off the highlight during isearch?
 * Q3.10.4::     How do I turn off highlighting after @kbd{C-x C-p} (mark-page)?
 * Q3.10.5::     The region disappears when I hit the end of buffer while scrolling.
 * Q4.1.1::      What is W3?
 * Q4.1.2::      How do I run W3 from behind a firewall?
 * Q4.1.3::      Is it true that W3 supports style sheets and tables?
 Reading Netnews and Mail with Gnus:
 * Q4.2.1::      GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus, Quassia Gnus, argh!
 * Q4.2.2::      [This question intentionally left blank]
 * Q4.2.3::      How do I make Gnus stay within a single frame?
 * Q4.2.4::      How do I customize the From: line?
 Other Mail & News:
 * Q4.3.3::      Why isn't this @code{movemail} program working?
 * Q4.3.4::      Movemail is also distributed by Netscape?  Can that cause problems?
 * Q4.3.5::      Where do I find pstogif (required by tm)?
 Sparcworks, EOS, and WorkShop:
 * Q4.4.1::      What is SPARCworks, EOS, and WorkShop
 Energize:
 * Q4.5.1::      What is/was Energize?
 Infodock:
 * Q5.0.5::      How can I get XEmacs to come up in text/auto-fill mode by default?
 * Q5.0.6::      How do I start up a second shell buffer?
 * Q5.0.7::      Telnet from shell filters too much.
 * Q5.0.8::      Why does edt emulation not work?
 * Q5.0.9::      How can I emulate VI and use it as my default mode?
 * Q5.0.10::     [This question intentionally left blank]
 * Q5.0.11::     Filladapt doesn't work in 19.15?
 * Q5.0.12::     How do I disable gnuserv from opening a new frame?
 * Q5.0.13::     How do I start gnuserv so that each subsequent XEmacs is a client?
 * Q5.0.14::     Strange things are happening in Shell Mode.
 * Q5.0.15::     Where do I get the latest CC Mode?
 * Q5.0.16::     I find auto-show-mode disconcerting.  How do I turn it off?
 * Q5.0.17::     How can I get two instances of info?
 * Q5.0.18::     I upgraded to XEmacs 19.14 and gnuserv stopped working
 * Q5.0.19::     Is there something better than LaTeX mode?
+* Q5.0.20::     Is there a way to start a new XEmacs if there's no gnuserv running, and otherwise use gnuclient?
 Emacs Lisp Programming Techniques:
 * Q5.1.1::      The difference in key sequences between XEmacs and GNU Emacs?
 * Q5.1.2::      Can I generate "fake" keyboard events?
 * Q5.1.3::      Could you explain @code{read-kbd-macro} in more detail?
 What the Future Holds
 * Q6.0.1::      What is new in 20.2?
 * Q6.0.2::      What is new in 20.3?
-* Q6.0.3::      Procedural changes in XEmacs development.
+* Q6.0.3::      What is new in 20.4?
+* Q6.0.4::      Procedural changes in XEmacs development.
 @end detailmenu
 @end menu
 @node Introduction, Installation, Top, Top
-@chapter Introduction, Policy, Credits
+@unnumbered 1 Introduction, Policy, Credits
-Learning XEmacs is a lifelong activity.  I've been using Emacs for
+Learning XEmacs is a lifelong activity.  Even people who have used Emacs
-over a decade now, and I'm still discovering new features.  Therefore
+for years keep discovering new features.  Therefore this document cannot
-this document cannot be complete.  Instead it is aimed at the person
+be complete.  Instead it is aimed at the person who is either
-who is either considering XEmacs for their own use, or has just
+considering XEmacs for their own use, or has just obtained it and is
-obtained it and is wondering what to do next.  It is also useful as a
+wondering what to do next.  It is also useful as a reference to
-reference to available resources.
+available resources.
-The previous maintainer of the FAQ was Anthony Rossini
+The previous maintainer of the FAQ was @email{rossini@@stat.sc.edu,
-<rossini@@stat.sc.edu>, who started it, after getting tired of hearing
+Anthony Rossini}, who started it, after getting tired of hearing JWZ
-JWZ complain about repeatedly having to answer questions.  Ben Wing
+complain about repeatedly having to answer questions.
-<ben@@666.com> and Chuck Thompson <cthomp@@xemacs.org>, the principal
+@email{ben@@666.com, Ben Wing} and @email{cthomp@@xemacs.org, Chuck
-authors of XEmacs, then took over and Ben did a massive update
+Thompson}, the principal authors of XEmacs, then took over and Ben did
-reorganizing the whole thing.  At which point Anthony took back over,
+a massive update reorganizing the whole thing.  At which point Anthony
-but then had to give it up again.  Some of the other contributors to
+took back over, but then had to give it up again.  Some of the other
-this FAQ are listed later in this document.
+contributors to this FAQ are listed later in this document.
 The previous version was converted to hypertext format, and edited by
-Steven L. Baur <steve@@altair.xemacs.org>.  It was converted back to
+@email{steve@@altair.xemacs.org, Steven L. Baur}.  It was converted back to
-texinfo by Hrvoje Niksic <hniksic@@srce.hr>.
+texinfo by @email{hniksic@@srce.hr, Hrvoje Niksic}.
-Since Steve Baur is so busy putting out multiple versions of XEmacs I
+The FAQ was then maintained by @email{andreas@@sccon.com, Andreas
-have taken on the task of maintaining the FAQ.  I use XEmacs on a daily
+Kaempf}, who passed it on to @email{chr@@mediascience.no, Christian
-basis and I wanted to give something back to the community that has made
+Nyb@o{}}, the current FAQ maintainer.
-XEmacs possible.  If you notice any errors or items which should be
-added or amended to this FAQ please send email to Andreas Kaempf
+If you notice any errors or items which should be added or amended to
-<andreas@@sccon.com>. Include @samp{XEmacs FAQ} on the Subject: line.
+this FAQ please send email to @email{chr@@mediascience.no, Christian
+Nyb@o{}}. Include @samp{XEmacs FAQ} on the Subject: line.
 @menu
 Introduction:
 * Q1.0.1::      What is XEmacs?
 * Q1.0.2::      What is the current version of XEmacs?
 * Q1.0.3::      Where can I find it?
 * Q1.0.4::      Why Another Version of Emacs?
 * Q1.0.5::      Why Haven't XEmacs and GNU Emacs Merged?
 * Q1.0.6::      Where can I get help?
 * Q1.0.7::      Where is the mailing list archived?
 * Q1.0.8::      How do you pronounce XEmacs?
 * Q1.0.9::      What does XEmacs look like?
 * Q1.0.10::     Is there a port of XEmacs to Microsoft ('95 or NT)?
 * Q1.0.11::     Is there a port of XEmacs to the Macintosh?
 * Q1.0.12::     Is there a port of XEmacs to NextStep?
 * Q1.0.13::     Is there a port of XEmacs to OS/2?
 * Q1.0.14::     Where can I get a printed copy of the XEmacs users manual?
 * Q1.1.2::      How do I become a Beta Tester?
 * Q1.1.3::      How do I contribute to XEmacs itself?
 Credits:
 * Q1.2.1::      Who wrote XEmacs?
 * Q1.2.2::      Who contributed to this version of the FAQ?
 * Q1.2.3::      Who contributed to the FAQ in the past?
 Internationalization:
 * Q1.3.1::      What is the status of XEmacs v20?
 * Q1.3.2::      What is the status of Asian-language support, aka @var{mule}?
 * Q1.3.3::      How do I type non-ASCII characters?
 * Q1.3.4::      Can XEmacs messages come out in a different language?
 * Q1.3.5::      Please explain the various input methods in MULE/XEmacs 20.0
 * Q1.3.6::      How do I portably code for MULE/XEmacs 20.0?
 * Q1.3.7::      How about Cyrillic Modes?
 Getting Started:
 * Q1.4.1::      What is a @file{.emacs} and is there a sample one?
 * Q1.4.2::      Can I use the same @file{.emacs} with the other Emacs?
 * Q1.4.3::      Any good XEmacs tutorials around?
 * Q1.4.6::      What's the difference between a macro and a function?
 * Q1.4.7::      Why options saved with 19.13 don't work with 19.14 or later?
 @end menu
 @node Q1.0.1, Q1.0.2, Introduction, Introduction
-@section What is XEmacs?
+@unnumberedsec 1.0: Introduction
+@unnumberedsubsec Q1.0.1: What is XEmacs?
 An alternative to GNU Emacs, originally based on an early alpha version
 of FSF's version 19, and has diverged quite a bit since then.  XEmacs
 was known as Lucid Emacs through version 19.10.  Almost all features of
 GNU Emacs are supported in XEmacs.  The maintainers of XEmacs actively
 track changes to GNU Emacs while also working to add new features.
 @node Q1.0.2, Q1.0.3, Q1.0.1, Introduction
-@section What is the current version of XEmacs?
+@unnumberedsubsec Q1.0.2: What is the current version of XEmacs?
-The current stable version of XEmacs is 20.3, released in November,
+XEmacs 20.4 is a minor upgrade from 20.3, containing many bugfixes. It
-1997.
+was released in February 1998.
-The next feature release will be XEmacs 20.4.
 XEmacs 19.16 was the last release of v19, released in November, 1997,
 which was also the last version without international language support.
 @node Q1.0.3, Q1.0.4, Q1.0.2, Introduction
-@section Where can I find it?
+@unnumberedsubsec Q1.0.3: Where can I find it?
 The canonical source and binaries is found via anonymous FTP at:
 @example
-<URL:ftp.xemacs.org:/pub/xemacs/>
+@uref{ftp://ftp.xemacs.org/pub/xemacs/}
 @end example
 @node Q1.0.4, Q1.0.5, Q1.0.3, Introduction
-@section Why Another Version of Emacs?
+@unnumberedsubsec Q1.0.4: Why Another Version of Emacs?
 For a detailed description of the differences between GNU Emacs and
 XEmacs and a detailed history of XEmacs, check out the
 @example
-<URL:http://www.xemacs.org/NEWS.html>
+@uref{http://www.xemacs.org/NEWS.html, NEWS file}
 @end example
 However, here is a list of some of the reasons why we think you might
 consider using it:
 @item
 First production Web Browser supporting Style Sheets.
 @end itemize
 @node Q1.0.5, Q1.0.6, Q1.0.4, Introduction
-@section Why Haven't XEmacs and GNU Emacs Merged?
+@unnumberedsubsec Q1.0.5: Why Haven't XEmacs and GNU Emacs Merged?
 There are currently irreconcilable differences in the views about
 technical, programming, design and organizational matters between RMS
 and the XEmacs development team which provide little hope for a merge to
 take place in the short-term future.
 If you have a comment to add regarding the merge, it is a good idea to
-avoid posting to the newsgroups, because of the very heated flamewars
+avoid posting to the newsgroups,  because of the very heated flamewars
-that often result.  Mail your questions to <xemacs-beta@@xemacs.org> and
+that often result.  Mail your questions to @email{xemacs-beta@@xemacs.org} and
-<bug-gnu-emacs@@prep.ai.mit.edu>.
+@email{bug-gnu-emacs@@prep.ai.mit.edu}.
 @node Q1.0.6, Q1.0.7, Q1.0.5, Introduction
-@section Where can I get help?
+@unnumberedsubsec Q1.0.6: Where can I get help?
 Probably the easiest way, if everything is installed, is to use info, by
 pressing @kbd{C-h i}, or selecting @code{Emacs Info} from the Help Menu.
 Also, @kbd{M-x apropos} will look for commands for you.
 Try reading this FAQ, examining the regular GNU Emacs FAQ (which can be
 found with the Emacs 19 distribution) as well as at
-<URL:http://www.eecs.nwu.edu/emacs/faq/> and reading the Usenet group
+@uref{http://www.eecs.nwu.edu/emacs/faq/} and reading the Usenet group
 comp.emacs.xemacs.
 If that does not help, try posting your question to comp.emacs.xemacs.
 Please @strong{do not} post XEmacs related questions to gnu.emacs.help.
 If you cannot post or read Usenet news, there is a corresponding mailing
 list which is available.  It can be subscribed to by sending a message
-with a subject of @samp{subscribe} to <xemacs-request@@xemacs.org>
+with a subject of @samp{subscribe} to @email{xemacs-request@@xemacs.org}
-for subscription information and <xemacs@@xemacs.org> to send messages
+for subscription information and @email{xemacs@@xemacs.org} to send messages
 to the list.
 To cancel a subscription, you @strong{must} use the xemacs-request
 address.  Send a message with a subject of @samp{unsubscribe} to be
 removed.
 @node Q1.0.7, Q1.0.8, Q1.0.6, Introduction
-@section Where is the mailing list archived?
+@unnumberedsubsec Q1.0.7: Where is the mailing list archived?
 The mailing list was archived in the directory
 @example
-<URL:ftp://ftp.xemacs.org:/pub/mlists/>.
+@uref{ftp://ftp.xemacs.org/pub/mlists/}.
 @end example
 However, this archive is out of date.  The current mailing list server
 supports an @code{archive} feature, which may be utilized.
 @node Q1.0.8, Q1.0.9, Q1.0.7, Introduction
-@section How do you pronounce XEmacs?
+@unnumberedsubsec Q1.0.8: How do you pronounce XEmacs?
 I pronounce it @samp{Eks eemax}.
 @node Q1.0.9, Q1.0.10, Q1.0.8, Introduction
-@section What does XEmacs look like?
+@unnumberedsubsec Q1.0.9: What does XEmacs look like?
 Screen snapshots are available in the WWW version of the FAQ.
 @example
-<URL:http://www.xemacs.org/faq/xemacs-faq.html>
+@uref{http://www.xemacs.org/faq/xemacs-faq.html}
 @end example
 @node Q1.0.10, Q1.0.11, Q1.0.9, Introduction
-@section Is there a port of XEmacs to Microsoft ('95 or NT)?
+@unnumberedsubsec Q1.0.10: Is there a port of XEmacs to Microsoft ('95 or NT)?
-Thanks to efforts of many people, coordinated by David Hobley
+Thanks to efforts of many people, coordinated by
-<davidh@@wr.com.au> and Marc Paquette <marcpa@@cam.org>, beta versions
+@email{davidh@@wr.com.au, David Hobley} and @email{marcpa@@cam.org, Marc
-of XEmacs now run on 32-bit Windows platforms (NT and 95).  The current
+Paquette}, beta versions of XEmacs now run on 32-bit Windows platforms
-betas require having an X server to run XEmacs; however, a native NT/95
+(NT and 95).  The current betas require having an X server to run
-port is in alpha, thanks to Jonathan Harris <jhar@@tardis.ed.ac.uk>.
+XEmacs; however, a native NT/95 port is in alpha, thanks to
+@email{jhar@@tardis.ed.ac.uk, Jonathan Harris}.
 The NT development is now coordinated by a mailing list at
-<xemacs-nt@@xemacs.org>.  If you are willing to contribute or want to
+@email{xemacs-nt@@xemacs.org}.
-follow the progress, mail to <xemacs-nt-request@@xemacs.org> to
-subscribe.
+If you are willing to contribute or want to follow the progress, mail to
+@iftex
+@*
+@end iftex
+@email{xemacs-nt-request@@xemacs.org} to subscribe.
 Furthermore, Altrasoft is seeking corporate and government sponsors to
 help fund a fully native port of XEmacs to Windows 95 and NT using
 full-time, senior-level staff working under a professionally managed
-project structure.  See <URL:http://www.altrasoft.com/> for more details
+project structure.  See @uref{http://www.altrasoft.com/, the Altrasoft
+web site} for more details
 or contact Altrasoft directly at 1-888-ALTSOFT.
 The closest existing port is @dfn{Win-Emacs}, which is based on Lucid
-Emacs 19.6.  Available from <URL:http://www.pearlsoft.com/>.
+Emacs 19.6.  Available from @uref{http://www.pearlsoft.com/}.
 There's a port of GNU Emacs (not XEmacs) at
 @example
-<URL:http://www.cs.washington.edu/homes/voelker/ntemacs.html>.
+@uref{http://www.cs.washington.edu/homes/voelker/ntemacs.html}.
 @end example
 @node Q1.0.11, Q1.0.12, Q1.0.10, Introduction
-@section Is there a port of XEmacs to the Macintosh?
+@unnumberedsubsec Q1.0.11: Is there a port of XEmacs to the Macintosh?
 There has been a port to the MachTen environment of XEmacs 19.13, but no
 patches have been submitted to the maintainers to get this in the
 mainstream distribution.
 @node Q1.0.12, Q1.0.13, Q1.0.11, Introduction
-@section Is there a port of XEmacs to NextStep?
+@unnumberedsubsec Q1.0.12: Is there a port of XEmacs to NextStep?
-Carl Edman, apparently no longer at <cedman@@princeton.edu>, did the
+Carl Edman, apparently no longer at @email{cedman@@princeton.edu}, did
-port of GNU Emacs to NeXTstep and expressed interest in doing the XEmacs
+the port of GNU Emacs to NeXTstep and expressed interest in doing the
-port, but never went any farther.
+XEmacs port, but never went any farther.
 @node Q1.0.13, Q1.0.14, Q1.0.12, Introduction
-@section Is there a port of XEmacs to OS/2?
+@unnumberedsubsec Q1.0.13: Is there a port of XEmacs to OS/2?
 No, and there is no news of anyone working on it.
 @node Q1.0.14, Q1.1.1, Q1.0.13, Introduction
-@section Where can I obtain a printed copy of the XEmacs users manual?
+@unnumberedsubsec Q1.0.14: Where can I obtain a printed copy of the XEmacs users manual?
 Altrasoft Associates, a firm specializing in Emacs-related support and
 development, will be maintaining the XEmacs user manual.  The firm plans
 to begin publishing printed copies of the manual soon.
 @c This used to say `March 1997'!
 @example
-Web:     http://www.xemacs.com
+Web:     @uref{http://www.xemacs.com}
-E-mail:  <info@@xemacs.com>
+E-mail:  @email{info@@xemacs.com}
 Tel:     +1 408 243 3300
 @end example
 @node Q1.1.1, Q1.1.2, Q1.0.14, Introduction
-@section What is the FAQ editorial policy?
+@unnumberedsec 1.1: Policies
+@unnumberedsubsec Q1.1.1: What is the FAQ editorial policy?
 The FAQ is actively maintained and modified regularly.  All links should
 be up to date.
 Changes are displayed on a monthly basis.  @dfn{Months}, for this
 purpose are defined as the 5th of the month through the 5th of the
 month.  Preexisting questions that have been changed are marked as such.
 Brand new questions are tagged.
-All submissions are welcome.  E-mail submissions to Andreas Kaempf
+All submissions are welcome.  E-mail submissions
-<andreas@@sccon.com>.
+to @iftex
+@*
+@end iftex
+@email{chr@@mediascience.no, Christian Nyb@o{}}.
 Please make sure that @samp{XEmacs FAQ} appears on the Subject: line.
 If you think you have a better way of answering a question, or think a
 question should be included, I'd like to hear about it.  Questions and
 answers included into the FAQ will be edited for spelling and grammar,
 of the four people listed at the top of this document.  Answers quoted
 from Usenet news articles will always be attributed, regardless of the
 author.
 @node Q1.1.2, Q1.1.3, Q1.1.1, Introduction
-@section How do I become a Beta Tester?
+@unnumberedsubsec Q1.1.2: How do I become a Beta Tester?
-Send an email message to <xemacs-beta-request@@xemacs.org> with a
+Send an email message to @email{xemacs-beta-request@@xemacs.org} with a
 subject line of @samp{subscribe}.
 Be prepared to get your hands dirty, as beta testers are expected to
 identify problems as best they can.
 @node Q1.1.3, Q1.2.1, Q1.1.2, Introduction
-@section How do I contribute to XEmacs itself?
+@unnumberedsubsec Q1.1.3: How do I contribute to XEmacs itself?
-Ben Wing <ben@@666.com> writes:
+Ben Wing @email{ben@@666.com} writes:
 @quotation
 BTW if you have a wish list of things that you want added, you have to
 speak up about it!  More specifically, you can do the following if you
 want a feature added (in increasing order of usefulness):
 (not that we're necessarily requiring you to write the code, but we can
 always hope :)
 @end quotation
 @node Q1.2.1, Q1.2.2, Q1.1.3, Introduction
-@section Who wrote XEmacs?
+@unnumberedsec 1.2: Credits
+@unnumberedsubsec Q1.2.1: Who wrote XEmacs?
 XEmacs is the result of the time and effort of many people.  The
 developers responsible for the 19.16/20.x releases are:
 @itemize @bullet
-@item Martin Buchholz <martin@@xemacs.org>
+@item @email{martin@@xemacs.org, Martin Buchholz}
+@ifhtml
-@item Steve Baur <steve@@altair.xemacs.org>
+<img src="mrb.jpeg">
+@end ifhtml
-@item Hrvoje Niksic <hniksic@@srce.hr>
+@item @email{steve@@altair.xemacs.org, Steve Baur}
+@ifhtml
+<img src="steve.gif">
+@end ifhtml
+@item @email{hniksic@@srce.hr, Hrvoje Niksic}
+@ifhtml
+<img src="hniksic.jpeg">
+@end ifhtml
 @end itemize
 The developers responsible for the 19.14 release are:
 @itemize @bullet
-@item Chuck Thompson <cthomp@@xemacs.org>
+@item @email{cthomp@@xemacs.org, Chuck Thompson}
+@ifhtml
+<img src="cthomp.jpeg">
+@end ifhtml
 Chuck was Mr. XEmacs from 19.11 through 19.14, and is responsible
 for XEmacs becoming a widely distributed program over the Internet.
-@item Ben Wing <ben@@666.com>
+@item @email{ben@@666.com, Ben Wing}
+@ifhtml
+<img src="wing.gif">
+@end ifhtml
 @end itemize
 Jamie Zawinski was Mr. Lucid Emacs from 19.0 through 19.10, the last
 release actually named Lucid Emacs.  Richard Mlynarik was crucial to
 most of those releases.
 @itemize @bullet
-@item Jamie Zawinski <jwz@@netscape.com>
+@item @email{jwz@@netscape.com, Jamie Zawinski}
+@ifhtml
-@item Richard Mlynarik <mly@@adoc.xerox.com>
+<img src="jwz.gif">
+@end ifhtml
+@item @email{mly@@adoc.xerox.com, Richard Mlynarik}
 @end itemize
 Along with many other contributors, partially enumerated in the
 @samp{About XEmacs} option in the Help menu.
 @node Q1.2.2, Q1.2.3, Q1.2.1, Introduction
-@section Who contributed to this version of the FAQ?
+@unnumberedsubsec Q1.2.2: Who contributed to this version of the FAQ?
 The following people contributed valuable suggestions to building this
 version of the FAQ (listed in alphabetical order):
 @itemize @bullet
-@item SL Baur <steve@@xemacs.org>
+@item @email{steve@@xemacs.org, SL Baur}
-@item Hrvoje Niksic <hniksic@@srce.hr>
+@item @email{hniksic@@srce.hr, Hrvoje Niksic}
-@item Aki Vehtari <Aki.Vehtari@@hut.fi>
+@item @email{Aki.Vehtari@@hut.fi, Aki Vehtari}
 @end itemize
 @node Q1.2.3, Q1.3.1, Q1.2.2, Introduction
-@section Who contributed to the FAQ in the past?
+@unnumberedsubsec Q1.2.3: Who contributed to the FAQ in the past?
 This is only a partial list, as many names were lost in a hard disk
 crash some time ago.
 @itemize @bullet
-@item Curtis.N.Bingham <binge@@aloft.att.com>
+@item @email{binge@@aloft.att.com, Curtis.N.Bingham}
-@item Richard Caley <rjc@@cogsci.ed.ac.uk>
+@item @email{rjc@@cogsci.ed.ac.uk, Richard Caley}
-@item Richard Cognot <cognot@@ensg.u-nancy.fr>
+@item @email{cognot@@ensg.u-nancy.fr, Richard Cognot}
-@item William G. Dubuque <wgd@@martigny.ai.mit.edu>
+@item @email{wgd@@martigny.ai.mit.edu, William G. Dubuque}
-@item Eric Eide <eeide@@cs.utah.edu>
+@item @email{eeide@@cs.utah.edu, Eric Eide}
-@item Chris Flatters <cflatter@@nrao.edu>
+@item @email{cflatter@@nrao.edu, Chris Flatters}
-@item Evelyn Ginsparg <ginsparg@@adra.com>
+@item @email{ginsparg@@adra.com, Evelyn Ginsparg}
-@item Marty Hall <hall@@aplcenmp.apl.jhu.edu>
+@item @email{hall@@aplcenmp.apl.jhu.edu, Marty Hall}
-@item Darrell Kindred <dkindred@@cmu.edu>
+@item @email{dkindred@@cmu.edu, Darrell Kindred}
-@item David Moore <dmoore@@ucsd.edu>
+@item @email{dmoore@@ucsd.edu, David Moore}
-@item Arup Mukherjee <arup+@@cmu.edu>
+@item @email{arup+@@cmu.edu, Arup Mukherjee}
-@item Juergen Nickelsen <nickel@@prz.tu-berlin.de>
+@item @email{nickel@@prz.tu-berlin.de, Juergen Nickelsen}
-@item Kevin R. Powell <powell@@csl.ncsa.uiuc.edu>
+@item @email{powell@@csl.ncsa.uiuc.edu, Kevin R. Powell}
-@item Justin Sheehy <dworkin@@ccs.neu.edu>
+@item @email{dworkin@@ccs.neu.edu, Justin Sheehy}
-@item Stig <stig@@hackvan.com>
+@item @email{stig@@hackvan.com, Stig}
-@item Aki Vehtari <Aki.Vehtari@@hut.fi>
+@item @email{Aki.Vehtari@@hut.fi, Aki Vehtari}
 @end itemize
 @node Q1.3.1, Q1.3.2, Q1.2.3, Introduction
-@section What is the status of XEmacs v20?
+@unnumberedsec 1.3: Internationalization
+@unnumberedsubsec Q1.3.1: What is the status of XEmacs v20?
 XEmacs v20 is the version of XEmacs that includes MULE (Asian-language)
 support.  XEmacs 20.0 was released in February 1997, followed by XEmacs
-20.2 in May and XEmacs 20.3 in November.  When compiled without MULE
+20.2 in May, XEmacs 20.3 in November and XEmacs 20.4 in February 1998.  When compiled without MULE
-support, 20.3 is approximately as stable as 19.16, and probably faster
+support, 20.4 is approximately as stable as 19.16, and probably faster
 (due to additional optimization work.)
 As of XEmacs 20.3, version 20 is @emph{the} supported version of
 XEmacs.  This means that 19.16 will optionally receive stability fixes
 (if any), but that all the real development work will be done on the v20
 tree.
 The incompatible changes in XEmacs 20 include the additional byte-codes,
 new primitive data types (@code{character}, @code{char-table}, and
 @code{range-table}).  This means that the character-integer equivalence
 inherent to all the previous Emacs and XEmacs releases no longer
 applies.
 However, to avoid breaking old code, many functions that should normally
 accept characters work with integers, and vice versa.  For more
 information, see the Lisp reference manual.  Here is a relevant excerpt,
 for your convenience.
 @quotation
 In XEmacs version 19, and in all versions of FSF GNU Emacs, a
 @dfn{character} in XEmacs Lisp is nothing more than an integer.
 common to work with @emph{strings}, which are sequences composed of
 characters.
 @end quotation
 @node Q1.3.2, Q1.3.3, Q1.3.1, Introduction
-@section What is the status of Asian-language support, aka MULE?
+@unnumberedsubsec Q1.3.2: What is the status of Asian-language support, aka MULE?
 The MULE support works OK but still needs a fair amount of work before
 it's really solid.  We could definitely use some help here, esp. people
 who speak Japanese and will use XEmacs/MULE to work with Japanese and
 have some experience with E-Lisp.
-As the funding on Mule have stopped, Mule part of XEmacs is currently
+As the fundings on Mule have stopped, Mule part of XEmacs is currently
 looking for a full-time maintainer.  If you can provide help here, or
-are willing to fund the work, please mail to <xemacs-beta@@xemacs.org>.
+are willing to fund the work, please mail to @email{xemacs-beta@@xemacs.org}.
 @xref{Q1.1.2}.
 @node Q1.3.3, Q1.3.4, Q1.3.2, Introduction
-@section How do I type non-ASCII characters?
+@unnumberedsubsec Q1.3.3: How do I type non-ASCII characters?
 See question 3.5.7 (@xref{Q3.5.7}) in part 3 of this FAQ.
 @node Q1.3.4, Q1.3.5, Q1.3.3, Introduction
-@section Can XEmacs messages come out in a different language?
+@unnumberedsubsec Q1.3.4: Can XEmacs messages come out in a different language?
 The message-catalog support has mostly been written but doesn't
 currently work.  The first release of XEmacs 20 will @emph{not} support
 it.  However, menubar localization @emph{does} work, even in 19.14.  To
 enable it, add to your @file{Emacs} file entries like this:
 The name of the resource is derived from the non-localized entry by
 removing punctuation and capitalizing as above.
 @node Q1.3.5, Q1.3.6, Q1.3.4, Introduction
-@section Please explain the various input methods in MULE/XEmacs 20.0
+@unnumberedsubsec Q1.3.5: Please explain the various input methods in MULE/XEmacs 20.0
-MORIOKA Tomohiko <morioka@@jaist.ac.jp> writes:
+@email{morioka@@jaist.ac.jp, MORIOKA Tomohiko} writes:
 @quotation
-Original Mule supports the following input methods: Wnn4, Wnn6, Canna, SJ3
+Original Mule supports following input methods: Wnn4, Wnn6, Canna, SJ3
 and XIM. Interfaces for Wnn and SJ3 uses the @code{egg} user
 interface. Interface for Canna does not use @samp{egg}. I don't know
 about XIM. It is to support ATOK, of course, it may work for another
 servers.
 plan is stopped.  Perhaps after Mule merged GNU Emacs will be released,
 it will be continued.
 @end quotation
 @node Q1.3.6, Q1.3.7, Q1.3.5, Introduction
-@section How do I portably code for MULE/XEmacs 20?
+@unnumberedsubsec Q1.3.6: How do I portably code for MULE/XEmacs 20?
-MORIOKA Tomohiko <morioka@@jaist.ac.jp> writes:
+@email{morioka@@jaist.ac.jp, MORIOKA Tomohiko} writes:
 @quotation
 MULE and XEmacs are quite different. So the application
 implementor must write separate code for these mule variants.
 )
 @end lisp
 @end quotation
 @node Q1.3.7, Q1.4.1, Q1.3.6, Introduction
-@section How about Cyrillic Modes?
+@unnumberedsubsec Q1.3.7: How about Cyrillic Modes?
-Ilya Zakharevich <ilya@@math.ohio-state.edu> writes:
+@email{ilya@@math.ohio-state.edu, Ilya Zakharevich} writes:
 @quotation
 There is a cyrillic mode in the file @file{mysetup.zip} in
-<URL:ftp://ftp.math.ohio-state.edu/pub/users/ilya/emacs/>.  This is a
+@iftex
-modification to Valery Alexeev's <ava@@math.jhu.ed> @file{russian.el}
+@*
-which can be obtained from <URL:ftp://ftp.cis.ohio-state.edu/pub/gnu/emacs/elisp-archive/packages/russian.el.Z>.
+@end iftex
-@end quotation
+@uref{ftp://ftp.math.ohio-state.edu/pub/users/ilya/emacs/}.  This is a
+modification to @email{ava@@math.jhu.ed, Valery Alexeev's} @file{russian.el}
-Dima Barsky <d.barsky@@ee.surrey.ac.uk> writes:
+which can be obtained from @uref{ftp://ftp.cis.ohio-state.edu/pub/gnu/emacs/elisp-archive/packages/russian.el.Z}.
+@end quotation
-@quotation
-There is another cyrillic mode for both GNU Emacs and XEmacs by Dmitrii
+@email{d.barsky@@ee.surrey.ac.uk, Dima Barsky} writes:
-(Mitya) Manin <manin@@camelot.mssm.edu> at
-<URL:http://camelot.mssm.edu/~manin/cyr.el>.
+@quotation
-@end quotation
+There is another cyrillic mode for both GNU Emacs and XEmacs by
+@email{manin@@camelot.mssm.edu, Dmitrii
-Rebecca Ore <rebecca.ore@@op.net> writes:
+(Mitya) Manin} at
+@iftex
+@end iftex
+@uref{http://camelot.mssm.edu/~manin/cyr.el}.
+@end quotation
+@email{rebecca.ore@@op.net, Rebecca Ore} writes:
 @quotation
 The fullest resource I found on Russian language use (in and out of
-XEmacs) is <URL:http://sunsite.oit.unc.edu/sergei/Software/Software.html>
+XEmacs) is @uref{http://sunsite.oit.unc.edu/sergei/Software/Software.html}
 @end quotation
 @node Q1.4.1, Q1.4.2, Q1.3.7, Introduction
-@section What is a @file{.emacs} and is there a sample one?
+@unnumberedsec 1.4: Getting Started, Backing up & Recovery
+@unnumberedsubsec Q1.4.1: What is a @file{.emacs} and is there a sample one?
 The @file{.emacs} file is used to customize XEmacs to your tastes.  No
 two are alike, nor are they expected to be alike, but that's the point.
 The XEmacs distribution contains an excellent starter example in the etc
 directory called @file{sample.emacs}.  Copy this file from there to your
 XEmacs buffer by selecting @samp{Help->Sample .emacs} from the menubar.
 To determine the location of the @file{etc} directory type the command
 @kbd{C-h v data-directory RET}.
 @node Q1.4.2, Q1.4.3, Q1.4.1, Introduction
-@section Can I use the same @file{.emacs} with the other Emacs?
+@unnumberedsubsec Q1.4.2: Can I use the same @file{.emacs} with the other Emacs?
 Yes.  The sample @file{.emacs} included in the XEmacs distribution will
 show you how to handle different versions and flavors of Emacs.
 @node Q1.4.3, Q1.4.4, Q1.4.2, Introduction
-@section Any good tutorials around?
+@unnumberedsubsec Q1.4.3: Any good tutorials around?
 There's the XEmacs tutorial available from the Help Menu, or by typing
-@kbd{C-h t}.
+@kbd{C-h t}. To check whether it's available in a non-english language,
+type @kbd{C-u C-h t TAB}, type the first letters of your preferred
+language, then type @kbd{RET}.
 There's an Emacs Lisp tutorial at
 @example
-<URL:ftp://prep.ai.mit.edu/pub/gnu/emacs-lisp-intro-1.04.tar.gz>.
+@uref{ftp://prep.ai.mit.edu/pub/gnu/emacs-lisp-intro-1.04.tar.gz}.
 @end example
-Erik Sundermann <erik@@petaxp.rug.ac.be> has made a tutorial web page at
+@email{erik@@petaxp.rug.ac.be, Erik Sundermann} has made a tutorial web
-<URL:http://petaxp.rug.ac.be/~erik/xemacs/>.
+page at
+@iftex
+@*
+@end iftex
+@uref{http://petaxp.rug.ac.be/~erik/xemacs/}.
 @node Q1.4.4, Q1.4.5, Q1.4.3, Introduction
-@section May I see an example of a useful XEmacs Lisp function?
+@unnumberedsubsec Q1.4.4: May I see an example of a useful XEmacs Lisp function?
 The following function does a little bit of everything useful.  It does
 something with the prefix argument, it examines the text around the
 cursor, and it's interactive so it may be bound to a key.  It inserts
 copies of the current word the cursor is sitting on at the cursor.  If
 this will tell you that the @code{*} requires a writable buffer, and
 @code{p} converts the prefix argument to a number, and
 @code{interactive} allows you to execute the command with @kbd{M-x}.
 @node Q1.4.5, Q1.4.6, Q1.4.4, Introduction
-@section And how do I bind it to a key?
+@unnumberedsubsec Q1.4.5: And how do I bind it to a key?
 To bind to a key do:
 @lisp
 (global-set-key "\C-cd" 'double-word)
 @end lisp
 Or interactively, @kbd{M-x global-set-key} and follow the prompts.
 @node Q1.4.6, Q1.4.7, Q1.4.5, Introduction
-@section What's the difference between a macro and a function?
+@unnumberedsubsec Q1.4.6: What's the difference between a macro and a function?
 Quoting from the Lisp Reference (a.k.a @dfn{Lispref}) Manual:
 @dfn{Macros} enable you to define new control constructs and other
 language features.  A macro is defined much like a function, but instead
 Do not confuse the two terms with @dfn{keyboard macros}, which are
 another matter, entirely.  A keyboard macro is a key bound to several
 other keys.  Refer to manual for details.
 @node Q1.4.7, , Q1.4.6, Introduction
-@section How come options saved with 19.13 don't work with 19.14 or later?
+@unnumberedsubsec Q1.4.7: How come options saved with 19.13 don't work with 19.14 or later?
 There's a problem with options of the form:
 @lisp
 (add-spec-list-to-specifier (face-property 'searchm-field 'font)
 ((and (string-match "XEmacs" emacs-version)
 (boundp 'emacs-major-version)
 (or (and (= emacs-major-version 19)
 (>= emacs-minor-version 12))
 (>= emacs-major-version 20)))
 ...
 ))
 @end lisp
 @node Installation, Customization, Introduction, Top
-@chapter Installation and Trouble Shooting
+@unnumbered 2 Installation and Trouble Shooting
 This is part 2 of the XEmacs Frequently Asked Questions list.  This
 section is devoted to Installation, Maintenance and Trouble Shooting.
 @menu
 Installation:
 * Q2.0.1::      Running XEmacs without installing.
 * Q2.0.2::      XEmacs is too big.
 * Q2.0.3::      Compiling XEmacs with Netaudio.
 * Q2.0.4::      Problems with Linux and ncurses.
 * Q2.0.5::      Do I need X11 to run XEmacs?
 * Q2.0.6::      I'm having strange crashes.  What do I do?
 * Q2.0.7::      Libraries in non-standard locations.
 * Q2.0.8::      can't resolve symbol _h_errno
 * Q2.0.9::      Where do I find external libraries?
 * Q2.0.10::     After I run configure I find a coredump, is something wrong?
 * Q2.0.11::     XEmacs can't resolve host names.
 * Q2.0.12::     Why can't I strip XEmacs?
 * Q2.0.13::     Can't link XEmacs on Solaris with Gcc.
 * Q2.0.14::     Make on HP/UX 9 fails after linking temacs
 Trouble Shooting:
 * Q2.1.1::      XEmacs just crashed on me!
 * Q2.1.2::      Cryptic Minibuffer messages.
 * Q2.1.3::      Translation Table Syntax messages at Startup.
 * Q2.1.22::     XEmacs seems to take a really long time to do some things.
 * Q2.1.23::     Movemail on Linux does not work for XEmacs 19.15 and later.
 @end menu
 @node Q2.0.1, Q2.0.2, Installation, Installation
-@section Running XEmacs without installing
+@unnumberedsec 2.0: Installation
+@unnumberedsubsec Q2.0.1: Running XEmacs without installing
 The @file{INSTALL} file says that up to 108 MB of space is needed
 temporarily during installation!  How can I just try it out?
 XEmacs will run in place without requiring installation and copying of
 the Lisp directories, and without having to specify a special build-time
 tree to instead of @file{/i/xemacs-20.2}).
 This will let you run XEmacs without massive copying.
 @node Q2.0.2, Q2.0.3, Q2.0.1, Installation
-@section XEmacs is too big
+@unnumberedsubsec Q2.0.2: XEmacs is too big
 Although this entry has been written for XEmacs 19.13, most of it still
 stands true.
-Steve Baur <steve@@altair.xemacs.org> writes:
+@email{steve@@altair.xemacs.org, Steve Baur} writes:
 @quotation
 The 45MB of space required by the installation directories can be
 reduced dramatically if desired.  Gzip all the .el files.  Remove all
 the packages you'll never want to use (or even ones you do like the two
 The 20MB achieved is less than half of what the full distribution takes up,
 @strong{and} can be achieved without deleting a single file.
 @end quotation
-giacomo boffi <boffi@@hp735.stru.polimi.it> provides this procedure:
+@email{boffi@@hp735.stru.polimi.it, Giacomo Boffi} provides this procedure:
 @quotation
 Substitute @file{/usr/local/lib/} with the path where the xemacs tree is
 rooted, then use this script:
 for d in * ; do
 if test -d $d ; then
 cd $d
 for f in *.el ; do
 #     compress (remove) only (ONLY) the sources that have a
-#     corresponding compiled file --- do not (DO NOT) touch other
+#     corresponding compiled file --- do not (DO NOT)
-#     sources
+#     touch other sources
 if test -f $@{f@}c ; then gzip -v9 $f >> $r/cmpr ; fi
 done
 cd ..
 fi
 done
 XEmacs 20.5 will unbundle the lisp hierarchy and allow the installer
 to choose exactly how much support code gets installed.
 @end quotation
 @node Q2.0.3, Q2.0.4, Q2.0.2, Installation
-@section Compiling XEmacs with Netaudio.
+@unnumberedsubsec Q2.0.3: Compiling XEmacs with Netaudio.
 What is the best way to compile XEmacs with the netaudio system, since I
 have got the netaudio system compiled but installed at a weird place, I
 am not root.  Also in the READMEs it does not say anything about
 compiling with the audioserver?
 netaudio isn't perfect).
 BTW, netaudio has been renamed as it has a name clash with something
 else, so if you see references to NAS or Network Audio System, it's the
 same thing.  It also might be found at
-<URL:ftp.x.org:/contrib/audio/nas/>.
+@uref{ftp://ftp.x.org/contrib/audio/nas/}.
 @node Q2.0.4, Q2.0.5, Q2.0.3, Installation
-@section Problems with Linux and ncurses.
+@unnumberedsubsec Q2.0.4: Problems with Linux and ncurses.
 On Linux 1.3.98 with termcap 2.0.8 and the ncurses that came with libc
 5.2.18, XEmacs 20.0b20 is unable to open a tty device:
 @example
 src/xemacs -nw -q
-Initialization error: Terminal type `xterm' undefined (or can't access database?)
+Initialization error: @iftex
-@end example
+@*
+@end iftex
-Ben Wing <ben@@666.com> writes:
+Terminal type `xterm' undefined (or can't access database?)
+@end example
+@email{ben@@666.com, Ben Wing} writes:
 @quotation
 Your ncurses configuration is messed up.  Your /usr/lib/terminfo is a
 bad pointer, perhaps to a CD-ROM that is not inserted.
 @end quotation
 @node Q2.0.5, Q2.0.6, Q2.0.4, Installation
-@section Do I need X11 to run XEmacs?
+@unnumberedsubsec Q2.0.5: Do I need X11 to run XEmacs?
 No.  The name @dfn{XEmacs} is unfortunate in the sense that it is
 @strong{not} an X Window System-only version of Emacs.  Starting with
 19.14 XEmacs has full color support on a color capable character
 terminal.
 @node Q2.0.6, Q2.0.7, Q2.0.5, Installation
-@section I'm having strange crashes.  What do I do?
+@unnumberedsubsec Q2.0.6: I'm having strange crashes.  What do I do?
 There have been a variety of reports of crashes due to compilers with
 buggy optimizers.  Please see the @file{PROBLEMS} file that comes with
 XEmacs to read what it says about your platform.
 @node Q2.0.7, Q2.0.8, Q2.0.6, Installation
-@section Libraries in non-standard locations
+@unnumberedsubsec Q2.0.7: Libraries in non-standard locations
 I have x-faces, jpeg, xpm etc. all in different places.  I've tried
 space-separated, comma-separated, several --site-libraries, all to no
 avail.
 @example
 --site-libraries='/path/one /path/two /path/etc'
 @end example
 @node Q2.0.8, Q2.0.9, Q2.0.7, Installation
-@section can't resolve symbol _h_errno
+@unnumberedsubsec Q2.0.8: can't resolve symbol _h_errno
 You are using the Linux/ELF distribution of XEmacs 19.14, and your ELF
 libraries are out of date.  You have the following options:
 @enumerate
 Upgrade your libc to at least 5.2.16 (better is 5.2.18, 5.3.12, or
 5.4.10).
 @item
 Patch the XEmacs binary by replacing all occurrences of
-@samp{_h_errno^@@} with @samp{h_errno^@@^@@}.  Any version of Emacs will
+@samp{_h_errno^@@} with @iftex
+@*
+@end iftex
+@samp{h_errno^@@^@@}.  Any version of Emacs will
 suffice.  If you don't understand how to do this, don't do it.
 @item
 Rebuild XEmacs yourself -- any working ELF version of libc should be
 O.K.
 @end enumerate
-Hrvoje Niksic <hniksic@@srce.hr> writes:
+@email{hniksic@@srce.hr, Hrvoje Niksic} writes:
 @quotation
 Why not use a Perl one-liner for No. 2?
 @example
-perl -pi -e 's/_h_errno\0/h_errno\0\0/g' /usr/local/bin/xemacs-19.14
+perl -pi -e 's/_h_errno\0/h_errno\0\0/g' \
+/usr/local/bin/xemacs-19.14
 @end example
 NB: You @emph{must} patch @file{/usr/local/bin/xemacs-19.14}, and not
 @file{xemacs} because @file{xemacs} is a link to @file{xemacs-19.14};
 the Perl @samp{-i} option will cause unwanted side-effects if applied to
 a symbolic link.
 @end quotation
-SL Baur <steve@@xemacs.org> writes:
+@email{steve@@xemacs.org, SL Baur} writes:
 @quotation
 If you build against a recent libc-5.4 (late enough to have caused
 problems earlier in the beta cycle) and then run with an earlier version
 of libc, you get a
 The solution is to upgrade to at least libc-5.4.23.  Sigh.  Drat.
 @end quotation
 @node Q2.0.9, Q2.0.10, Q2.0.8, Installation
-@section Where do I find external libraries?
+@unnumberedsubsec Q2.0.9: Where do I find external libraries?
 All external libraries used by XEmacs can be found at the XEmacs FTP
-site <URL:ftp://ftp.xemacs.org/pub/aux/>.
+site
+@iftex
+@*
+@end iftex
+@uref{ftp://ftp.xemacs.org/pub/aux/}.
 @c This list is a pain in the you-know-what to keep in synch with the
 @c world.
 The canonical locations (at the time of this writing) are as follows:
 @table @asis
 @item JPEG
-<URL:ftp://ftp.uu.net/graphics/jpeg/>.  Version 6a is current.
+@uref{ftp://ftp.uu.net/graphics/jpeg/}.  Version 6a is current.
 @item XPM
-<URL:ftp://ftp.x.org/contrib/libraries/>.  Version 3.4j is current.
+@uref{ftp://ftp.x.org/contrib/libraries/}.  Version 3.4j is current.
 Older versions of this package are known to cause XEmacs crashes.
 @item TIFF
-<URL:ftp://ftp.sgi.com/graphics/tiff/>.  v3.4 is current.  The latest
+@uref{ftp://ftp.sgi.com/graphics/tiff/}.  v3.4 is current.  The latest
 beta is v3.4b035.  There is a HOWTO here.
 @item PNG
-<URL:ftp://ftp.uu.net/graphics/png/>.  0.89c is current.  XEmacs
+@uref{ftp://ftp.uu.net/graphics/png/}.  0.89c is current.  XEmacs
 requires a fairly recent version to avoid using temporary files.
-<URL:ftp://swrinde.nde.swri.edu/pub/png/src/>
+@uref{ftp://swrinde.nde.swri.edu/pub/png/src/}
 @item Compface
-<URL:ftp://ftp.cs.indiana.edu/pub/faces/compface/>.  This library has
+@uref{ftp://ftp.cs.indiana.edu/pub/faces/compface/}.  This library has
 been frozen for about 6 years, and is distributed without version
 numbers.  @emph{It should be compiled with the same options that X11 was
 compiled with on your system}.  The version of this library at
 XEmacs.org includes the @file{xbm2xface.pl} script, written by
-stig@@hackvan.com, which may be useful when generating your own xface.
+@email{stig@@hackvan.com}, which may be useful when generating your own xface.
 @item NAS
-<URL:ftp://ftp.x.org/contrib/audio/nas/>.
+@uref{ftp://ftp.x.org/contrib/audio/nas/}.
 Version 1.2p5 is current.  There is a FAQ here.
 @end table
 @node Q2.0.10, Q2.0.11, Q2.0.9, Installation
-@section After I run configure I find a core dump, is something wrong?
+@unnumberedsubsec Q2.0.10: After I run configure I find a core dump, is something wrong?
 Not necessarily.  If you have GNU sed 3.0 you should downgrade it to
 2.05.  From the @file{README} at prep.ai.mit.edu:
 @quotation
 It has also been observed that the vfork test on Solaris will leave a
 core dump.
 @node Q2.0.11, Q2.0.12, Q2.0.10, Installation
-@section XEmacs doesn't resolve hostnames.
+@unnumberedsubsec Q2.0.11: XEmacs doesn't resolve hostnames.
 This is the result of a long-standing problem with SunOS and the fact
 that stock SunOS systems do not ship with DNS resolver code in libc.
-Christopher Davis <ckd@@loiosh.kei.com> writes:
+@email{ckd@@loiosh.kei.com, Christopher Davis} writes:
 @quotation
 That's correct [The SunOS 4.1.3 precompiled binaries don't do name
 lookup].  Since Sun figured that everyone used NIS to do name lookups
 (that DNS thing was apparently only a passing fad, right?), the stock
 check to see if you've put DNS in the shared libc and will then proceed
 to link against the DNS resolver library code.
 @end quotation
 @node Q2.0.12, Q2.0.13, Q2.0.11, Installation
-@section Why can't I strip XEmacs?
+@unnumberedsubsec Q2.0.12: Why can't I strip XEmacs?
-Richard Cognot <cognot@@fronsac.ensg.u-nancy.fr> writes:
+@email{cognot@@fronsac.ensg.u-nancy.fr, Richard Cognot} writes:
 @quotation
 Because of the way XEmacs (and every other Emacsen, AFAIK) is built. The
 link gives you a bare-boned emacs (called temacs). temacs is then run,
 preloading some of the lisp files. The result is then dumped into a new
 dumping xemacs. This will always work, although you can do that only if
 you install from sources (as temacs is @file{not} part of the binary
 kits).
 @end quotation
-Nat Makarevitch <nat@@nataa.fr.eu.org> writes:
+@email{nat@@nataa.fr.eu.org, Nat Makarevitch} writes:
 @quotation
 Here is the trick:
 @enumerate
 @item
 cp src/xemacs /usr/local/bin/xemacs
 @item
-cp lib-src/DOC-19.16-XEmacs /usr/local/lib/xemacs-19.16/i586-unknown-linuxaout
+cp lib-src/DOC-19.16-XEmacs
+@iftex
+\ @*
+@end iftex
+/usr/local/lib/xemacs-19.16/i586-unknown-linuxaout
 @end enumerate
 @end quotation
 @node Q2.0.13, Q2.0.14, Q2.0.12, Installation
-@section Problems linking with Gcc on Solaris
+@unnumberedsubsec Q2.0.13: Problems linking with Gcc on Solaris
 There are known difficulties linking with Gnu ld on Solaris.  A typical
 error message might look like:
 @example
 unexec(): dlopen(../dynodump/dynodump.so): ld.so.1: ./temacs:
 fatal: relocation error:
 symbol not found: main: referenced in ../dynodump/dynodump.so
 @end example
-Martin Buchholz <martin@@xemacs.org> writes:
+@email{martin@@xemacs.org, Martin Buchholz} writes:
 @quotation
 You need to specify @samp{-fno-gnu-linker} as part of your flags to pass
 to ld.  Future releases of XEmacs will try to do this automatically.
 @end quotation
 @node Q2.0.14, Q2.1.1, Q2.0.13, Installation
-@section Make on HP/UX 9 fails after linking temacs
+@unnumberedsubsec Q2.0.14: Make on HP/UX 9 fails after linking temacs
 Problem when building xemacs-19.16 on hpux 9:
-Richard Cognot <cognot@@ensg.u-nancy.fr> writes:
+@email{cognot@@ensg.u-nancy.fr, Richard Cognot} writes:
 @quotation
 make on hpux fails after linking temacs with a message:
 @example
 72.24.1.17.
 @end quotation
 @node Q2.1.1, Q2.1.2, Q2.0.14, Installation
-@section Help!  XEmacs just crashed on me!
+@unnumberedsec 2.1: Trouble Shooting
+@unnumberedsubsec Q2.1.1: Help!  XEmacs just crashed on me!
 First of all, don't panic.  Whenever XEmacs crashes, it tries extremely
 hard to auto-save all of your files before dying.  (The main time that
 this will not happen is if the machine physically lost power or if you
 killed the XEmacs process using @code{kill -9}).  The next time you try
 Now, XEmacs is not perfect, and there may occasionally be times, or
 particular sequences of actions, that cause it to crash.  If you can
 come up with a reproducible way of doing this (or even if you have a
 pretty good memory of exactly what you were doing at the time), the
 maintainers would be very interested in knowing about it.  Post a
-message to comp.emacs.xemacs or send mail to <crashes@@xemacs.org>.
+message to comp.emacs.xemacs or send mail to @email{crashes@@xemacs.org}.
 Please note that the @samp{crashes} address is exclusively for crash
 reports.
 If at all possible, include a stack backtrace of the core dump that was
 produced.  This shows where exactly things went wrong, and makes it much
 @item
 If the problem happened on a tty, please include the terminal type.
 @end enumerate
 @node Q2.1.2, Q2.1.3, Q2.1.1, Installation
-@section Cryptic Minibuffer messages.
+@unnumberedsubsec Q2.1.2: Cryptic Minibuffer messages.
 When I try to use some particular option of some particular package, I
 get a cryptic error in the minibuffer.
 If you can't figure out what's going on, select Options/General
 Messages (19.13 and earlier) or Help->Recent Keystrokes/Messages (19.14
 and later) from the menubar to see the most recent messages.  This
 command is bound to @kbd{C-h l} by default.
 @node Q2.1.3, Q2.1.4, Q2.1.2, Installation
-@section Translation Table Syntax messages at Startup
+@unnumberedsubsec Q2.1.3: Translation Table Syntax messages at Startup
 I get tons of translation table syntax error messages during startup.
 How do I get rid of them?
 There are two causes of this problem.  The first usually only strikes
 hardcoded at compile time so if the system the binary was built on puts
 it a different place than your system does, you have problems.  To fix,
 set the environment variable @var{XKEYSYMDB} to the location of the
 @file{XKeysymDB} file on your system or to the location of the one
 included with XEmacs which should be at
+@iftex
+@*
+@end iftex
 @file{<xemacs_root_directory>/lib/xemacs-19.16/etc/XKeysymDB}.
 @item
 The binary is finding the XKeysymDB but it is out-of-date on your system
 and does not contain the necessary lines.  Either ask your system
 is the stock R6 version and is backwards compatible) or set your
 @var{XKEYSYMDB} variable to the location of XEmacs's described above.
 @end itemize
 @node Q2.1.4, Q2.1.5, Q2.1.3, Installation
-@section Startup warnings about deducing proper fonts?
+@unnumberedsubsec Q2.1.4: Startup warnings about deducing proper fonts?
 How can I avoid the startup warnings about deducing proper fonts?
 This is highly dependent on your installation, but try with the
 following font as your base font for XEmacs and see what it does:
 @end lisp
 The buffer still exists; it just isn't in your face.
 @node Q2.1.5, Q2.1.6, Q2.1.4, Installation
-@section XEmacs cannot connect to my X Terminal!
+@unnumberedsubsec Q2.1.5: XEmacs cannot connect to my X Terminal!
 Help!  I can not get XEmacs to display on my Envizex X-terminal!
 Try setting the @var{DISPLAY} variable using the numeric IP address of
 the host you are running XEmacs from.
 @node Q2.1.6, Q2.1.7, Q2.1.5, Installation
-@section XEmacs just locked up my Linux X server!
+@unnumberedsubsec Q2.1.6: XEmacs just locked up my Linux X server!
 There have been several reports of the X server locking up under Linux.
 In all reported cases removing speedo and scaled fonts from the font
 path corrected the problem.  This can be done with the command
 @code{xset}.
 It is possible that using a font server may also solve the problem.
 @node Q2.1.7, Q2.1.8, Q2.1.6, Installation
-@section HP Alt key as Meta.
+@unnumberedsubsec Q2.1.7: HP Alt key as Meta.
 How can I make XEmacs recognize the Alt key of my HP workstation as a
 Meta key?
 Put the following line into a file and load it with xmodmap(1) before
 @example
 remove Mod1 = Mode_switch
 @end example
 @node Q2.1.8, Q2.1.9, Q2.1.7, Installation
-@section got (wrong-type-argument color-instance-p nil)
+@unnumberedsubsec Q2.1.8: got (wrong-type-argument color-instance-p nil)
-Natalie Kershaw <nataliek@@rd.scitec.com.au> writes:
+@email{nataliek@@rd.scitec.com.au, Natalie Kershaw} writes:
 @quotation
 I am trying to run xemacs 19.13 under X11R4. Whenever I move the mouse I
 get the following error. Has anyone seen anything like this? This
 doesn't occur on X11R5.
 @lisp
-Signalling: (error "got (wrong-type-argument color-instance-p nil) and I don't know why!")
+Signalling:
-@end lisp
+(error "got (wrong-type-argument color-instance-p nil)
-@end quotation
+and I don't know why!")
+@end lisp
-dinos <map01kd@@gold.ac.uk> writes:
+@end quotation
+@email{map01kd@@gold.ac.uk, dinos} writes:
 @quotation
 I think this is due to undefined resources; You need to define color
 backgrounds and foregrounds into your @file{.../app-defaults/Emacs}
 like:
 @example
 xemacs*cursorColor:    black
 xemacs*pointerColor:   black
 @end example
-With the new colors installed the problem still occurs if the above
+With the new colours installed the problem still occurs if the above
 resources are not defined.
-If the new colors are not present then an additional error occurs on
+If the new colours are not present then an additional error occurs on
 XEmacs startup, which says @samp{Color Red3} not defined.
 @end quotation
 @node Q2.1.9, Q2.1.10, Q2.1.8, Installation
-@section XEmacs causes my OpenWindows 3.0 server to crash.
+@unnumberedsubsec Q2.1.9: XEmacs causes my OpenWindows 3.0 server to crash.
 The OpenWindows 3.0 server is incredibly buggy.  Your best bet is to
 replace it with one from the generic MIT X11 release.  You might also
 try disabling parts of your @file{.emacs}, like enabling background
 pixmaps.
 @node Q2.1.10, Q2.1.11, Q2.1.9, Installation
-@section Warnings from incorrect key modifiers.
+@unnumberedsubsec Q2.1.10: Warnings from incorrect key modifiers.
 The following information comes from the @file{PROBLEMS} file that comes
 with XEmacs.
 If you're having troubles with HP/UX it is because HP/UX defines the
 add mod2 = Mode_switch
 EOF
 @end example
 @node Q2.1.11, Q2.1.12, Q2.1.10, Installation
-@section [This question intentionally left blank]
+@unnumberedsubsec Q2.1.11: [This question intentionally left blank]
 Obsolete question, left blank to avoid renumbering.
 @node Q2.1.12, Q2.1.13, Q2.1.11, Installation
-@section Problems with Regular Expressions on DEC OSF1.
+@unnumberedsubsec Q2.1.12: Problems with Regular Expressions on DEC OSF1.
 I have xemacs 19.13 running on an alpha running OSF1 V3.2 148 and ispell
 would not run because it claimed the version number was incorrect
 although it was indeed OK. I traced the problem to the regular
 expression handler.
-Douglas Kosovic <douglask@@dstc.edu.au> writes:
+@email{douglask@@dstc.edu.au, Douglas Kosovic} writes:
 @quotation
-Actually it's a DEC cc optimization bug that screws up the regexp
+Actually it's a DEC cc optimisation bug that screws up the regexp
 handling in XEmacs.
 Rebuilding using the @samp{-migrate} switch for DEC cc (which uses a
-different sort of optimization) works fine.
+different sort of optimisation) works fine.
 @end quotation
 See @file{xemacs-19_13-dunix-3_2c.patch} at the following URL on how to
 build with the @samp{-migrate} flag:
 @example
-<URL:http://www-digital.cern.ch/carney/emacs/emacs.html>
+@uref{http://www-digital.cern.ch/carney/emacs/emacs.html}
 @end example
 NOTE: There have been a variety of other problems reported that are
 fixed in this fashion.
 @node Q2.1.13, Q2.1.14, Q2.1.12, Installation
-@section HP/UX 10.10 and @code{create_process} failure.
+@unnumberedsubsec Q2.1.13: HP/UX 10.10 and @code{create_process} failure.
-Dave Carrigan <Dave.Carrigan@@ipl.ca> writes:
+@email{Dave.Carrigan@@ipl.ca, Dave Carrigan} writes:
 @quotation
 With XEmacs 19.13 and HP/UX 10.10, anything that relies on the
 @code{create_process} function fails. This breaks a lot of things
 (shell-mode, compile, ange-ftp, to name a few).
 @end quotation
-Phil Johnson <johnson@@dtc.hp.com> writes:
+@email{johnson@@dtc.hp.com, Phil Johnson} writes:
 @quotation
 This is a problem specific to HP-UX 10.10.  It only occurs when XEmacs
 is compiled for shared libraries (the default), so you can work around
 it by compiling a statically-linked binary (run configure with
 I'm not sure whether the problem is with a particular shared library or
 if it's a kernel problem which crept into 10.10.
 @end quotation
-Richard Cognot <cognot@@ensg.u-nancy.fr> writes:
+@email{cognot@@ensg.u-nancy.fr, Richard Cognot} writes:
 @quotation
 I had a few problems with 10.10. Apparently, some of them were solved by
 forcing a static link of libc (manually).
 @end quotation
 @node Q2.1.14, Q2.1.15, Q2.1.13, Installation
-@section @kbd{C-g} doesn't work for me.  Is it broken?
+@unnumberedsubsec Q2.1.14: @kbd{C-g} doesn't work for me.  Is it broken?
-Ben Wing <ben@@666.com> writes:
+@email{ben@@666.com, Ben Wing} writes:
 @quotation
 @kbd{C-g} does work for most people in most circumstances.  If it
 doesn't, there are only two explanations:
 To test #2, try executing @code{(while t)} from the @samp{*scratch*}
 buffer.  If @kbd{C-g} doesn't interrupt, then you're seeing #2.
 @end quotation
-Morten Welinder <terra@@diku.dk> writes:
+@email{terra@@diku.dk, Morten Welinder} writes:
 @quotation
 On some (but @emph{not} all) machines a hung XEmacs can be revived by
 @code{kill -FPE <pid>}.  This is a hack, of course, not a solution.
 This technique works on a Sun4 running 4.1.3_U1.  To see if it works for
 dump the method doesn't work and if you get @samp{Arithmetic error} then
 it does.
 @end quotation
 @node Q2.1.15, Q2.1.16, Q2.1.14, Installation
-@section How to Debug an XEmacs problem with a debugger
+@unnumberedsubsec Q2.1.15: How to Debug an XEmacs problem with a debugger
 If XEmacs does crash on you, one of the most productive things you can
 do to help get the bug fixed is to poke around a bit with the debugger.
 Here are some hints:
 @itemize @bullet
 @item
 First of all, if the crash is at all reproducible, consider very
 strongly recompiling your XEmacs with debugging symbols, with no
-optimization, and with the configure options @samp{--debug=yes} and
+optimization, and with the configure options @samp{--debug=yes},
-@samp{--error-checking=all}.  This will make your XEmacs run somewhat
+@samp{--error-checking=all}, and @samp{--dynamic=no}.  This will make
-slower but make it a lot more likely to catch the problem earlier
+your XEmacs run somewhat slower but make it a lot more likely to catch
-(closer to its source), and a lot easier to determine what's going on
+the problem earlier (closer to its source), and a lot easier to
-with a debugger.
+determine what's going on with a debugger.
 @item
 If you're able to run XEmacs under a debugger and reproduce the crash
 (if it's inconvenient to do this because XEmacs is already running or is
 running in batch mode as part of a bunch of scripts, consider attaching
 @item
 Internally, you will probably see lots of variables that hold objects of
 type @code{Lisp_Object}.  These are exactly what they appear to be,
 i.e. references to Lisp objects.  Printing them out with the debugger
-probably won't be too useful---you'll likely just see a number.  To
+probably won't be too useful---you'll just see a number.  To decode
-decode them, do this:
+them, do this:
 @example
 call debug_print (OBJECT)
 @end example
 Linux), stack backtraces of core dumps will have the frame where the
 fatal signal occurred mangled; if you can obtain a stack trace while
 running the XEmacs process under a debugger, the stack trace should be
 clean.
-Curtiss <1CMC3466@@ibm.mtsac.edu> suggests upgrading to ld.so version 1.8
+@email{1CMC3466@@ibm.mtsac.edu, Curtiss} suggests upgrading to ld.so version 1.8
 if dynamic linking and debugging is a problem on Linux.
 @item
 If you're using a debugger to get a C stack backtrace and you're
 getting a completely mangled and bogus stack trace, it's probably due to
 do this---it doesn't accomplish anything except to save a bit of disk
 space, and makes debugging much much harder.
 @item
 Your stack is getting trashed.  Debugging this is hard; you have to do a
-binary-search type of narrowing down where the crash occurs, until you
+binary-search-type of narrowing down where the crash occurs, until you
 figure out exactly which line is causing the problem.  Of course, this
 only works if the bug is highly reproducible.
 @item
 If your stack trace has exactly one frame in it, with address 0x0, this
 use the narrowing-down process described above.
 @item
 If you compiled 19.14 with @samp{--debug} (or by default in later
 versions), you will get a Lisp backtrace output when XEmacs crashes, so
-you'll have something useful.
+you'll have something useful.  If you're in 19.13, you could try doing
+@code{call debug_backtrace()}---sometimes this works even after a fatal
+signal has been received.
 @end enumerate
-@item
-If you compile with the newer gcc variants gcc-2.8 or egcs, you will
-need gdb 4.17.  At the time of writing, this has not yet been released.
-Pre-releases are available at ftp://ftp.cygnus.com/private/gdb.
-@item
-The above information on using @file{src/gdbinit} works for XEmacs-21.0
-and above.  For older versions of XEmacs, there are different
-@file{gdbinit} files provided in the @file{src} directory.  Use the one
-corresponding to the configure options used when building XEmacs.
 @end itemize
+Here's some more info about using gdbinit:
+Different version of @code{gdbinit} are provided for different
+platforms.  One of these should be installed as @file{.gdbinit} in your
+home directory.  If you're using XEmacs 19.14 or better, you should
+install the default @code{gdbinit} in the @file{src/} directory if you
+have GDB 4.14 or better.  With GDB 4.13 or earlier, install
+@file{gdbinit.pre-4.14}; however, this is noticeably harder to use.  If
+you're on a machine that uses a union type for Lisp_Objects (only the
+DEC Alpha, I think), you'll have to use @code{gdbinit.union}, which is
+of the pre-4.14 variety but should be easily upgradable.
+With XEmacs 19.13 and earlier, only one @code{gdbinit} is provided (I
+think); it's of the pre-4.14 variety and of the union-type
+variety. (Many more machines used the union type under 19.13).
+With the GDB 4.14+ gdbinit, you can print out a Lisp_Object using
+@code{p1 OBJECT} (which calls @code{debug_print()}, and hence only works
+if you have a running process) or @code{frob OBJECT} (which works even
+on core dumps, and does its own decoding of the object, but its output
+isn't always so convenient).
+With the pre-GDB 4.14 gdbinit, you have to do these steps:
+@example
+print OBJECT
+xtype
+<then type "xcons" or "xstring" or
+whatever, depending on the type>
+@end example
+If the object is a record type, you'll probably have to the following
+steps:
+@example
+print OBJECT
+xtype
+xrecord
+<remember what type is printed>
+print OBJECT
+<then type "xbuffer" or "xsymbol" or whatever>
+@end example
+Of course, if you know in advance what type the object is of, you can
+omit all but the last two steps.
 @node Q2.1.16, Q2.1.17, Q2.1.15, Installation
-@section XEmacs crashes in @code{strcat} on HP/UX 10
+@unnumberedsubsec Q2.1.16: XEmacs crashes in @code{strcat} on HP/UX 10
 >From the problems database (through
-<URL:http://support.mayfield.hp.com/>):
+@uref{http://support.mayfield.hp.com/}):
 @example
 Problem Report: 5003302299
 Status:         Open
 System/Model:   9000/700
 Product Name:   HPUX S800 10.0X
 Product Vers:   9245XB.10.00
-Description: strcat(3C) may read beyond end of source string, can cause
+Description: strcat(3C) may read beyond
-SIGSEGV
+end of source string, can cause SIGSEGV
 *** PROBLEM TEXT ***
 strcat(3C) may read beyond the source string onto an unmapped page,
 causing a segmentation violation.
 @end example
 @node Q2.1.17, Q2.1.18, Q2.1.16, Installation
-@section @samp{Marker does not point anywhere}
+@unnumberedsubsec Q2.1.17: @samp{Marker does not point anywhere}
 As with other errors, set @code{debug-on-error} to @code{t} to get the
 backtrace when the error occurs.  Specifically, two problems have been
 reported (and fixed).
 A problem with some early versions of Gnus 5.4 caused this error.
 Upgrade your Gnus.
 @end enumerate
 @node Q2.1.18, Q2.1.19, Q2.1.17, Installation
-@section 19.14 hangs on HP/UX 10.10.
+@unnumberedsubsec Q2.1.18: 19.14 hangs on HP/UX 10.10.
-Richard Cognot <cognot@@ensg.u-nancy.fr> writes:
+@email{cognot@@ensg.u-nancy.fr, Richard Cognot} writes:
 @quotation
 For the record, compiling on hpux 10.10 leads to a hang in Gnus when
 compiled with optimization on.
 is needed on 10.10, but @strong{not} on 10.01: if I run my 10.01 binary
 on a 10.01 machine, without @code{BROKEN_SIGIO} being defined, @kbd{C-g}
 works as expected.
 @end quotation
-Richard Cognot <cognot@@ensg.u-nancy.fr> adds:
+@email{cognot@@ensg.u-nancy.fr, Richard Cognot} adds:
 @quotation
-Apparently somebody has found the reason why there is this @samp{poll:
+Apparently somebody has found the reason why there is this
+@iftex
+@*
+@end iftex
+@samp{poll:
 interrupted...} message for each event.  For some reason, libcurses
 reimplements a @code{select()} system call, in a highly broken fashion.
 The fix is to add a -lc to the link line @emph{before} the
 -lxcurses. XEmacs will then use the right version of @code{select()}.
 @end quotation
-Alain Fauconnet <af@@biomath.jussieu.fr> writes:
+@email{af@@biomath.jussieu.fr, Alain Fauconnet} writes:
 @quotation
 The @emph{real} solution is to @emph{not} link -lcurses in!  I just
 changed -lcurses to -ltermcap in the Makefile and it fixed:
 socket which connects stdout...
 @end enumerate
 @end quotation
 @node Q2.1.19, Q2.1.20, Q2.1.18, Installation
-@section XEmacs does not follow the local timezone.
+@unnumberedsubsec Q2.1.19: XEmacs does not follow the local timezone.
 When using one of the prebuilt binaries many users have observed that
 XEmacs uses the timezone under which it was built, but not the timezone
 under which it is running.  The solution is to add:
 to your @file{.emacs} or the @file{site-start.el} file if you can.
 Replace @code{MET} with your local timezone.
 @node Q2.1.20, Q2.1.21, Q2.1.19, Installation
-@section @samp{Symbol's function definition is void: hkey-help-show.}
+@unnumberedsubsec Q2.1.20: @samp{Symbol's function definition is void: hkey-help-show.}
 This is a problem with a partially loaded hyperbole.  Try adding:
 @lisp
 (require 'hmouse-drv)
 @end lisp
 where you load hyperbole and the problem should go away.
 @node Q2.1.21, Q2.1.22, Q2.1.20, Installation
-@section Every so often the XEmacs frame freezes
+@unnumberedsubsec Q2.1.21: Every so often the XEmacs frame freezes
 This problem has been fixed in 19.15, and was due to a not easily
 reproducible race condition.
 @node Q2.1.22, Q2.1.23, Q2.1.21, Installation
-@section XEmacs seems to take a really long time to do some things
+@unnumberedsubsec Q2.1.22: XEmacs seems to take a really long time to do some things
-David Moore <dmoore@@ucsd.edu> writes:
+@email{dmoore@@ucsd.edu, David Moore} writes:
 @quotation
 Two things you can do:
 1) C level:
 debug-on-quit doesn't work if something's turned on inhibit-quit or in
 some other strange cases.
 @end quotation
 @node Q2.1.23,  , Q2.1.22, Installation
-@section  Movemail on Linux does not work for XEmacs 19.15 and later.
+@unnumberedsubsec Q2.1.23:  Movemail on Linux does not work for XEmacs 19.15 and later.
 Movemail used to work fine in 19.14 but has stopped working in 19.15
 and 20.x.  I am using Linux.
-SL Baur <steve@@xemacs.org> writes:
+@email{steve@@xemacs.org, SL Baur} writes:
 @quotation
 Movemail on Linux used to default to using flock file locking.  With
 19.15 and later versions it now defaults to using @code{.lock} file
 locking.  If this is not appropriate for your system, edit src/s/linux.h
 #define MAIL_USE_FLOCK
 @end example
 @end quotation
 @node Customization, Subsystems, Installation, Top
-@chapter Customization and Options
+@unnumbered 3 Customization and Options
 This is part 3 of the XEmacs Frequently Asked Questions list.  This
 section is devoted to Customization and screen settings.
 @menu
 Customization---Emacs Lisp and @file{.emacs}:
 * Q3.0.1::      What version of Emacs am I running?
 * Q3.0.2::      How do I evaluate Elisp expressions?
 * Q3.0.3::      @code{(setq tab-width 6)} behaves oddly.
 * Q3.0.4::      How can I add directories to the @code{load-path}?
 * Q3.0.5::      How to check if a lisp function is defined?
 * Q3.0.6::      Can I force the output of @code{(face-list)} to a buffer?
 * Q3.0.7::      Font selections don't get saved after @code{Save Options}.
 * Q3.0.8::      How do I make a single minibuffer frame?
 * Q3.0.9::      What is @code{Customize}?
 X Window System & Resources:
 * Q3.1.1::      Where is a list of X resources?
 * Q3.1.3::      @code{(set-screen-width)} worked in 19.6, but not in 19.13?
 * Q3.1.4::      Specifying @code{Emacs*EmacsScreen.geometry} in @file{.emacs} does not work in 19.15?
 * Q3.1.5::      How can I get the icon to just say @samp{XEmacs}?
 * Q3.1.6::      How can I have the window title area display the full path?
 * Q3.1.7::      @samp{xemacs -name junk} doesn't work?
-* Q3.1.8::      @samp{-iconic} doesn't work.
+* Q3.1.8::      @samp{-iconic} it doesn't work.
 Textual Fonts & Colors:
 * Q3.2.1::      How can I set color options from @file{.emacs}?
 * Q3.2.2::      How do I set the text, menu and modeline fonts?
 * Q3.2.3::      How can I set the colors when highlighting a region?
 * Q3.2.4::      How can I limit color map usage?
 * Q3.2.5::      My tty supports color, but XEmacs doesn't use them.
 The Modeline:
 * Q3.3.1::      How can I make the modeline go away?
 * Q3.3.2::      How do you have XEmacs display the line number in the modeline?
 * Q3.3.3::      How do I get XEmacs to put the time of day on the modeline?
 * Q3.3.4::      How do I turn off current chapter from AUC TeX modeline?
 * Q3.3.5::      How can one change the modeline color based on the mode used?
 3.4 Multiple Device Support:
 * Q3.4.1::      How do I open a frame on another screen of my multi-headed display?
 * Q3.4.2::      Can I really connect to a running XEmacs after calling up over a modem?  How?
 3.5 The Keyboard:
 * Q3.5.1::      How can I bind complex functions (or macros) to keys?
 * Q3.5.2::      How can I stop down-arrow from adding empty lines to the bottom of my buffers?
 * Q3.5.3::      How do I bind C-. and C-; to scroll one line up and down?
 * Q3.5.4::      Globally binding @kbd{Delete}?
 * Q3.5.5::      Scrolling one line at a time.
 * Q3.5.6::      How to map @kbd{Help} key alone on Sun type4 keyboard?
 * Q3.5.7::      How can you type in special characters in XEmacs?
 * Q3.5.8::      Why does @code{(global-set-key [delete-forward] 'delete-char)} complain?
 * Q3.5.9::      How do I make the Delete key delete forward?
 * Q3.5.10::     Can I turn on @dfn{sticky} modifier keys?
 * Q3.9.2::      How can one use resources to change scrollbar colors?
 * Q3.9.3::      Moving the scrollbar can move the point; can I disable this?
 * Q3.9.4::      How can I get automatic horizontal scrolling?
 Text Selections:
 * Q3.10.1::     How can I turn off or change highlighted selections?
 * Q3.10.2::     How do I get that typing on an active region removes it?
 * Q3.10.3::     Can I turn off the highlight during isearch?
 * Q3.10.4::     How do I turn off highlighting after @kbd{C-x C-p} (mark-page)?
 * Q3.10.5::     The region disappears when I hit the end of buffer while scrolling.
 @end menu
 @node Q3.0.1, Q3.0.2, Customization, Customization
-@section What version of Emacs am I running?
+@unnumberedsec 3.0: Customization -- Emacs Lisp and .emacs
+@unnumberedsubsec Q3.0.1: What version of Emacs am I running?
 How can @file{.emacs} determine which of the family of Emacsen I am
 using?
 To determine if you are currently running GNU Emacs 18, GNU Emacs 19,
 @lisp
 (defvar running-xemacs (string-match "XEmacs\\|Lucid" emacs-version))
 @end lisp
 @node Q3.0.2, Q3.0.3, Q3.0.1, Customization
-@section How can I evaluate Emacs-Lisp expressions?
+@unnumberedsubsec Q3.0.2: How can I evaluate Emacs-Lisp expressions?
 I know I can evaluate Elisp expressions from @code{*scratch*} buffer
 with @kbd{C-j} after the expression.  How do I do it from another
 buffer?
 enter the expression to the minibuffer.  In XEmacs prior to 19.15
 @code{eval-expression} used to be a disabled command by default.  If
 this is the case, upgrade your XEmacs.
 @node Q3.0.3, Q3.0.4, Q3.0.2, Customization
-@section @code{(setq tab-width 6)} behaves oddly.
+@unnumberedsubsec Q3.0.3: @code{(setq tab-width 6)} behaves oddly.
 If you put @code{(setq tab-width 6)} in your @file{.emacs} file it does
 not work!  Is there a reason for this?  If you do it at the EVAL prompt
 it works fine!! How strange.
 Use @code{setq-default} instead, since @code{tab-width} is
 all-buffer-local.
 @node Q3.0.4, Q3.0.5, Q3.0.3, Customization
-@section How can I add directories to the @code{load-path}?
+@unnumberedsubsec Q3.0.4: How can I add directories to the @code{load-path}?
 Here are two ways to do that, one that puts your directories at the
 front of the load-path, the other at the end:
 @lisp
 ;;; Add things at the end, unconditionally
 (setq load-path (nconc load-path '("foo" "bar")))
 @end lisp
-keith (k.p.) hanlan <keithh@@nortel.ca> writes:
+@email{keithh@@nortel.ca, keith (k.p.) hanlan} writes:
 @quotation
 To add directories using Unix shell metacharacters use
 @file{expand-file-name} like this:
 (push (expand-file-name "~keithh/.emacsdir") load-path)
 @end lisp
 @end quotation
 @node Q3.0.5, Q3.0.6, Q3.0.4, Customization
-@section How to check if a lisp function is defined?
+@unnumberedsubsec Q3.0.5: How to check if a lisp function is defined?
 Use the following elisp:
 @lisp
 (fboundp 'foo)
 It's almost always a mistake to test @code{emacs-version} or any similar
 variables.
 Instead, use feature-tests, such as @code{featurep}, @code{boundp},
-@code{fboundp}, or even simple behavioral tests, eg.:
+@code{fboundp}, or even simple behavioural tests, eg.:
 @lisp
 (defvar foo-old-losing-code-p
 (condition-case nil (progn (losing-code t) nil)
 (wrong-number-of-arguments t)))
 @end lisp
 There is an incredible amount of broken code out there which could work
 much better more often in more places if it did the above instead of
 trying to divine its environment from the value of one variable.
 @node Q3.0.6, Q3.0.7, Q3.0.5, Customization
-@section Can I force the output of @code{(face-list)} to a buffer?
+@unnumberedsubsec Q3.0.6: Can I force the output of @code{(face-list)} to a buffer?
 It would be good having it in a buffer, as the output of
 @code{(face-list)} is too wide to fit to a minibuffer.
 Evaluate the expression in the @samp{*scratch*} buffer with point after
 If the minibuffer smallness is the only problem you encounter, you can
 simply press @kbd{C-h l} to get the former minibuffer contents in a
 buffer.
 @node Q3.0.7, Q3.0.8, Q3.0.6, Customization
-@section Font selections in don't get saved after @code{Save Options}.
+@unnumberedsubsec Q3.0.7: Font selections in don't get saved after @code{Save Options}.
 For XEmacs 19.14 and previous:
-John Mann <mannj@@ll.mit.edu> writes:
+@email{mannj@@ll.mit.edu, John Mann} writes:
 @quotation
 You have to go to Options->Menubar Appearance and unselect
 @samp{Frame-Local Font Menu}.  If this option is selected, font changes
 are only applied to the @emph{current} frame and do @emph{not} get saved
 when you save options.
 @end quotation
 For XEmacs 19.15 and later:
 Implement the above as well as set the following in your @file{.emacs}
 @lisp
 (setq options-save-faces t)
 @end lisp
 @node Q3.0.8, Q3.0.9, Q3.0.7, Customization
-@section How do I get a single minibuffer frame?
+@unnumberedsubsec Q3.0.8: How do I get a single minibuffer frame?
-Vin Shelton <acs@@acm.org> writes:
+@email{acs@@acm.org, Vin Shelton} writes:
 @lisp
 (setq initial-frame-plist '(minibuffer nil))
 (setq default-frame-plist '(minibuffer nil))
 (setq default-minibuffer-frame
 (make-frame
-	'(minibuffer only
+'(minibuffer only
-width 86
+		    width 86
-height 1
+		    height 1
-menubar-visible-p nil
+		    menubar-visible-p nil
-default-toolbar-visible-p nil
+		    default-toolbar-visible-p nil
-name "minibuffer"
+		    name "minibuffer"
-top -2
+		    top -2
-left -2
+		    left -2
-has-modeline-p nil)))
+		    has-modeline-p nil)))
 (frame-notice-user-settings)
 @end lisp
 @strong{NOTE:} The single minibuffer frame may not be to everyone's
 taste, and there any number of other XEmacs options settings that may
 make it difficult or inconvenient to use.
 @node Q3.0.9, Q3.1.1, Q3.0.8, Customization
-@section What is @code{Customize}?
+@unnumberedsubsec Q3.0.9: What is @code{Customize}?
 Starting with XEmacs 20.2 there is new system 'Customize' for customizing
 XEmacs options.
 You can access @code{Customize} from the @code{Options} menu
 Starting with XEmacs 20.3 there is also new `browser' mode for Customize.
 Try it out with @kbd{M-x customize-browse}
 @node Q3.1.1, Q3.1.2, Q3.0.9, Customization
-@section Where is a list of X resources?
+@unnumberedsec 3.1: X Window System & Resources
+@unnumberedsubsec Q3.1.1: Where is a list of X resources?
 Search through the @file{NEWS} file for @samp{X Resources}.  A fairly
 comprehensive list is given after it.
 In addition, an @file{app-defaults} file is supplied,
 entries are slightly altered.  Be careful about installing the contents
 of this file into your @file{.Xdefaults} or @file{.Xresources} file if
 you use GNU Emacs under X11 as well.
 @node Q3.1.2, Q3.1.3, Q3.1.1, Customization
-@section How can I detect a color display?
+@unnumberedsubsec Q3.1.2: How can I detect a color display?
 You can test the return value of the function @code{(device-class)}, as
 in:
 @lisp
 ....
 )
 @end lisp
 @node Q3.1.3, Q3.1.4, Q3.1.2, Customization
-@section @code{(set-screen-width)} worked in 19.6, but not in 19.13?
+@unnumberedsubsec Q3.1.3: @code{(set-screen-width)} worked in 19.6, but not in 19.13?
 In Lucid Emacs 19.6 I did @code{(set-screen-width @var{characters})} and
 @code{(set-screen-height @var{lines})} in my @file{.emacs} instead of
-specifying @code{Emacs*EmacsScreen.geometry} in my @file{.Xdefaults} but
+specifying @code{Emacs*EmacsScreen.geometry} in my
+@iftex
+@*
+@end iftex
+@file{.Xdefaults} but
 this does not work in XEmacs 19.13.
 These two functions now take frame arguments:
 @lisp
 (set-frame-width (selected-frame) @var{characters})
 (set-frame-height (selected-frame) @var{lines})
 @end lisp
 @node Q3.1.4, Q3.1.5, Q3.1.3, Customization
-@section Specifying @code{Emacs*EmacsScreen.geometry} in @file{.emacs} does not work in 19.15?
+@unnumberedsubsec Q3.1.4: Specifying @code{Emacs*EmacsScreen.geometry} in @file{.emacs} does not work in 19.15?
 In XEmacs 19.11 I specified @code{Emacs*EmacsScreen.geometry} in
 my @file{.emacs} but this does not work in XEmacs 19.15.
 We have switched from using the term @dfn{screen} to using the term
 @example
 Emacs*EmacsFrame.geometry
 @end example
 @node Q3.1.5, Q3.1.6, Q3.1.4, Customization
-@section How can I get the icon to just say @samp{XEmacs}?
+@unnumberedsubsec Q3.1.5: How can I get the icon to just say @samp{XEmacs}?
 I'd like the icon to just say @samp{XEmacs}, and not include the name of
 the current file in it.
 Add the following line to your @file{.emacs}:
 @lisp
 (setq frame-icon-title-format "XEmacs")
 @end lisp
 @node Q3.1.6, Q3.1.7, Q3.1.5, Customization
-@section How can I have the window title area display the full path?
+@unnumberedsubsec Q3.1.6: How can I have the window title area display the full path?
 I'd like to have the window title area display the full directory/name
 of the current buffer file and not just the name.
 Add the following line to your @file{.emacs}:
 A more sophisticated title might be:
 @lisp
 (setq frame-title-format
-'("%S: " (buffer-file-name "%f" (dired-directory dired-directory "%b"))))
+'("%S: " (buffer-file-name "%f"
+				 (dired-directory dired-directory "%b"))))
 @end lisp
 That is, use the file name, or the dired-directory, or the buffer name.
 @node Q3.1.7, Q3.1.8, Q3.1.6, Customization
-@section @samp{xemacs -name junk} doesn't work?
+@unnumberedsubsec Q3.1.7: @samp{xemacs -name junk} doesn't work?
 When I run @samp{xterm -name junk}, I get an xterm whose class name
 according to xprop, is @samp{junk}.  This is the way it's supposed to
 work, I think.  When I run @samp{xemacs -name junk} the class name is
 not set to @samp{junk}.  It's still @samp{emacs}.  What does
 @lisp
 (make-frame '((name . "the-name")))
 @end lisp
 @node Q3.1.8, Q3.2.1, Q3.1.7, Customization
-@section @samp{-iconic} doesn't work.
+@unnumberedsubsec Q3.1.8: @samp{-iconic} doesn't work.
 When I start up XEmacs using @samp{-iconic} it doesn't work right.
 Using @samp{-unmapped} on the command line, and setting the
 @code{initiallyUnmapped} X Resource don't seem to help much either...
-Ben Wing <ben@@666.com> writes:
+@email{ben@@666.com, Ben Wing} writes:
 @quotation
 Ugh, this stuff is such an incredible mess that I've about given up
 getting it to work.  The principal problem is numerous window-manager
 bugs...
 @end quotation
 @node Q3.2.1, Q3.2.2, Q3.1.8, Customization
-@section How can I set color options from @file{.emacs}?
+@unnumberedsec 3.2: Textual Fonts & Colors
+@unnumberedsubsec Q3.2.1: How can I set color options from @file{.emacs}?
 How can I set the most commonly used color options from my @file{.emacs}
 instead of from my @file{.Xdefaults}?
 Like this:
 @lisp
-(set-face-background 'default      "bisque")     ; frame background
+(set-face-background 'default      "bisque") ; frame background
-(set-face-foreground 'default      "black")      ; normal text
+(set-face-foreground 'default      "black") ; normal text
-(set-face-background 'zmacs-region "red")        ; When selecting w/
+(set-face-background 'zmacs-region "red") ; When selecting w/
-; mouse
+					; mouse
 (set-face-foreground 'zmacs-region "yellow")
 (set-face-font       'default      "*courier-bold-r*120-100-100*")
-(set-face-background 'highlight    "blue")       ; Ie when selecting buffers
+(set-face-background 'highlight    "blue") ; Ie when selecting
+					; buffers
 (set-face-foreground 'highlight    "yellow")
-(set-face-background 'modeline     "blue")       ; Line at bottom of buffer
+(set-face-background 'modeline     "blue") ; Line at bottom
+					; of buffer
 (set-face-foreground 'modeline     "white")
 (set-face-font       'modeline     "*bold-r-normal*140-100-100*")
-(set-face-background 'isearch      "yellow")     ; When highlighting while
+(set-face-background 'isearch      "yellow") ; When highlighting
-; searching
+					; while searching
 (set-face-foreground 'isearch      "red")
-(setq x-pointer-foreground-color   "black")      ; Adds to bg color,
+(setq x-pointer-foreground-color   "black") ; Adds to bg color,
-; so keep black
+					; so keep black
-(setq x-pointer-background-color   "blue")       ; This is color you really
+(setq x-pointer-background-color   "blue") ; This is color
-; want ptr/crsr
+					; you really
+					; want ptr/crsr
 @end lisp
 @node Q3.2.2, Q3.2.3, Q3.2.1, Customization
-@section How do I set the text, menu and modeline fonts?
+@unnumberedsubsec Q3.2.2: How do I set the text, menu and modeline fonts?
 Note that you should use @samp{Emacs.} and not @samp{Emacs*} when
 setting face values.
 In @file{.Xdefaults}:
 @example
 Emacs.default.attributeFont:  -*-*-medium-r-*-*-*-120-*-*-m-*-*-*
 Emacs*menubar*font:           fixed
 Emacs.modeline.attributeFont: fixed
 @end example
 This is confusing because modeline is a face, and can be found listed
 while menubar is a normal X thing that uses the specification
 @code{font}.  With Motif it may be necessary to use @code{fontList}
 instead of @code{font}.
 @node Q3.2.3, Q3.2.4, Q3.2.2, Customization
-@section How can I set the colors when highlighting a region?
+@unnumberedsubsec Q3.2.3: How can I set the colors when highlighting a region?
 How can I set the background/foreground colors when highlighting a
 region?
 You can change the face @code{zmacs-region} either in your
 @end example
 or in your @file{.emacs}:
 @lisp
 (set-face-background 'zmacs-region "red")
 (set-face-foreground 'zmacs-region "yellow")
 @end lisp
 @node Q3.2.4, Q3.2.5, Q3.2.3, Customization
-@section How can I limit color map usage?
+@unnumberedsubsec Q3.2.4: How can I limit color map usage?
 I'm using Netscape (or another color grabber like XEmacs);
 is there anyway to limit the number of available colors in the color map?
 XEmacs 19.13 didn't have such a mechanism (unlike netscape, or other
 Starting with XEmacs 19.14, XEmacs uses the closest available color if
 the colormap is full, so it's O.K. now to start Netscape first.
 @node Q3.2.5, Q3.3.1, Q3.2.4, Customization
-@section My tty supports color, but XEmacs doesn't use them.
+@unnumberedsubsec Q3.2.5: My tty supports color, but XEmacs doesn't use them.
 XEmacs tries to automatically determine whether your tty supports color,
 but sometimes guesses wrong.  In that case, you can make XEmacs Do The
 Right Thing using this Lisp code:
 (if (eq 'tty (device-type))
 (set-device-class nil 'color))
 @end lisp
 @node Q3.3.1, Q3.3.2, Q3.2.5, Customization
-@section How can I make the modeline go away?
+@unnumberedsubsec Q3.3.1: How can I make the modeline go away?
 @lisp
 (set-specifier has-modeline-p nil)
 @end lisp
 Starting with XEmacs 19.14 the modeline responds to mouse clicks, so if
 you haven't liked or used the modeline in the past, you might want to
 try the new version out.
 @node Q3.3.2, Q3.3.3, Q3.3.1, Customization
-@section How do you have XEmacs display the line number in the modeline?
+@unnumberedsubsec Q3.3.2: How do you have XEmacs display the line number in the modeline?
 Add the following line to your @file{.emacs} file to display the
 line number:
 @lisp
 @lisp
 (column-number-mode 1)
 @end lisp
 Or select from the @code{Options} menu
-@code{Customize->Emacs->Editing->Basics->Line Number Mode}
+@iftex
+@*
+@end iftex
+@code{Customize->Emacs->Editing->Basics->Line Number Mode}
 and/or
-@code{Customize->Emacs->Editing->Basics->Column Number Mode}
+@iftex
+@*
+@end iftex
+@code{Customize->Emacs->Editing->Basics->Column Number Mode}
 Or type @kbd{M-x customize RET editing-basics RET}.
 @node Q3.3.3, Q3.3.4, Q3.3.2, Customization
-@section How do I get XEmacs to put the time of day on the modeline?
+@unnumberedsubsec Q3.3.3: How do I get XEmacs to put the time of day on the modeline?
 Add the following line to your @file{.emacs} file to display the
 time:
 @lisp
 @end lisp
 See @code{Customize} from the @code{Options} menu for customization.
 @node Q3.3.4, Q3.3.5, Q3.3.3, Customization
-@section How do I turn off current chapter from AUC TeX modeline?
+@unnumberedsubsec Q3.3.4: How do I turn off current chapter from AUC TeX modeline?
 With AUC TeX, fast typing is hard because the current chapter, section
 etc. are given in the modeline.  How can I turn this off?
 It's not AUC TeX, it comes from @code{func-menu} in @file{func-menu.el}.
 Or just add a hook to @code{TeX-mode-hook} to turn it off only for TeX
 mode:
 @lisp
-(add-hook 'TeX-mode-hook '(lambda () (setq fume-display-in-modeline-p nil)))
+(add-hook 'TeX-mode-hook
-@end lisp
+	  '(lambda () (setq fume-display-in-modeline-p nil)))
+@end lisp
-David Hughes <dhughes@@origin-at.co.uk> writes:
+@email{dhughes@@origin-at.co.uk, David Hughes} writes:
 @quotation
 If you have 19.14 or later, try this instead; you'll still get the
 function name displayed in the modeline, but it won't attempt to keep
 track when you modify the file. To refresh when it gets out of synch,
 (setq-default fume-auto-rescan-buffer-p nil)
 @end lisp
 @end quotation
 @node Q3.3.5, Q3.4.1, Q3.3.4, Customization
-@section How can one change the modeline color based on the mode used?
+@unnumberedsubsec Q3.3.5: How can one change the modeline color based on the mode used?
 You can use something like the following:
 @lisp
 (add-hook 'lisp-mode-hook
 (lambda ()
 (set-face-background 'modeline "red" (current-buffer))))
 @end lisp
 Then, when editing a Lisp file (i.e. when in Lisp mode), the modeline
 This works in 19.15 as well, but there are additional modeline faces,
 @code{modeline-buffer-id}, @code{modeline-mousable}, and
 @code{modeline-mousable-minor-mode}, which you may want to customize.
 @node Q3.4.1, Q3.4.2, Q3.3.5, Customization
-@section How do I open a frame on another screen of my multi-headed display?
+@unnumberedsec 3.4: Multiple Device Support
+@unnumberedsubsec Q3.4.1: How do I open a frame on another screen of my multi-headed display?
 The support for this was revamped for 19.14.  Use the command
 @kbd{M-x make-frame-on-display}.  This command is also on the File menu
 in the menubar.
 XEmacs 19.14 and later also have the command @code{make-frame-on-tty}
 which will establish a connection to any tty-like device.  Opening the
 TTY devices should be left to @code{gnuclient}, though.
 @node Q3.4.2, Q3.5.1, Q3.4.1, Customization
-@section Can I really connect to a running XEmacs after calling up over a modem?  How?
+@unnumberedsubsec Q3.4.2: Can I really connect to a running XEmacs after calling up over a modem?  How?
 If you're not running at least XEmacs 19.14, you can't.  Otherwise check
 out the @code{gnuattach} program supplied with XEmacs.  Starting with
 XEmacs 20.3, @code{gnuattach} and @code{gnudoit} functionality is
 provided by @code{gnuclient}.
 Also @xref{Q5.0.12}.
 @node Q3.5.1, Q3.5.2, Q3.4.2, Customization
-@section How can I bind complex functions (or macros) to keys?
+@unnumberedsec 3.5: The Keyboard
+@unnumberedsubsec Q3.5.1: How can I bind complex functions (or macros) to keys?
 As an example, say you want the @kbd{paste} key on a Sun keyboard to
 insert the current Primary X selection at point. You can accomplish this
 with:
 pass arguments to @code{x-insert-selection}.  This is done by wrapping
 the call in a 'lambda form:
 @lisp
 (global-set-key [f18]
 (lambda () (interactive) (x-insert-selection t nil)))
 @end lisp
 This binds the f18 key to a @dfn{generic} functional object.  The
 interactive spec is required because only interactive functions can be
 bound to keys.
 For the FAQ example you could use:
 @lisp
 (global-set-key [(control ?.)]
-		(lambda () (interactive) (scroll-up 1)))
+(lambda () (interactive) (scroll-up 1)))
-(global-set-key [(control ?;)]
+(global-set-key [(control ?		;)]
-	        (lambda () (interactive) (scroll-up -1)))
+			  (lambda () (interactive) (scroll-up -1)))
 @end lisp
 This is fine if you only need a few functions within the lambda body.
 If you're doing more it's cleaner to define a separate function as in
 question 3.5.3 (@xref{Q3.5.3}).
 @node Q3.5.2, Q3.5.3, Q3.5.1, Customization
-@section How can I stop down-arrow from adding empty lines to the bottom of my buffers?
+@unnumberedsubsec Q3.5.2: How can I stop down-arrow from adding empty lines to the bottom of my buffers?
 Add the following line to your @file{.emacs} file:
 @lisp
 (setq next-line-add-newlines nil)
 @end lisp
 This has been the default setting in XEmacs for some time.
 @node Q3.5.3, Q3.5.4, Q3.5.2, Customization
-@section How do I bind C-. and C-; to scroll one line up and down?
+@unnumberedsubsec Q3.5.3: How do I bind C-. and C-; to scroll one line up and down?
-Add the following (Thanks to Richard Mlynarik <mly@@adoc.xerox.com> and
+Add the following (Thanks to @email{mly@@adoc.xerox.com, Richard Mlynarik} and
-Wayne Newberry <wayne@@zen.cac.stratus.com>) to @file{.emacs}:
+@email{wayne@@zen.cac.stratus.com, Wayne Newberry}) to @file{.emacs}:
 @lisp
 (defun scroll-up-one-line ()
 (interactive)
 (scroll-up 1))
 (defun scroll-down-one-line ()
 (interactive)
 (scroll-down 1))
-(global-set-key [(control ?.)] 'scroll-up-one-line)        ; C-.
+(global-set-key [(control ?.)] 'scroll-up-one-line) ; C-.
-(global-set-key [(control ?;)] 'scroll-down-one-line)      ; C-;
+(global-set-key [(control ?		;)] 'scroll-down-one-line) ; C-;
 @end lisp
 The key point is that you can only bind simple functions to keys; you
 can not bind a key to a function that you're also passing arguments to.
 (@xref{Q3.5.1} for a better answer).
 @node Q3.5.4, Q3.5.5, Q3.5.3, Customization
-@section Globally binding @kbd{Delete}?
+@unnumberedsubsec Q3.5.4: Globally binding @kbd{Delete}?
 I cannot manage to globally bind my @kbd{Delete} key to something other
 than the default.  How does one do this?
 @lisp
 good example of how to do this correctly.
 Also @xref{Q3.5.10}.
 @node Q3.5.5, Q3.5.6, Q3.5.4, Customization
-@section Scrolling one line at a time.
+@unnumberedsubsec Q3.5.5: Scrolling one line at a time.
 Can the cursor keys scroll the screen a line at a time, rather than the
 default half page jump?  I tend it to find it disorienting.
 Try this:
 Select from the @code{Options} menu
 @code{Customize->Emacs->Environment->Windows->Scroll Step...} or type
 @kbd{M-x customize RET windows RET}.
 @node Q3.5.6, Q3.5.7, Q3.5.5, Customization
-@section How to map @kbd{Help} key alone on Sun type4 keyboard?
+@unnumberedsubsec Q3.5.6: How to map @kbd{Help} key alone on Sun type4 keyboard?
 The following works in GNU Emacs 19:
 @lisp
-(global-set-key [help] 'help-command)  		;; Help
+(global-set-key [help] 'help-command);; Help
 @end lisp
 The following works in XEmacs 19.15 with the addition of shift:
 @lisp
-(global-set-key [(shift help)] 'help-command)  		;; Help
+(global-set-key [(shift help)] 'help-command);; Help
 @end lisp
 But it doesn't work alone.  This is in the file @file{PROBLEMS} which
 should have come with your XEmacs installation: @emph{Emacs ignores the
 @kbd{help} key when running OLWM}.
 OLWM grabs the @kbd{help} key, and retransmits it to the appropriate
-client using @code{XSendEvent}.  Allowing Emacs to react to synthetic
+client using
+@iftex
+@*
+@end iftex
+@code{XSendEvent}.  Allowing Emacs to react to synthetic
 events is a security hole, so this is turned off by default.  You can
 enable it by setting the variable @code{x-allow-sendevents} to t.  You
 can also cause fix this by telling OLWM to not grab the help key, with
 the null binding @code{OpenWindows.KeyboardCommand.Help:}.
 @node Q3.5.7, Q3.5.8, Q3.5.6, Customization
-@section How can you type in special characters in XEmacs?
+@unnumberedsubsec Q3.5.7: How can you type in special characters in XEmacs?
 One way is to use the package @code{x-compose}.  Then you can use
 sequences like @kbd{Compose " a} to get �, etc.
 Another way is to use the @code{iso-insert} package, provided in XEmacs
 19.15 and later. Then you can use sequences like @kbd{C-x 8 " a} to get
 �, etc.
 @node Q3.5.8, Q3.5.9, Q3.5.7, Customization
-@section Why does @code{(global-set-key [delete-forward] 'delete-char)} complain?
+@unnumberedsubsec Q3.5.8: Why does @code{(global-set-key [delete-forward] 'delete-char)} complain?
 Why does @code{(define-key global-map [ delete-forward ] 'delete-char)}
 complain of not being able to bind an unknown key?
 Try this instead:
 expected behavior.
 This bug has been fixed in 19.14.
 @node Q3.5.9, Q3.5.10, Q3.5.8, Customization
-@section How do I make the Delete key delete forward?
+@unnumberedsubsec Q3.5.9: How do I make the Delete key delete forward?
 With XEmacs-20.2 use the @code{delbs} package:
 @lisp
 (require 'delbs)
 type @kbd{M-x customize RET editing-basics RET}.
 Also @xref{Q3.5.4}.
 @node Q3.5.10, Q3.6.1, Q3.5.9, Customization
-@section Can I turn on @dfn{sticky} modifier keys?
+@unnumberedsubsec Q3.5.10: Can I turn on @dfn{sticky} modifier keys?
 Yes, with @code{(setq modifier-keys-are-sticky t)}.  This will give the
 effect of being able to press and release Shift and have the next
 character typed come out in upper case.  This will affect all the other
 modifier keys like Control and Meta as well.
-Ben Wing <ben@@666.com> writes:
+@email{ben@@666.com, Ben Wing} writes:
 @quotation
 One thing about the sticky modifiers is that if you move the mouse out
 of the frame and back in, it cancels all currently ``stuck'' modifiers.
 @end quotation
 @node Q3.6.1, Q3.6.2, Q3.5.10, Customization
-@section Is there a way to make the bar cursor thicker?
+@unnumberedsec 3.6: The Cursor
+@unnumberedsubsec Q3.6.1: Is there a way to make the bar cursor thicker?
 I'd like to have the bar cursor a little thicker, as I tend to "lose" it
 often.
 For a 1 pixel bar cursor, use:
 @example
 Emacs*cursorColor:	Red
 @end example
 @node Q3.6.2, Q3.6.3, Q3.6.1, Customization
-@section Is there a way to get back the block cursor?
+@unnumberedsubsec Q3.6.2: Is there a way to get back the block cursor?
 @lisp
 (setq bar-cursor nil)
 @end lisp
 Select from the @code{Options} menu
 @code{Customize->Emacs->Environment->Display->Bar Cursor...} or type
 @kbd{M-x customize RET display RET}.
 @node Q3.6.3, Q3.7.1, Q3.6.2, Customization
-@section Can I make the cursor blink?
+@unnumberedsubsec Q3.6.3: Can I make the cursor blink?
 If you are running a version of XEmacs older than 19.14, no.  Otherwise
 you can do the following:
 @lisp
 This function toggles between a steady cursor and a blinking cursor.
 You may also set this mode from the menu bar by selecting @samp{Options
 => Frame Appearance => Blinking Cursor}.  Remember to save options.
 @node Q3.7.1, Q3.7.2, Q3.6.3, Customization
-@section How can I turn off Mouse pasting?
+@unnumberedsec 3.7: The Mouse and Highlighting
+@unnumberedsubsec Q3.7.1: How can I turn off Mouse pasting?
 I keep hitting the middle mouse button by accident and getting stuff
 pasted into my buffer so how can I turn this off?
 Here is an alternative binding, whereby the middle mouse button selects
 (mark-sexp 1))
 (define-key global-map [button2] 'mouse-set-point-and-select)
 @end lisp
 @node Q3.7.2, Q3.7.3, Q3.7.1, Customization
-@section How do I set control/meta/etc modifiers on mouse buttons?
+@unnumberedsubsec Q3.7.2: How do I set control/meta/etc modifiers on mouse buttons?
 Use, for instance, @code{[(meta button1)]}. For example, here is a common
 setting for Common Lisp programmers who use the bundled @code{ilisp}
 package, whereby meta-button1 on a function name will find the file where
 the function name was defined, and put you at that location in the source
 @lisp
 (local-set-key [(meta button1)] 'edit-definitions-lisp)
 @end lisp
 @node Q3.7.3, Q3.7.4, Q3.7.2, Customization
-@section Clicking the left button does not do anything in buffer list.
+@unnumberedsubsec Q3.7.3: Clicking the left button does not do anything in buffer list.
 I do @kbd{C-x C-b} to get a list of buffers and the entries get
 highlighted when I move the mouse over them but clicking the left mouse
 does not do anything.
 Use the middle mouse button.
 @node Q3.7.4, Q3.7.5, Q3.7.3, Customization
-@section How can I get a list of buffers when I hit mouse button 3?
+@unnumberedsubsec Q3.7.4: How can I get a list of buffers when I hit mouse button 3?
 The following code will replace the default popup on button3:
 @lisp
 (global-set-key [button3] 'popup-buffer-menu)
 @end lisp
 @node Q3.7.5, Q3.7.6, Q3.7.4, Customization
-@section Why does cut-and-paste not work between XEmacs and a cmdtool?
+@unnumberedsubsec Q3.7.5: Why does cut-and-paste not work between XEmacs and a cmdtool?
 We don't know.  It's a bug.  There does seem to be a work-around,
 however.  Try running xclipboard first.  It appears to fix the problem
 even if you exit it.  (This should be mostly fixed in 19.13, but we
 haven't yet verified that).
 @node Q3.7.6, Q3.7.7, Q3.7.5, Customization
-@section How I can set XEmacs up so that it pastes where the text cursor is?
+@unnumberedsubsec Q3.7.6: How I can set XEmacs up so that it pastes where the text cursor is?
 By default XEmacs pastes X selections where the mouse pointer is.  How
 do I disable this?
 Examine the function @code{mouse-yank}, by typing @kbd{C-h f mouse-yank
 Select from the @code{Options} menu
 @code{Customize->Emacs->Editing->Mouse->Yank At Point...} or type
 @kbd{M-x customize RET mouse RET}.
 @node Q3.7.7, Q3.7.8, Q3.7.6, Customization
-@section How do I select a rectangular region?
+@unnumberedsubsec Q3.7.7: How do I select a rectangular region?
 Just select the region normally, then use the rectangle commands (e.g.
 @code{kill-rectangle} on it.  The region does not highlight as a
 rectangle, but the commands work just fine.
 -- an interactive compiled Lisp function.
 Like `mouse-track' but selects rectangles instead of regions.
 @end example
 @node Q3.7.8, Q3.8.1, Q3.7.7, Customization
-@section Why does @kbd{M-w} take so long?
+@unnumberedsubsec Q3.7.8: Why does @kbd{M-w} take so long?
 It actually doesn't.  It leaves the region visible for a second so that
 you can see what area is being yanked.  If you start working, though, it
 will immediately complete its operation.  In other words, it will only
 delay for a second if you let it.
 @node Q3.8.1, Q3.8.2, Q3.7.8, Customization
-@section How do I get rid of the menu (or menubar)?
+@unnumberedsec 3.8: The Menubar and Toolbar
+@unnumberedsubsec Q3.8.1: How do I get rid of the menu (or menubar)?
 If you are running XEmacs 19.13 and earlier, add this command to your
 @file{.emacs}.
 @lisp
 @lisp
 (set-specifier menubar-visible-p nil)
 @end lisp
 @node Q3.8.2, Q3.8.3, Q3.8.1, Customization
-@section Can I customize the basic menubar?
+@unnumberedsubsec Q3.8.2: Can I customize the basic menubar?
 For an extensive menubar, add this line to your @file{.emacs}:
 @lisp
 (load "big-menubar")
 examples as any to start from.  The file is located in
 @file{lisp/packages/big-menubar.el} in the XEmacs installation
 directory.
 @node Q3.8.3, Q3.8.4, Q3.8.2, Customization
-@section How do I control how many buffers are listed in the menu @code{Buffers List}?
+@unnumberedsubsec Q3.8.3: How do I control how many buffers are listed in the menu @code{Buffers List}?
 Add the following to your @file{.emacs} (suit to fit):
 @lisp
 (setq buffers-menu-max-size 20)
 Select from the @code{Options} menu
 @code{Customize->Emacs->Environment->Menu->Buffers Menu->Max Size...} or
 type @kbd{M-x customize RET buffers-menu RET}.
 @node Q3.8.4, Q3.8.5, Q3.8.3, Customization
-@section Resources like @code{Emacs*menubar*font} are not working?
+@unnumberedsubsec Q3.8.4: Resources like @code{Emacs*menubar*font} are not working?
 I am trying to use a resource like @code{Emacs*menubar*font} to set the
 font of the menubar but it's not working.
 If you are using the real Motif menubar, this resource is not
 @end example
 even though the latter is more specific.
 @node Q3.8.5, Q3.9.1, Q3.8.4, Customization
-@section How can I bind a key to a function to toggle the toolbar?
+@unnumberedsubsec Q3.8.5: How can I bind a key to a function to toggle the toolbar?
 Try something like:
 @lisp
 (defun my-toggle-toolbar ()
 There are redisplay bugs in 19.14 that may make the preceding result in
 a messed-up display, especially for frames with multiple windows.  You
 may need to resize the frame before XEmacs completely realizes the
 toolbar is really gone.
-Thanks to Martin Buchholz <martin@@xemacs.org> for the correct
+Thanks to @email{martin@@xemacs.org, Martin Buchholz} for the correct
 code.
 @node Q3.9.1, Q3.9.2, Q3.8.5, Customization
-@section How can I disable the scrollbar?
+@unnumberedsec 3.9: Scrollbars
+@unnumberedsubsec Q3.9.1: How can I disable the scrollbar?
 To disable them for all frames, add the following line to
 your @file{.Xdefaults}:
 @example
 Emacs.scrollBarWidth:  0
 @end example
-Or select from the @code{Options} menu @code{Frame Appearance->Scrollbars}.
+Or select from the @code{Options} menu @code{Frame Appearance->Scrolbars}.
 Remember to save options.
 To turn the scrollbar off on a per-frame basis, use the following
 function:
 @lisp
 (set-specifier scrollbar-width (cons (selected-frame) 0))
 @end lisp
 @node Q3.9.2, Q3.9.3, Q3.9.1, Customization
-@section How can one use resources to change scrollbar colors?
+@unnumberedsubsec Q3.9.2: How can one use resources to change scrollbar colors?
 Here's a recap of how to use resources to change your scrollbar colors:
 @example
 ! Motif scrollbars
 @end example
 Note the capitalization of @code{Scrollbar} for the Athena widget.
 @node Q3.9.3, Q3.9.4, Q3.9.2, Customization
-@section Moving the scrollbar can move the point; can I disable this?
+@unnumberedsubsec Q3.9.3: Moving the scrollbar can move the point; can I disable this?
 When I move the scrollbar in an XEmacs window, it moves the point as
 well, which should not be the default behavior.  Is this a bug or a
 feature?  Can I disable it?
 hand corner.
 This cannot be changed.
 @node Q3.9.4, Q3.10.1, Q3.9.3, Customization
-@section How can I get automatic horizontal scrolling?
+@unnumberedsubsec Q3.9.4: How can I get automatic horizontal scrolling?
 By the same token, how can I turn it off in specific modes?
 To do this, add to your @file{.emacs} file:
 the package specifically asked for them.
 Automatic horizontal scrolling is now standard, starting with 19.14.
 @node Q3.10.1, Q3.10.2, Q3.9.4, Customization
-@section How can I turn off or change highlighted selections?
+@unnumberedsec Text Selections
+@unnumberedsubsec Q3.10.1: How can I turn off or change highlighted selections?
 The @code{zmacs} mode allows for what some might call gratuitous
 highlighting for selected regions (either by setting mark or by using
 the mouse).  This is the default behavior.  To turn off, add the
 following line to your @file{.emacs} file:
 To change the face for selection, look at @code{Options->Customize} on
 the menubar.
 @node Q3.10.2, Q3.10.3, Q3.10.1, Customization
-@section How do I get that typing on an active region removes it?
+@unnumberedsubsec Q3.10.2: How do I get that typing on an active region removes it?
 I want to change things so that if I select some text and start typing,
 the typed text replaces the selected text, similar to Motif.
 You want to use something called @dfn{pending delete}.  Pending delete
 @end lisp
 Note that this will work with both Backspace and Delete.
 @node Q3.10.3, Q3.10.4, Q3.10.2, Customization
-@section Can I turn off the highlight during isearch?
+@unnumberedsubsec Q3.10.3: Can I turn off the highlight during isearch?
 I do not like my text highlighted while I am doing isearch as I am not
 able to see what's underneath.  How do I turn it off?
 Put the following in your @file{.emacs}:
 Note also that isearch-highlight affects query-replace and ispell.
 Instead of disabling isearch-highlight you may find that a better
 solution consists of customizing the @code{isearch} face.
 @node Q3.10.4, Q3.10.5, Q3.10.3, Customization
-@section How do I turn off highlighting after @kbd{C-x C-p} (mark-page)?
+@unnumberedsubsec Q3.10.4: How do I turn off highlighting after @kbd{C-x C-p} (mark-page)?
 Put this in your @code{.emacs}:
 @lisp
 (setq zmacs-regions nil)
 @strong{Warning: This command turns off all region highlighting.}
 Also @xref{Q3.10.1}.
 @node Q3.10.5,  , Q3.10.4, Customization
-@section The region disappears when I hit the end of buffer while scrolling.
+@unnumberedsubsec Q3.10.5: The region disappears when I hit the end of buffer while scrolling.
 This has been fixed by default starting with XEmacs-20.3.
 With older versions you can turn this feature (if it indeed is a feature)
 off like this:
 	    ad-do-it
 	  (beginning-of-buffer (goto-char (point-min))))
 ad-do-it)))
 @end lisp
-Thanks to T. V. Raman <raman@@adobe.com> for assistance in deriving this
+Thanks to @email{raman@@adobe.com, T. V. Raman} for assistance in deriving this
 answer.
 @node Subsystems, Miscellaneous, Customization, Top
-@chapter Major Subsystems
+@unnumbered 4 Major Subsystems
 This is part 4 of the XEmacs Frequently Asked Questions list.  This
 section is devoted to major XEmacs subsystems.
 @menu
 * Q4.1.1::      What is W3?
 * Q4.1.2::      How do I run W3 from behind a firewall?
 * Q4.1.3::      Is it true that W3 supports style sheets and tables?
 Reading Netnews and Mail with Gnus:
 * Q4.2.1::      GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus,argh!
 * Q4.2.2::      [This question intentionally left blank]
 * Q4.2.3::      How do I make Gnus stay within a single frame?
 * Q4.2.4::      How do I customize the From: line?
 Other Mail & News:
 * Q4.3.3::      Why isn't this @code{movemail} program working?
 * Q4.3.4::      Movemail is also distributed by Netscape?  Can that cause problems?
 * Q4.3.5::      Where do I find pstogif (required by tm)?
 Sparcworks, EOS, and WorkShop:
 * Q4.4.1::      What is SPARCworks, EOS, and WorkShop
 Energize:
 * Q4.5.1::      What is/was Energize?
 Infodock:
 * Q4.7.4::      Problems installing AUC TeX
 * Q4.7.5::      Is there a reason for an Emacs package not to be included in XEmacs?
 @end menu
 @node Q4.0.1, Q4.0.2, Subsystems, Subsystems
-@section How do I set up VM to retrieve mail from a remote site using POP?
+@unnumberedsec Reading Mail with VM
+@unnumberedsubsec Q4.0.1: How do I set up VM to retrieve mail from a remote site using POP?
 Use @code{vm-spool-files}, like this for example:
 @lisp
 (setq vm-spool-files '("/var/spool/mail/wing"
 @end lisp
 Of course substitute your actual password for MYPASS.
 @node Q4.0.2, Q4.0.3, Q4.0.1, Subsystems
-@section How do I get VM to filter mail for me?
+@unnumberedsubsec Q4.0.2: How do I get VM to filter mail for me?
 One possibility is to use procmail to split your mail before it gets to
 VM.  I prefer this personally, since there are many strange and
 wonderful things one can do with procmail.  Procmail may be found at
-<URL:ftp://ftp.informatik.rwth-aachen.de/pub/packages/procmail/>.
+@uref{ftp://ftp.informatik.rwth-aachen.de/pub/packages/procmail/}.
 Also see the Mail Filtering FAQ at:
-<URL:http://www.cis.ohio-state.edu/hypertext/faq/usenet/mail/filtering-faq/faq.html>.
+@iftex
+@*
+@end iftex
+@uref{http://www.cis.ohio-state.edu/hypertext/faq/usenet/mail/filtering-faq/faq.html}.
 @node Q4.0.3, Q4.0.4, Q4.0.2, Subsystems
-@section How can I get VM to automatically check for new mail?
+@unnumberedsubsec Q4.0.3: How can I get VM to automatically check for new mail?
-John Turner <turner@@lanl.gov> writes:
+@email{turner@@lanl.gov, John Turner} writes:
 @quotation
 Use the following:
 @lisp
 (setq vm-auto-get-new-mail 60)
 @end lisp
 @end quotation
 @node Q4.0.4, Q4.0.5, Q4.0.3, Subsystems
-@section [This question intentionally left blank]
+@unnumberedsubsec Q4.0.4: [This question intentionally left blank]
 Obsolete question, left blank to avoid renumbering.
 @node Q4.0.5, Q4.0.6, Q4.0.4, Subsystems
-@section How do I get my outgoing mail archived?
+@unnumberedsubsec Q4.0.5: How do I get my outgoing mail archived?
 @lisp
 (setq mail-archive-file-name "~/outbox")
 @end lisp
 @node Q4.0.6, Q4.0.7, Q4.0.5, Subsystems
-@section I have various addresses at which I receive mail.  How can I tell VM to ignore them when doing a "reply-all"?
+@unnumberedsubsec Q4.0.6: I have various addresses at which I receive mail.  How can I tell VM to ignore them when doing a "reply-all"?
 Set @code{vm-reply-ignored-addresses} to a list, like
 @lisp
-(setq vm-reply-ignored-addresses '("wing@@netcom[0-9]*.netcom.com"
+(setq vm-reply-ignored-addresses
-				   "wing@@netcom.com" "wing@@666.com"))
+'("wing@@nuspl@@nvwls.cc.purdue.edu,netcom[0-9]*.netcom.com"
+	"wing@@netcom.com" "wing@@666.com"))
 @end lisp
 Note that each string is a regular expression.
 @node Q4.0.7, Q4.0.8, Q4.0.6, Subsystems
-@section Is there a mailing list or FAQ for VM?
+@unnumberedsubsec Q4.0.7: Is there a mailing list or FAQ for VM?
-A FAQ for VM exists at <URL:http://www.cyberpass.net/~gorkab/vmfaq.htm>.
+A FAQ for VM exists at @uref{http://www.cyberpass.net/~gorkab/vmfaq.htm}.
 VM has its own newsgroups gnu.emacs.vm.info and gnu.emacs.vm.bug.
-@node Q4.0.8, Q4.0.9, Q4.0.7, Subsystems
+@node Q4.0.8, Q4.0.9, Q4.0.7,  Subsystems
-@section Remote mail reading with VM.
+@unnumberedsubsec Q4.0.8: Remote mail reading with VM.
 My mailbox lives at the office on a big honkin server.  My regular INBOX
 lives on my honkin desktop machine.  I now can PPP to the office from
 home which is far from honking...  I'd like to be able to read mail at
 home without storing it here and I'd like to use xemacs and VM at
 home...  Is there a recommended setup?
-Joseph J. Nuspl Jr. <nuspl@@nvwls.cc.purdue.edu> writes:
+@email{nuspl@@nvwls.cc.purdue.edu, Joseph J. Nuspl Jr.} writes:
 @quotation
 There are several ways to do this.
 @enumerate
 Run a POP server on your desktop machine as well and do a sort of two
 tiered POP get.
 @end enumerate
 @end quotation
-William Perry <wmperry@@monolith.spry.com> adds:
+@email{wmperry@@monolith.spry.com, William Perry} adds:
 @quotation
 Or you could run a pop script periodically on your desktop machine, and
 just use ange-ftp or NFS to get to your mailbox.  I used to do this all
 the time back at IU.
 @end quotation
 @node Q4.0.9, Q4.0.10, Q4.0.8, Subsystems
-@section rmail or VM gets an error incorporating new mail.
+@unnumberedsubsec Q4.0.9: rmail or VM gets an error incorporating new mail.
 Quoting the XEmacs PROBLEMS file:
 @quotation
 rmail and VM get new mail from @file{/usr/spool/mail/$USER} using a
 program called @code{movemail}.  This program interlocks with
 @code{/bin/mail} using the protocol defined by @code{/bin/mail}.
 There are two different protocols in general use.  One of them uses the
 @code{flock} system call.  The other involves creating a lock file;
 @code{movemail} must be able to write in @file{/usr/spool/mail} in order
 to do this.  You control which one is used by defining, or not defining,
 the macro @code{MAIL_USE_FLOCK} in @file{config.h} or the m- or s- file
 and mode of the installed copy; changing the group and mode of the build
 directory copy is ineffective.
 @end quotation
 @node Q4.0.10, Q4.0.11, Q4.0.9, Subsystems
-@section How do I make VM stay in a single frame?
+@unnumberedsubsec Q4.0.10: How do I make VM stay in a single frame?
-John S Cooper <John.Cooper@@Eng.Sun.COM> writes:
+John.@email{Cooper@@Eng.Sun.COM, John S Cooper} writes:
 @quotation
 @lisp
-; Don't use multiple frames
+					; Don't use multiple frames
 (setq vm-frame-per-composition nil)
 (setq vm-frame-per-folder nil)
 (setq vm-frame-per-edit nil)
 (setq vm-frame-per-summary nil)
 @end lisp
 @end quotation
 @node Q4.0.11, Q4.0.12, Q4.0.10, Subsystems
-@section How do I make VM or mh-e display graphical smilies?
+@unnumberedsubsec Q4.0.11: How do I make VM or mh-e display graphical smilies?
 For mh-e use the following:
 @lisp
-(add-hook 'mh-show-mode-hook '(lambda () (smiley-region (point-min)
+(add-hook 'mh-show-mode-hook '(lambda ()
-(point-max))))
+				(smiley-region (point-min)
+(point-max))))
 @end lisp
 For vm use the following:
 @lisp
 (require 'messagexmas)
 (require 'smiley)
-(add-hook 'vm-select-message-hook '(lambda () (smiley-region (point-min)
+(add-hook 'vm-select-message-hook
-(point-max))))
+	  '(lambda ()
+	     (smiley-region (point-min)
+			    (point-max))))
 @end lisp
 For tm use the following:
 @lisp
 (autoload 'smiley-buffer "smiley" nil t)
 (add-hook 'mime-viewer/plain-text-preview-hook 'smiley-buffer)
 @end lisp
 @node Q4.0.12, Q4.1.1, Q4.0.11, Subsystems
-@section Customization of VM not covered in the manual, or here.
+@unnumberedsubsec Q4.0.12: Customization of VM not covered in the manual, or here.
-giacomo boffi <boffi@@hp735.stru.polimi.it> writes:
+@email{boffi@@hp735.stru.polimi.it, giacomo boffi} writes:
 @quotation
 The meta-answer is to look into the file @file{vm-vars.el}, in the vm
 directory of the lisp library.
 some keywords, maybe the first you conjure isn't appropriate, find the
 appropriate variables, copy and experiment.
 @end quotation
 @node Q4.1.1, Q4.1.2, Q4.0.12, Subsystems
-@section What is W3?
+@unnumberedsec Web browsing with W3
+@unnumberedsubsec Q4.1.1: What is W3?
 W3 is an advanced graphical browser written in Emacs lisp that runs on
 XEmacs.  It has full support for cascaded style sheets, and more...
 It has a home web page at
-<URL:http://www.cs.indiana.edu/elisp/w3/docs.html>.
+@uref{http://www.cs.indiana.edu/elisp/w3/docs.html}.
 @node Q4.1.2, Q4.1.3, Q4.1.1, Subsystems
-@section How do I run W3 from behind a firewall?
+@unnumberedsubsec Q4.1.2: How do I run W3 from behind a firewall?
 There is a long, well-written, detailed section in the W3 manual that
 describes how to do this.  Look in the section entitled "Firewalls".
 @node Q4.1.3, Q4.2.1, Q4.1.2, Subsystems
-@section Is it true that W3 supports style sheets and tables?
+@unnumberedsubsec Q4.1.3: Is it true that W3 supports style sheets and tables?
 Yes, and much more.  W3, as distributed with the latest XEmacs is a
 full-featured web browser.
 @node Q4.2.1, Q4.2.2, Q4.1.3, Subsystems
-@section GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus, Quassia Gnus, argh!
+@unnumberedsec Reading Netnews and Mail with Gnus
+@unnumberedsubsec Q4.2.1: GNUS, (ding) Gnus, Gnus 5, September Gnus, Red Gnus, Quassia Gnus, argh!
 The Gnus numbering issues are not meant for mere mortals to know them.
 If you feel you @emph{must} enter the muddy waters of Gnus, visit the
 excellent FAQ, maintained by Justin Sheehy, at:
 @example
-<URL:http://www.ccs.neu.edu/software/gnus/>
+@uref{http://www.ccs.neu.edu/software/gnus/}
 @end example
 See also Gnus home page
 @example
-<URL:http://www.gnus.org/>
+@uref{http://www.gnus.org/}
 @end example
 @node Q4.2.2, Q4.2.3, Q4.2.1, Subsystems
-@section This question intentionally left blank.
+@unnumberedsubsec Q4.2.2: This question intentionally left blank.
 Obsolete question, left blank to avoid renumbering.
 @node Q4.2.3, Q4.2.4, Q4.2.2, Subsystems
-@section How do I make Gnus stay within a single frame?
+@unnumberedsubsec Q4.2.3: How do I make Gnus stay within a single frame?
 The toolbar code to start Gnus opens the new frame---and it's a feature
 rather than a bug.  If you don't like it, but would still like to click
 on the seemly icon, use the following code:
 It will redefine the callback function of the icon to just call
 @code{gnus}, without all the fancy frame stuff.
 @node Q4.2.4, Q4.3.1, Q4.2.3, Subsystems
-@section How do I customize the From: line?
+@unnumberedsubsec Q4.2.4: How do I customize the From: line?
 How do I change the @code{From:} line?  I have set gnus-user-from-line
-to Gail Gurman <gail.gurman@@sybase.com>, but XEmacs Gnus doesn't use
+to @example
-it. Instead it uses Gail Mara Gurman <gailg@@deall> and then complains
+Gail Gurman <gail.gurman@@sybase.com>
+@end example
+@noindent , but XEmacs Gnus doesn't use
+it. Instead it uses @example
+Gail Mara Gurman @email{gailg@@deall}
+@end example
+@noindent and then complains
 that it's incorrect. Also, as you perhaps can see, my Message-ID is
 screwy. How can I change that?
-Lars Magne Ingebrigtsen <larsi@@aegir.ifi.uio.no> writes:
+@email{larsi@@ifi.uio.no, Lars Magne Ingebrigtsen} writes:
 @quotation
 Set @code{user-mail-address} to @samp{gail.gurman@@sybase.com} or
 @code{mail-host-address} to @samp{sybase.com}.
 @end quotation
 @node Q4.3.1, Q4.3.2, Q4.2.4, Subsystems
-@section How can I read and/or compose MIME messages?
+@unnumberedsec Other Mail & News
+@unnumberedsubsec Q4.3.1: How can I read and/or compose MIME messages?
 One answer is @code{tra-vm-mime}.  You may find it at
-<URL:http://lenkkari.cs.tut.fi/~tra/software/tra-vm-mime.el>.
+@iftex
+@*
+@end iftex
+@uref{http://lenkkari.cs.tut.fi/~tra/software/tra-vm-mime.el}.
 Another possibility is RMIME.  You may find RMIME at
-<URL:http://www.cinti.net/~rmoody/rmime/index.html>.
+@iftex
+@*
+@end iftex
+@uref{http://www.cinti.net/~rmoody/rmime/index.html}.
 You probably want to use the Tools for MIME (tm).  @xref{Q4.3.2} for
 details.
-Trey Jackson <trey@@cs.berkeley.edu> has an Emacs & MIME web page at
+@email{trey@@cs.berkeley.edu, Trey Jackson} has an Emacs & MIME web page at
-<URL:http://bmrc.berkeley.edu/~trey/emacs/mime.html>.
+@iftex
+@*
+@end iftex
+@uref{http://bmrc.berkeley.edu/~trey/emacs/mime.html}.
 @node Q4.3.2, Q4.3.3, Q4.3.1, Subsystems
-@section What is TM and where do I get it?
+@unnumberedsubsec Q4.3.2: What is TM and where do I get it?
 TM stands for @dfn{Tools for MIME} and not Tiny MIME.  TM integrates
 with all major XEmacs packages like Gnus (all flavors), VM, MH-E, and
 mailcrypt.  It provides totally transparent and trouble-free MIME
 support.  When appropriate a message will be decoded in place in an
 XEmacs buffer.
 TM now comes as a package with XEmacs 19.16 and XEmacs 20.2.
-TM was written by MORIOKA Tomohiko <morioka@@jaist.ac.jp> and KOBAYASHI
+TM was written by @email{morioka@@jaist.ac.jp, MORIOKA Tomohiko} and
-Shuhei <shuhei-k@@jaist.ac.jp>.  It is based on the work of UMEDA
+@email{shuhei-k@@jaist.ac.jp, KOBAYASHI
-Masanobu <umerin@@mse.kyutech.ac.jp>, the original writer of GNUS.
+Shuhei}.
+It is based on the work of @email{umerin@@mse.kyutech.ac.jp, UMEDA
+Masanobu}, the original writer of GNUS.
 The following information is from the @file{README}:
 @dfn{tm} is a MIME package for GNU Emacs.
 tm has following functions:
 @item MIME extenders for mh-e, GNUS, RMAIL and VM.
 @end itemize
 tm is available from following anonymous ftp sites:
 @itemize @bullet
-@item <URL:ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/> (Japan).
+@item @uref{ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/} (Japan).
-@item <URL:ftp://ftp.nis.co.jp/pub/gnu/emacs-lisp/tm/> (Japan).
+@item @uref{ftp://ftp.nis.co.jp/pub/gnu/emacs-lisp/tm/} (Japan).
-@item <URL:ftp://ftp.nisiq.net/pub/gnu/emacs-lisp/tm/> (US).
+@item @uref{ftp://ftp.nisiq.net/pub/gnu/emacs-lisp/tm/} (US).
-@item <URL:ftp://ftp.miranova.com/pub/gnus/jaist.ac.jp/> (US).
+@item @uref{ftp://ftp.miranova.com/pub/gnus/jaist.ac.jp/} (US).
-@item <URL:ftp://ftp.unicamp.br/pub/mail/mime/tm/> (Brasil).
+@item @uref{ftp://ftp.unicamp.br/pub/mail/mime/tm/} (Brasil).
-@item <URL:ftp://ftp.th-darmstadt.de/pub/editors/GNU-Emacs/lisp/mime/> (Germany).
+@item @uref{ftp://ftp.th-darmstadt.de/pub/editors/GNU-Emacs/lisp/mime/} (Germany).
-@item <URL:ftp://ftp.tnt.uni-hannover.de/pub/editors/xemacs/contrib/> (Germany).
+@item @uref{ftp://ftp.tnt.uni-hannover.de/pub/editors/xemacs/contrib/} (Germany).
 @end itemize
 Don't let the installation procedure & instructions stop you from trying
 this package out---it's much simpler than it looks, and once installed,
 trivial to use.
 @node Q4.3.3, Q4.3.4, Q4.3.2, Subsystems
-@section Why isn't this @code{movemail} program working?
+@unnumberedsubsec Q4.3.3: Why isn't this @code{movemail} program working?
-Ben Wing <ben@@666.com> writes:
+Ben Wing @email{ben@@666.com} writes:
 @quotation
 It wasn't chown'ed/chmod'd correctly.
 @end quotation
 @node Q4.3.4, Q4.3.5, Q4.3.3, Subsystems
-@section Movemail is also distributed by Netscape?  Can that cause problems?
+@unnumberedsubsec Q4.3.4: Movemail is also distributed by Netscape?  Can that cause problems?
-Steve Baur <steve@@altair.xemacs.org> writes:
+@email{steve@@altair.xemacs.org, Steve Baur} writes:
 @quotation
 Yes.  Always use the movemail installed with your XEmacs.  Failure to do
 so can result in lost mail.
 @end quotation
-Please refer to Jamie Zawinski's <jwz@@netscape.com> notes at
+Please refer to @email{jwz@@netscape.com, Jamie Zawinski's} notes at
-<URL:http://home.netscape.com/eng/mozilla/2.0/relnotes/demo/movemail.html>.
+@iftex
+@*
+@end iftex
+@uref{http://home.netscape.com/eng/mozilla/2.0/relnotes/demo/movemail.html}.
 In particular, this document will show you how to make Netscape use the
 version of movemail configured for your system by the person who built
 XEmacs.
 @node Q4.3.5, Q4.4.1, Q4.3.4, Subsystems
-@section Where do I find pstogif (required by tm)?
+@unnumberedsubsec Q4.3.5: Where do I find pstogif (required by tm)?
 pstogif is part of the latex2html package.
-Jan Vroonhof <vroonhof@@math.ethz.ch> writes:
+@email{vroonhof@@math.ethz.ch, Jan Vroonhof} writes:
 latex2html is best found at the CTAN hosts and their mirrors
-in @file{tex-archive/support/latex2html}.
+in
+@iftex
+@*
+@end iftex
+@file{tex-archive/support/latex2html}.
 CTAN hosts are:
 @itemize @bullet
-@item <URL:ftp://ftp.tex.ac.uk/tex-archive/support/latex2html/>.
+@item @uref{ftp://ftp.tex.ac.uk/tex-archive/support/latex2html/}.
-@item <URL:ftp://ftp.dante.de/tex-archive/support/latex2html/>.
+@item @uref{ftp://ftp.dante.de/tex-archive/support/latex2html/}.
 @end itemize
 There is a good mirror at ftp.cdrom.com;
-<URL:ftp://ftp.cdrom.com/pub/tex/ctan/support/latex2html/>.
+@iftex
+@*
+@end iftex
+@uref{ftp://ftp.cdrom.com/pub/tex/ctan/support/latex2html/}.
 @node Q4.4.1, Q4.5.1, Q4.3.5, Subsystems
-@section What is SPARCworks, EOS, and WorkShop?
+@unnumberedsec Sparcworks, EOS, and WorkShop
+@unnumberedsubsec Q4.4.1: What is SPARCworks, EOS, and WorkShop?
-John Turner <turner@@lanl.gov> writes:
+@email{turner@@lanl.gov, John Turner} writes:
 @quotation
 SPARCworks is SunSoft's development environment, comprising compilers
 (C, C++, FORTRAN 77, Fortran 90, Ada, and Pascal), a debugger, and other
 tools such as TeamWare (for configuration management), MakeTool, etc.
 @end quotation
-See <URL:http://www.sun.com/sunsoft/Developer-products/>
+See @uref{http://www.sun.com/sunsoft/Developer-products/}
 for more info.
 EOS stands for "Era on SPARCworks", but I don't know what Era stands
 for.
 allows one to use an XEmacs frame to view code (complete with
 fontification, etc.), set breakpoints, print variables, etc., while
 using the SPARCworks debugger.  It works very well and I use it all the
 time.
-Chuck Thompson <cthomp@@xemacs.org> writes:
+@email{cthomp@@xemacs.org, Chuck Thompson} writes:
 @quotation
 Era stood for "Emacs Rewritten Again".  It was what we were calling the
 modified version of Lucid Emacs for Sun when I was dragged, er, allowed
 to work on this wonderful editor.
 @end quotation
-Martin Buchholz <martin@@xemacs.org> writes:
+@email{martin@@xemacs.org, Martin Buchholz} writes:
 @quotation
 EOS is being replaced with a new graphical development environment
 called Sun WorkShop, which is currently (07/96) in Alpha Test.  For more
 details, check out
-<URL:http://www.sun.com/sunsoft/Products/Developer-products/programs.html>.
+@iftex
+@*
+@end iftex
+@uref{http://www.sun.com/sunsoft/Products/Developer-products/programs.html}.
 @end quotation
 @node Q4.5.1, Q4.6.1, Q4.4.1, Subsystems
-@section What is/was Energize?
+@unnumberedsec Energize
+@unnumberedsubsec Q4.5.1: What is/was Energize?
-David N Gray <gray@@meteor.harlequin.com> writes:
+@email{gray@@meteor.harlequin.com, David N Gray} writes:
 @quotation
 The files in @file{lisp/energize} are to enable Emacs to interface with
 the "Energize Programming System", a C and C++ development environment,
 which was a product of Lucid, Inc.  Tragically, Lucid went out of
 business in 1994, so although Energize is still a great system, if you
 Tartan bought the rights to sell it in the rest of the world, but never
 did so.)
 @end quotation
 @node Q4.6.1, Q4.7.1, Q4.5.1, Subsystems
-@section What is Infodock?
+@unnumberedsec Infodock
+@unnumberedsubsec Q4.6.1: What is Infodock?
 InfoDock is an integrated productivity toolset, mainly aimed at
 technical people.  It is developed and supported by InfoDock
 Associates, a firm that offers custom support and development
-for InfoDock, XEmacs and GNU Emacs.  (http://www.infodock.com,
+for InfoDock, XEmacs and GNU Emacs.  ( @uref{http://www.infodock.com},
-<info@@infodock.com>, +1 408 243 3300).
+@email{info@@infodock.com}, +1 408 243 3300).
 InfoDock is built atop the XEmacs variant of GNU Emacs and so has all of
 the power of Emacs, but with an easier to use and more comprehensive
 menu-based user interface.  The bottom portion of this text describes
 how it differs from XEmacs and GNU Emacs from the Free Software
 Emacs Manual.
 InfoDock menus are much more extensive and more mature than standard
 Emacs menus.  Each menu offers a @samp{Manual} item which displays
 documentation associated with the menu's functions.
 @noindent
 Four types of menubars are provided:
 @enumerate
 @item
 An extensive menubar providing access to global InfoDock commands.
 Extensions and improvements to many areas of Emacs are included, such as:
 paragraph filling, mail reading with Rmail, shell handling, outlining, code
 highlighting and browsing, and man page browsing.
 InfoDock questions, answers and discussion should go to the mail list
-@samp{infodock@@infodock.com}.  Use
+@iftex
-@samp{infodock-request@@infodock.com} to be added or removed from the
+@*
+@end iftex
+@email{infodock@@infodock.com}.  Use
+@email{infodock-request@@infodock.com} to be added or removed from the
 list.  Always include your InfoDock version number when sending help
 requests.
 InfoDock is available across the Internet via anonymous FTP.  To get
 it, first move to a directory into which you want the InfoDock archive
 files placed.  We will call this <DIST-DIR>.
 @example
 cd <DIST-DIR>
 @end example
 Ftp to ftp.xemacs.org  (Internet Host ID = 128.174.252.16):
 prompt> ftp ftp.xemacs.org
 @end example
 Login as @samp{anonymous} with your own <user-id>@@<site-name> as a password.
 @example
 Name (ftp.xemacs.org): anonymous
 331 Guest login ok, send your complete e-mail address as password.
-Password: -<your-user-id@@your-domain>
+Password: -<your-user-id>@@<your-domain>
 230 Guest login ok, access restrictions apply.
 @end example
 Move to the location of the InfoDock archives:
 Read the @file{ID-INSTALL} file which you just retrieved for
 step-by-step installation instructions.
 @node Q4.7.1, Q4.7.2, Q4.6.1, Subsystems
-@section What is AUC TeX?  Where do you get it?
+@unnumberedsec Other Unbundled Packages
+@unnumberedsubsec Q4.7.1: What is AUC TeX?  Where do you get it?
-AUC TeX is a package written by Per Abrahamsen <abraham@@dina.kvl.dk>.
+AUC TeX is a package written by @email{abraham@@dina.kvl.dk, Per Abrahamsen}.
 Starting with XEmacs 19.16, AUC TeX is bundled with XEmacs.  The
 following information is from the @file{README} and website.
 AUC TeX is an extensible package that supports writing and formatting
 TeX files for most variants of GNU Emacs. Many different macro packages
 are supported, including AMS TeX, LaTeX, and TeXinfo.
 The most recent version is always available by ftp at
-<URL:ftp://sunsite.auc.dk/packages/auctex/auctex.tar.gz>.
+@iftex
+@*
+@end iftex
+@uref{ftp://sunsite.auc.dk/packages/auctex/auctex.tar.gz}.
 In case you don't have access to anonymous ftp, you can get it by an
-email request to <URL:mailto:ftpmail@@decwrl.dec.com>.
+email request to @email{ftpmail@@decwrl.dec.com}.
 WWW users may want to check out the AUC TeX page at
-<URL:http://sunsite.auc.dk/auctex/>.
+@iftex
+@*
+@end iftex
+@uref{http://sunsite.auc.dk/auctex/}.
 @node Q4.7.2, Q4.7.3, Q4.7.1, Subsystems
-@section Are there any Emacs Lisp Spreadsheets?
+@unnumberedsubsec Q4.7.2: Are there any Emacs Lisp Spreadsheets?
 Yes.  Check out @dfn{dismal} (which stands for Dis' Mode Ain't Lotus) at
-<URL:ftp://cs.nyu.edu/pub/local/fox/dismal/>.
+@iftex
+@*
+@end iftex
+@uref{ftp://cs.nyu.edu/pub/local/fox/dismal/}.
 @node Q4.7.3, Q4.7.4, Q4.7.2, Subsystems
-@section Byte compiling AUC TeX on XEmacs 19.14.
+@unnumberedsubsec Q4.7.3: Byte compiling AUC TeX on XEmacs 19.14.
-Georges Brun-Cottan <bruncott@@dormeur.inria.fr> writes:
+@email{bruncott@@dormeur.inria.fr, Georges Brun-Cottan} writes:
 @quotation
-When byte compiling auctex-9.4g, you must use the command:
+When byte compiling auxtex-9.4g, you must use the command:
 @example
 xemacs -batch -l lpath.el
 @end example
 @end quotation
 @node Q4.7.4, Q4.7.5, Q4.7.3, Subsystems
-@section Problems installing AUC TeX.
+@unnumberedsubsec Q4.7.4: Problems installing AUC TeX.
-Jan Vroonhof <vroonhof@@math.ethz.ch> writes:
+@email{vroonhof@@math.ethz.ch, Jan Vroonhof} writes:
 @quotation
 AUC TeX works fine on both stock Emacs and XEmacs has been doing so for
-a very very long time. This is mostly due to the work of Per Abrahamsen
+a very very long time. This is mostly due to the work of
-<abraham@@dina.kvl.dk> (clap clap) in particular his @file{easymenu}
+@email{abraham@@dina.kvl.dk, Per Abrahamsen} (clap clap) in particular his @file{easymenu}
 package.  Which leads to what is probably the problem...
 @end quotation
 Most problems with AUC TeX are one of two things:
 @strong{only} finds the one that came with XEmacs.
 @end itemize
 @node Q4.7.5,  , Q4.7.4, Subsystems
-@section Is there a reason for an Emacs package not to be included in XEmacs?
+@unnumberedsubsec Q4.7.5: Is there a reason for an Emacs package not to be included in XEmacs?
 The reason for an Emacs package not to be included in XEmacs is
 usually one or more of the following:
 @enumerate
 even better, offer your help.  It will be gladly accepted and
 appreciated.
 @end enumerate
 @node Miscellaneous, Current Events, Subsystems, Top
-@chapter The Miscellaneous Stuff
+@unnumbered 5 The Miscellaneous Stuff
 This is part 5 of the XEmacs Frequently Asked Questions list.  This
 section is devoted to anything that doesn't fit neatly into the other
 sections.
 * Q5.0.5::      How can I get XEmacs to come up in text/auto-fill mode by default?
 * Q5.0.6::      How do I start up a second shell buffer?
 * Q5.0.7::      Telnet from shell filters too much.
 * Q5.0.8::      Why does edt emulation not work?
 * Q5.0.9::      How can I emulate VI and use it as my default mode?
 * Q5.0.10::     [This question intentionally left blank]
 * Q5.0.11::     Filladapt doesn't work in 19.15?
 * Q5.0.12::     How do I disable gnuserv from opening a new frame?
 * Q5.0.13::     How do I start gnuserv so that each subsequent XEmacs is a client?
 * Q5.0.14::     Strange things are happening in Shell Mode.
 * Q5.0.15::     Where do I get the latest CC Mode?
 * Q5.0.16::     I find auto-show-mode disconcerting.  How do I turn it off?
 * Q5.0.17::     How can I get two instances of info?
 * Q5.0.18::     I upgraded to XEmacs 19.14 and gnuserv stopped working
 * Q5.0.19::     Is there something better than LaTeX mode?
+* Q5.0.20::     Is there a way to start a new XEmacs if there's no gnuserv running, and otherwise use gnuclient?
 Emacs Lisp Programming Techniques:
 * Q5.1.1::      The difference in key sequences between XEmacs and GNU Emacs?
 * Q5.1.2::      Can I generate "fake" keyboard events?
 * Q5.1.3::      Could you explain @code{read-kbd-macro} in more detail?
 * Q5.3.11::     How do I add new Info directories?
 * Q5.3.12::     What do I need to change to make printing work?
 @end menu
 @node Q5.0.1, Q5.0.2, Miscellaneous, Miscellaneous
-@section How can I do source code highlighting using font-lock?
+@unnumberedsec Major & Minor Modes
+@unnumberedsubsec Q5.0.1: How can I do source code highlighting using font-lock?
 For most modes, font-lock is already set up and just needs to be turned
 on.  This can be done by @kbd{M-x font-lock-mode}, or by having XEmacs
 automatically start it by adding lines like:
 See also @code{Syntax Highlighting} from the @code{Options} menu.
 Remember to save options.
 @node Q5.0.2, Q5.0.3, Q5.0.1, Miscellaneous
-@section I do not like cc-mode.  How do I use the old c-mode?
+@unnumberedsubsec Q5.0.2: I do not like cc-mode.  How do I use the old c-mode?
 Well, first off, consider if you really want to do this.  cc-mode is
 much more powerful than the old c-mode.  If you're having trouble
 getting your old offsets to work, try using @code{c-set-offset} instead.
 You might also consider using the package @code{cc-compat}.
 (makunbound 'c-mode-map)
 (fmakunbound 'c++-mode)
 (makunbound 'c++-mode-map)
 (makunbound 'c-style-alist)
 (load-library "old-c-mode")
 (load-library "old-c++-mode")
 @end lisp
 This must be done before any other reference is made to either c-mode or
 c++-mode.
 @node Q5.0.3, Q5.0.4, Q5.0.2, Miscellaneous
-@section How do I get @samp{More} Syntax Highlighting on by default?
+@unnumberedsubsec Q5.0.3: How do I get @samp{More} Syntax Highlighting on by default?
 Use the following code in your @file{.emacs}:
 @lisp
 (setq-default font-lock-maximum-decoration t)
 See also @code{Syntax Highlighting} from the @code{Options} menu.
 Remember to save options.
 @node Q5.0.4, Q5.0.5, Q5.0.3, Miscellaneous
-@section How can I enable auto-indent?
+@unnumberedsubsec Q5.0.4: How can I enable auto-indent?
 Put the following line in your @file{.emacs}:
 @lisp
 (setq indent-line-function 'indent-relative-maybe)
 the nasty ones, you'll have to provide the @code{add-hook}s yourself.
 Please note that the @code{fa-extras} package is no longer useful.
 @node Q5.0.5, Q5.0.6, Q5.0.4, Miscellaneous
-@section How can I get XEmacs to come up in text/auto-fill mode by default?
+@unnumberedsubsec Q5.0.5: How can I get XEmacs to come up in text/auto-fill mode by default?
 Try the following lisp in your @file{.emacs}:
 @lisp
 (setq default-major-mode 'text-mode)
 a nonstandard mode that has automatic font lock rules, then the startup
 message might get fontified in a strange foreign manner, e.g. as code in
 some programming language).
 @node Q5.0.6, Q5.0.7, Q5.0.5, Miscellaneous
-@section How do I start up a second shell buffer?
+@unnumberedsubsec Q5.0.6: How do I start up a second shell buffer?
 In the @code{*shell*} buffer:
 @lisp
 M-x rename-buffer RET *shell-1* RET
 @samp{*shell*} can exist.  It might be preferable to use @kbd{M-x
 rename-uniquely} to rename the @code{*shell*} buffer instead of @kbd{M-x
 rename-buffer}.
 @node Q5.0.7, Q5.0.8, Q5.0.6, Miscellaneous
-@section Telnet from shell filters too much
+@unnumberedsubsec Q5.0.7: Telnet from shell filters too much
 I'm using the Emacs @kbd{M-x shell} function, and I would like to invoke
 and use a telnet session within it.  Everything works fine except that
 now all @samp{^M}'s are filtered out by Emacs.  Fixes?
 than doing rsh or telnet within the local shell buffer.  Starting with
 XEmacs-20.3 you can also use @kbd{M-x ssh} to open secure remote session
 if you have @code{ssh} installed.
 @node Q5.0.8, Q5.0.9, Q5.0.7, Miscellaneous
-@section Why does edt emulation not work?
+@unnumberedsubsec Q5.0.8: Why does edt emulation not work?
 We don't know, but you can use tpu-edt emulation instead, which works
 fine and is a little fancier than the standard edt emulation.  To do
 this, add the following line to your @file{.emacs}:
 @lisp
 (global-set-key [(control h)] 'help-for-help)
 @end lisp
 @node Q5.0.9, Q5.0.10, Q5.0.8, Miscellaneous
-@section How can I emulate VI and use it as my default mode?
+@unnumberedsubsec Q5.0.9: How can I emulate VI and use it as my default mode?
 Our recommended VI emulator is viper. To make viper-mode the default,
 add this to your @file{.emacs}:
 @lisp
 (viper-mode)
 @end lisp
-Michael Kifer <kifer@@CS.SunySB.EDU> writes:
+@email{kifer@@CS.SunySB.EDU, Michael Kifer} writes:
 @quotation
 This should be added as close to the top of @file{.emacs} as you can get
 it, otherwise some minor modes may not get viper-ized.
 @end quotation
 @node Q5.0.10, Q5.0.11, Q5.0.9, Miscellaneous
-@section [This question intentionally left blank]
+@unnumberedsubsec Q5.0.10: [This question intentionally left blank]
 Obsolete question, left blank to avoid renumbering
 @node Q5.0.11, Q5.0.12, Q5.0.10, Miscellaneous
-@section Filladapt doesn't work in 19.15
+@unnumberedsubsec Q5.0.11: Filladapt doesn't work in 19.15
 Filladapt 2.x is included in 19.15.  In it filladapt is now a minor
 mode and minor modes are traditionally off by default.  The following
 added to your @file{.emacs} will turn it on for all buffers:
 Use @code{turn-on-filladapt-mode} to turn Filladapt on in particular
 major modes, like this:
 @lisp
 (add-hook 'text-mode-hook 'turn-on-filladapt-mode)
 @end lisp
 @node Q5.0.12, Q5.0.13, Q5.0.11, Miscellaneous
-@section How do I disable gnuserv from opening a new frame?
+@unnumberedsubsec Q5.0.12: How do I disable gnuserv from opening a new frame?
 If you set the @code{gnuserv-frame} variable to the frame that should be
 used to display buffers that are pulled up, a new frame will not be
 created. For example, you could put
 @code{Customize->Emacs->Environment->Gnuserv->Gnuserv Frame...} or type
 @kbd{M-x customize RET gnuserv RET}.
 @node Q5.0.13, Q5.0.14, Q5.0.12, Miscellaneous
-@section How do I start gnuserv so that each subsequent XEmacs is a client?
+@unnumberedsubsec Q5.0.13: How do I start gnuserv so that each subsequent XEmacs is a client?
 Put the following in your @file{.emacs} file to start the server:
 @lisp
 (gnuserv-start)
 frame.
 See also man page of gnuclient.
 @node Q5.0.14, Q5.0.15, Q5.0.13, Miscellaneous
-@section Strange things are happening in Shell Mode.
+@unnumberedsubsec Q5.0.14: Strange things are happening in Shell Mode.
 Sometimes (i.e. it's not repeatable, and I can't work out why it
 happens) when I'm typing into shell mode, I hit return and only a
 portion of the command is given to the shell, and a blank prompt is
 returned.  If I hit return again, the rest of the previous command is
 given to the shell.
-Martin Buchholz <martin@@xemacs.org> writes:
+@email{martin@@xemacs.org, Martin Buchholz} writes:
 @quotation
 There is a known problem with interaction between @code{csh} and the
 @code{filec} option and XEmacs.  You should add the following to your
 @file{.cshrc}:
 if ( "$TERM" == emacs || "$TERM" == unknown ) unset filec
 @end example
 @end quotation
 @node Q5.0.15, Q5.0.16, Q5.0.14, Miscellaneous
-@section Where do I get the latest CC Mode?
+@unnumberedsubsec Q5.0.15: Where do I get the latest CC Mode?
-Barry A. Warsaw <bwarsaw@@cnri.reston.va.us> writes:
+@email{bwarsaw@@cnri.reston.va.us, Barry A. Warsaw} writes:
 @quotation
-This can be had from <URL:http://www.python.org/ftp/emacs/>.
+This can be had from @uref{http://www.python.org/ftp/emacs/}.
 @end quotation
 @node Q5.0.16, Q5.0.17, Q5.0.15, Miscellaneous
-@section I find auto-show-mode disconcerting.  How do I turn it off?
+@unnumberedsubsec Q5.0.16: I find auto-show-mode disconcerting.  How do I turn it off?
 @code{auto-show-mode} controls whether or not a horizontal scrollbar
 magically appears when a line is too long to be displayed.  This is
 enabled by default.  To turn it off, put the following in your
 @file{.emacs}:
 (setq auto-show-mode nil)
 (setq-default auto-show-mode nil)
 @end lisp
 @node Q5.0.17, Q5.0.18, Q5.0.16, Miscellaneous
-@section How can I get two instances of info?
+@unnumberedsubsec Q5.0.17: How can I get two instances of info?
 You can't.  The @code{info} package does not provide for multiple info buffers.
 @node Q5.0.18, Q5.0.19, Q5.0.17, Miscellaneous
-@section I upgraded to XEmacs 19.14 and gnuserv stopped working.
+@unnumberedsubsec Q5.0.18: I upgraded to XEmacs 19.14 and gnuserv stopped working.
-Mark Daku <daku@@nortel.ca> writes:
+@email{daku@@nortel.ca, Mark Daku} writes:
 @quotation
 It turns out I was using an older version of gnuserv.  The installation
 didn't put the binary into the public bin directory.  It put it in
+@iftex
+@*
+@end iftex
 @file{lib/xemacs-19.14/hppa1.1-hp-hpux9.05/gnuserv}.  Shouldn't it have
 been put in @file{bin/hppa1.1-hp-hpux9.0}?
 @end quotation
-@node Q5.0.19, Q5.1.1, Q5.0.18, Miscellaneous
+@node Q5.0.19, Q5.0.20, Q5.0.18, Miscellaneous
-@section Is there something better than LaTeX mode?
+@unnumberedsubsec Q5.0.19: Is there something better than LaTeX mode?
-David Kastrup <dak@@fsnif.neuroinformatik.ruhr-uni-bochum.de> writes:
+@email{dak@@fsnif.neuroinformatik.ruhr-uni-bochum.de, David Kastrup} writes:
 @quotation
 The standard TeX modes leave much to be desired, and are somewhat
 leniently maintained.  Serious TeX users use AUC TeX (@xref{Q4.7.1}).
 @end quotation
-@node Q5.1.1, Q5.1.2, Q5.0.19, Miscellaneous
+@node Q5.0.20, Q5.1.1, Q5.0.19, Miscellaneous
-@section What is the difference in key sequences between XEmacs and GNU Emacs?
+@unnumberedsubsec Q5.0.20: Is there a way to start a new XEmacs if there's no gnuserv running, and otherwise use gnuclient?
-Erik Naggum <erik@@naggum.no> writes;
+@email{vroonhof@@math.ethz.ch, Jan Vroonhof} writes:
+@quotation
+Here is one of the solutions, we have this in a script called
+@file{etc/editclient.sh}.
+@example
+#!/bin/sh
+if gnuclient -batch -eval t >/dev/null 2>&1
+then
+exec gnuclient $@{1+"$@@"@}
+else
+xemacs -unmapped -f gnuserv-start &
+until gnuclient -batch -eval t >/dev/null 2>&1
+do
+sleep 1
+done
+exec gnuclient $@{1+"$@@"@}
+fi
+@end example
+Note that there is a known problem when running XEmacs and 'gnuclient
+-nw' on the same TTY.
+@end quotation
+@node Q5.1.1, Q5.1.2, Q5.0.20, Miscellaneous
+@unnumberedsec Emacs Lisp Programming Techniques
+@unnumberedsubsec Q5.1.1: What is the difference in key sequences between XEmacs and GNU Emacs?
+@email{clerik@@naggum.no, Erik Naggum} writes;
 @quotation
 Emacs has a legacy of keyboards that produced characters with modifier
 bits, and therefore map a variety of input systems into this scheme even
 today.  XEmacs is instead optimized for X events.  This causes an
 @code{read-kbd-macro} function, which takes a string like @samp{C-c
 <up>}, and converts it to the internal key representation of the Emacs
 you use.  The function is available both on XEmacs and GNU Emacs.
 @node Q5.1.2, Q5.1.3, Q5.1.1, Miscellaneous
-@section Can I generate "fake" keyboard events?
+@unnumberedsubsec Q5.1.2: Can I generate "fake" keyboard events?
 I wonder if there is an interactive function that can generate
 @dfn{fake} keyboard events.  This way, I could simply map them inside
 XEmacs.
 "Generate an event, as if ch has been typed"
 (dispatch-event (character-to-event ch)))
 ;;  Backspace and Delete stuff
 (global-set-key [backspace]
 (lambda () (interactive) (cg--generate-char-event 127)))
 (global-set-key [unknown_keysym_0x4]
 (lambda () (interactive) (cg--generate-char-event 4)))
 @end lisp
 @node Q5.1.3, Q5.1.4, Q5.1.2, Miscellaneous
-@section Could you explain @code{read-kbd-macro} in more detail?
+@unnumberedsubsec Q5.1.3: Could you explain @code{read-kbd-macro} in more detail?
 The @code{read-kbd-macro} function returns the internal Emacs
 representation of a human-readable string (which is its argument).
 Thus:
 @lisp
 (read-kbd-macro "C-c C-a")
 @result{} [(control ?c) (control ?a)]
 (read-kbd-macro "C-c C-. <up>")
 @result{} [(control ?c) (control ?.) up]
 @end lisp
 In GNU Emacs the same forms will be evaluated to what GNU Emacs
 understands internally---the sequences @code{"\C-x\C-c"} and @code{[3
 67108910 up]}, respectively.
 ignored as a comment.
 @end itemize
 Any word may be prefixed by a multiplier in the form of a decimal number
 and @code{*}: @code{3*<right>} @equiv{} @code{<right> <right> <right>},
-and @code{10*foo} @equiv{} @code{foofoofoofoofoofoofoofoofoofoo}.
+and @code{10*foo} @equiv{}
+@iftex
+@*
+@end iftex
+@code{foofoofoofoofoofoofoofoofoofoo}.
 Multiple text keys can normally be strung together to form a word, but
 you may need to add whitespace if the word would look like one of the
 above notations: @code{; ; ;} is a keyboard macro with three semicolons,
 but @code{;;;} is a comment.  Likewise, @code{\ 1 2 3} is four keys but
 seven keys but @code{<right>} is a single function key.  When in doubt,
 use whitespace.
 @end quotation
 @node Q5.1.4, Q5.1.5, Q5.1.3, Miscellaneous
-@section What is the performance hit of @code{let}?
+@unnumberedsubsec Q5.1.4: What is the performance hit of @code{let}?
 In most cases, not noticeable.  Besides, there's no avoiding
 @code{let}---you have to bind your local variables, after all.  Some
 pose a question whether to nest @code{let}s, or use one @code{let} per
 function.  I think because of clarity and maintenance (and possible
 future implementation), @code{let}-s should be used (nested) in a way to
 provide the clearest code.
 @node Q5.1.5, Q5.1.6, Q5.1.4, Miscellaneous
-@section What is the recommended use of @code{setq}?
+@unnumberedsubsec Q5.1.5: What is the recommended use of @code{setq}?
 @itemize @bullet
 @item Global variables
 You will typically @code{defvar} your global variable to a default
 variable if it was bound previously.  If you wish to change a
 user-variable temporarily, use @code{let}:
 @lisp
 (let ((case-fold-search nil))
-...       ; code with searches that must be case-sensitive
+...					; code with searches that must be case-sensitive
 ...)
 @end lisp
 You will notice the user-variables by their docstrings beginning with an
 asterisk (a convention).
 (let .....))
 @end lisp
 @end itemize
 @node Q5.1.6, Q5.1.7, Q5.1.5, Miscellaneous
-@section What is the typical misuse of @code{setq} ?
+@unnumberedsubsec Q5.1.6: What is the typical misuse of @code{setq} ?
 A typical misuse is probably @code{setq}ing a variable that was meant to
 be local.  Such a variable will remain bound forever, never to be
 garbage-collected.  For example, the code doing:
 does a bad thing, as @code{a} will keep consuming memory, never to be
 unbound.  The correct thing is to do it like this:
 @lisp
 (defun my-function (whatever)
-(let (a)             ; default initialization is to nil
+(let (a)				; default initialization is to nil
 ... build a large list ...
 ... and exit, unbinding `a' in the process  ...)
 @end lisp
 Not only is this prettier syntactically, but it makes it possible for
 Note that even global variables should not be @code{setq}ed without
 @code{defvar}ing them first, because the byte-compiler issues warnings.
 The reason for the warning is the following:
 @lisp
-(defun flurgoze nil)          ; ok, global internal variable
+(defun flurgoze nil)			; ok, global internal variable
 ...
-(setq flurghoze t)      ; ops!  a typo, but semantically correct.
+(setq flurghoze t)			; ops!  a typo, but semantically correct.
-; however, the byte-compiler warns.
+					; however, the byte-compiler warns.
 While compiling toplevel forms:
 ** assignment to free variable flurghoze
 @end lisp
 @node Q5.1.7, Q5.1.8, Q5.1.6, Miscellaneous
-@section I like the the @code{do} form of cl, does it slow things down?
+@unnumberedsubsec Q5.1.7: I like the the @code{do} form of cl, does it slow things down?
 It shouldn't.  Here is what Dave Gillespie has to say about cl.el
 performance:
 @quotation
 You can find out how a macro expands by using the @code{cl-prettyexpand}
 function.
 @end quotation
 @node Q5.1.8, Q5.1.9, Q5.1.7, Miscellaneous
-@section I like recursion, does it slow things down?
+@unnumberedsubsec Q5.1.8: I like recursion, does it slow things down?
 Yes.  Emacs byte-compiler cannot do much to optimize recursion.  But
 think well whether this is a real concern in Emacs.  Much of the Emacs
 slowness comes from internal mechanisms such as redisplay, or from the
 fact that it is an interpreter.
 Please try not to make your code much uglier to gain a very small speed
 gain.  It's not usually worth it.
 @node Q5.1.9, Q5.1.10, Q5.1.8, Miscellaneous
-@section How do I put a glyph as annotation in a buffer?
+@unnumberedsubsec Q5.1.9: How do I put a glyph as annotation in a buffer?
 Here is a solution that will insert the glyph annotation at the
 beginning of buffer:
 @lisp
 (point-min)
 'text
 (current-buffer))
 @end lisp
 Replace @samp{FORMAT} with an unquoted symbol representing the format of
 the image (e.g. @code{xpm}, @code{xbm}, @code{gif}, @code{jpeg}, etc.)
 Instead of @samp{FILE}, use the image file name
-(e.g. @file{/usr/local/lib/xemacs-20.2/etc/recycle.xpm}).
+(e.g.
+@iftex
+@*
+@end iftex
+@file{/usr/local/lib/xemacs-20.2/etc/recycle.xpm}).
 You can turn this to a function (that optionally prompts you for a file
 name), and inserts the glyph at @code{(point)} instead of
 @code{(point-min)}.
 @node Q5.1.10, Q5.2.1, Q5.1.9, Miscellaneous
-@section @code{map-extents} won't traverse all of my extents!
+@unnumberedsubsec Q5.1.10: @code{map-extents} won't traverse all of my extents!
 I tried to use @code{map-extents} to do an operation on all the extents
 in a region.  However, it seems to quit after processing a random number
 of extents.  Is it buggy?
 No.  The documentation of @code{map-extents} states that it will iterate
 across the extents as long as @var{function} returns @code{nil}.
 Unexperienced programmers often forget to return @code{nil} explicitly,
 which results in buggy code.  For instance, the following code is
 supposed to delete all the extents in a buffer, and issue as many
 @samp{fubar!} messages.
 (message "fubar!")
 nil))
 @end lisp
 @node Q5.2.1, Q5.2.2, Q5.1.10, Miscellaneous
-@section How do I turn off the sound?
+@unnumberedsubsec Q5.2.1: How do I turn off the sound?
 Add the following line to your @file{.emacs}:
 @lisp
 (setq bell-volume 0)
 (setq sound-alist nil)
 @end lisp
 That will make your XEmacs totally silent -- even the default ding sound
 (TTY beep on TTY-s) will be gone.
 Starting with XEmacs-20.2 you can also change these with Customize.
 Select from the @code{Options} menu
 @code{Customize->Emacs->Environment->Sound->Sound...} or type
 @kbd{M-x customize RET sound RET}.
 @node Q5.2.2, Q5.2.3, Q5.2.1, Miscellaneous
-@section How do I get funky sounds instead of a boring beep?
+@unnumberedsubsec Q5.2.2: How do I get funky sounds instead of a boring beep?
 Make sure your XEmacs was compiled with sound support, and then put this
 in your @file{.emacs}:
 @lisp
 The sound support in XEmacs 19.14 was greatly improved over previous
 versions.
 @node Q5.2.3, Q5.2.4, Q5.2.2, Miscellaneous
-@section What's NAS, how do I get it?
+@unnumberedsubsec Q5.2.3: What's NAS, how do I get it?
 @xref{Q2.0.3} for an explanation of the @dfn{Network Audio System}.
 @node Q5.2.4, Q5.3.1, Q5.2.3, Miscellaneous
-@section Sunsite sounds don't play.
+@unnumberedsubsec Q5.2.4: Sunsite sounds don't play.
 I'm having some trouble with sounds I've downloaded from sunsite.  They
 play when I run them through @code{showaudio} or cat them directly to
 @file{/dev/audio}, but XEmacs refuses to play them.
-Markus Gutschke <gutschk@@uni-muenster.de> writes:
+@email{gutschk@@uni-muenster.de, Markus Gutschke} writes:
 @quotation
 [Many of] These files have an (erroneous) 24byte header that tells about
 the format that they have been recorded in. If you cat them to
 @file{/dev/audio}, the header will be ignored and the default behavior
 passing explicit parameters for specifying the sampling format; you then
 need to perform a 'null' conversion from SunAudio to SunAudio.
 @end quotation
 @node Q5.3.1, Q5.3.2, Q5.2.4, Miscellaneous
-@section How do you make XEmacs indent CL if-clauses correctly?
+@unnumberedsec Miscellaneous
+@unnumberedsubsec Q5.3.1: How do you make XEmacs indent CL if-clauses correctly?
 I'd like XEmacs to indent all the clauses of a Common Lisp @code{if} the
 same amount instead of indenting the 3rd clause differently from the
 first two.
 comp.emacs.xemacs on 12/9/94.  This version includes more documentation
 than previous versions.  This may prove useful if you need to customize
 any indent-functions.
 @node Q5.3.2, Q5.3.3, Q5.3.1, Miscellaneous
-@section Fontifying hang when editing a postscript file.
+@unnumberedsubsec Q5.3.2: Fontifying hang when editing a postscript file.
 When I try to edit a postscript file it gets stuck saying:
 @samp{fontifying 'filename' (regexps....)} and it just sits there.  If I
 press @kbd{C-c} in the window where XEmacs was started, it suddenly
 becomes alive again.
 Take it out, restart XEmacs, and it won't try to fontify your postscript
 files anymore.
 @node Q5.3.3, Q5.3.4, Q5.3.2, Miscellaneous
-@section How can I print WYSIWYG a font-locked buffer?
+@unnumberedsubsec Q5.3.3: How can I print WYSIWYG a font-locked buffer?
 Font-lock looks nice.  How can I print (WYSIWYG) the highlighted
 document?
 The package @code{ps-print}, which is now included with XEmacs, provides
 the ability to do this.  The source code contains complete instructions
-on its use, in @file{<xemacs_src_root>/lisp/packages/ps-print.el}.
+on its use, in @file{@email{xemacs_src_root}/lisp/packages/ps-print.el}.
 @node Q5.3.4, Q5.3.5, Q5.3.3, Miscellaneous
-@section Getting @kbd{M-x lpr} to work with postscript printer.
+@unnumberedsubsec Q5.3.4: Getting @kbd{M-x lpr} to work with postscript printer.
 My printer is a Postscript printer and @code{lpr} only works for
 Postscript files, so how do I get @kbd{M-x lpr-region} and @kbd{M-x
 lpr-buffer} to work?
 If you don't use a2ps to convert ASCII to postscript (why not, it's
 free?), replace with the command you do use.  Note also that some
 versions of a2ps require a @samp{-Pprinter} to ensure spooling.
 @node Q5.3.5, Q5.3.6, Q5.3.4, Miscellaneous
-@section How do I specify the paths that XEmacs uses for finding files?
+@unnumberedsubsec Q5.3.5: How do I specify the paths that XEmacs uses for finding files?
 You can specify what paths to use by using a number of different flags
 when running configure.  See the section MAKE VARIABLES in the top-level
 file INSTALL in the XEmacs distribution for a listing of those flags.
 be specified by passing the @code{--prefix} flag to configure.  For a
 description of the XEmacs install tree, please consult the @file{NEWS}
 file.
 @node Q5.3.6, Q5.3.7, Q5.3.5, Miscellaneous
-@section [This question intentionally left blank]
+@unnumberedsubsec Q5.3.6: [This question intentionally left blank]
 Obsolete question, left blank to avoid renumbering.
 @node Q5.3.7, Q5.3.8, Q5.3.6, Miscellaneous
-@section Can I have the end of the buffer delimited in some way?
+@unnumberedsubsec Q5.3.7: Can I have the end of the buffer delimited in some way?
 Say, with: @samp{[END]}?
 Try this:
 @lisp
 (let ((ext (make-extent (point-min) (point-max))))
 (set-extent-property ext 'start-closed t)
 (set-extent-property ext 'end-closed t)
 (set-extent-property ext 'detachable nil)
 (set-extent-end-glyph ext (make-glyph [string :data "[END]"])))
 @end lisp
 Since this is XEmacs, you can specify an icon to be shown on
 window-system devices.  To do so, change the @code{make-glyph} call to
 @lisp
 (let ((ext (make-extent (point-min) (point-max))))
 (set-extent-property ext 'start-closed t)
 (set-extent-property ext 'end-closed t)
 (set-extent-property ext 'detachable nil)
 (set-extent-end-glyph ext (make-glyph '([xpm :data "\
 /* XPM */
 static char* eye = @{
 \"20 11 7 2\",
 \"__ c None\"
 \"_a c #fefefe\",
 \"_b c #7f0000\",
 \"_c c #fefe00\",
 \"_d c #fe0000\",
 \"_e c #bfbfbf\",
 \"___________`_`_`___b_b_b_b_________`____\",
 \"_________`_`_`___b_c_c_c_b_b____________\",
 \"_____`_`_`_e___b_b_c_c_c___b___b_______`\",
 \"___`_`_e_a___b_b_d___b___b___b___b______\",
 \"_`_`_e_a_e___b_b_d_b___b___b___b___b____\",
 \"_`_`_a_e_a___b_b_d___b___b___b___b___b__\",
 \"_`_`_e_a_e___b_b_d_b___b___b___b___b_b__\",
 \"___`_`_e_a___b_b_b_d_c___b___b___d_b____\",
 \"_____`_`_e_e___b_b_b_d_c___b_b_d_b______\",
 \"_`_____`_`_`_`___b_b_b_d_d_d_d_b________\",
 \"___`_____`_`_`_`___b_b_b_b_b_b__________\",
 @} ;"]
 [string :data "[END]"]))))
 @end lisp
 Note that you might want to make this a function, and put it to a hook.
 We leave that as an exercise for the reader.
 @node Q5.3.8, Q5.3.9, Q5.3.7, Miscellaneous
-@section How do I insert today's date into a buffer?
+@unnumberedsubsec Q5.3.8: How do I insert today's date into a buffer?
 Like this:
 @lisp
 (insert (current-time-string))
 @end lisp
 @node Q5.3.9, Q5.3.10, Q5.3.8, Miscellaneous
-@section Are only certain syntactic character classes available for abbrevs?
+@unnumberedsubsec Q5.3.9: Are only certain syntactic character classes available for abbrevs?
-Markus Gutschke <gutschk@@uni-muenster.de> writes:
+@email{gutschk@@uni-muenster.de, Markus Gutschke} writes:
 @quotation
 Yes, abbrevs only expands word-syntax strings. While XEmacs does not
 prevent you from defining (e.g. with @kbd{C-x a g} or @kbd{C-x a l})
 abbrevs that contain special characters, it will refuse to expand
 @end quotation
 Starting with XEmacs 20.3 this restriction has been lifted.
 @node Q5.3.10, Q5.3.11, Q5.3.9, Miscellaneous
-@section How can I get those oh-so-neat X-Face lines?
+@unnumberedsubsec Q5.3.10: How can I get those oh-so-neat X-Face lines?
 Firstly there is an ftp site which describes X-faces and has the
 associated tools mentioned below, at
-<URL:ftp://ftp.cs.indiana.edu:/pub/faces/>.
+@uref{ftp://ftp.cs.indiana.edu:/pub/faces/}.
 Then the steps are
 @enumerate
 @item
 @item
 Then be sure to quote things that are necessary for emacs strings:
 @example
-cat ./file.face | sed 's/\\/\\\\/g'  | sed 's/\"/\\\"/g' > ./file.face.quoted
+cat ./file.face | sed 's/\\/\\\\/g'
+@iftex
+\ @*
+@end iftex
+| sed 's/\"/\\\"/g' > ./file.face.quoted
 @end example
 @item
 Then set up emacs to include the file as a mail header - there were a
 couple of suggestions here---either something like:
 @lisp
 (setq  mail-default-headers
-"X-Face:  <Ugly looking text string here>")
+"X-Face:  @email{Ugly looking text string here}")
 @end lisp
 Or, alternatively, as:
 @lisp
 (defun mail-insert-x-face ()
 (save-excursion
 (goto-char (point-min))
 (search-forward mail-header-separator)
 (beginning-of-line)
 (insert "X-Face:")
 (insert-file-contents "~/.face")))
 @end example
 Some people have also found that if one uses the @code{(insert-file)}
 method, one should NOT quote the face string using the sed script .
-It might also be helpful to use Stig's <stig@@hackvan.com> script
+It might also be helpful to use @email{stig@@hackvan.com, Stig's} script
 (included in the compface distribution at XEmacs.org) to do the
 conversion.  For convenience xbm2xface is available for anonymous FTP at
-<URL:ftp://ftp.miranova.com/pub/xemacs/xbm2xface.pl>.
+@uref{ftp://ftp.miranova.com/pub/xemacs/xbm2xface.pl}.
 Contributors for this item:
 Paul Emsley,
 Ricardo Marek,
 Amir J. Katz,
 Glen McCort,
 Heinz Uphoff,
 Peter Arius,
 Paul Harrison, and
 Vegard Vesterheim
 @node Q5.3.11, Q5.3.12, Q5.3.10, Miscellaneous
-@section How do I add new Info directories?
+@unnumberedsubsec Q5.3.11: How do I add new Info directories?
 You use something like:
 @lisp
 (setq Info-directory-list (cons
-			    (expand-file-name "~/info")
+			   (expand-file-name "~/info")
-			    Info-default-directory-list))
+			   Info-default-directory-list))
 @end lisp
-David Masterson <davidm@@prism.kla.com> writes:
+@email{davidm@@prism.kla.com, David Masterson} writes:
 @quotation
 Emacs Info and XEmacs Info do many things differently.  If you're trying to
 support a number of versions of Emacs, here are some notes to remember:
 Another alternative is to convert the documentation to HTML with
 texi2html and read it from a web browser like Lynx or W3.
 @end quotation
 @node Q5.3.12,  , Q5.3.11, Miscellaneous
-@section What do I need to change to make printing work?
+@unnumberedsubsec Q5.3.12: What do I need to change to make printing work?
 For regular printing there are two variables that can be customized.
 @table @code
 @item lpr-command
 NOTE: It is an undocumented limitation in XEmacs that postscript
 printing (the @code{Pretty Print Buffer} menu item) @strong{requires} a
 window system environment.  It cannot be used outside of X11.
 @node Current Events,  , Miscellaneous, Top
-@chapter What the Future Holds
+@unnumbered 6 What the Future Holds
 This is part 6 of the XEmacs Frequently Asked Questions list.  This
 section will change monthly, and contains any interesting items that have
 transpired over the previous month.  If you are reading this from the
 XEmacs distribution, please see the version on the Web or archived at the
 various FAQ FTP sites, as this file is surely out of date.
 @menu
 * Q6.0.1::      What is new in 20.2?
 * Q6.0.2::      What is new in 20.3?
-* Q6.0.3::      Procedural changes in XEmacs development.
+* Q6.0.3::      What is new in 20.4?
+* Q6.0.4::      Procedural changes in XEmacs development.
 @end menu
 @node Q6.0.1, Q6.0.2, Current Events, Current Events
-@section What is new in 20.2?
+@unnumberedsec Changes
+@unnumberedsubsec Q6.0.1: What is new in 20.2?
 The biggest changes in 20.2 include integration of EFS (the next
 generation of ange-ftp) and AUC Tex (the Emacs subsystem that includes a
 major mode for editing Tex and LaTeX, and a lot of other stuff).  Many
 bugs from 20.0 have been fixed for this release.  20.2 also contains a
 XEmacs 20.2 is the development release (20.0 was beta), and is no longer
 considered unstable.
 @node Q6.0.2, Q6.0.3, Q6.0.1, Current Events
-@section What is new in 20.3?
+@unnumberedsubsec Q6.0.2: What is new in 20.3?
 XEmacs 20.3 was released in November 1997. It contains many bugfixes,
 and a number of new features, including Autoconf 2 based configuration,
 additional support for Mule (Multi-language extensions to Emacs), many
 more customizations, multiple frames on TTY-s, support for multiple info
 the default) is definitely faster than XEmacs 19.16.
 XEmacs 20.3 is the first non-beta v20 release, and will be the
 basis for all further development.
-@node Q6.0.3,  , Q6.0.2, Current Events
+@node Q6.0.3, Q6.0.4, Q6.0.2, Current Events
-@section Procedural changes in XEmacs development.
+@unnumberedsubsec Q6.0.3: What's new in XEmacs 20.4?
+XEmacs 20.4 is a bugfix release with no user-visible changes.
+@c Filled in from NEWS file of 20.5-b33
+@node Q6.0.4,  , Q6.0.3, Current Events
+@unnumberedsubsec Q6.0.4: Procedural changes in XEmacs development.
 @enumerate
 @item
 Discussion about the development of XEmacs occurs on the xemacs-beta
 mailing list.  Subscriptions to this list will now be fully automated
 instead of being handled by hand.  Send a mail message to
-<xemacs-beta-request@@xemacs.org> with a subject of subscribe to join
+@email{xemacs-beta-request@@xemacs.org} with a subject of subscribe to join
 the list.  Please note this is a developers mailing list for people who
 have an active interest in the development process.
 The discussion of NT XEmacs development is taking place on a separate
-mailing list.  Send mail to <xemacs-nt-request@@xemacs.org> to
+mailing list.  Send mail to
+@iftex
+@*
+@end iftex
+@email{xemacs-nt-request@@xemacs.org} to
 subscribe.
 @item
 Due to the long development cycle in between releases, it has been
 decided that intermediate versions will be made available in source only
 XEmacs 19.16 was the last 19 release, basically consisting of 19.15 plus
 the collected bugfixes.
 @item
-As of December 1996, Steve Baur <steve@@altair.xemacs.org> has become
+As of December 1996, @email{steve@@altair.xemacs.org, Steve Baur} has become
 the lead maintainer of XEmacs.
 @end enumerate
 @bye

Mercurial > hg > xemacs-beta

comparison man/xemacs-faq.texi @ 274:ca9a9ec9c1c1 r21-0b35