-Q1.4.1: What is a `.emacs' and is there a sample one?
------------------------------------------------------
-
- The `.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 `sample.emacs'. Copy this file from there to your
-home directory and rename it `.emacs'. Then edit it to suit.
-
- Starting with 19.14, you may bring the `sample.emacs' into an XEmacs
-buffer by selecting `Help->Sample .emacs' from the menubar. To
-determine the location of the `etc' directory type the command `C-h v
+Q1.4.1: What is an `init.el' or `.emacs' and is there a sample one?
+-------------------------------------------------------------------
+
+ The `init.el' or `.emacs' file is used to customize XEmacs to your
+tastes. Starting in 21.4, the preferred location for the init file is
+`~/.xemacs/init.el'; in previous versions, it was `~/.emacs'. 21.4
+still accepts the old location, but the first time you run it, it will
+ask to migrate your file to the new location. If you answer yes, the
+file will be moved, and a "compatibility" `.emacs' file will be placed
+in the old location so that you can still run older versions of XEmacs,
+and versions of GNU Emacs, which expect the old location. The `.emacs'
+file present is just a stub that loads the real file in
+`~/.xemacs/init.el'.
+
+ No two init files 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 `sample.init.el' (starting in
+21.4) or `sample.emacs' in older versions. Copy this file from there
+to `~/.xemacs/init.el' (starting in 21.4) or `~/.emacs' in older
+versions, where `~' means your home directory, of course. Then edit it
+to suit.
+
+ You may bring the `sample.init.el' or `sample.emacs' file into an
+XEmacs buffer from the menubar. (The menu entry for it is always under
+the `Help' menu, but its location under that has changed in various
+versions. Recently, look under the `Samples' submenu.) To determine
+the location of the `etc/' directory type the command `C-h v