--- a/man/xemacs-faq.texi	Mon Aug 13 10:05:53 2007 +0200
+++ b/man/xemacs-faq.texi	Mon Aug 13 10:06:47 2007 +0200
@@ -8,7 +8,7 @@
 @titlepage
 @title XEmacs FAQ
 @subtitle Frequently asked questions about XEmacs
-@subtitle Last Modified:  1997-07-17
+@subtitle Last Modified:  1997-11-10
 @sp 1
 @author Tony Rossini <arossini@@stat.sc.edu>
 @author Ben Wing <wing@@666.com>
@@ -420,21 +420,22 @@
 @node Q1.0.2, Q1.0.3, Q1.0.1, Introduction
 @section What is the current version of XEmacs?
 
-The current stable version of XEmacs is 20.2, released in May, 1997.
-The next feature release will XEmacs 20.3.
-
-XEmacs 19.15 was the last release of v19, released in March, 1997.
-
-To help users who are not yet ready to move to XEmacs 20, we run a
-patch-page with official bugfixes for 19.15 at:
+There are currently two released versions of XEmacs:
+
+The current stable International version of XEmacs is 20.2, released in
+May, 1997.  The next feature release will XEmacs 20.3.
+
+The current version of XEmacs without international language support is
+XEmacs 19.16 and is the last release of v19. This version was released
+in November, 1997.
+
+We also run a patch-page with official bugfixes for 19.15 at:
 
 @example
 <URL:http://www.xemacs.org/xemacs-19.15-patches/patch-page.html>
 @end example
 
-The page is maintained by Vinnie Shelton @code{<acs@@acm.org>}.  These
-fixes will be integrated to a XEmacs and released as 19.16, which would
-serve as stable XEmacs until 20.x settles completely.
+The page is maintained by Vinnie Shelton @code{<acs@@acm.org>}.  
 
 @node Q1.0.3, Q1.0.4, Q1.0.2, Introduction
 @section Where can I find it?
@@ -631,7 +632,7 @@
 @node Q1.0.14, Q1.1.1, Q1.0.13, Introduction
 @section Where can I obtain a printed copy of the XEmacs users manual?
 
-InfoDock Associates, a firm specializing in Emacs-related support and
+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'!
@@ -670,9 +671,7 @@
 @section How do I become a Beta Tester?
 
 Send an email message to <xemacs-beta-request@@xemacs.org> with a
-subject line of @samp{subscribe}.  Fill out and return the questionnaire
-you get back, and you will receive the password to get at the current
-beta.
+subject line of @samp{subscribe}.  
 
 Be prepared to get your hands dirty, as beta testers are expected to
 identify problems as best they can.
@@ -713,12 +712,14 @@
 @section Who wrote XEmacs?
 
 XEmacs is the result of the time and effort of many people.  The
-developers responsible for the 19.15/20.x releases are:
+developers responsible for the 19.16/20.x releases are:
 
 @itemize @bullet
 @item Martin Buchholz <mrb@@eng.sun.com>
 
 @item Steve Baur <steve@@altair.xemacs.org>
+
+@item Hrvoje Niksic <hniksic@@srce.hr>
 @end itemize
 
 The developers responsible for the 19.14 release are:
@@ -804,7 +805,7 @@
 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.  When compiled without MULE support 20.2 is currently very
-similar to 19.15 (except for some changes to the byte-code format, some
+similar to 19.16 (except for some changes to the byte-code format, some
 new primitive types including @code{char}, @code{char-table}, and
 @code{range-table}) and equally stable.
 
@@ -953,8 +954,7 @@
 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
 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>.
+which can be obtained from <URL:ftp://ftp.cis.ohio-state.edu/pub/gnu/emacs/elisp-archive/packages/russian.el.Z>.
 @end quotation
 
 Dima Barsky <d.barsky@@ee.surrey.ac.uk> writes:
@@ -1073,7 +1073,7 @@
 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
+@node Q1.4.7, , Q1.4.6, Introduction
 @section How come options saved with 19.13 don't work with 19.14 or later?
 
 There's a problem with options of the form:
@@ -1607,7 +1607,7 @@
 cp src/xemacs /usr/local/bin/xemacs
 
 @item
-cp lib-src/DOC-19.15-XEmacs /usr/local/lib/xemacs-19.15/i586-unknown-linuxaout
+cp lib-src/DOC-19.16-XEmacs /usr/local/lib/xemacs-19.16/i586-unknown-linuxaout
 @end enumerate
 @end quotation
 
@@ -1633,7 +1633,7 @@
 @node Q2.0.14, Q2.1.1, Q2.0.13, Installation
 @section Make on HP/UX 9 fails after linking temacs
 
-Problem when building xemacs-19.15 on hpux 9:
+Problem when building xemacs-19.16 on hpux 9:
 
 Richard Cognot <cognot@@ensg.u-nancy.fr> writes:
 
@@ -1769,7 +1769,7 @@
 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
-@file{<xemacs_root_directory>/lib/xemacs-19.15/etc/XKeysymDB}.
+@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
@@ -4007,7 +4007,7 @@
 support.  When appropriate a message will be decoded in place in an
 XEmacs buffer.
 
-TM now comes as a package with XEmacs 19.15 and XEmacs 20.0.
+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
 Shuhei <shuhei-k@@jaist.ac.jp>.  It is based on the work of UMEDA
@@ -4300,7 +4300,7 @@
 @section What is AUC TeX?  Where do you get it?
 
 AUC TeX is a package written by Per Abrahamsen <abraham@@dina.kvl.dk>.
-Starting with XEmacs 19.15, AUC TeX is bundled with XEmacs.  The
+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
@@ -4438,10 +4438,11 @@
 * Q5.1.3::      Could you explain @code{read-kbd-macro} in more detail?
 * Q5.1.4::      What is the performance hit of @code{let}?
 * Q5.1.5::      What is the recommended use of @code{setq}?
-* Q5.1.6::      What is the typical misuse of @code{setq} ?
+* Q5.1.6::      What is the typical misuse of @code{setq}?
 * Q5.1.7::      I like the the @code{do} form of cl, does it slow things down?
 * Q5.1.8::      I like recursion, does it slow things down?
 * Q5.1.9::      How do I put a glyph as annotation in a buffer?
+* Q5.1.10::     @code{map-extents} won't traverse all of my extents!
 
 Sound:
 * Q5.2.1::      How do I turn off the sound?
@@ -5091,7 +5092,7 @@
 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.2.1, Q5.1.8, Miscellaneous
+@node Q5.1.9, Q5.1.10, Q5.1.8, Miscellaneous
 @section How do I put a glyph as annotation in a buffer?
 
 Here is a solution that will insert the glyph annotation at the
@@ -5114,7 +5115,38 @@
 name), and inserts the glyph at @code{(point)} instead of
 @code{(point-min)}.
 
-@node Q5.2.1, Q5.2.2, Q5.1.9, Miscellaneous
+@node Q5.1.10, Q5.2.1, Q5.1.9, Miscellaneous
+@section @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.
+
+@lisp
+(map-extents (lambda (ext ignore)
+               (delete-extent ext)
+               (message "fubar!")))
+@end lisp
+
+Instead, it will delete only the first extent, and stop right there --
+because @code{message} will return a non-nil value.  The correct code
+is:
+
+@lisp
+(map-extents (lambda (ext ignore)
+               (delete-extent ext)
+               (message "fubar!")
+               nil))
+@end lisp
+
+@node Q5.2.1, Q5.2.2, Q5.1.10, Miscellaneous
 @section How do I turn off the sound?
 
 Add the following line to your @file{.emacs}: