Difference between revisions of "User's Initialization File"

From WikEmacs
Jump to: navigation, search
m (Reverted edits by 31.41.216.134 (talk) to last revision by Holocronweaver)
 
(6 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]]
 +
* [[Emacs Starter Kit]]
  
 
== 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]]

Latest revision as of 20:34, 30 January 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[edit]

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

Debugging the Init file[edit]

$ emacs --debug-init

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

See Also[edit]

External links[edit]