Difference between revisions of "User's Initialization File"
Jump to navigation
Jump to search
(7 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
'''User's Initialization File ''' or '''dotemacs''' or '''init file''' is a file to store your configurations/customizations for Emacs written | '''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]]. | 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 == | == Configuration Example == | ||
− | == Debugging Init file == | + | 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 == | == See Also == | ||
+ | |||
+ | * [[Prelude]], a much more powerful and productive set of initial configuration than the one you get out of the box. | ||
+ | * [[Emacs Starter Kit]] | ||
+ | * [[package.el]], the built-in package manager in Emacs 24. | ||
== External links == | == 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:Customization]] | ||
[[Category:Key Concepts]] | [[Category:Key Concepts]] | ||
[[Category:Debug]] | [[Category:Debug]] |
Revision as of 13:44, 29 August 2014
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
- Prelude, a much more powerful and productive set of initial configuration than the one you get out of the box.
- Emacs Starter Kit
- package.el, the built-in package manager in Emacs 24.
External links
- The Init File (`(info "(emacs) The Init File")')
- How Large is Your .emacs?