summaryrefslogtreecommitdiff
path: root/doc/emacs
diff options
context:
space:
mode:
authorGlenn Morris <rgm@gnu.org>2008-04-05 18:39:33 +0000
committerGlenn Morris <rgm@gnu.org>2008-04-05 18:39:33 +0000
commit06a97d46c40453352292d28589ffbf2631819fa0 (patch)
tree90450aadc6243161d6e3c43e4aa08d0bc2e18de9 /doc/emacs
parent185ae1f1d01b224ae638ea0d83070065bf091e69 (diff)
downloademacs-06a97d46c40453352292d28589ffbf2631819fa0.tar.gz
(Init File): Byte-compiling .emacs is bad.
Diffstat (limited to 'doc/emacs')
-rw-r--r--doc/emacs/ChangeLog4
-rw-r--r--doc/emacs/custom.texi12
2 files changed, 12 insertions, 4 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 141ec6b97e8..a94c43e1af8 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2008-04-05 Glenn Morris <rgm@gnu.org>
+
+ * custom.texi (Init File): Byte-compiling .emacs is bad.
+
2008-04-04 Stefan Monnier <monnier@iro.umontreal.ca>
* mini.texi (Minibuffer Edit) <resize-mini-windows>: Adjust default.
diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi
index 6660b5e66ff..efc6614abe2 100644
--- a/doc/emacs/custom.texi
+++ b/doc/emacs/custom.texi
@@ -2085,10 +2085,14 @@ 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
-should rename it to @file{~/.emacs.el}, and byte-compile it. @xref{Byte
-Compilation,, Byte Compilation, elisp, the Emacs Lisp Reference Manual},
-for more information about compiling Emacs Lisp programs.
+ Byte-compiling your @file{.emacs} is not recommended (@pxref{Byte
+Compilation,, Byte Compilation, elisp, the Emacs Lisp Reference
+Manual}). It generally does not speed up startup very much, and often
+leads to problems when you forget to recompile the file. A better
+solution is to use the Emacs server to reduce the number of times you
+have to start Emacs (@pxref{Emacs Server}). If your @file{.emacs}
+defines many functions, consider moving them to a separate
+(byte-compiled) file which you load in your @file{.emacs}.
If you are going to write actual Emacs Lisp programs that go beyond
minor customization, you should read the @cite{Emacs Lisp Reference Manual}.