Document ~/.emacs.d/init.el

3 files changed, 19 insertions, 10 deletions

diff --git a/man/ChangeLog b/man/ChangeLog
index a89484c30f5..286db35285d 100644
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,9 @@
+2005-10-29  Chong Yidong  <cyd@stupidchicken.com>
+
+        * custom.texi (Init File): Document ~/.emacs.d/init.el.
+
+        * anti.texi (Antinews): Likewise.
+
 2005-10-29  Sascha Wilde  <wilde@sha-bang.de>
 
         * pgg.texi (How to use): Update the example to add autoload of
diff --git a/man/anti.texi b/man/anti.texi
index ecff1f06a8c..0095f0d6872 100644
--- a/man/anti.texi
+++ b/man/anti.texi
@@ -63,9 +63,10 @@ the @samp{-f} option will not read arguments for interactive
 functions.
 
 @item
-Emacs now looks for @file{.emacs} and @file{.emacs_SHELL} in one
-standard location---your home directory.  Don't put these files in
-@file{~/.emacs.d}; they won't be found.
+We have standardized on one location for the user init file: the file
+named @file{.emacs} in your home directory.  Emacs will not look for
+the init file in @file{~/.emacs.d/init.el}.  Similarly, don't try
+putting @file{.emacs_SHELL} in @file{~/.emacs.d}; Emacs won't find it.
 
 @item
 Emacs will not read @file{~/.abbrev_defs} automatically.  If you want
diff --git a/man/custom.texi b/man/custom.texi
index aad67d21133..9a76f0cc111 100644
--- a/man/custom.texi
+++ b/man/custom.texi
@@ -1983,13 +1983,15 @@ Reference Manual}.
 @cindex startup (init file)
 
   When Emacs is started, it normally loads a Lisp program from the
-file @file{.emacs} or @file{.emacs.el} in your home directory.  (You
-can also put it in a subdirectory @file{~/.emacs.d} and Emacs will
-still find it.)  We call this file your @dfn{init file} because it
-specifies how to initialize Emacs for you.  You can use the command
-line switch @samp{-q} to prevent loading your init file, and @samp{-u}
-(or @samp{--user}) to specify a different user's init file
-(@pxref{Initial Options}).
+file @file{.emacs} or @file{.emacs.el} in your home directory.  We
+call this file your @dfn{init file} because it specifies how to
+initialize Emacs for you.  You can use the command line switch
+@samp{-q} to prevent loading your init file, and @samp{-u} (or
+@samp{--user}) to specify a different user's init file (@pxref{Initial
+Options}).
+
+  You can also use @file{~/.emacs.d/init.el} as the init file.  Emacs
+tries this if it cannot find @file{~/.emacs} or @file{~/.emacs.el}.
 
 @cindex @file{default.el}, the default init file
   There can also be a @dfn{default init file}, which is the library