| Both sides previous revisionPrevious revision | |
| doc:emacs-config [2015/04/27 19:07] – gkazhoya | doc:emacs-config [2015/04/27 19:10] (current) – gkazhoya |
|---|
| The main part of configuring your IDE is done through the Emacs init file. | The main part of configuring your IDE is done through the Emacs init file. |
| |
| According to the GNU Emacs Manual, "Emacs looks for your init file using the filenames ''~/.emacs'', ''~/.emacs.el'', or ''~/.emacs.d/init.el''". The last one is the recommended alternative because for that one creates a directory for Emacs in the user home and all the Emacs extensions are then also put into that directory. A sample of the ''~/.emacs.d'' directory can be found on [[https://github.com/gaya-/configs/tree/master/.emacs.d|GitHub]]. If you set up your Emacs initialization properly you will be able to start the Lisp environment from inside your Emacs. | According to the GNU Emacs Manual, "Emacs looks for your init file using the filenames ''~/.emacs'', ''~/.emacs.el'', or ''~/.emacs.d/init.el''". The last one is the recommended alternative: you create a directory for Emacs in the user home (called ''.emacs.d'') and all the Emacs extensions are then put into that directory. A sample of the ''~/.emacs.d'' directory can be found on [[https://github.com/gaya-/configs/tree/master/.emacs.d|GitHub]]. If you set up your Emacs initialization properly you will be able to start the Lisp environment from inside your Emacs. |
| |
| Alternatively, you can specify the filename of the init file you'd like Emacs to use as a command line argument in your bash. That is exactly what the ''roslisp_repl'' script is doing: it start Emacs with an alternative initialization file. So, if you prefer starting your Lisp environment using ''roslisp_repl'', the configuration file you should edit is ''/opt/ros/your-distro/share/roslisp_repl/repl-config.el''. | Alternatively, you can specify the path to the init file you'd like Emacs to use as a command line argument in your bash each time you start Emacs. That is exactly what the ''roslisp_repl'' script is doing: it start Emacs with an alternative initialization file. So, if you prefer starting your Lisp environment using ''roslisp_repl'', the configuration file you should edit is ''/opt/ros/your-distro/share/roslisp_repl/repl-config.el''. |
| |
| At the bottom of this doc is an excerpt from the ''.emacs.d/init.el'' file for Emacs version 24 with some of the settings explained. | At the bottom of this doc is an excerpt from the ''.emacs.d/init.el'' file for Emacs version 24 with some of the settings explained. |
| The simple settings are already provided with comments and won't be explained further, just try them out. | The simple settings are already provided with comments and won't be explained further, just try them out. |
| For more documentation and to know what possible values of variables are use ''Ctrl-h v'' to describe en Emacs Lisp variable and ''Ctrl-h f'' for functions respectively. | For more documentation and to know what are possible values of variables use ''Ctrl-h v'' to describe en Emacs Lisp variable and ''Ctrl-h f'' for functions respectively. |
| |
| If the configuration file will give errors you will see an error buffer on Emacs startup. Most usual causes of errors are missing extension source files and incompatibilities between different Emacs versions. For each ''require'' statement you should make sure that the extension code is somewhere on your file system and Emacs can find it: | If the configuration file will give errors you will see an error buffer on Emacs startup. Most usual causes of errors are missing extension source files and incompatibilities between different Emacs versions. For each ''require'' statement you should make sure that the extension code is somewhere on your file system and Emacs can find it: |
