Mercurial > emacs
changeset 66305:3fcb7f692502
(Building Emacs): Document eval-at-startup.
| author | Richard M. Stallman <rms@gnu.org> |
|---|---|
| date | Sat, 22 Oct 2005 15:15:56 +0000 |
| parents | f754be327a7e |
| children | 138f9b1d6682 |
| files | lispref/internals.texi |
| diffstat | 1 files changed, 12 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- a/lispref/internals.texi Sat Oct 22 15:01:08 2005 +0000 +++ b/lispref/internals.texi Sat Oct 22 15:15:56 2005 +0000 @@ -117,6 +117,18 @@ normal features for your site, do it with @file{default.el}, so that users can override your changes if they wish. @xref{Startup Summary}. + In a package that can be preloaded, it is sometimes useful to +specify a computation to be done when Emacs subsequently starts up. +For this, use @code{eval-at-startup}: + +@defmacro eval-at-startup body@dots{} +This evaluates the @var{body} forms, either immediately if running in +an Emacs that has already started up, or later when Emacs does start +up. Since the value of the @var{body} forms is not necessarily +available when the @code{eval-at-startup} form is run, that form +always returns @code{nil}. +@end defmacro + @defun dump-emacs to-file from-file @cindex unexec This function dumps the current state of Emacs into an executable file