masscollaborationlabs/emacs
2
0
Fork 0
mirror of https://github.com/masscollaborationlabs/emacs.git synced 2025-07-04 03:13:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

; Mention early-init file in Emacs FAQ for Windows

Browse source 
* doc/misc/efaq-w32.texi (Location of init file, Init file):
Mention the early-init file.  Suggested by David Hedlund
<davidh@gnu.org>.
This commit is contained in:
Eli Zaretskii 2025-04-29 09:05:28 +03:00
parent 14c707b42d
commit 2a8e223b8d
1 changed files with 14 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

18
doc/misc/efaq-w32.texi
View file

@ -353,6 +353,7 @@ not bundled with Emacs. @xref{Other useful ports}.
@section What is my init file? @section What is my init file?
@cindex .emacs @cindex .emacs
@cindex init file @cindex init file
@cindex early init file
When Emacs starts up, it attempts to load and execute the contents of When Emacs starts up, it attempts to load and execute the contents of
a file commonly called @file{.emacs} (though it may have other names, a file commonly called @file{.emacs} (though it may have other names,
@ -362,22 +363,31 @@ code to your .emacs, or you can use the Customization interface
accessible from the @emph{Options} menu. If the file does not exist, accessible from the @emph{Options} menu. If the file does not exist,
Emacs will start with the default settings. Emacs will start with the default settings.
In addition, Emacs 27 and later attempts to load and execute the
contents of the @file{early-init.el} file. As its name suggests, this
file, if it exists, is loaded and executed early on during the Emacs
startup sequence, before @code{.emacs}, and is intended to contain the
few initializations which must be performed before @file{.emacs} is
looked up and loaded.
@node Location of init file @node Location of init file
@section Where do I put my init file? @section Where do I put my init file?
@cindex HOME directory @cindex HOME directory
@cindex .emacs.d @cindex .emacs.d
@cindex _emacs @cindex _emacs
@cindex init.el @cindex init.el
@cinde early-init.el
@cindex registry, setting the HOME directory in @cindex registry, setting the HOME directory in
On Windows, the @file{.emacs} file may be called @file{_emacs} for On Windows, the @file{.emacs} init file may be called @file{_emacs} for
backward compatibility with DOS and FAT filesystems where filenames backward compatibility with DOS and FAT filesystems where filenames
could not start with a dot. Some users prefer to continue using such could not start with a dot. Some users prefer to continue using such
a name due to historical problems various Windows tools had in the a name due to historical problems various Windows tools had in the
past with file names that begin with a dot. The init file may also be past with file names that begin with a dot. The init file may also be
called @file{.emacs.d/init.el}. Many of the other files that are called @file{.emacs.d/init.el}. The @file{early-init.el} file and many
created by Lisp packages are stored in the @file{.emacs.d} directory of the other files that are created by Lisp packages are stored in the
too, which keeps all your Emacs related files in one place. @file{.emacs.d} directory too, which keeps all your Emacs related files
in one place.
All the files mentioned above should go in your @env{HOME} directory. All the files mentioned above should go in your @env{HOME} directory.
The @env{HOME} directory is determined by following the steps below: The @env{HOME} directory is determined by following the steps below: