Commit 14a893ee authored by Eli Zaretskii's avatar Eli Zaretskii
Browse files

(Init File): Say explicitly that site-start.el is also searched along

load-path.  Recommend where to put default.el and site-start.el.  Add
index entries for site-start.el and default.el.
parent 3b703ce9
...@@ -2037,6 +2037,7 @@ for you. You can use the command line switch @samp{-q} to prevent ...@@ -2037,6 +2037,7 @@ 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 loading your init file, and @samp{-u} (or @samp{--user}) to specify a
different user's init file (@pxref{Entering Emacs}). different user's init file (@pxref{Entering Emacs}).
@cindex @file{default.el}, the default init file
There can also be a @dfn{default init file}, which is the library There can also be a @dfn{default init file}, which is the library
named @file{default.el}, found via the standard search path for named @file{default.el}, found via the standard search path for
libraries. The Emacs distribution contains no such library; your site libraries. The Emacs distribution contains no such library; your site
...@@ -2046,10 +2047,21 @@ But your init file, if any, is loaded first; if it sets ...@@ -2046,10 +2047,21 @@ But your init file, if any, is loaded first; if it sets
@code{inhibit-default-init} non-@code{nil}, then @file{default} is not @code{inhibit-default-init} non-@code{nil}, then @file{default} is not
loaded. loaded.
@cindex site init file
@cindex @file{site-start.el}, the site startup file
Your site may also have a @dfn{site startup file}; this is named Your site may also have a @dfn{site startup file}; this is named
@file{site-start.el}, if it exists. Emacs loads this library before it @file{site-start.el}, if it exists. Like @file{default.el}, Emacs
loads your init file. To inhibit loading of this library, use the finds this file via the standard search path for Lisp libraries.
option @samp{-no-site-file}. @xref{Initial Options}. Emacs loads this library before it loads your init file. To inhibit
loading of this library, use the option @samp{-no-site-file}.
@xref{Initial Options}.
You can place @file{default.el} and @file{site-start.el} in any of
the directories which Emacs searches for Lisp libraries. The variable
@code{load-path} (@pxref{Lisp Libraries}) specifies these directories.
Many sites put these files in the @file{site-lisp} subdirectory of the
Emacs installation directory, typically
@file{/usr/local/share/emacs/site-lisp}.
If you have a large amount of code in your @file{.emacs} file, you If you have a large amount of code in your @file{.emacs} file, you
should rename it to @file{~/.emacs.el}, and byte-compile it. @xref{Byte should rename it to @file{~/.emacs.el}, and byte-compile it. @xref{Byte
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment