Mercurial > emacs

comparison man/custom.texi @ 66544:142b6109f5b7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Document ~/.emacs.d/init.el
author Chong Yidong <cyd@stupidchicken.com>
date Sun, 30 Oct 2005 03:56:16 +0000
parents 72170abe8953
children 79c2827d1a52
comparison
equal deleted inserted replaced
66543:673d94c09ed4 66544:142b6109f5b7
1981 @cindex key rebinding, permanent 1981 @cindex key rebinding, permanent
1982 @cindex rebinding keys, permanently 1982 @cindex rebinding keys, permanently
1983 @cindex startup (init file) 1983 @cindex startup (init file)
1984 1984
1985 When Emacs is started, it normally loads a Lisp program from the 1985 When Emacs is started, it normally loads a Lisp program from the
1986 file @file{.emacs} or @file{.emacs.el} in your home directory. (You 1986 file @file{.emacs} or @file{.emacs.el} in your home directory. We
1987 can also put it in a subdirectory @file{~/.emacs.d} and Emacs will 1987 call this file your @dfn{init file} because it specifies how to
1988 still find it.) We call this file your @dfn{init file} because it 1988 initialize Emacs for you. You can use the command line switch
1989 specifies how to initialize Emacs for you. You can use the command 1989 @samp{-q} to prevent loading your init file, and @samp{-u} (or
1990 line switch @samp{-q} to prevent loading your init file, and @samp{-u} 1990 @samp{--user}) to specify a different user's init file (@pxref{Initial
1991 (or @samp{--user}) to specify a different user's init file 1991 Options}).
1992 (@pxref{Initial Options}). 1992
1993 You can also use @file{~/.emacs.d/init.el} as the init file. Emacs
1994 tries this if it cannot find @file{~/.emacs} or @file{~/.emacs.el}.
1993 1995
1994 @cindex @file{default.el}, the default init file 1996 @cindex @file{default.el}, the default init file
1995 There can also be a @dfn{default init file}, which is the library 1997 There can also be a @dfn{default init file}, which is the library
1996 named @file{default.el}, found via the standard search path for 1998 named @file{default.el}, found via the standard search path for
1997 libraries. The Emacs distribution contains no such library; your site 1999 libraries. The Emacs distribution contains no such library; your site