Difference between revisions of "User's Initialization File"

From WikEmacs
Jump to: navigation, search
m
(Configuration Example)
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
A file to store your configurations/customizations for Emacs written in [[Emacs Lisp]], located at either {{File|${HOME}/.emacs.d/init.el}} or (archaically) at {{File|${HOME}/.emacs}} or at {{File|%HOME%\_emacs}} on [[Windows]].
+
'''User's Initialization File ''' or '''dotemacs''' or '''init file''' is a file to store your configurations/customizations for Emacs written
 +
in [[Emacs Lisp]], located at either {{Filename|${HOME}/.emacs.d/init.el}} or (archaically) at {{Filename|${HOME}/.emacs}} or at {{Filename|%HOME%\_emacs}} on [[Windows| MS Windows]].
 +
 
 +
The most reliable way to find our the place of the initialization file on your system is to check the value of the '''user-init-file''' variable.
 +
 
 +
== Configuration Example ==
 +
 
 +
For a good example of an init file check out some of the starter kits, like [[Prelude]].
 +
 
 +
== Debugging the Init file ==
 +
 
 +
<syntaxhighlight lang="bash">
 +
$ emacs --debug-init
 +
</syntaxhighlight>
 +
 
 +
Running the above command will enable the Emacs Lisp debugger for errors in the init file.
 +
 
 +
== See Also ==
 +
 
 +
* [[Prelude]]
 +
* [[Emacs Starter Kit]]
 +
 
 +
== External links ==
 +
 
 +
* {{Manual|emacs|Init-File|The Init File}}
 +
* [http://ola-bini.blogspot.com/2008/05/how-large-is-your-emacs.html How Large is Your .emacs?]
 +
 
 +
[[Category:Customization]]
 +
[[Category:Key Concepts]]
 +
[[Category:Debug]]

Revision as of 06:17, 11 May 2012

User's Initialization File or dotemacs or init file is a file to store your configurations/customizations for Emacs written in Emacs Lisp, located at either ${HOME}/.emacs.d/init.el or (archaically) at ${HOME}/.emacs or at %HOME%\_emacs on MS Windows.

The most reliable way to find our the place of the initialization file on your system is to check the value of the user-init-file variable.

Configuration Example

For a good example of an init file check out some of the starter kits, like Prelude.

Debugging the Init file

$ emacs --debug-init

Running the above command will enable the Emacs Lisp debugger for errors in the init file.

See Also

External links