[ { "path": "README.org", "content": "#+TITLE: Emacs for developers\n#+AUTHOR: Pierre Lecocq\n#+DESCRIPTION: Learn using Emacs as a developer\n#+KEYWORDS: emacs, developer\n#+STARTUP: showall\n\n* Emacs for developers\n\nThis document will (hopefully) help you to use Emacs as a developer.\n\n**** Disclaimer\n\n- Work in progress, so stay tuned.\n- Exports are handled by the author for the moment and do not reflect the very last changes (but are recent anyway). A scripted solution will be provided soon for contributors.\n\n**** Contributions or requests\n\nDo not hesitate to send a pull request or open an issue to fix, add, discuss, ... etc.\n\n** Who is the target of this tutorial\n\nWell, this is a good question. And I won't give an answer but some elements of answer.\n\nWhat is sure is that it is not written for the people thanked below (Bastien, Dimitri, Sacha, Nic, Avdi, and so on ...), but what is interseting with Emacs is that even if you are a beginner, an intermediate / advanced user or an every day power user, you can learn from others each time you open a web page or a manual dealing with Emacs.\n\nTherefore, this tutorial is written for people who want to improve their experience. Simple as that. Whatever is their knowledge, their feeling, their usage, their config file size (without any pun), etc ...\n\nRemember one thing: Emacs is 30+ years old and brings new users everyday. It is a clue that this is a piece of software that deserve some attention.\n\n* Table of contents\n\n- 1. [[./chapters/01-introduction.org][Introduction]]\n - 1.1 [[./chapters/01-introduction.org#brief-history][Brief history]]\n - 1.2 [[./chapters/01-introduction.org#how-to-get-emacs][How to get Emacs?]]\n - 1.3 [[./chapters/01-introduction.org#more-than-an-editor][More than an editor]]\n - 1.4 [[./chapters/01-introduction.org#the-perfect-development-tool][The perfect development tool]]\n- 2. [[./chapters/02-the-basics.org][The basics]]\n - 2.1 [[./chapters/02-the-basics.org#config-files][Config files]]\n - 2.2 [[./chapters/02-the-basics.org#executing-commands][Executing commands]]\n - 2.3 [[./chapters/02-the-basics.org#key-bindings][Key bindings]]\n - 2.3.1 [[./chapters/02-the-basics.org#manipulate-files][Manipulate files]]\n - 2.3.2 [[./chapters/02-the-basics.org#manipulate-the-current-line][Manipulate the current line]]\n - 2.3.3 [[./chapters/02-the-basics.org#selecting-a-region][Selecting a region]]\n - 2.3.4 [[./chapters/02-the-basics.org#commenting][Commenting]]\n - 2.3.5 [[./chapters/02-the-basics.org#windows][Windows]]\n - 2.3.6 [[./chapters/02-the-basics.org#buffers][Buffers]]\n - 2.3.7 [[./chapters/02-the-basics.org#cancel-a-command][Cancel a command]]\n - 2.3.8 [[./chapters/02-the-basics.org#the-most-useless-command][The most useless command]]\n - 2.4 [[./chapters/02-the-basics.org#help][Help!]]\n- 3. [[./chapters/03-building-your-own-editor.org][Building your own editor]]\n - 3.1 [[./chapters/03-building-your-own-editor.org#first-basic-configuration][First basic configuration]]\n - 3.2 [[./chapters/03-building-your-own-editor.org#general-basic-configuration][General basic configuration]]\n - 3.3 [[./chapters/03-building-your-own-editor.org#backup-files][Backup files]]\n - 3.4 [[./chapters/03-building-your-own-editor.org#setting-up-the-locales][Setting up the locales]]\n - 3.5 [[./chapters/03-building-your-own-editor.org#more-configuration][More configuration]]\n - 3.6 [[./chapters/03-building-your-own-editor.org#modes][Modes]]\n - 3.7 [[./chapters/03-building-your-own-editor.org#package-managers][Package managers]]\n - 3.8 [[./chapters/03-building-your-own-editor.org#some-useful-packages][Some useful packages]]\n - 3.9 [[./chapters/03-building-your-own-editor.org#code-navigation][Code navigation]]\n - 3.10 [[./chapters/03-building-your-own-editor.org#setting-a-color-theme][Setting a color theme]]\n- 4. [[./chapters/04-emacs-developing-environments.org][Emacs developing environments]]\n - 4.1 [[./chapters/04-emacs-developing-environments.org#emacs-for-ruby-developers][Emacs for Ruby developers]]\n - 4.2 [[./chapters/04-emacs-developing-environments.org#emacs-for-python-developers][Emacs for Python developers]]\n - 4.3 [[./chapters/04-emacs-developing-environments.org#emacs-for-ccobjective-c][Emacs for C/C++/Objective-C developers]]\n - 4.4 [[./chapters/04-emacs-developing-environments.org#emacs-for-go-developers][Emacs for Go developers]]\n - 4.5 [[./chapters/04-emacs-developing-environments.org#emacs-for-php-developers][Emacs for PHP developers]]\n - 4.6 [[./chapters/04-emacs-developing-environments.org#emacs-for-java-developers][Emacs for Java developers]]\n - 4.7 [[./chapters/04-emacs-developing-environments.org#emacs-for-r-and-statistics][Emacs for R and statistics]]\n- 5. [[./chapters/05-special-features.org][Special features]]\n - 5.1 [[./chapters/05-special-features.org#emacs-as-a-file-manager][Emacs as a file manager]]\n - 5.2 [[./chapters/05-special-features.org#working-locally-vs-remotely][Working locally vs remotely]]\n - 5.3 [[./chapters/05-special-features.org#organize-your-work-write-papers-and-manage-your-agenda][Organize your work, write papers and manage your agenda]]\n - 5.4 [[./chapters/05-special-features.org#emails-in-emacs][Emails in Emacs]]\n - 5.5 [[./chapters/05-special-features.org#some-great-emacs-tips-and-tricks][Some great Emacs tips and tricks]]\n - 5.6 [[./chapters/05-special-features.org#coming-from-other-editors-ie-vim][Coming from other editors (i.e Vim or SublimeText)]]\n- 6. [[./chapters/06-readings-and-resources.org][Readings and resources]]\n\n* The demo\n\nHere is a video that covers the basics of this tutorial.\nIt is a simple, annoted but efficient demo of a session in Emacs.\n\n[[https://github.com/pierre-lecocq/emacs4developers/tree/master/demo][Here is the links, the sources and the dedicated config file!]]\n\n* The Gnus case\n\nIf you need a detailed and explained Gnus (an Emacs mail reader) configuration example, please refer to [[http://qsdfgh.com/articles/gnus-configuration-example.html][this dedicated article]]\n\n* Exports\n\nThis document is also available in [[./exports/emacs4developers.org][a single ORG file]], [[./exports/emacs4developers.pdf][PDF]], [[./exports/emacs4developers.odt][ODT]] and [[./exports/emacs4developers.html][HTML]].\n\n* License\n\nThe content of this project itself is licensed under the [[http://creativecommons.org/licenses/by/3.0/us/deed.en_US][Creative Commons Attribution 3.0 license]], and the underlying source code used to format and display that content is licensed under the [[http://opensource.org/licenses/mit-license.php][MIT license]].\n\nContributors list can be found [[https://github.com/pierre-lecocq/emacs4developers/network/members][here]].\n\n* Thanks\n\nI want to thank some of the great people who make Emacs a very intersting piece of software or make its community very active (the sort order is absolutely not important here):\n\nBastien Guerry ([[https://twitter.com/bzg2][@bzg2]]), Dimitri Fontaine ([[https://twitter.com/tapoueh][@tapoueh]]), Julien Danjou ([[https://twitter.com/juldanjou][@juldanjou]]), Sacha Chua ([[https://twitter.com/sachac][@sachac]]), Steve Purcell ([[https://twitter.com/sanityinc][@sanityinc]]), Nic Ferrier ([[https://twitter.com/nicferrier][@nicferrier]]), Avdi Grimm ([[https://twitter.com/avdi][@avdi]]), Magnars ([[https://twitter.com/magnars][@magnars]]), Steve Yegge ([[https://twitter.com/Steve_Yegge][@Steve_Yegge]]), Bozhidar Batsov ([[https://twitter.com/bbatsov][@bbatsov]]), Xah Lee ([[https://twitter.com/xah_lee][@xah_lee]]), and many more ...\n\nYou should check those people and their work over the web, twitter, youtube, ...\n\nAnd thank you for reading this !\n" }, { "path": "chapters/01-introduction.org", "content": "#+TITLE: Emacs for developers - Introduction\n#+AUTHOR: Pierre Lecocq\n#+DESCRIPTION: Learn using Emacs as a developer\n#+KEYWORDS: emacs, developer\n#+STARTUP: showall\n\n* Emacs for developers - Introduction\n\n** Brief history\n\n- Originally developed by Richard Stallman and Guy Steele in MIT AI lab\n- First release in 1976\n- Inspired by TECO editor\n- Based on macros (Emacs stands for Editor MACroS)\n- Written in C and Emacs Lisp\n- Part of the GNU project (therefore, we /should/ say \"GNU Emacs\", not \"Emacs\")\n\n- Despite its age, new users are still adopting Emacs as their development platform to this day!\n\n** How to get Emacs?\n\nOn every Linux distribution, packages are available.\nSo run your favorite package manager to install it:\n\n- /apt-get install emacs/\n- /yum install emacs/\n- ...\n\nAnd if you have an exotic operating system, here are the specific distributions:\n\n- Mac OS X: http://emacsformacosx.com/ (or with homebrew: /brew install emacs/)\n- Windows: http://ftp.igh.cnrs.fr/pub/gnu/emacs/windows/\n\nFor Max OS X, the Yamamoto Mitsuharu port has some nice features an can be found via this [[https://github.com/railwaycat/emacs-mac-port][github mirror]].\n\nBut, in order to get the latest version, it's _highly recommended_ that you compile Emacs yourself: http://ftp.igh.cnrs.fr/pub/gnu/emacs/\n\n\n** More than an editor\n\n- More than an editor, it is a Lisp interpreter\n- Can run any type of program written in Lisp:\n - Email clients (like [[http://www.gnus.org/][Gnus]] or [[http://www.emacswiki.org/emacs/mu4e][mu4e]])\n - Shell (like bash or eshell)\n - File and directory management (with [[http://www.gnu.org/software/emacs/manual/html_node/emacs/Dired.html][Dired mode]])\n - Agenda / Notes / TODO list / Project management (with the amazing [[http://orgmode.org][OrgMode]])\n - IRC / Twitter / Jabber / ... clients\n - Games (like Tetris, Pong, Snake, 5x5, Dunnet, ...)\n - Encrypt/decrypt files (like GPG files)\n - On-the-fly archives editing (thanks to [[http://www.emacswiki.org/emacs/ArchiveMode][archive-mode]])\n - PDF / Image / (...) viewer\n - A powerful front end to R / S+ / SPSS / Stata (with [[http://ess.r-project.org/][EmacsSpeaksStatisics)]]\n - An editor for multi-modal REPL's like IPython (with [[http://tkf.github.io/emacs-ipython-notebook/][EmacsIPythonNotebook]])\n - Music player (with emms, vlc, mplayer, ...)\n - Music programming (with [[http://vimeo.com/22798433][Overtone]])\n - Video editing\n - And so on ...\n - (and of course a document editor that can automatically generate this presentation)\n\nIt goes without saying that you can do all of this at the same time with only one Emacs instance.\n\n** The perfect development tool\n\n- As Emacs is a Lisp interpreter, it is extensible. Really, really extensible.\n- The (unofficial) goal of Emacs is to be hacked\n- Therefore, your goal is to hack Emacs to make it work exactly as you want\n\n- Already provides so many development tools (also extensible, of course)\n - Debuggers\n - Compilers\n - Syntax checkers\n - Documentations\n - Consoles\n - ...\n\n- Also provides /modes/ (extensions) for *every* programming language for\n - Syntax highlighting\n - Documentation search\n - Indentation\n - Source code browsing\n - Compilation commands\n - Specific behaviour\n - ...\n" }, { "path": "chapters/02-the-basics.org", "content": "#+TITLE: Emacs for developers - The basics\n#+AUTHOR: Pierre Lecocq\n#+DESCRIPTION: Learn using Emacs as a developer\n#+KEYWORDS: emacs, developer\n#+STARTUP: showall\n\n* Emacs for developers - The basics\n\n** Config files\n\nIn order to customize Emacs, you will have to edit its configuration files.\nWhen you install the software, the configuration file does not exist (or is empty) and does nothing until you decide to tweak Emacs.\nSome people use Emacs for decades without any extra configuration because they like it out of the box.\n\nThere are several ways to manage your Emacs configuration:\n\n- Simply create and edit a *~/.emacs* file\n- Create a *~/.emacs.d/* directory with a *~/.emacs.d/init.el* file\n\nThe first solution is great if you have a small, clean and exportable configuration file.\n\nThe second solution is great if you need several configuration files (keep your configuration parts separated) or you need to install external extensions (you will install them in *~/.emacs.d* to keep them centralized and exportable).\n\n** Executing commands\n\nThe main idea of Emacs is that everything is a command. For example: opening a file with a keybinding calls a command that is executed by the Emacs' core.\nAnd all the commands are written in Lisp.\n\nTo call a command, you simply have to press *Escape* and then *x*. It could be *Alt-x* for more comfort.\nThe official name is \"/Meta x/\" and is written /M-x/\n\nIf you type this key sequence, you will see at the bottom of the editor a little prompt.\nThis part of Emacs is called the /mini buffer/ and is used for every interactive actions.\n\nLet's try something:\n\n- type *M-x*\n- Then, in the minibuffer, type *version* and *RET* (return)\n\nEmacs should display the current version number of the software.\n\n#+CAPTION: Execute the version command\n[[../images/version.gif]]\n\nCongratulations! You just called your first Emacs command.\n\n** Key bindings\n\nHere are the most useful keys in Emacs. You will use them several hundreds (or thousands) of times a day.\n\nHow does it work?\n\n- The sequence /C-something/ means that you have to press and hold the /Control/ key while pressing the /something/ key. Example: /C-a/ means /Control + a/.\n- The sequence /C-something somethingelse/ means that you press /Control + something/, then you release Control to press /somethingelse/.\n- The sequence /C-something C-somethingelse/ means that you have to press Control while pressing /something/, then releasing /something/ and pressing /somethingelse/.\n\n*** Manipulate files\n\n- *C-x C-f*: open a file, which corresponds to *M-x find-file*\n- *C-x C-s*: save a file, which corresponds to *M-x save-buffer*\n\n#+CAPTION: Open a file, modify it and save it\n[[../images/open-and-save.gif]]\n\n*** Manipulate the current line\n\n- *C-a*: go to the beginning of the current line, which corresponds to *M-x begining-of-line*\n- *C-e*: go to the end of the current line, which corresponds to *M-x end-of-line*\n- *C-k*: cut the rest of the line at the cursor position, which corresponds to *M-x kill-line*\n- *C-y*: paste what you had cut with the command above, which corresponds to *M-x yank*\n- *C-l*: center the buffer at the cursor position, which corresponds to *M-x recenter-top-bottom*\n\n#+CAPTION: Line manipulation\n[[../images/line.gif]]\n\n*** Selecting a region\n\nRegions are selections, in Emacs.\n\nThey are composed by two points. A starting one and and an ending one.\n\nTo select the starting point, move your cursor to the wanted location and simply press *C-Space*. In your minibuffer, you should have seen a message like \"Mark set\".\nNow, move your cursor to the location you wantyour selection to end.\n\nYou have now a selection (or a /region/) delimited by the place you set the first mark and your cursor. With this region, you can do what ever you want:\n\n- Copy (*M-w*)\n- Cut (*C-k*)\n- Paste (*C-y*)\n- Replace (*M-%*)\n- ... etc\n\n#+CAPTION: Selecting a region\n[[../images/selecting.gif]]\n\n*** Commenting\n\nIn order to comment a code block, select the region you want to comment and use:\n\n- *M-x comment-region* in order to comment the block\n- *M-x uncomment-region* in order to uncomment the block\n\nOf course, Emacs knows, according to the major mode loaded how to comment properly your code. If the major-mode is /ruby-mode/, it will add a \"#\" before the line; if the major-mode is /lisp-mode/, it will add \";;\", and so on and so forth.\n\n#+CAPTION: Commenting\n[[../images/comment.gif]]\n\n*** Windows\n\nThis might be confusing but a /window/ is a part of a /frame/.\n\nAn /Emacs frame/ is the window that you opened when you launched Emacs.\n\nAn /Emacs frame/ can be divided into /windows/ in itself.\n\n- *C-x 2*: open a new window horizontally, which corresponds to *M-x split-window-below*\n- *C-x 3*: open a new window vertically, which corresponds to *M-x split-window-right*\n- *C-x o*: switch to the next window, which corresponds to *M-x other-window*\n- *C-x 0*: close the current window, which corresponds to *M-x delete-window*\n- *C-x 1*: close all the windows but the one focused, which correspond to *M-x delete-other-windows*\n\n#+CAPTION: Windows manipulation\n[[../images/windows.gif]]\n\n*** Buffers\n\nA /buffer/ is displayed in a /frame/.\n\n- *C-x b*: switch to an already opened buffer, which corresponds to *M-x switch-to-buffer*\n- *C-x C-b*: list opened buffer (and jump to the selected one), which corresponds to *M-x list-buffers*\n- *C-x k*: kill a buffer, which corresponds to *M-x kill-buffer*\n\nOn most read-only buffers, press *q* to close it.\n\n#+CAPTION: Buffer navigation\n[[../images/buffers.gif]]\n\n*** Cancel a command\n\n- *C-g* or *ESC ESC ESC*: cancel the current command running in the minibuffer, which corresponds to *M-x keyboard-quit*\n\nIt also cancels all previously pressed keys.\n\n*** The most useless command\n\n- *C-x C-c*: quit emacs (use at your own risks!), which corresponds to *M-x save-buffers-kill-terminal*\n\n** Help!\n\nEmacs has a powerful built-in help system for key bindings and internal functionalities.\n\n- *C-h f *: Find the key binding corresponding to (ex: C-h f save-buffer)\n- *C-h k *: Find the function name corresponding to (ex: C-h k C-x C-s)\n- *C-h v var*: Display the documentation of the Lisp variable var (describe-variable) (ex: C-h v emacs-version)\n- * C-h*: Show the next possible keys to press after the (ex: C-x 4 C-h)\n\nFor more detail about Emacs help system, see: https://www.gnu.org/software/emacs/manual/html_node/emacs/Help-Summary.html\n\nWhen executing these commands, a new frame opens. To close it, switch to it (/C-x o/) and type /q/. If not, simply close it (/C-x 0/)\n\nAfter executing a command with M-x, if the command have a corresponding keybinding bound to it, a message indicating what to press will appear in the minibuffer.\n\nEmacs also includes the full manual (also available online: http://www.gnu.org/software/emacs/manual/html_node/emacs/)\n\n- *C-h r*: browse the Emacs manual within Emacs\n\nFinally, there are so many other help functions: http://www.emacswiki.org/emacs/EmacsNewbieHelpReference\n" }, { "path": "chapters/03-building-your-own-editor.org", "content": "#+TITLE: Emacs for developers - Building your own editor\n#+AUTHOR: Pierre Lecocq\n#+DESCRIPTION: Learn using Emacs as a developer\n#+KEYWORDS: emacs, developer\n#+STARTUP: showall\n\n* Emacs for developers - Building your own editor\n\nFrom this moment on, we will edit the configuration file.\nFor now, we will put everything in a single *~/.emacs.d/init.el* file. Create it if it does not exist.\n\n#+BEGIN_SRC sh\n# Backup old configuration\ncp .emacs dot-emacs.old\ncp -R .emacs.d dot-emacs.d.old\n\n# Create new and empty configuration\nmkdir ~/.emacs.d\ntouch ~/.emacs.d/init.el\n#+END_SRC\n\n** First basic configuration\n\nWhen you will have to change or add configuration, simply edit your *~/.emacs.d/init.el* file and add what you need.\n\nFor example, here is a tweak that does nothing visually but is useful for other packages and the Emacs engine itself.\nIt allows you to define your name and email. Emacs can use it to add author information to a file when asked.\n\n#+BEGIN_SRC lisp\n(setq user-full-name \"Your full name\")\n(setq user-mail-address \"your@email.com\")\n#+END_SRC\n\nAfter each configuration modification, two solutions:\n\n- the soft & clever way: execute *M-x eval-buffer*\n- the hard way: restart Emacs.\n\n** General basic configuration\n\nNow, let's move on to a basic set of more visual basic configurations.\nAs you did earlier, simply add this to your configuration file:\n\n#+BEGIN_SRC lisp\n;; Ask \"y\" or \"n\" instead of \"yes\" or \"no\". Yes, laziness is great.\n(fset 'yes-or-no-p 'y-or-n-p)\n\n;; Highlight corresponding parentheses when cursor is on one\n(show-paren-mode t)\n\n;; Highlight tabulations\n(setq-default highlight-tabs t)\n\n;; Show trailing white spaces\n(setq-default show-trailing-whitespace t)\n\n;; Remove useless whitespace before saving a file\n(add-hook 'before-save-hook 'whitespace-cleanup)\n(add-hook 'before-save-hook (lambda() (delete-trailing-whitespace)))\n#+END_SRC\n\n** Backup files\n\nYou may have notice that the files you edit are duplicated and renamed with a /~/ at the end.\nThey are the backup files that Emacs creates for you with the auto-save feature.\nSometimes it is great because you can recover a file in case of error, sometimes it is annoying because you can have so many of these files.\n\nIt is up to you to keep it or disable it.\nHere is the configuration to disable it:\n\n#+BEGIN_SRC lisp\n;; Remove all backup files\n(setq make-backup-files nil)\n(setq backup-inhibited t)\n(setq auto-save-default nil)\n#+END_SRC\n\nAn alternative method is to save these backups in a centralized directory:\n\n#+BEGIN_SRC lisp\n;; Save backup files in a dedicated directory\n(setq backup-directory-alist '((\".\" . \"~/.saves\")))\n#+END_SRC\n\n** Setting up the locales\n\nYou may want to set up a specific locale for your files.\nThis will do the trick:\n\n#+BEGIN_SRC lisp\n;; Set locale to UTF8\n(set-language-environment 'utf-8)\n(set-terminal-coding-system 'utf-8)\n(setq locale-coding-system 'utf-8)\n(set-default-coding-systems 'utf-8)\n(set-selection-coding-system 'utf-8)\n(prefer-coding-system 'utf-8)\n#+END_SRC\n\n** More configuration\n\nThe best way to improve your configuration is to read the [[http://www.gnu.org/software/emacs/manual/][manual]] ...\nBut you can also (this is the unofficial method) read others Emacs users' config files.\nThere are so many people who share their configuration, comment their code, and distribute their modes!\n\nHere is mine: (https://github.com/pierre-lecocq/emacs.d)\n\nIf you are a heavy VIM user, you can bring you VIM experience to Emacs by using [[https://github.com/syl20bnr/spacemacs][Spacemacs]]. You can also\nfind [[https://github.com/emacs-tw/awesome-emacs#starter-kit][Starter Kit]] to start with Emacs.\n\n** Modes\n\n/Modes/ are Emacs /extensions/ that can be installed to extend the capabilities of Emacs. They will allow you to build a powerful tailored editor.\n\nThere are 2 kinds of modes: major and minor.\n\n*** Major modes\n\nMajor modes are modes that transform Emacs to a specialized software for editing a certain type of files (i.e c-mode) or managing special tasks (i.e reading emails, managing git repository, ...)\n\nOnly one major mode can be used at a time.\n\n*** Minor modes\n\nMinor modes are additional modes that are added transparently to the major mode. They add features and behavior (i.e parentheses matching, syntax or spelling checkers, ...)\n\nSeveral minor modes can be used at any given time.\n\n** Package managers\n\nEmacs has brilliant package managers such as /package.el/ or /el-get/ that allows you to add and update modes really easily.\n\n*** Package.el\n\n/package.el/ is the built in package manager shipped by default with Emacs 24 or later.\n\nTo list available packages, simply type this command:\n\n#+BEGIN_SRC lisp\nM-x package-list-packages\n#+END_SRC\n\nYou will see a list of packages. Simply press ENTER on the name of one of them to install it.\n\nAdditionally, you can manage the packages list by adding other sources to your configuration file:\n\n#+BEGIN_SRC lisp\n;; Add package sources\n(setq package-archives '((\"gnu\" . \"http://elpa.gnu.org/packages/\")\n (\"marmalade\" . \"http://marmalade-repo.org/packages/\")\n (\"melpa\" . \"http://melpa.org/packages/\")))\n#+END_SRC\n\n*** El-Get\n\n/[[https://github.com/dimitri/el-get][el-get]]/ is one of the most popular and easy-to-use package managers. It's the \"/apt-get/\" of Emacs.\nIt is written by the great [[https://github.com/dimitri][Dimitri Fontaine]] and is based on recipe files that simply describe where the package is located and how to get/compile/install it for you.\n\nTo use it, simply add this to your configuration file. It will download and set up /el-get/ for you:\n\n#+BEGIN_SRC lisp\n;; Set up el-get\n(add-to-list 'load-path \"~/.emacs.d/el-get/el-get\")\n(unless (require 'el-get nil 'noerror)\n (with-current-buffer\n (url-retrieve-synchronously\n \"https://raw.github.com/dimitri/el-get/master/el-get-install.el\")\n (let (el-get-master-branch)\n (goto-char (point-max))\n (eval-print-last-sexp))))\n#+END_SRC\n\n*** The generic method\n\nIn order to leave you the choice of the package manager you want to use, here is a function that handles several package managers. For now, it covers /package.el/ and /el-get/.\n\nIt also allows you to automatically install packages you want.\n\nIn the following snippet, two sample packages are installed\n\n- /color-theme/ in order to allow us to change colors themes\n- /autopair/ in order to close automatically parentheses, brackets and braces when you open it\n\nSimply add this code to your configuration file:\n\n#+BEGIN_SRC lisp\n;; Set up the package manager of choice. Supports \"el-get\" and \"package.el\"\n(setq pmoc \"el-get\")\n\n;; List of all wanted packages\n(setq\n wanted-packages\n '(\n color-theme\n autopair\n))\n\n;; Package manager and packages handler\n(defun install-wanted-packages ()\n \"Install wanted packages according to a specific package manager\"\n (interactive)\n (cond\n ;; package.el\n ((string= pmoc \"package.el\")\n (require 'package)\n (add-to-list 'package-archives '(\"gnu\" . \"http://elpa.gnu.org/packages/\"))\n (add-to-list 'package-archives '(\"melpa\" . \"http://melpa.org/packages/\"))\n (add-to-list 'package-archives '(\"marmelade\" . \"http://marmalade-repo.org/packages/\"))\n (package-initialize)\n (let ((need-refresh nil))\n (mapc (lambda (package-name)\n (unless (package-installed-p package-name)\n (set 'need-refresh t))) wanted-packages)\n (if need-refresh\n (package-refresh-contents)))\n (mapc (lambda (package-name)\n (unless (package-installed-p package-name)\n (package-install package-name))) wanted-packages)\n )\n ;; el-get\n ((string= pmoc \"el-get\")\n (add-to-list 'load-path \"~/.emacs.d/el-get/el-get\")\n (unless (require 'el-get nil 'noerror)\n (with-current-buffer\n (url-retrieve-synchronously\n \"https://raw.github.com/dimitri/el-get/master/el-get-install.el\")\n (let (el-get-master-branch)\n (goto-char (point-max))\n (eval-print-last-sexp))))\n (el-get 'sync wanted-packages))\n ;; fallback\n (t (error \"Unsupported package manager\")))\n )\n\n;; Install wanted packages\n(install-wanted-packages)\n#+END_SRC\n\nNote that some of the following package names could vary if you use /package.el/ or /el-get/.\n\n*** The modern and efficient way\n\nSome upper-level packages make package management easier and cleaner.\n\nFor example, John Wiegley's =use-package= software is an elegant and efficient way to install and tidy your external packages configurations.\n\nHere is the way to use it:\n\nFirst, setup packages sources and install =use-package=\n\n#+BEGIN_SRC lisp\n(require 'package)\n(setq package-archives '((\"gnu\" . \"http://elpa.gnu.org/packages/\")\n (\"marmalade\" . \"http://marmalade-repo.org/packages/\")\n (\"melpa\" . \"http://melpa.org/packages/\")))\n(package-initialize)\n\n(unless (package-installed-p 'use-package)\n (progn\n (package-refresh-contents)\n (package-install 'use-package)))\n\n(require 'use-package)\n#+END_SRC\n\nThen, for each package you want to install, simply add this to your configuration (replace /the-package-name/ by any package name):\n\n#+BEGIN_SRC LISP\n(use-package the-package-name\n :ensure the-package-name\n :init (progn\n ;; Do something after the package is initialized\n ))\n#+END_SRC\n\n\n** Some useful packages\n\nAs a developer, you will need some packages that will help you to work, increase your productivity and enhance your comfort while coding.\nPlease note that even if I am a Ruby/shell/Lisp/web/PHP developer, some packages are compatible and useful for every kind of development. Therefore, the base packages are listed here but some specific packages that might be useful for your work may not be listed here. It is up to you to adapt the list according to your needs!\n\nTip: After adding packages, restart Emacs in order to let your package manager download and install it properly.\n\n*** Auto complete\n\nAuto completion is a must-have feature in the development world.\nThis package simply displays a popup at the cursor position with the available completions.\n\nTo install it, add =auto-complete= to your packages list.\n\n[[http://www.emacswiki.org/emacs/AutoComplete][Read more]]\n\n[[../images/mode-autocomplete.gif]]\n\nBUT there is a more \"modern\" mode for auto-completion: /company-mode/. I switched to it in order to try and play with it. It seems very efficient and useful.\n\nTo install it, add =company-mode= to your packages list.\n\n[[http://company-mode.github.io/][Read more about company-mode]]\n\n*** Autopair\n\nWhen you open a quote/parenthese/bracket/curly bracket, this mode automatically adds the closed one and bring your cursor between the two.\nVery useful to avoid syntax errors, for example.\n\nTo install it, add =autopair= to your packages list.\n\n[[https://github.com/capitaomorte/autopair][Read more]]\n\n[[../images/mode-autopair.gif]]\n\n*** Buffer move\n\nThis mode allows you to re-organize and move the buffers from a window to another.\nUseful if you want to switch buffer places in order to have your debugging buffer on the right side, for example.\n\nTo install it, add =buffer-move= to your packages list.\n\n[[http://www.emacswiki.org/cgi-bin/wiki/buffer-move.el][Read more]]\n\n[[../images/mode-buffermove.gif]]\n\n*** Flycheck\n\nThis mode check the syntax of a buffer. It could be used for checking code syntax or typos when writing any kind of text.\n\nTo install it, add =flycheck= to your packages list.\n\n[[http://flycheck.readthedocs.org/en/latest/][Read more]]\n\n*** Highlight symbol\n\nThis mode highlights all symbols that matches a pattern in your buffer\n\nTo install it, add =highlight-symbol= to your packages list.\n\n[[http://www.emacswiki.org/emacs/HighlightSymbol][Read more]]\n\n*** Ido\n\nIdo is a must have mode to navigate, find stuffs, and do things interactively.\nIt is for comfort, but is indispensable to go fast.\n\nMany extensions of this mode are available, therefore read and chose what you want.\n\nI personally use two of them: /vertical/ and /hack/.\n\nTo install it, add =ido-hacks= and =ido-vertical-mode= to your packages list.\n\n[[http://www.emacswiki.org/emacs/InteractivelyDoThings][Read more]]\n\n[[../images/mode-ido.gif]]\n\n*** JS3\n\nThis mode is an enhanced mode for editing Javascript files. I do not use it a lot, but it is useful for some javascript-like or NPM files.\n\nTo install it, add =js3-mode= to your packages list.\n\n[[http://www.emacswiki.org/emacs/Js2Mode][Read more]]\n\n*** Magit\n\nMagit is a very powerful and elegant mode for interacting with your git repository.\nIn order to understand how powerful it is, simply watch this amazing [[http://vimeo.com/2871241][video]].\n\nOnce installed, always keep the [[http://daemianmack.com/magit-cheatsheet.html][magit cheatsheet]] around.\n\nTo install it, add =magit= to your packages list.\n\n*** Git time machine\n\nIn addition to Magit, there is an interesting package that allows you to travel in time accross the different versions of a file stored in Git.\n\nHere is a demo and its repository: [[https://github.com/pidu/git-timemachine][git-timemachine on github]].\n\nTo install it, add =git-timemachine= to your packages list.\n\n[[https://github.com/magit/magit][Read more]]\n\n*** Multiple cursors\n\nThis mode is great and super powerful. Instead of explaining what it is, I'll point you to this amazing [[http://emacsrocks.com/e13.html][video]] by Magnars.\n\nTo install it, add =multiple-cursors= to your packages list.\n\n[[https://github.com/magnars/multiple-cursors.el][Read more]]\n\n*** PHP mode\n\nA basic but stable mode for editing PHP files, whatever you think about PHP ...\n\nTo install it, add =php-mode= to your packages list.\n\n[[http://php-mode.sourceforge.net/][Read more]]\n\n*** Rainbow mode\n\nA toyish but indispensable mode to add colors to your CSS files when using properties like \"color\", \"background-color\".\nIt is great because it understands every way to write a color (hex, name, ...) and gives you a preview of the color itself.\n\nTo install it, add =rainbow-mode= to your packages list.\n\n[[http://julien.danjou.info/projects/emacs-packages][Read more]]\n\n*** RHTML mode\n\nThis mode is useful for editing .rhtml files. You can also use it to edit any kind of ruby templates (i.e .erb).\n\nTo install it, add =rhtml-mode= to your packages list.\n\n[[https://github.com/eschulte/rhtml][Read more]]\n\n*** Ruby mode\n\nDo I really need to explain ?\n\nRuby mode is already installed in Emacs and is very stable.\n\n[[http://www.emacswiki.org/emacs/RubyMode][Read more]]\n\n*** Switch window\n\nThis mode is cool when you work with a lot of windows opened.\nIf you want to switch to another one, you have to press *C-x o* until you reach the wanted window.\nWith this mode, when you press *C-x o*, big numbers replace your opened windows. Simply type the corresponding number to reach the wanted window.\n\nTo install it, add =switch-window= to your packages list.\n\nThen do not forget to override the default configuration by adding this to your configuration:\n\n#+BEGIN_SRC lisp\n(global-set-key (kbd \"C-x o\") 'switch-window)\n#+END_SRC\n\n[[https://github.com/dimitri/switch-window][Read more]]\n\n[[../images/mode-switchwindow.gif]]\n\n*** Visual regexp\n\nThis mode highlights the text that matches the regexp that you are writing in the mini buffer.\n\nTo install it, add =visual-regexp= to your packages list.\n\n[[https://github.com/benma/visual-regexp.el][Read more]]\n\n*** YAML mode\n\nAllows you to edit YAML files\n\nTo install it, add =yaml-mode= to your packages list.\n\n[[http://www.emacswiki.org/emacs/YamlMode][Read more]]\n\n*** Yasnippet\n\nA mode that allows you to write code faster if you are lazy.\nIt is very easy to create your own snippets and use it whatever the file you are editing (code, non-code, emails, ...)\n\nI personally do not use it, but people coming from Textmate/Sublime would love it.\n\nTo install it, add =yasnippet= to your packages list.\n\n[[http://www.emacswiki.org/emacs/Yasnippet][Read more]]\n\n*** Paredit\n\nParedit is a really cool mode to \"keep parentheses balanced\" and navigating in the S-expressions. Useful and indispensable if you write Lisp code, for example.\n\nTo install it, add =paredit= to your packages list.\n\n[[http://www.emacswiki.org/emacs/ParEdit][Read more]]\n\n** Code navigation\n\nNavigate through source code is an indispensable feature in code editors. Some other editors are focused on this (like Sublime) but the problem is that they do not leave you the choice of weapons (like every other features).\n\nEmacs, as you noticed (yes, you did) can integrate any external tool or include a large variety of internal tools to make it more efficient. Code navigation is not an exception.\n\nThere are a lot of packages that exist to navigate through code, with different methodologies and advantages:\n\n- [[http://www.emacswiki.org/emacs/EmacsTags][TAGS]] (built in. No installation required)\n- [[https://github.com/bbatsov/projectile][Projectile]] (install it by adding =projectile= to your packages list)\n- [[https://github.com/emacs-helm/helm][Helm]] (install it by adding =helm= to your packages list)\n- [[http://cedet.sourceforge.net/][Emacs CEDET]] (install it by adding =cedet= to your packages list)\n- ...\n\n(Note: use once at a time! You do not need to install them all.)\n\nAfter using /Projectile/ for a certain period of time, I gave /Helm/ a shot but finally got back to the simplicity and the efficiency of the /TAGS/ system.\nNevertheless, /Projectile/ and /Helm/ are really powerful and useful. You really should look at them.\n\nFor now, I will cover the basics of /TAGS/ since it is a standard (used by other software) and it is built-in (so if you use another Emacs without your config, you still know how to surf in the code). And other useful tricks will be shown here.\n\n*** Tags basics\n\nBasically, the TAGS rely on an index file of the content of your code source.\nIn the root folder of a project, you must generate your index.\nSeveral methods for this, but here is one command that generates the file:\n\n#+begin_src sh\ncd /path/to/your/project\nfind . -regex \".*\\.\\(c\\|h\\|rb\\|py\\|php\\|js\\|sh\\|bash\\)\" -print | xargs etags -a\n#+end_src\n\nYou now should see a \"TAGS\" file. If needed, exclude this file from your git/svn/whatever repository/.\n\nYou are now ready to surf!\n\nNow, here are the main commands to use them:\n\n- *M-.* is the equivalent of *M-x find-tag*: find a tag\n- *M-x find-tag-other-window*: find a tag, but in another window\n- *M-x tags-search*: find a tag thanks to a regexp\n- *M-x tags-query-replace*: replace a tag in all the indexed files\n- *M-x tags-apropos*: list all tags that match a regexp\n- *M-x list-tags*: list all tags in a file\n\n*** List functions or methods\n\nIn order to list and jump easily between the functions or methods of the current file, here is a little trick:\n\n#+begin_src emacs-lisp\n(global-set-key (kbd \"C-S-f\") 'imenu) ;; use iMenu\n#+end_src\n\nAfter pressing Ctrl-Shift-f (replace it by whatever you want!), a menu with all the available resources appears in the minibuffer.\nSelect the resource you want (let's say /All.methods/ if you are editing some code) and you will be able to search and jump to a method definition directly.\n\n*** Files navigation (a.k.a fuzzy matching) with TAGS and ido\n\nIn order to find and jump easily to a file in your project thanks to TAGS, you have to add a little function to your configuration.\nFor this you should have installed the =ido-mode= described above.\n\n#+begin_src emacs-lisp\n(defun ido-find-file-in-tag-files ()\n (interactive)\n (save-excursion\n (let ((enable-recursive-minibuffers t))\n (visit-tags-table-buffer))\n (find-file\n (expand-file-name\n (ido-completing-read\n \"Project file: \" (tags-table-files) nil t)))))\n\n(global-set-key (kbd \"C-S-x C-S-f\") 'ido-find-file-in-tag-files)\n#+end_src\n\nNow, in your project folder and once you generated your TAGS file, you can press *C-S-x C-S-f* to find files through the whole tree of directories just by typing a pattern.\n\n[[../images/fuzzy.gif]]\n\n*** RGrep\n\n/rgrep/ is a great tool to use in addition of the TAGS. It is a Unix tool that make /grep/ queries recursively. In Emacs, it will show you a new buffer with all the results of the command. To use it, simply type:\n\n*M-x rgrep RET yoursearchterm RET*\n\nOnce fired, you can switch to the newly created buffer, parse the results and jump to the wanted files very quickly.\n\nWhat is cool is that it is integrated in the editor, just beside your code -- it does not require you to switch to a shell and then copy-paste the file you want.\n\n[[../images/rgrep.gif]]\n\n** Setting a color theme\n\nNow, we are talking about something very touchy and that can be a long quest ...\n\nA color theme generally includes colors for:\n\n- background\n- syntax color (for code)\n- specific modes colors (gnus, dired, git, ...)\n\nThere are several ways to install a color theme, but first, we will use the Emacs' internal color-theme library.\n\nLet's try to switch between different themes:\n\n- Type *M-x load-theme RET tango-dark*\n- Then type *M-x load-theme RET wombat*\n- Finally type *M-x load-theme RET whiteboard*\n\nThere is no secret or perfect color theme. There are so many of theme and each user has its preferences in term of colors.\n\n#+CAPTION: color themes\n[[../images/colors.gif]]\n\nIn order to choose yours, try the default ones, Google a lot or why not considering making your own?\n\nTip: for an effective choice, here are two showcases:\n\n- [[http://pawelbx.github.io/emacs-theme-gallery/]]\n- http://gnuemacscolorthemetest.googlecode.com/svn/html/index-el.html\n\n\n*** Font settings\n\nAfter setting up your theme, there are some other tweaks that are \"color theme related\".\nFonts are something very important depending on your system, your screen size, your current task in Emacs, ... etc\n\nIf you want to change the font directly from your current Emacs instance, simply type *M-x set-frame-font RET*.\nAnd if you want to see all supported fonts, type *TAB* twice. It will show you a list.\n\nThe global and easy way to do it is to add a line to your configuration:\n\n#+BEGIN_SRC lisp\n(set-default-font \"DejaVu Sans Mono-10\")\n#+END_SRC\n\nBut to be safe, you'd better add this into your X resource settings file (~/.Xresources):\n\n#+BEGIN_SRC lisp\nemacs.font: DejaVu Sans Mono-10\n#+END_SRC\n\nOf course, it is possible to set a different font for any system or mode you want. It is cool since you can use different font (size) if you are on Linux or mac OR if you write a book, write code, read your emails, ... etc.\nAs an exercise, I'll let you search how to do this kind of stuff in Emacs Lisp if you need it.\n\nIf you want more about font settings and especially about font names, please see the [[http://www.emacswiki.org/emacs/SetFonts][Emacs wiki page]] or the [[http://www.gnu.org/software/emacs/manual/html_node/emacs/Fonts.html][manual]].\n\nOne last point: sometimes you want to change the font size of your current buffer. To do this, simply type:\n\n- *M-x text-scale-increase* or *C-x C-+*\n- *M-x text-scale-decrease* or *C-x C--* (Ctrl x, Ctrl dash)\n\nReally handy if you show your screen through an external display or you want to focus on a specific part of a file.\n" }, { "path": "chapters/04-emacs-developing-environments.org", "content": "#+TITLE: Emacs for developers - Emacs developing environments\n#+AUTHOR: Pierre Lecocq\n#+DESCRIPTION: Learn using Emacs as a developer\n#+KEYWORDS: emacs, developer\n#+STARTUP: showall\n\n* Emacs for developers - Emacs developing environments\n\nEmacs, thanks to major and minor modes, can be transformed into a powerful specific development environment.\n\nAccording to the kind of files you are editing (or a command you type), it can change and give you specific features that fit the need of a programming language (or a task like debugging, launching unit tests, ...)\n\n** Emacs for Ruby developers\n\nThere are many Ruby developers who describe their setup around the web. Here are the most popular:\n\n- [[http://devblog.avdi.org/category/emacs-reboot/][The Emacs reboot series, by Avdi Grimm]] (Avdi is a famous ruby programmer and a great Emacs hacker)\n- [[http://crypt.codemancers.com/posts/2013-09-26-setting-up-emacs-as-development-environment-on-osx/][Setting up Emacs as Ruby development environment on OSX]] (even if it is for OSX, the packages remain the same on all OSes)\n- [[http://lorefnon.me/2014/02/02/configuring-emacs-for-rails.html][Configuring Emacs as a productive development environment for Rails development]]\n- [[http://www.emacswiki.org/emacs/RubyOnRails][The EmacsWiki on Ruby and RoR]]\n\n** Emacs for Python developers\n\nHere are some resources about configuring Emacs for developing in Python:\n\n- [[http://caisah.info/emacs-for-python/][Emacs for python - on caisah.info]]\n- [[http://www.emacswiki.org/emacs/PythonProgrammingInEmacs][Python programming in Emacs - on the EmacsWiki]]\n\n** Emacs for C/C++/Objective-C\n\nC languages are very well handled by Emacs and it allows you to edit, debug and run programs with Emacs very easily, with all the control you want.\n\n- [[http://tuhdo.github.io/c-ide.html][C/C++ Development Environment for Emacs]] is a very complete article about this\n- [[http://stackoverflow.com/questions/5800317/emacs-as-a-c-programming-ide-configuration][A various tips and packages for C language(s)]] on StackOverflow\n- [[http://truongtx.me/2013/03/10/emacs-setting-up-perfect-environment-for-cc-programming/][Setting up perfect environment for C/C++ Programming]] (according to its author. Good resource, though)\n- [[http://www.emacswiki.org/emacs/DebuggingWithEmacs][Debugging with Emacs]]\n- [[http://cedet.sourceforge.net/][CEDET - Collection of Emacs Development Environment Tools]] An amazing collection of tools for developing in many programming languages, especially for C/C++\n- [[http://alexott.net/en/writings/emacs-devenv/EmacsCedet.html][How to configure CEDET]]\n\n** Emacs for Go developers\n\n- If you develop in Go, you really should refer to the great [[http://yousefourabi.com/blog/2014/05/emacs-for-go/][Emacs for Go]] article, written by Yousef Ourabi.\n- Another one, with videos, is written by Dominik Honnef: [[http://dominik.honnef.co/posts/2013/03/writing_go_in_emacs/][Writing Go in Emacs]]\n\n** Emacs for PHP developers\n\nPHP, along with all the web technologies (HTML/JS/CSS) are very well supported in Emacs. The PHP mode does almost all the work by itself.\n\n- [[http://www.emacswiki.org/emacs/PhpMode][The EmacsWiki page about php-mode and other associated packages]]\n- [[http://stackoverflow.com/questions/912671/what-is-a-good-setup-for-editing-php-in-emacs][A list of useful packages for PHP - on StackOverflow]]\n- [[https://drupal.org/node/59868][An example setup for working on Drupal]] (but can be used for PHP in general)\n- [[https://code.google.com/p/geben-on-emacs/][GEBEN - remote debugging environment for Emacs]]\n- [[http://web-mode.org/][Web Mode - focused on web templates (HTML/JS/CSS)]]\n\n** Emacs for Java developers\n\nJava development is held by Eclipse. But it is not the only editor/environment that allows you to develop in Java!\n\n- [[http://jdee.sourceforge.net/][JDEE - the Java Development Environment for Emacs]]\n- [[http://www.emacswiki.org/emacs/JavaDevelopmentEnvironment][The EmacsWiki article on JDEE]]\n- [[http:][A video demo of a full Java environment on Emacs]]\n\n** Emacs for R and statistics\n\nEmacs is very useful for scientists and people dealing with data. Statistics, analysis, plotting, ... everything can be done within Emacs.\n\n- [[https://github.com/vikasrawal/orgpaper/blob/master/orgpapers.org][An amazing paper on working with Emacs, OrgMode and R]]\n- [[http://ess.r-project.org/][Emacs Speaks Statistics]] is a great project that adds a full statistics environment to your Emacs\n- [[http://stats.blogoverflow.com/2011/08/using-emacs-to-work-with-r/][A tutorial on using ESS]]\n" }, { "path": "chapters/05-special-features.org", "content": "#+TITLE: Emacs for developers - Special features\n#+AUTHOR: Pierre Lecocq\n#+DESCRIPTION: Learn using Emacs as a developer\n#+KEYWORDS: emacs, developer\n#+STARTUP: showall\n\n* Emacs for developers - Special features\n\n** Emacs as a file manager\n\nEmacs has a built-in mode named /dired/ that allows you to manage your file system directly in Emacs really easily.\nIt is very powerful and has features that graphical file managers do not have.\n\nFirst of all, to launch it, type:\n\n- *M-x dired RET* and then select a path to open (default is the directory of the file you are editing)\n- or *C-x d* if you prefer keybindings\n\nHere are a few quick shortcuts once you are in /dired mode/\n\n- *R* (capital R): rename a file\n- *D* (capital D): delete a file\n- *+*: create a new directory\n- *Z*: compress the file\n- *RET* (enter): Open the file\n- *g*: refresh\n- *q*: close the dired window\n\nOf course, files can be marked to operate on a selection of them. Use *m* to mark, *u* to unmark (*U* to unmark all), *% m* to mark according to a pattern.\n\nNote that there are so many tricks, extensions and features in /dired mode/ that I let you see around what you need.\n\n[[http://www.emacswiki.org/emacs/DiredMode][Read more about Dired]]\n\n[[https://www.gnu.org/software/emacs/manual/html_node/emacs/Dired.html][Read the manual]]\n\n** Working locally vs remotely\n\nEmacs, once installed on your machine will allow you to edit your file locally, obviously.\n\nOther people (non-Emacs users) will do a dirty trick to edit remote files like they were local files. They will mount the remote directory on their machine (thanks to /sshfs/).\nBut the magic in Emacs is that you can transparently edit remote files on your development servers for example.\nTo do so, Emacs comes with an ingenious extension named \"Tramp\". It is already installed and available when you install Emacs.\n\nIf you press *C-x C-f*, you can open a file. But if you ask =myname@myserver.com:/path/to/file=, it will automatically connect to the server and let you edit the remote file. Easy as pie.\n/Tramp/ supports lots of protocols like ssh, ftp, and so on.\n\nAnd what is great is that if you are editing a remote file and you launch a shell in Emacs, it will automatically set the shell into your remote environment and open it as if you were in the remote directory the file is in.\n\nA last tip about TRAMP. If you simply add =sudo:= in front of your file path, you edit your file with higher privileges. It is a very useful feature if you need to edit your configuration files on a server, for example. Of course, it works remotely and locally.\n\n[[http://www.emacswiki.org/emacs/TrampMode][Read more about Tramp]]\n\n** Organize your work, write papers and manage your agenda\n\nIn Emacs, you can do everything. This is a fact.\n\nOne the most amazing and complete mode is the amazing [[http://orgmode.org][Org mode]], written by amazing people.\nBut when I say amazing, it is absolutely amazing. It allows you to \"live in Emacs\".\n\nHere a a few of its am... features:\n\n- A full agenda / calendar\n- TODO lists and project management\n- Writing (research papers, books, an \"Emacs for developers\" whitepaper, your shopping list ...)\n- Include code in you papers\n- Tables and spreadsheets (with formulas and calculation)\n- Mobile integration\n- ...\n\nAnd what is really cool is that every thing you do in Org is exportable in:\n\n- PDF\n- LaTex\n- HTML\n- Text\n- ODT\n- iCalendar\n- TextInfo\n- ... and many more.\n\nYou really should check their [[http://orgmode.org/features.html][list of features]].\n\nIf you want to see a good example of Org-mode capabilities, check [[http://home.fnal.gov/~neilsen/notebook/orgExamples/org-examples.html][that great page]].\n\n** Emails in Emacs\n\nThere are packages that let you use Emacs as a full featured MUA.\nReading emails, sending emails, filtering, archiving ... etc.\n\nEmacs can be a very powerful and fast e-mail client and as it is controlled by the keyboard, it could be more efficient than a graphical e-mail client (clicking is a loss of time).\nI've used it for years now and I can not imagine using another program to read my emails.\n\nThere are several package to do so, but the most used is [[http://www.gnus.org/][Gnus]]. It is already installed with Emacs.\n\nHere are some of its features beside the basic ones:\n\n- Gnus is in fact a newsreader used to interact with email servers. So you can use to fetch messages from newsgroups, RSS, SMTP, POP, ...\n- Easy and powerful mail splitting\n- Integration with BBDB, a contact manager\n- Message scoring\n- LDAP\n- PGP signing and encrypting\n- Customizable layout\n- Encrypted file to manage your credentials\n- ... and many more\n- ... and of course, it is extensible thanks to Lisp\n\nYou really should try it with your personal account. It is easy to configure and integrate with [[http://www.emacswiki.org/emacs/GnusGmail][Gmail]], for example.\n\nIf you want a complete configuration example with some of the most important features (imap, smtp, search, contacts, GPG signature, display customization, ...), please refer to this dedicated article: [[http://qsdfgh.com/articles/gnus-configuration-example.html][Gnus configuration example]]\n\nBut be careful! If you try it, you will love it.\n\nSome alternatives to Gnus (that I do not use, but that are popular):\n- [[http://www.emacswiki.org/emacs/WanderLust][Wanderlust]]\n- [[http://www.djcbsoftware.nl/code/mu/mu4e.html][Mu4e]]\n\n** Some great Emacs tips and tricks\n\n- Emacs is all about Macros. This is one of its most powerful feature. Record a sequence and re-play it on other lines! Here is [[http://www.thegeekstuff.com/2010/07/emacs-macro-tutorial-how-to-record-and-play/][how]].\n- Using [[http://www.masteringemacs.org/articles/2010/11/01/running-shells-in-emacs-overview/][shell]] inside Emacs is cool\n- You really should use the /[[http://www.emacswiki.org/emacs/BookMarks][bookmarks]]/ functionality to save your projects locations (locally or remotely)\n- When opening a file, add /sudo:/ in front of its path in order to edit it as a privileged user\n- You can edit files in hexadecimal directly in Emacs thanks to the /hexl-mode/\n- Emacs allows you to open an archive (gz, bz2, zip, ...), edit its files on-the-fly without extracting yourself the archive. To do so, simple open the file directly in Emacs (*C-x C-f* /path/to/archive.tar.bz2)\n- [[http://www.gnu.org/software/emacs/manual/html_node/emacs/Rectangles.html][Rectangle regions]] edition is really easy\n- [[http://www.cs.bu.edu/teaching/tool/emacs/programming/#compile][Compilation]] and [[http://www.cs.bu.edu/teaching/tool/emacs/programming/#gdb][debugging]] is really well supported in Emacs\n- [[http://www.emacswiki.org/ERC][Erc]] is a great IRC client running in Emacs\n\n/To be continued/\n\n** Coming from other editors (i.e Vim or SublimeText)\n\nSome people use other editors and want to give Emacs a try.\nSome people are really used to use a specific editor.\nSome people do not want to lose their habits and their learning curve.\n\nI am thinking about Vim, but it is also true for other editors (textmate, sublime, ...)\nEmacs has a mode that allows you to use it exactly like Vim.\nI have personally never used this mode, but many people use it. Therefore, it allows you to switch gently and softly from Vim to Emacs.\n\n[[http://www.emacswiki.org/emacs/Evil][Read more about Evil-mode]]\n\nThere is also a package to recreate SublimeText and its GUI features that some people like (minimap, smooth scrolling, ...)\n\n[[https://github.com/zk-phi/sublimity][Read more about Sublimity]]\n" }, { "path": "chapters/06-readings-and-resources.org", "content": "#+TITLE: Emacs for developers - Readings and resources\n#+AUTHOR: Pierre Lecocq\n#+DESCRIPTION: Learn using Emacs as a developer\n#+KEYWORDS: emacs, developer\n#+STARTUP: showall\n\n* Emacs for developers - Readings and resources\n\n- [[http://emacsrocks.com/][Emacs rocks videos]]\n- [[http://devblog.avdi.org/category/emacs-reboot/][Avdi Grimm Emacs reboot series]]\n- [[http://www.masteringemacs.org/][Mastering Emacs]]\n- [[http://sachachua.com/blog/category/geek/emacs/][Sacha's blog]] and her wonderful Emacs contributors interviews serie\n- [[http://emacsredux.com][Emacs redux]] by Bozhidar Batsov\n- [[http://planet.emacsen.org/][Planet Emacsen]]\n- [[http://reddit.com/r/emacs][Emacs sub-reddit]]\n- [[http://endlessparentheses.com/][Endless Parentheses]], concise emacs productivity tips\n\nAnd of course, the [[http://www.emacswiki.org/][Emacs wiki]]\n" }, { "path": "demo/README.org", "content": "* The demo\n\nA (basic) annoted demo associated to this tutorial is available in video:\n\n- [[https://www.youtube.com/watch?v=oPZ8yliLYMM]] (Watch it in HD for better ... quality !)\n- [[https://vimeo.com/110356656]]\n\n** Scenario\n\n*** 1. Setup\n\n- 1.1 Launch using a dedicated config file\n- 1.2 Print the current Emacs' version (wouhou !)\n- 1.3 Open a file\n\n*** 2. Basic editing\n\n- 2.1 Go to constructor and edit arguments\n- 2.2 Select a region\n- 2.3 Copy and paste the region\n- 2.4 Comment/Uncomment a region\n- 2.5 Save the current file (buffer)\n\n*** 3. Searching\n\n- 3.1 Search in the current buffer\n- 3.2 Navigate between occurrences\n- 3.3 Search in project files with rgrep\n\n*** 4. Windows and buffers\n\n- 4.1 Open a new window\n- 4.2 Open a new buffer with a new file\n- 4.3 Close window\n- 4.4 Switch between buffers in the same window\n- 4.5 Re-open several windows with different buffers\n- 4.6 Close everything but the current window\n\n*** 5. Dired mode\n\n- 5.1 Open dired mode\n- 5.2 Create a directory (+)\n- 5.3 Create three new file (C-x C-f) and then refresh the buffer (g)\n- 5.4 Rename two file (R) one by one\n- 5.5 Mark two files (m) and delete them both (D)\n- 5.6 Compress the remaining file (Z)\n- 5.7 Change its mode (M)\n\n*** 6. Shell\n\n- 6.1 Open a shell\n- 6.2 Execute a command (ls -l)\n- 6.4 Select the output and execute a command on the selected region (M-| RET sed -e 's/e/EEE/g' > test-shell.txt)\n- 6.5 Execute a command from a buffer (M-! RET ls -l /)\n" }, { "path": "demo/config.el", "content": ";;\n;; emacs4developer demo - emacs config\n;; by Pierre Lecocq\n;;\n;; See https://github.com/pierre-lecocq/emacs.d for full configuration\n;;\n\n(setq debug-on-error t)\n\n;; ----------------\n;; Install packages\n\n(when (>= emacs-major-version 24)\n\n ;; Require the library\n (require 'package)\n\n ;; Set repositories\n (setq package-archives '((\"gnu\" . \"http://elpa.gnu.org/packages/\")\n\t\t\t (\"marmalade\" . \"http://marmalade-repo.org/packages/\")\n\t\t\t (\"melpa\" . \"http://melpa.milkbox.net/packages/\")))\n\n ;; Initialize the package manager\n (package-initialize)\n\n ;; Install autopair package (to match parentheses, brackets, ...)\n (unless (package-installed-p 'autopair)\n (progn\n (package-refresh-contents)\n (package-install 'autopair)))\n \n (require 'autopair)\n (autopair-global-mode)\n\n ;; Install darkmine-theme package (a darkish theme)\n (unless (package-installed-p 'darkmine-theme)\n (progn\n (package-refresh-contents)\n (package-install 'darkmine-theme)))\n\n (load-theme 'darkmine t)\n\n )\n\n;; ------------------\n;; Some basic configs\n\n;; See matching pairs of parentheses\n(show-paren-mode t)\n;; Fontify the text in the buffer\n(global-font-lock-mode t)\n;; Selection highlighting\n(transient-mark-mode t)\n;; Display line number in the modeline\n(line-number-mode t)\n;; Display column number in the modeline\n(column-number-mode t)\n;; Layziness is the best invention, ever\n(fset 'yes-or-no-p 'y-or-n-p)\n" }, { "path": "demo/src/dummy.rb", "content": "#!/usr/bin/env ruby\n\nrequire_relative 'functions'\n\n# A dummy class\nclass Dummy\n # Accessor - author\n attr_accessor :author\n\n # Accessor - version\n attr_accessor :version\n\n # Constructor\n #\n # @param action_name [String]\n def initialize(action_name)\n # Because we are polite\n puts 'Bonjour'\n\n # Get a few informations\n @author = ENV['user']\n @version = [1, 5, 2].join '.'\n\n # And then do something ...\n dispatch action_name\n end\n\n # Dispatcher\n #\n # @param action [Symbol]\n def dispatch(action)\n case action\n when :create\n do_create\n when :update\n do_update\n when :delete\n do_delete\n else\n fail 'Unknown action'\n end\n end\n\n # Create something\n def do_create\n puts \"Let's create something !\"\n end\n\n # Update something\n def do_update\n puts \"Let's update something !\"\n end\n\n # Delete something\n def do_delete\n puts \"Let's delete something !\"\n end\n\n # The most silly thing, ever\n def compute_version\n result = 0\n @version.split('.').map! { |n| result += n.to_i }\n result\n end\nend\n" }, { "path": "demo/src/functions.rb", "content": "# Just say something\n#\n# @param message [String]\n# @param prefix [String]\ndef say(message, prefix = ' => ')\n puts \"%s%s\" % [\n prefix,\n message\n ]\nend\n\n# Symbolize hash keys\n# Credits: Avdi Grimm\ndef symbolize_keys(hash)\n hash.inject({}){|result, (key, value)|\n new_key = case key\n when String then key.to_sym\n else key\n end\n new_value = case value\n when Hash then symbolize_keys(value)\n else value\n end\n result[new_key] = new_value\n result\n }\nend\n" }, { "path": "exports/emacs4developers.html", "content": "\n\n\n\n*Org HTML Export*\n\n\n\n\n\n\n\n\n\n\n
\n

*Org HTML Export*

\n

\n<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Strict//EN\"\n\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd\">\n<html xmlns=\"http://www.w3.org/1999/xhtml\" lang=\"en\" xml:lang=\"en\">\n<head>\n<title>Emacs for developers</title>\n<!– 2014-10-21 Mar 13:50 –>\n<meta http-equiv=\"Content-Type\" content=\"text/html;charset=utf-8\" />\n<meta name=\"generator\" content=\"Org-mode\" />\n<meta name=\"author\" content=\"Pierre Lecocq\" />\n<meta name=\"description\" content=\"Learn using Emacs as a developer\"\n />\n<meta name=\"keywords\" content=\"emacs, developer\" />\n<style type=\"text/css\">\n <!–/*–><![CDATA[/*><!–*/\n .title { text-align: center; }\n .todo { font-family: monospace; color: red; }\n .done { color: green; }\n .tag { background-color: #eee; font-family: monospace;\n padding: 2px; font-size: 80%; font-weight: normal; }\n .timestamp { color: #bebebe; }\n .timestamp-kwd { color: #5f9ea0; }\n .right { margin-left: auto; margin-right: 0px; text-align: right; }\n .left { margin-left: 0px; margin-right: auto; text-align: left; }\n .center { margin-left: auto; margin-right: auto; text-align: center; }\n .underline { text-decoration: underline; }\n #postamble p, #preamble p { font-size: 90%; margin: .2em; }\n p.verse { margin-left: 3%; }\n pre {\n border: 1px solid #ccc;\n box-shadow: 3px 3px 3px #eee;\n padding: 8pt;\n font-family: monospace;\n overflow: auto;\n margin: 1.2em;\n }\n pre.src {\n position: relative;\n overflow: visible;\n padding-top: 1.2em;\n }\n pre.src:before {\n display: none;\n position: absolute;\n background-color: white;\n top: -10px;\n right: 10px;\n padding: 3px;\n border: 1px solid black;\n }\n pre.src:hover:before { display: inline;}\n pre.src-sh:before { content: 'sh'; }\n pre.src-bash:before { content: 'sh'; }\n pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }\n pre.src-R:before { content: 'R'; }\n pre.src-perl:before { content: 'Perl'; }\n pre.src-java:before { content: 'Java'; }\n pre.src-sql:before { content: 'SQL'; }\n

\n\n

\n table { border-collapse:collapse; }\n caption.t-above { caption-side: top; }\n caption.t-bottom { caption-side: bottom; }\n td, th { vertical-align:top; }\n th.right { text-align: center; }\n th.left { text-align: center; }\n th.center { text-align: center; }\n td.right { text-align: right; }\n td.left { text-align: left; }\n td.center { text-align: center; }\n dt { font-weight: bold; }\n .footpara:nth-child(2) { display: inline; }\n .footpara { display: block; }\n .footdef { margin-bottom: 1em; }\n .figure { padding: 1em; }\n .figure p { text-align: center; }\n .inlinetask {\n padding: 10px;\n border: 2px solid gray;\n margin: 10px;\n background: #ffffcc;\n }\n #org-div-home-and-up\n { text-align: right; font-size: 70%; white-space: nowrap; }\n textarea { overflow-x: auto; }\n .linenr { font-size: smaller }\n .code-highlighted { background-color: #ffff00; }\n .org-info-jsinfo-navigation { border-style: none; }\n #org-info-jsconsole-label\n { font-size: 10px; font-weight: bold; white-space: nowrap; }\n .org-info-jssearch-highlight\n { background-color: #ffff00; color: #000000; font-weight: bold; }\n ]]>–>\n</style>\n<script type=\"text/javascript\">\n/*\n@licstart The following is the entire license notice for the\nJavaScript code in this tag.\n

\n\n

\nCopyright (C) 2012-2013 Free Software Foundation, Inc.\n

\n\n

\nThe JavaScript code in this tag is free software: you can\nredistribute it and/or modify it under the terms of the GNU\nGeneral Public License (GNU GPL) as published by the Free Software\nFoundation, either version 3 of the License, or (at your option)\nany later version. The code is distributed WITHOUT ANY WARRANTY;\nwithout even the implied warranty of MERCHANTABILITY or FITNESS\nFOR A PARTICULAR PURPOSE. See the GNU GPL for more details.\n

\n\n

\nAs additional permission under GNU GPL version 3 section 7, you\nmay distribute non-source (e.g., minimized or compacted) forms of\nthat code without the copy of the GNU GPL normally required by\nsection 4, provided you include this license notice and a URL\nthrough which recipients can access the Corresponding Source.\n

\n\n\n

\n@licend The above is the entire license notice\nfor the JavaScript code in this tag.\n/\n<!–/–><![CDATA[/*><!–*/\n function CodeHighlightOn(elem, id)\n {\n var target = document.getElementById(id);\n if(null != target) {\n elem.cacheClassElem = elem.className;\n elem.cacheClassTarget = target.className;\n target.className = \"code-highlighted\";\n elem.className = \"code-highlighted\";\n }\n }\n function CodeHighlightOff(elem, id)\n {\n var target = document.getElementById(id);\n if(elem.cacheClassElem)\n elem.className = elem.cacheClassElem;\n if(elem.cacheClassTarget)\n target.className = elem.cacheClassTarget;\n }\n*]]>*//–>\n</script>\n</head>\n<body>\n<div id=\"content\">\n<h1 class=\"title\">Emacs for developers</h1>\n<div id=\"table-of-contents\">\n<h2>Table of Contents</h2>\n<div id=\"text-table-of-contents\">\n<ul>\n<li><a href=\"#sec-1\">1. Emacs for developers</a>\n<ul>\n<li><a href=\"#sec-1-1\">1.1. Who is the target of this tutorial</a></li>\n</ul>\n</li>\n<li><a href=\"#sec-2\">2. Table of contents</a></li>\n<li><a href=\"#sec-3\">3. Introduction</a>\n<ul>\n<li><a href=\"#sec-3-1\">3.1. Brief history</a></li>\n<li><a href=\"#sec-3-2\">3.2. How to get Emacs?</a></li>\n<li><a href=\"#sec-3-3\">3.3. More than an editor</a></li>\n<li><a href=\"#sec-3-4\">3.4. The perfect development tool</a></li>\n</ul>\n</li>\n<li><a href=\"#sec-4\">4. The basics</a>\n<ul>\n<li><a href=\"#sec-4-1\">4.1. Config files</a></li>\n<li><a href=\"#sec-4-2\">4.2. Executing commands</a></li>\n<li><a href=\"#sec-4-3\">4.3. Key bindings</a>\n<ul>\n<li><a href=\"#sec-4-3-1\">4.3.1. Manipulate files</a></li>\n<li><a href=\"#sec-4-3-2\">4.3.2. Manipulate the line</a></li>\n<li><a href=\"#sec-4-3-3\">4.3.3. Selecting a region</a></li>\n<li><a href=\"#sec-4-3-4\">4.3.4. Commenting</a></li>\n<li><a href=\"#sec-4-3-5\">4.3.5. Windows</a></li>\n<li><a href=\"#sec-4-3-6\">4.3.6. Buffers</a></li>\n<li><a href=\"#sec-4-3-7\">4.3.7. Cancel a command</a></li>\n<li><a href=\"#sec-4-3-8\">4.3.8. The most useless one</a></li>\n</ul>\n</li>\n<li><a href=\"#sec-4-4\">4.4. Help!</a></li>\n</ul>\n</li>\n<li><a href=\"#sec-5\">5. Building your own editor</a>\n<ul>\n<li><a href=\"#sec-5-1\">5.1. First basic configuration</a></li>\n<li><a href=\"#sec-5-2\">5.2. General basic configuration</a></li>\n<li><a href=\"#sec-5-3\">5.3. Backup files</a></li>\n<li><a href=\"#sec-5-4\">5.4. Setting up the locales</a></li>\n<li><a href=\"#sec-5-5\">5.5. More configuration</a></li>\n<li><a href=\"#sec-5-6\">5.6. Modes</a>\n<ul>\n<li><a href=\"#sec-5-6-1\">5.6.1. Major modes</a></li>\n<li><a href=\"#sec-5-6-2\">5.6.2. Minor modes</a></li>\n</ul>\n</li>\n<li><a href=\"#sec-5-7\">5.7. Package managers</a>\n<ul>\n<li><a href=\"#sec-5-7-1\">5.7.1. Package.el</a></li>\n<li><a href=\"#sec-5-7-2\">5.7.2. El-Get</a></li>\n<li><a href=\"#sec-5-7-3\">5.7.3. The generic method</a></li>\n<li><a href=\"#sec-5-7-4\">5.7.4. The modern and efficient way</a></li>\n</ul>\n</li>\n<li><a href=\"#sec-5-8\">5.8. Some useful packages</a>\n<ul>\n<li><a href=\"#sec-5-8-1\">5.8.1. Auto complete</a></li>\n<li><a href=\"#sec-5-8-2\">5.8.2. Autopair</a></li>\n<li><a href=\"#sec-5-8-3\">5.8.3. Buffer move</a></li>\n<li><a href=\"#sec-5-8-4\">5.8.4. Flycheck</a></li>\n<li><a href=\"#sec-5-8-5\">5.8.5. Highlight symbol</a></li>\n<li><a href=\"#sec-5-8-6\">5.8.6. Ido</a></li>\n<li><a href=\"#sec-5-8-7\">5.8.7. JS3</a></li>\n<li><a href=\"#sec-5-8-8\">5.8.8. Magit</a></li>\n<li><a href=\"#sec-5-8-9\">5.8.9. Multiple cursors</a></li>\n<li><a href=\"#sec-5-8-10\">5.8.10. PHP mode</a></li>\n<li><a href=\"#sec-5-8-11\">5.8.11. Rainbow mode</a></li>\n<li><a href=\"#sec-5-8-12\">5.8.12. RHTML mode</a></li>\n<li><a href=\"#sec-5-8-13\">5.8.13. Ruby mode</a></li>\n<li><a href=\"#sec-5-8-14\">5.8.14. Switch window</a></li>\n<li><a href=\"#sec-5-8-15\">5.8.15. Visual regexp</a></li>\n<li><a href=\"#sec-5-8-16\">5.8.16. Yaml mode</a></li>\n<li><a href=\"#sec-5-8-17\">5.8.17. Yasnippet</a></li>\n<li><a href=\"#sec-5-8-18\">5.8.18. Paredit</a></li>\n</ul>\n</li>\n<li><a href=\"#sec-5-9\">5.9. Code navigation</a>\n<ul>\n<li><a href=\"#sec-5-9-1\">5.9.1. Tags basics</a></li>\n<li><a href=\"#sec-5-9-2\">5.9.2. List functions or methods</a></li>\n<li><a href=\"#sec-5-9-3\">5.9.3. Files navigation (a.k.a fuzzy matching) with TAGS and ido</a></li>\n<li><a href=\"#sec-5-9-4\">5.9.4. RGrep</a></li>\n</ul>\n</li>\n<li><a href=\"#sec-5-10\">5.10. Setting a color theme</a>\n<ul>\n<li><a href=\"#sec-5-10-1\">5.10.1. Font settings</a></li>\n</ul>\n</li>\n</ul>\n</li>\n<li><a href=\"#sec-6\">6. Emacs for developers - Emacs developing environments</a>\n<ul>\n<li><a href=\"#sec-6-1\">6.1. Emacs for Ruby developers</a></li>\n<li><a href=\"#sec-6-2\">6.2. Emacs for Python developers</a></li>\n<li><a href=\"#sec-6-3\">6.3. Emacs for C/C++/Objective-C</a></li>\n<li><a href=\"#sec-6-4\">6.4. Emacs for Go developers</a></li>\n<li><a href=\"#sec-6-5\">6.5. Emacs for PHP developers</a></li>\n<li><a href=\"#sec-6-6\">6.6. Emacs for Java developers</a></li>\n<li><a href=\"#sec-6-7\">6.7. Emacs for R and statistics</a></li>\n</ul>\n</li>\n<li><a href=\"#sec-7\">7. Special features</a>\n<ul>\n<li><a href=\"#sec-7-1\">7.1. Emacs as a file manager</a></li>\n<li><a href=\"#sec-7-2\">7.2. Working locally vs remotely</a></li>\n<li><a href=\"#sec-7-3\">7.3. Organize your work, write papers and manage your agenda</a></li>\n<li><a href=\"#sec-7-4\">7.4. Emails in Emacs</a></li>\n<li><a href=\"#sec-7-5\">7.5. Some great Emacs tips and tricks</a></li>\n<li><a href=\"#sec-7-6\">7.6. Coming from other editors (i.e Vim)</a></li>\n</ul>\n</li>\n<li><a href=\"#sec-8\">8. Readings and resources</a></li>\n<li><a href=\"#sec-9\">9. License</a></li>\n<li><a href=\"#sec-10\">10. Thanks</a></li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-1\" class=\"outline-2\">\n<h2 id=\"sec-1\"><span class=\"section-number-2\">1</span> Emacs for developers</h2>\n<div class=\"outline-text-2\" id=\"text-1\">\n<p>\nThis document will (hopefully) help you to use Emacs as a developer.\n</p>\n</div>\n

\n\n

\n<ol class=\"org-ol\"><li><a id=\"sec-1-0-0-1\" name=\"sec-1-0-0-1\"></a>Disclaimer<br /><div class=\"outline-text-5\" id=\"text-1-0-0-1\">\n<p>\nWork in progress, so stay tuned.\n</p>\n</div>\n</li>\n

\n\n

\n<div id=\"outline-container-sec-1-1\" class=\"outline-3\">\n<h3 id=\"sec-1-1\"><span class=\"section-number-3\">1.1</span> Who is the target of this tutorial</h3>\n<div class=\"outline-text-3\" id=\"text-1-1\">\n<p>\nWell, this is a good question. And I won't give an answer but some elements of answer.\n</p>\n

\n\n

\n<p>\nWhat is sure is that it is not written for the people thanked below (Batien, Dimitri, Sacha, Nic, Avdi, and so on &#x2026;), but what is interseting with Emacs is that even if you are a beginner, an intermediate / advanced user or an every day power user, you can learn from others each time you open a web page or a manual dealing with Emacs.\n</p>\n

\n\n

\n<p>\nTherefore, this tutorial is written for people who want to improve their experience. Simple as that. Whatever is their knowledge, their feeling, their usage, their config file size (without any pun), etc &#x2026;\n</p>\n

\n\n

\n<p>\nRemember one thing: Emacs is 30+ years old and brings new users everyday. It is a clue that this is a piece of software that deserve some attention.\n</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-2\" class=\"outline-2\">\n<h2 id=\"sec-2\"><span class=\"section-number-2\">2</span> Table of contents</h2>\n<div class=\"outline-text-2\" id=\"text-2\">\n<ul class=\"org-ul\">\n<li>1. <i>Introduction</i>\n<ul class=\"org-ul\">\n<li>1.1 <i>Brief history</i>\n</li>\n<li>1.2 <i>How to get Emacs?</i>\n</li>\n<li>1.3 <i>More than an editor</i>\n</li>\n<li>1.4 <i>The perfect development tool</i>\n</li>\n</ul>\n</li>\n<li>2. <i>The basics</i>\n<ul class=\"org-ul\">\n<li>2.1 <i>Config files</i>\n</li>\n<li>2.2 <i>Executing commands</i>\n</li>\n<li>2.3 <i>Key bindings</i>\n<ul class=\"org-ul\">\n<li>2.3.1 <i>Manipulate files</i>\n</li>\n<li>2.3.2 <i>Manipulate the current line</i>\n</li>\n<li>2.3.3 <i>Selecting a region</i>\n</li>\n<li>2.3.4 <i>Commenting</i>\n</li>\n<li>2.3.5 <i>Windows</i>\n</li>\n<li>2.3.6 <i>Buffers</i>\n</li>\n<li>2.3.7 <i>Cancel a command</i>\n</li>\n<li>2.3.8 <i>The most useless command</i>\n</li>\n</ul>\n</li>\n<li>2.4 <i>Help!</i>\n</li>\n</ul>\n</li>\n<li>3. <i>Building your own editor</i>\n<ul class=\"org-ul\">\n<li>3.1 <i>First basic configuration</i>\n</li>\n<li>3.2 <i>General basic configuration</i>\n</li>\n<li>3.3 <i>Backup files</i>\n</li>\n<li>3.4 <i>Setting up the locales</i>\n</li>\n<li>3.5 <i>More configuration</i>\n</li>\n<li>3.6 <i>Modes</i>\n</li>\n<li>3.7 <i>Package managers</i>\n</li>\n<li>3.8 <i>Some useful packages</i>\n</li>\n<li>3.9 <i>Code navigation</i>\n</li>\n<li>3.10 <i>Setting a color theme</i>\n</li>\n</ul>\n</li>\n<li>4. <i>Emacs developing environments</i>\n<ul class=\"org-ul\">\n<li>4.1 <i>Emacs for Ruby developers</i>\n</li>\n<li>4.2 <i>Emacs for Python developers</i>\n</li>\n<li>4.3 <i>Emacs for C/C++/Objective-C developers</i>\n</li>\n<li>4.4 <i>Emacs for Go developers</i>\n</li>\n<li>4.5 <i>Emacs for PHP developers</i>\n</li>\n<li>4.6 <i>Emacs for Java developers</i>\n</li>\n<li>4.7 <i>Emacs for R and statistics</i>\n</li>\n</ul>\n</li>\n<li>5. <i>Special features</i>\n<ul class=\"org-ul\">\n<li>5.1 <i>Emacs as a file manager</i>\n</li>\n<li>5.2 <i>Working locally vs remotely</i>\n</li>\n<li>5.3 <i>Organize your work, write papers and manage your agenda</i>\n</li>\n<li>5.4 <i>Emails in Emacs</i>\n</li>\n<li>5.5 <i>Some great Emacs tips and tricks</i>\n</li>\n<li>5.6 <i>Coming from other editors (i.e Vim or SublimeText)</i>\n</li>\n</ul>\n</li>\n<li>6. <i>Readings and resources</i>\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-3\" class=\"outline-2\">\n<h2 id=\"sec-3\"><span class=\"section-number-2\">3</span> Introduction</h2>\n<div class=\"outline-text-2\" id=\"text-3\">\n</div><div id=\"outline-container-sec-3-1\" class=\"outline-3\">\n<h3 id=\"sec-3-1\"><span class=\"section-number-3\">3.1</span> Brief history</h3>\n<div class=\"outline-text-3\" id=\"text-3-1\">\n<ul class=\"org-ul\">\n<li>Originally developed by Richard Stallman and Guy Steele in MIT AI lab\n</li>\n<li>First release in 1976\n</li>\n<li>Inspired by TECO editor\n</li>\n<li>Based on macros (Emacs stands for Editor MACroS)\n</li>\n<li>Written in C and Emacs Lisp\n</li>\n<li>Part of the GNU project (therefore, we <i>should</i> say \"GNU Emacs\", not \"Emacs\")\n</li>\n

\n\n

\n<li>Despite its age, new users are still adopting Emacs as their development platform to this day!\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-3-2\" class=\"outline-3\">\n<h3 id=\"sec-3-2\"><span class=\"section-number-3\">3.2</span> How to get Emacs?</h3>\n<div class=\"outline-text-3\" id=\"text-3-2\">\n<p>\nOn every Linux distribution, packages are available.\nSo run your favorite package manager to install it:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><i>apt-get install emacs</i>\n</li>\n<li><i>yum install emacs</i>\n</li>\n<li>&#x2026;\n</li>\n</ul>\n

\n\n

\n<p>\nAnd if you have an exotic operating system, here are the specific distributions:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li>Mac OS X: <a href=\"http://emacsformacosx.com/\">http://emacsformacosx.com/</a>\n</li>\n<li>Windows: <a href=\"http://ftp.igh.cnrs.fr/pub/gnu/emacs/windows/\">http://ftp.igh.cnrs.fr/pub/gnu/emacs/windows/</a>\n</li>\n</ul>\n

\n\n

\n<p>\nBut, in order to get the latest version, it's <span class=\"underline\">highly recommended</span> that you compile Emacs yourself: <a href=\"http://ftp.igh.cnrs.fr/pub/gnu/emacs/\">http://ftp.igh.cnrs.fr/pub/gnu/emacs/</a>\n</p>\n</div>\n</div>\n

\n\n\n

\n<div id=\"outline-container-sec-3-3\" class=\"outline-3\">\n<h3 id=\"sec-3-3\"><span class=\"section-number-3\">3.3</span> More than an editor</h3>\n<div class=\"outline-text-3\" id=\"text-3-3\">\n<ul class=\"org-ul\">\n<li>More than an editor, it is a Lisp interpretor\n</li>\n<li>Can run any type of program written in Lisp:\n<ul class=\"org-ul\">\n<li>Email clients (like <a href=\"http://www.gnus.org/\">Gnus</a> or <a href=\"http://www.emacswiki.org/emacs/mu4e\">mu4e</a>)\n</li>\n<li>Shell (like bash or eshell)\n</li>\n<li>File and directory management (with <a href=\"http://www.gnu.org/software/emacs/manual/html_node/emacs/Dired.html\">Dired mode</a>)\n</li>\n<li>Agenda / Notes / TODO list / Project management (with the amazing <a href=\"http://orgmode.org\">OrgMode</a>)\n</li>\n<li>IRC / Twitter / Jabber / &#x2026; clients\n</li>\n<li>Games (like Tetris, Pong, Snake, 5x5, Dunnet, &#x2026;)\n</li>\n<li>Encrypt/decrypt files (like GPG files)\n</li>\n<li>On-the-fly archives editing (thanks to <a href=\"http://www.emacswiki.org/emacs/ArchiveMode\">archive-mode</a>)\n</li>\n<li>PDF / Image / (&#x2026;) viewer\n</li>\n<li>A powerful front end to R / S+ / SPSS / Stata (with <a href=\"http://ess.r-project.org/\">EmacsSpeaksStatisics)</a>\n</li>\n<li>An editor for multi-modal REPL's like IPython (with <a href=\"http://tkf.github.io/emacs-ipython-notebook/\">EmacsIPythonNotebook</a>)\n</li>\n<li>Music player (with emms, vlc, mplayer, &#x2026;)\n</li>\n<li>Music programming (with <a href=\"http://vimeo.com/22798433\">Overtone</a>)\n</li>\n<li>Video editing\n</li>\n<li>And so on &#x2026;\n</li>\n<li>(and of course a document editor that can automatically generate this presentation)\n</li>\n</ul>\n</li>\n</ul>\n

\n\n

\n<p>\nNaturally, you can do all of that at the same time with only one Emacs instance. Don't need to say it &#x2026;\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-3-4\" class=\"outline-3\">\n<h3 id=\"sec-3-4\"><span class=\"section-number-3\">3.4</span> The perfect development tool</h3>\n<div class=\"outline-text-3\" id=\"text-3-4\">\n<ul class=\"org-ul\">\n<li>As Emacs is a Lisp interpretor, it is extensible. Really really extensible.\n</li>\n<li>The (unofficial) goal of Emacs is to be hacked\n</li>\n<li>Therefore your goal is to hack Emacs to make it work perfectly as you want\n</li>\n

\n\n

\n<li>Already provides so many development tools (also extensible, of course)\n<ul class=\"org-ul\">\n<li>Debuggers\n</li>\n<li>Compilers\n</li>\n<li>Syntax checkers\n</li>\n<li>Documentations\n</li>\n<li>Consoles\n</li>\n<li>&#x2026;\n</li>\n</ul>\n</li>\n

\n\n

\n<li>Also provides <i>modes</i> (extensions) for <b>every</b> programming language for\n<ul class=\"org-ul\">\n<li>Syntax highlighting\n</li>\n<li>Documentation search\n</li>\n<li>Indentation\n</li>\n<li>Source code browsing\n</li>\n<li>Compilation commands\n</li>\n<li>Specific behaviour\n</li>\n<li>&#x2026;\n</li>\n</ul>\n</li>\n</ul>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4\" class=\"outline-2\">\n<h2 id=\"sec-4\"><span class=\"section-number-2\">4</span> The basics</h2>\n<div class=\"outline-text-2\" id=\"text-4\">\n</div><div id=\"outline-container-sec-4-1\" class=\"outline-3\">\n<h3 id=\"sec-4-1\"><span class=\"section-number-3\">4.1</span> Config files</h3>\n<div class=\"outline-text-3\" id=\"text-4-1\">\n<p>\nIn order to customize Emacs, you will have to edit its configuration files.\nIt does not exist when you install the software (or is an empty file) and does nothing until you decide to tweak Emacs.\nSome people use Emacs for decades without any extra configuration because they like it out of the box.\n</p>\n

\n\n

\n<p>\nThere are several ways to manage your Emacs configuration:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li>Simply create and edit a <b>~/.emacs</b> file\n</li>\n<li>Create a <b>~/.emacs.d/</b> directory with a <b>~/.emacs.d/init.el</b> file\n</li>\n</ul>\n

\n\n

\n<p>\nThe first solution is great if you have a small, tidied and exportable configuration file.\n</p>\n

\n\n

\n<p>\nThe second solution is great if you need several configuration files (keep you configuration parts separated) or you need to install external extensions (you will install them in <b>~/.emacs.d</b> to keep them centralized and exportable).\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4-2\" class=\"outline-3\">\n<h3 id=\"sec-4-2\"><span class=\"section-number-3\">4.2</span> Executing commands</h3>\n<div class=\"outline-text-3\" id=\"text-4-2\">\n<p>\nThe main idea of Emacs is that everything is a command. For example: opening a file with a keybinding calls a command that is executed by the Emacs' core.\nAnd all the commands are written in Lisp.\n</p>\n

\n\n

\n<p>\nTo call a command, you simply have to press <b>Escape</b> and then <b>x</b>. It could be <b>Alt-x</b> for more comfort.\nThe official name is \"<i>Meta x</i>\" and is written <i>M-x</i>\n</p>\n

\n\n

\n<p>\nIf you type this key sequence, you will see at the bottom of the editor a little prompt.\nThis part of Emacs is called the <i>mini buffer</i> and is used for every interactive actions.\n</p>\n

\n\n

\n<p>\nLet's try something:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li>type <b>M-x</b>\n</li>\n<li>Then, in the minibuffer, type <b>version</b> and <b>RET</b> (return)\n</li>\n</ul>\n

\n\n

\n<p>\nEmacs should display the current version number of the software.\n</p>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/version.gif\" alt=\"version.gif\" />\n</p>\n<p><span class=\"figure-number\">Figure 1:</span> Execute the version command</p>\n</div>\n

\n\n

\n<p>\nCongratulations! You just called your first Emacs command.\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4-3\" class=\"outline-3\">\n<h3 id=\"sec-4-3\"><span class=\"section-number-3\">4.3</span> Key bindings</h3>\n<div class=\"outline-text-3\" id=\"text-4-3\">\n<p>\nHere are the most useful keys in Emacs. You will use them several hundreds (or thousands) times a day.\n</p>\n

\n\n

\n<p>\nHow it works?\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li>The sequence <i>C-something</i> means that you have to press and hold the <i>Control</i> key while hitting the <i>something</i> key. Example: <i>C-a</i> means <i>Control + a</i>.\n</li>\n<li>The sequence <i>C-something somethingelse</i> means that you press <i>Control + something</i>, then you release Control to hit <i>somethingelse</i>.\n</li>\n<li>The sequence <i>C-something C-somethingelse</i> means that you have to press Control while hitting <i>something</i> and <i>somethingelse</i>.\n</li>\n</ul>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4-3-1\" class=\"outline-4\">\n<h4 id=\"sec-4-3-1\"><span class=\"section-number-4\">4.3.1</span> Manipulate files</h4>\n<div class=\"outline-text-4\" id=\"text-4-3-1\">\n<ul class=\"org-ul\">\n<li><b>C-x C-f</b>: open a file, which corresponds to <b>M-x find-file</b>\n</li>\n<li><b>C-x C-s</b>: save a file, which corresponds to <b>M-x save-buffer</b>\n</li>\n</ul>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/open-and-save.gif\" alt=\"open-and-save.gif\" />\n</p>\n<p><span class=\"figure-number\">Figure 2:</span> Open a file, modify it and save it</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4-3-2\" class=\"outline-4\">\n<h4 id=\"sec-4-3-2\"><span class=\"section-number-4\">4.3.2</span> Manipulate the line</h4>\n<div class=\"outline-text-4\" id=\"text-4-3-2\">\n<ul class=\"org-ul\">\n<li><b>C-a</b>: go to the beginning of the current line, which corresponds to <b>M-x begining-of-line</b>\n</li>\n<li><b>C-e</b>: go to the end of the current line, which corresponds to <b>M-x end-of-line</b>\n</li>\n<li><b>C-k</b>: cut the rest of the line at the cursor position, which corresponds to <b>M-x kill-line</b>\n</li>\n<li><b>C-y</b>: paste what you had cut with the command above, which corresponds to <b>M-x yank</b>\n</li>\n<li><b>C-l</b>: center the buffer at the cursor position, which corresponds to <b>M-x recenter-top-bottom</b>\n</li>\n</ul>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/line.gif\" alt=\"line.gif\" />\n</p>\n<p><span class=\"figure-number\">Figure 3:</span> Line manipulation</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4-3-3\" class=\"outline-4\">\n<h4 id=\"sec-4-3-3\"><span class=\"section-number-4\">4.3.3</span> Selecting a region</h4>\n<div class=\"outline-text-4\" id=\"text-4-3-3\">\n<p>\nRegions are selections, in Emacs.\n</p>\n

\n\n

\n<p>\nThey are composed by two points. A starting one and and an ending one.\n</p>\n

\n\n

\n<p>\nTo select the starting point, move your cursor to the wanted location and simply press <b>C-Space</b>. In your minibuffer, you should have seen a message like \"Mark set\".\nNow, move your cursor to the location you wantyour selection to end.\n</p>\n

\n\n

\n<p>\nYou have now a selection (or a <i>region</i>) delimited by the place you set the first mark and your cursor. With this region, you can do what ever you want:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li>Copy (<b>M-w</b>)\n</li>\n<li>Cut (<b>C-k</b>)\n</li>\n<li>Paste (<b>C-y</b>)\n</li>\n<li>Replace (<b>M-%</b>)\n</li>\n<li>&#x2026; etc\n</li>\n</ul>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/selecting.gif\" alt=\"selecting.gif\" />\n</p>\n<p><span class=\"figure-number\">Figure 4:</span> Selecting a region</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4-3-4\" class=\"outline-4\">\n<h4 id=\"sec-4-3-4\"><span class=\"section-number-4\">4.3.4</span> Commenting</h4>\n<div class=\"outline-text-4\" id=\"text-4-3-4\">\n<p>\nIn order to comment a code block, select the region you want to comment and use:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><b>M-x comment-region</b> in order to comment the block\n</li>\n<li><b>M-x uncomment-region</b> in order to uncomment the block\n</li>\n</ul>\n

\n\n

\n<p>\nOf course, Emacs knows, according to the major mode loaded how to comment properly your code. If the major-mode is <i>ruby-mode</i>, it will add a \"#\" before the line; if the major-mode is <i>lisp-mode</i>, it will add \";;\", and so on and so forth.\n</p>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/comment.gif\" alt=\"comment.gif\" />\n</p>\n<p><span class=\"figure-number\">Figure 5:</span> Commenting</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4-3-5\" class=\"outline-4\">\n<h4 id=\"sec-4-3-5\"><span class=\"section-number-4\">4.3.5</span> Windows</h4>\n<div class=\"outline-text-4\" id=\"text-4-3-5\">\n<p>\nThis might be confusing but a <i>window</i> is a part of a <i>frame</i>.\n</p>\n

\n\n

\n<p>\nAn <i>Emacs frame</i> is the window that you opened when you launched Emacs.\n</p>\n

\n\n

\n<p>\nAn <i>Emacs frame</i> can be divided into <i>windows</i> in itself.\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><b>C-x 2</b>: open a new window horizontally, which corresponds to <b>M-x split-window-below</b>\n</li>\n<li><b>C-x 3</b>: open a new window vertically, which corresponds to <b>M-x split-window-right</b>\n</li>\n<li><b>C-x o</b>: switch to the next window, which corresponds to <b>M-x other-window</b>\n</li>\n<li><b>C-x 0</b>: close the current window, which corresponds to <b>M-x delete-window</b>\n</li>\n</ul>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/windows.gif\" alt=\"windows.gif\" />\n</p>\n<p><span class=\"figure-number\">Figure 6:</span> Windows manipulation</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4-3-6\" class=\"outline-4\">\n<h4 id=\"sec-4-3-6\"><span class=\"section-number-4\">4.3.6</span> Buffers</h4>\n<div class=\"outline-text-4\" id=\"text-4-3-6\">\n<p>\nA <i>buffer</i> is displayed in a <i>frame</i>.\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><b>C-x b</b>: switch to an already opened buffer, which corresponds to <b>M-x switch-to-buffer</b>\n</li>\n<li><b>C-x C-b</b>: list opened buffer (and jump to the selected one), which corresponds to <b>M-x list-buffers</b>\n</li>\n<li><b>C-x k</b>: kill a buffer, which corresponds to <b>M-x kill-buffer</b>\n</li>\n</ul>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/buffers.gif\" alt=\"buffers.gif\" />\n</p>\n<p><span class=\"figure-number\">Figure 7:</span> Buffer navigation</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4-3-7\" class=\"outline-4\">\n<h4 id=\"sec-4-3-7\"><span class=\"section-number-4\">4.3.7</span> Cancel a command</h4>\n<div class=\"outline-text-4\" id=\"text-4-3-7\">\n<ul class=\"org-ul\">\n<li><b>C-g</b> or <b>ESC ESC ESC</b>: cancel the current command running in the minibuffer, which corresponds to <b>M-x keyboard-quit</b>\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4-3-8\" class=\"outline-4\">\n<h4 id=\"sec-4-3-8\"><span class=\"section-number-4\">4.3.8</span> The most useless one</h4>\n<div class=\"outline-text-4\" id=\"text-4-3-8\">\n<ul class=\"org-ul\">\n<li><b>C-x C-c</b>: quit emacs (use at your own risks!), which corresponds to <b>M-x save-buffers-kill-terminal</b>\n</li>\n</ul>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-4-4\" class=\"outline-3\">\n<h3 id=\"sec-4-4\"><span class=\"section-number-3\">4.4</span> Help!</h3>\n<div class=\"outline-text-3\" id=\"text-4-4\">\n<p>\nEmacs has a powerful built-in help system for key bindings and internal functionalities.\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><b>C-h f &lt;function-name&gt;</b>: Find the key binding corresponding to &lt;function-name&gt; (ex: C-h f save-buffer)\n</li>\n<li><b>C-h k &lt;key-sequence&gt;</b>: Find the function name corresponding to &lt;key-sequence&gt; (ex: C-h k C-x C-s)\n</li>\n</ul>\n

\n\n

\n<p>\nWhen executing these commands, a new frame opens. To close it, switch to it (<i>C-x o</i>) and type <i>q</i>. If not, simply close it (<i>C-x 0</i>)\n</p>\n

\n\n

\n<p>\nEmacs also includes the full manual (also available online: <a href=\"http://www.gnu.org/software/emacs/manual/html_node/emacs/\">http://www.gnu.org/software/emacs/manual/html_node/emacs/</a>)\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><b>C-h r</b>: browse the Emacs manual within Emacs\n</li>\n</ul>\n

\n\n

\n<p>\nFinally, there are so many other help functions: <a href=\"http://www.emacswiki.org/emacs/EmacsNewbieHelpReference\">http://www.emacswiki.org/emacs/EmacsNewbieHelpReference</a>\n</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5\" class=\"outline-2\">\n<h2 id=\"sec-5\"><span class=\"section-number-2\">5</span> Building your own editor</h2>\n<div class=\"outline-text-2\" id=\"text-5\">\n<p>\nFrom this point, we will edit the configuration file.\nFor the moment, we will put everything in a single <b>~/.emacs.d/init.el</b> file. Create it if it does not exist.\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-sh\"><span style=\"color: #a5a5a5;\"># </span><span style=\"color: #a5a5a5;\">Backup old configuration</span>\ncp .emacs dot-emacs.old\ncp -R .emacs.d dot-emacs.d.old\n

\n\n

\n<span style=\"color: #a5a5a5;\"># </span><span style=\"color: #a5a5a5;\">Create new and empty configuration</span>\nmkdir ~/.emacs.d\ntouch ~/.emacs.d/init.el\n</pre>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-1\" class=\"outline-3\">\n<h3 id=\"sec-5-1\"><span class=\"section-number-3\">5.1</span> First basic configuration</h3>\n<div class=\"outline-text-3\" id=\"text-5-1\">\n<p>\nWhen you will have to change or add configuration, simply edit your <b>~/.emacs.d/init.el</b> file and add what you need.\n</p>\n

\n\n

\n<p>\nFor exemple, here is a tweak that does nothing visually but is useful for other packages and the Emacs engine itself.\nIt allows you to define your name and email. Emacs can use it to add author informations to a file when asked.\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\">(setq user-full-name <span style=\"color: #aa3939;\">\"Your full name\"</span>)\n(setq user-mail-address <span style=\"color: #aa3939;\">\"your@email.com\"</span>)\n</pre>\n</div>\n

\n\n

\n<p>\nAfter each configuration modification, two solutions:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li>the soft &amp; clever way: execute <b>M-x eval-buffer</b>\n</li>\n<li>the hard way: restart Emacs.\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-2\" class=\"outline-3\">\n<h3 id=\"sec-5-2\"><span class=\"section-number-3\">5.2</span> General basic configuration</h3>\n<div class=\"outline-text-3\" id=\"text-5-2\">\n<p>\nNow, let's move to a more visual configuration basic set.\nAs before, simply add this to your configuration file:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\"><span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Ask \"y\" or \"n\" instead of \"yes\" or \"no\". Yes, laziness is great.</span>\n(fset 'yes-or-no-p 'y-or-n-p)\n

\n\n

\n<span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Highlight corresponding parenthese when cursor is on one</span>\n(show-paren-mode t)\n

\n\n

\n<span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Highlight tabulations</span>\n(setq-default highlight-tabs t)\n

\n\n

\n<span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Show trailing white spaces</span>\n(setq-default show-trailing-whitespace t)\n

\n\n

\n<span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Remove useless whitespaces before saving a file</span>\n(add-hook 'before-save-hook 'whitespace-cleanup)\n(add-hook 'before-save-hook (<span style=\"color: #5FB7CC;\">lambda</span>() (delete-trailing-whitespace)))\n</pre>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-3\" class=\"outline-3\">\n<h3 id=\"sec-5-3\"><span class=\"section-number-3\">5.3</span> Backup files</h3>\n<div class=\"outline-text-3\" id=\"text-5-3\">\n<p>\nYou may have notice that the files you edit are duplicated and renamed with a <i>~</i> at the end.\nThey are the backup files that Emacs creates for you with an auto-save feature.\nSometimes it is great because you can recover a file in case of error, sometimes it is annoying because you can have some many of these files.\n</p>\n

\n\n

\n<p>\nIt is up to you to keep it or disable it.\nHere is the configuration for that:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\"><span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Remove all backup files</span>\n(setq make-backup-files nil)\n(setq backup-inhibited t)\n(setq auto-save-default nil)\n</pre>\n</div>\n

\n\n

\n<p>\nAn alternative method is to save these backups in a centralized folder:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\"><span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Save backup files in a dedicated directory</span>\n(setq backup-directory-alist '((<span style=\"color: #aa3939;\">\".\"</span> . <span style=\"color: #aa3939;\">\"~/.saves\"</span>)))\n</pre>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-4\" class=\"outline-3\">\n<h3 id=\"sec-5-4\"><span class=\"section-number-3\">5.4</span> Setting up the locales</h3>\n<div class=\"outline-text-3\" id=\"text-5-4\">\n<p>\nYou may want to set up a specific locale for your files.\nHere is the trick:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\"><span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Set locale to UTF8</span>\n(set-language-environment 'utf-8)\n(set-terminal-coding-system 'utf-8)\n(setq locale-coding-system 'utf-8)\n(set-default-coding-systems 'utf-8)\n(set-selection-coding-system 'utf-8)\n(prefer-coding-system 'utf-8)\n</pre>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-5\" class=\"outline-3\">\n<h3 id=\"sec-5-5\"><span class=\"section-number-3\">5.5</span> More configuration</h3>\n<div class=\"outline-text-3\" id=\"text-5-5\">\n<p>\nThe best way to get your configuration better, is to read the <a href=\"http://www.gnu.org/software/emacs/manual/\">manual</a> &#x2026;\nBut you can also (this is the un-official method) read the others Emacs users' config files.\nThere are so many people who share their configuration, comment their code, and distribute their modes!\n</p>\n

\n\n

\n<p>\nHere is mine: (<a href=\"https://github.com/pierre-lecocq/emacs.d\">https://github.com/pierre-lecocq/emacs.d</a>)\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-6\" class=\"outline-3\">\n<h3 id=\"sec-5-6\"><span class=\"section-number-3\">5.6</span> Modes</h3>\n<div class=\"outline-text-3\" id=\"text-5-6\">\n<p>\n<i>Modes</i> are Emacs' <i>extensions</i> that can be installed to extend the capabilities of Emacs. They will allow you to build a powerful tailored editor.\n</p>\n

\n\n

\n<p>\nThere are 2 kind of modes: minor and major.\n</p>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-6-1\" class=\"outline-4\">\n<h4 id=\"sec-5-6-1\"><span class=\"section-number-4\">5.6.1</span> Major modes</h4>\n<div class=\"outline-text-4\" id=\"text-5-6-1\">\n<p>\nMajor modes are modes that transform Emacs to a specialized software for editing a certain type of files (i.e c-mode) or managing special tasks (i.e reading emails, managing git repository, &#x2026;)\n</p>\n

\n\n

\n<p>\nOnly one major mode can be used at a time.\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-6-2\" class=\"outline-4\">\n<h4 id=\"sec-5-6-2\"><span class=\"section-number-4\">5.6.2</span> Minor modes</h4>\n<div class=\"outline-text-4\" id=\"text-5-6-2\">\n<p>\nMinor modes are additionnal modes that are added transparently to the major mode. They add more features to the main one (i.e parentheses matching, syntax or spelling checkers, &#x2026;)\n</p>\n

\n\n

\n<p>\nSeveral minor modes can be used at a time.\n</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-7\" class=\"outline-3\">\n<h3 id=\"sec-5-7\"><span class=\"section-number-3\">5.7</span> Package managers</h3>\n<div class=\"outline-text-3\" id=\"text-5-7\">\n<p>\nEmacs has brilliant package managers such as <i>package.el</i> or <i>el-get</i> that allows you to add and update modes really easily.\n</p>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-7-1\" class=\"outline-4\">\n<h4 id=\"sec-5-7-1\"><span class=\"section-number-4\">5.7.1</span> Package.el</h4>\n<div class=\"outline-text-4\" id=\"text-5-7-1\">\n<p>\n<i>package.el</i> is the built in package manager shipped by default with Emacs 24 or later.\n</p>\n

\n\n

\n<p>\nTo list available packages, simply type this command:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\">M-x package-list-packages\n</pre>\n</div>\n

\n\n

\n<p>\nYou will have a list of packages. Simply press ENTER on the name of one of it to install it.\n</p>\n

\n\n

\n<p>\nAdditionnaly, you can manage the packages list by adding other sources to your configuration file:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\"><span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Add package sources</span>\n(setq package-archives '((<span style=\"color: #aa3939;\">\"gnu\"</span> . <span style=\"color: #aa3939;\">\"http://elpa.gnu.org/packages/\"</span>)\n (<span style=\"color: #aa3939;\">\"marmalade\"</span> . <span style=\"color: #aa3939;\">\"http://marmalade-repo.org/packages/\"</span>)\n (<span style=\"color: #aa3939;\">\"melpa\"</span> . <span style=\"color: #aa3939;\">\"http://melpa.org/packages/\"</span>)))\n</pre>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-7-2\" class=\"outline-4\">\n<h4 id=\"sec-5-7-2\"><span class=\"section-number-4\">5.7.2</span> El-Get</h4>\n<div class=\"outline-text-4\" id=\"text-5-7-2\">\n<p>\n<i><a href=\"https://github.com/dimitri/el-get\">el-get</a></i> is one of the most popular and easy to use package manager. The \"<i>apt-get</i>\" of Emacs.\nIt is written by the great <a href=\"https://github.com/dimitri\">Dimitri Fontaine</a> and is based on recipe files that simply describe where is located the package and how to get/compile/install it for you.\n</p>\n

\n\n

\n<p>\nTo use it, simply add this to your configuration file. It will download and set up <i>el-get</i> for you:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\"><span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Set up el-get</span>\n(add-to-list 'load-path <span style=\"color: #aa3939;\">\"~/.emacs.d/el-get/el-get\"</span>)\n(<span style=\"color: #5FB7CC;\">unless</span> (<span style=\"color: #5FB7CC;\">require</span> '<span style=\"color: #8dd7e9;\">el-get</span> nil 'noerror)\n (with-current-buffer\n (url-retrieve-synchronously\n <span style=\"color: #aa3939;\">\"https://raw.github.com/dimitri/el-get/master/el-get-install.el\"</span>)\n (<span style=\"color: #5FB7CC;\">let</span> (el-get-master-branch)\n (goto-char (point-max))\n (eval-print-last-sexp))))\n</pre>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-7-3\" class=\"outline-4\">\n<h4 id=\"sec-5-7-3\"><span class=\"section-number-4\">5.7.3</span> The generic method</h4>\n<div class=\"outline-text-4\" id=\"text-5-7-3\">\n<p>\nIn order to leave you the choice of the package manager you want to use, here is a function that handles several package managers. For now, it covers <i>package.el</i> and <i>el-get</i>.\n</p>\n

\n\n

\n<p>\nIt also allows you to automatically install packages you want.\n</p>\n

\n\n

\n<p>\nIn the following snippet, two sample packages are installed\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><i>color-theme</i> in order to allow us to change colors themes\n</li>\n<li><i>autopair</i> in order to close automatically parentheses, brackets and braces when you open it\n</li>\n</ul>\n

\n\n

\n<p>\nSimply add this code to your configuration file:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\"><span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Set up the package manager of choice. Supports \"el-get\" and \"package.el\"</span>\n(setq pmoc <span style=\"color: #aa3939;\">\"el-get\"</span>)\n

\n\n

\n<span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">List of all wanted packages</span>\n(setq\n wanted-packages\n '(\n color-theme\n autopair\n))\n

\n\n

\n<span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Package manager and packages handler</span>\n(<span style=\"color: #5FB7CC;\">defun</span> <span style=\"color: #1D68C4;\">install-wanted-packages</span> ()\n <span style=\"color: #aa3939;\">\"Install wanted packages according to a specific package manager\"</span>\n (interactive)\n (<span style=\"color: #5FB7CC;\">cond</span>\n <span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">package.el</span>\n ((string= pmoc <span style=\"color: #aa3939;\">\"package.el\"</span>)\n (<span style=\"color: #5FB7CC;\">require</span> '<span style=\"color: #8dd7e9;\">package</span>)\n (add-to-list 'package-archives '(<span style=\"color: #aa3939;\">\"gnu\"</span> . <span style=\"color: #aa3939;\">\"http://elpa.gnu.org/packages/\"</span>))\n (add-to-list 'package-archives '(<span style=\"color: #aa3939;\">\"melpa\"</span> . <span style=\"color: #aa3939;\">\"http://melpa.org/packages/\"</span>))\n (add-to-list 'package-archives '(<span style=\"color: #aa3939;\">\"marmelade\"</span> . <span style=\"color: #aa3939;\">\"http://marmalade-repo.org/packages/\"</span>))\n (package-initialize)\n (<span style=\"color: #5FB7CC;\">let</span> ((need-refresh nil))\n (mapc (<span style=\"color: #5FB7CC;\">lambda</span> (package-name)\n (<span style=\"color: #5FB7CC;\">unless</span> (package-installed-p package-name)\n (set 'need-refresh t))) wanted-packages)\n (<span style=\"color: #5FB7CC;\">if</span> need-refresh\n (package-refresh-contents)))\n (mapc (<span style=\"color: #5FB7CC;\">lambda</span> (package-name)\n (<span style=\"color: #5FB7CC;\">unless</span> (package-installed-p package-name)\n (package-install package-name))) wanted-packages)\n )\n <span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">el-get</span>\n ((string= pmoc <span style=\"color: #aa3939;\">\"el-get\"</span>)\n (add-to-list 'load-path <span style=\"color: #aa3939;\">\"~/.emacs.d/el-get/el-get\"</span>)\n (<span style=\"color: #5FB7CC;\">unless</span> (<span style=\"color: #5FB7CC;\">require</span> '<span style=\"color: #8dd7e9;\">el-get</span> nil 'noerror)\n (with-current-buffer\n (url-retrieve-synchronously\n <span style=\"color: #aa3939;\">\"https://raw.github.com/dimitri/el-get/master/el-get-install.el\"</span>)\n (<span style=\"color: #5FB7CC;\">let</span> (el-get-master-branch)\n (goto-char (point-max))\n (eval-print-last-sexp))))\n (el-get 'sync wanted-packages))\n <span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">fallback</span>\n (t (<span style=\"color: #ffc0cb; font-weight: bold;\">error</span> <span style=\"color: #aa3939;\">\"Unsupported package manager\"</span>)))\n )\n

\n\n

\n<span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">Install wanted packages</span>\n(install-wanted-packages)\n</pre>\n</div>\n

\n\n

\n<p>\nNote that some of the following package names could vary if you use <i>package.el</i> or <i>el-get</i>.\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-7-4\" class=\"outline-4\">\n<h4 id=\"sec-5-7-4\"><span class=\"section-number-4\">5.7.4</span> The modern and efficient way</h4>\n<div class=\"outline-text-4\" id=\"text-5-7-4\">\n<p>\nSome upper-level packages make package management easier and cleaner.\n</p>\n

\n\n

\n<p>\nFor example, John Wiegley's <code>use-package</code> software is an elegant and efficient way to install and tidy your external packages configurations.\n</p>\n

\n\n

\n<p>\nHere is the way to use it:\n</p>\n

\n\n

\n<p>\nFirst, setup packages sources and install <code>use-package</code>\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\">(<span style=\"color: #5FB7CC;\">require</span> '<span style=\"color: #8dd7e9;\">package</span>)\n(setq package-archives '((<span style=\"color: #aa3939;\">\"gnu\"</span> . <span style=\"color: #aa3939;\">\"http://elpa.gnu.org/packages/\"</span>)\n (<span style=\"color: #aa3939;\">\"marmalade\"</span> . <span style=\"color: #aa3939;\">\"http://marmalade-repo.org/packages/\"</span>)\n (<span style=\"color: #aa3939;\">\"melpa\"</span> . <span style=\"color: #aa3939;\">\"http://melpa.org/packages/\"</span>)))\n(package-initialize)\n

\n\n

\n(<span style=\"color: #5FB7CC;\">unless</span> (package-installed-p 'use-package)\n (<span style=\"color: #5FB7CC;\">progn</span>\n (package-refresh-contents)\n (package-install 'use-package)))\n

\n\n

\n(<span style=\"color: #5FB7CC;\">require</span> '<span style=\"color: #8dd7e9;\">use-package</span>)\n</pre>\n</div>\n

\n\n

\n<p>\nThen, for each package you want to install, simply add this to your configuration (replace <i>the-package-name</i> by any package name):\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-LISP\">(use-package the-package-name\n

\n

\n:ensure the-package-name\n

\n

\n :init (progn\n ;; Do something after the package is initialized\n ))\n</pre>\n</div>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8\" class=\"outline-3\">\n<h3 id=\"sec-5-8\"><span class=\"section-number-3\">5.8</span> Some useful packages</h3>\n<div class=\"outline-text-3\" id=\"text-5-8\">\n<p>\nAs a developer, you will need some packages that will help you to work, increase your productivity and enhance your confort while coding.\nPlease note that even if I am a Ruby/shell/Lisp/web/PHP developer, some packages are compatible and useful for every kind of development. Therefore, the base packages are listed here but some specific packages that might be useful for your work are eventually not listed here. It is up to you to adapt the list according to your needs!\n</p>\n

\n\n

\n<p>\nTip: After adding packages, restart Emacs in order to let <i>el-get</i> download and install it properly.\n</p>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-1\" class=\"outline-4\">\n<h4 id=\"sec-5-8-1\"><span class=\"section-number-4\">5.8.1</span> Auto complete</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-1\">\n<p>\nAuto completion is a must-have feature in the development world.\nThis package simply displays a popup at the cursor position with the available completions.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>auto-complete</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/emacs/AutoComplete\">Read more</a>\n</p>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/mode-autocomplete.gif\" alt=\"mode-autocomplete.gif\" />\n</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-2\" class=\"outline-4\">\n<h4 id=\"sec-5-8-2\"><span class=\"section-number-4\">5.8.2</span> Autopair</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-2\">\n<p>\nWhen you open a quote/parenthese/bracket/curly bracket, this mode automatically adds the closed one and bring your cusror between the two.\nVery useful to avoid syntax errors, for example.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>autopair</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"https://github.com/capitaomorte/autopair\">Read more</a>\n</p>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/mode-autopair.gif\" alt=\"mode-autopair.gif\" />\n</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-3\" class=\"outline-4\">\n<h4 id=\"sec-5-8-3\"><span class=\"section-number-4\">5.8.3</span> Buffer move</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-3\">\n<p>\nThis mode allows you to re-organize and move the buffers from a window to another.\nUseful if you want to switch buffer places in order to have your debugging buffer on the right side, for example.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>buffer-move</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/cgi-bin/wiki/buffer-move.el\">Read more</a>\n</p>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/mode-buffermove.gif\" alt=\"mode-buffermove.gif\" />\n</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-4\" class=\"outline-4\">\n<h4 id=\"sec-5-8-4\"><span class=\"section-number-4\">5.8.4</span> Flycheck</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-4\">\n<p>\nThis mode check the syntax of a buffer. It could be used for checking code syntax or typos when writing any kind of text.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>flycheck</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"https://github.com/flycheck/flycheck\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-5\" class=\"outline-4\">\n<h4 id=\"sec-5-8-5\"><span class=\"section-number-4\">5.8.5</span> Highlight symbol</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-5\">\n<p>\nThis mode highlights all symbols that matches a pattern in your buffer\n</p>\n

\n\n

\n<p>\nTo install it, add <code>highlight-symbol</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/emacs/HighlightSymbol\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-6\" class=\"outline-4\">\n<h4 id=\"sec-5-8-6\"><span class=\"section-number-4\">5.8.6</span> Ido</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-6\">\n<p>\nIdo is a must have mode to navigate, find stuffs, and do things interactively.\nIt is for comfort, but is indispensable to go fast.\n</p>\n

\n\n

\n<p>\nMany extensions of this mode are available, therefore read and chose what you want.\n</p>\n

\n\n

\n<p>\nI personnaly use two of them: <i>vertical</i> and <i>hack</i>.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>ido-hacks</code> and <code>ido-vertical-mode</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/emacs/InteractivelyDoThings\">Read more</a>\n</p>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/mode-ido.gif\" alt=\"mode-ido.gif\" />\n</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-7\" class=\"outline-4\">\n<h4 id=\"sec-5-8-7\"><span class=\"section-number-4\">5.8.7</span> JS3</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-7\">\n<p>\nThis mode is an enhanced mode for editing Javascript files. I do not use it a lot, but it is useful for some javascript-like or NPM files.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>js3-mode</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/emacs/Js2Mode\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-8\" class=\"outline-4\">\n<h4 id=\"sec-5-8-8\"><span class=\"section-number-4\">5.8.8</span> Magit</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-8\">\n<p>\nMagit is a very powerful and elegant mode for intercating with your git repository.\nIn order to understand how powerful it is, simply watch this amazing <a href=\"http://vimeo.com/2871241\">video</a>\n</p>\n

\n\n

\n<p>\nTo install it, add <code>magit</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"https://github.com/magit/magit\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-9\" class=\"outline-4\">\n<h4 id=\"sec-5-8-9\"><span class=\"section-number-4\">5.8.9</span> Multiple cursors</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-9\">\n<p>\nThis mode is great and super powerful. Instead of explaining what it is, check this amazing <a href=\"http://emacsrocks.com/e13.html\">video</a> by Magnars.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>multiple-cursors</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"https://github.com/magnars/multiple-cursors.el\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-10\" class=\"outline-4\">\n<h4 id=\"sec-5-8-10\"><span class=\"section-number-4\">5.8.10</span> PHP mode</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-10\">\n<p>\nA basic but stable mode for editing PHP files, whatever you think about PHP &#x2026;\n</p>\n

\n\n

\n<p>\nTo install it, add <code>php-mode</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"http://php-mode.sourceforge.net/\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-11\" class=\"outline-4\">\n<h4 id=\"sec-5-8-11\"><span class=\"section-number-4\">5.8.11</span> Rainbow mode</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-11\">\n<p>\nA useless but indispensable mode to add colors to your CSS files when using properties like \"color\", \"background-color\".\nIt is cool since it understands every way to write a color (hex, name, &#x2026;) and gives you a preview of the color itself.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>rainbow-mode</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"http://julien.danjou.info/projects/emacs-packages\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-12\" class=\"outline-4\">\n<h4 id=\"sec-5-8-12\"><span class=\"section-number-4\">5.8.12</span> RHTML mode</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-12\">\n<p>\nThis mode is useful for editing .rhtml files. You can also use it to edit any kinf of ruby templates (i.e .erb).\n</p>\n

\n\n

\n<p>\nTo install it, add <code>rhtml-mode</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"https://github.com/eschulte/rhtml\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-13\" class=\"outline-4\">\n<h4 id=\"sec-5-8-13\"><span class=\"section-number-4\">5.8.13</span> Ruby mode</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-13\">\n<p>\nDo I really need to explain ?\n</p>\n

\n\n

\n<p>\nRuby mode is already installed in Emacs and is very stable.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/emacs/RubyMode\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-14\" class=\"outline-4\">\n<h4 id=\"sec-5-8-14\"><span class=\"section-number-4\">5.8.14</span> Switch window</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-14\">\n<p>\nThis mode is cool when you work with a lot of windows opened.\nIf you want to switch to another one, you have to press <b>C-x o</b> until you reach the wanted window.\nWith this mode, when you press <b>C-x o</b>, big numbers replace your opened windows. Simply type the corresponding number to reach the wanted window.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>switch-window</code> to your packages list.\n</p>\n

\n\n

\n<p>\nThen do not forget to override the defaut configuration by adding this to your configuration:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\">(global-set-key (kbd <span style=\"color: #aa3939;\">\"C-x o\"</span>) 'switch-window)\n</pre>\n</div>\n

\n\n

\n<p>\n<a href=\"https://github.com/dimitri/switch-window\">Read more</a>\n</p>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/mode-switchwindow.gif\" alt=\"mode-switchwindow.gif\" />\n</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-15\" class=\"outline-4\">\n<h4 id=\"sec-5-8-15\"><span class=\"section-number-4\">5.8.15</span> Visual regexp</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-15\">\n<p>\nThis mode highlights the text that matches the regexp that you are writing in the mini buffer.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>visual-regexp</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"https://github.com/benma/visual-regexp.el\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-16\" class=\"outline-4\">\n<h4 id=\"sec-5-8-16\"><span class=\"section-number-4\">5.8.16</span> Yaml mode</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-16\">\n<p>\nAlows you to edit .yml files\n</p>\n

\n\n

\n<p>\nTo install it, add <code>yaml-mode</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/emacs/YamlMode\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-17\" class=\"outline-4\">\n<h4 id=\"sec-5-8-17\"><span class=\"section-number-4\">5.8.17</span> Yasnippet</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-17\">\n<p>\nA mode that allows you to write code faster if you are lazy.\nIt is very easy to create your own snippets and use it whatever the file you are editing (code, non-code, emails, &#x2026;)\n</p>\n

\n\n

\n<p>\nI personnaly do not use it, but people coming from Textmate/Sublime would love it.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>yasnippet</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/emacs/Yasnippet\">Read more</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-8-18\" class=\"outline-4\">\n<h4 id=\"sec-5-8-18\"><span class=\"section-number-4\">5.8.18</span> Paredit</h4>\n<div class=\"outline-text-4\" id=\"text-5-8-18\">\n<p>\nParedit is a really cool mode to \"keep parentheses balanced\" and navigating in the S-expressions. Useful and indispensable if you write Lisp code, for example.\n</p>\n

\n\n

\n<p>\nTo install it, add <code>paredit</code> to your packages list.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/emacs/ParEdit\">Read more</a>\n</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-9\" class=\"outline-3\">\n<h3 id=\"sec-5-9\"><span class=\"section-number-3\">5.9</span> Code navigation</h3>\n<div class=\"outline-text-3\" id=\"text-5-9\">\n<p>\nNavigate through source code is an indispensable feature in code editors. Some of other editors are focused on this (like Sublime) but the problem is that they do not leave you the choices of the weapons (like every other features).\n</p>\n

\n\n

\n<p>\nEmacs, as you noticed (yes, you did) can integrate any external tool or include a large variety of internal tools to make it more efficient. Code navigation is not an exception.\n</p>\n

\n\n

\n<p>\nThere are a lot of packages in order to navigate through code, with different methodologies and advantages:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><a href=\"http://www.emacswiki.org/emacs/EmacsTags\">TAGS</a> (built in. No installation required)\n</li>\n<li><a href=\"https://github.com/bbatsov/projectile\">Projectile</a> (install it by adding <code>projectile</code> to your packages list)\n</li>\n<li><a href=\"https://github.com/emacs-helm/helm\">Helm</a> (install it by adding <code>heml</code> to your packages list)\n</li>\n<li><a href=\"http://cedet.sourceforge.net/\">Emacs CEDET</a> (install it by adding <code>cedet</code> to your packages list)\n</li>\n<li>&#x2026;\n</li>\n</ul>\n

\n\n

\n<p>\n(Note: use once at a time! You do not need to install them all)\n</p>\n

\n\n

\n<p>\nAfter using <i>Projectile</i> for a certain period of time, I gave <i>Helm</i> a shot but finally got back to the simplicity and the efficiency of the <i>TAGS</i> system.\nNevertheless, <i>Projectile</i> and <i>Helm</i> are really powerful and useful. You really should look at them.\n</p>\n

\n\n

\n<p>\nFor now, I will cover the basics of <i>TAGS</i> since it is a standard (used by other softwares) and it is built-in (so if you use another Emacs without your config, you still know how to surf in the code). And other useful tricks will be shown here.\n</p>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-9-1\" class=\"outline-4\">\n<h4 id=\"sec-5-9-1\"><span class=\"section-number-4\">5.9.1</span> Tags basics</h4>\n<div class=\"outline-text-4\" id=\"text-5-9-1\">\n<p>\nBasically, the TAGS rely on an index file of the content of your code source.\nIn the root folder of a project, you must generate your index.\nSeveral methods for this, but here is one command that generates the file:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-sh\"><span style=\"color: #7FFFD4;\">cd</span> /path/to/your/project\nfind . -regex <span style=\"color: #aa3939;\">\".*\\.\\(c\\|h\\|rb\\|py\\|php\\|js\\|sh\\|bash\\)\"</span> -print | xargs etags -a\n</pre>\n</div>\n

\n\n

\n<p>\nYou now should see a \"TAGS\" file. If needed, exclude this file from your git/svn/whatever repository/.\n</p>\n

\n\n

\n<p>\nYou are now ready to surf!\n</p>\n

\n\n

\n<p>\nNow, here are the main commands to use them:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><b>M-.</b> is the equivalent of <b>M-x find-tag</b>: find a tag\n</li>\n<li><b>M-x find-tag-other-window</b>: find a tag, but in another window\n</li>\n<li><b>M-x tags-search</b>: find a tag thanks to a regexp\n</li>\n<li><b>M-x tags-query-replace</b>: replace a tag in all the indexed files\n</li>\n<li><b>M-x tags-apropos</b>: list all tags that match a regexp\n</li>\n<li><b>M-x list-tags</b>: list all tags in a file\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-9-2\" class=\"outline-4\">\n<h4 id=\"sec-5-9-2\"><span class=\"section-number-4\">5.9.2</span> List functions or methods</h4>\n<div class=\"outline-text-4\" id=\"text-5-9-2\">\n<p>\nIn order to list and jump easily between the functions or methods of the current file, here is a little trick:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-emacs-lisp\">(global-set-key (kbd <span style=\"color: #aa3939;\">\"C-S-f\"</span>) 'imenu) <span style=\"color: #a5a5a5;\">;; </span><span style=\"color: #a5a5a5;\">use iMenu</span>\n</pre>\n</div>\n

\n\n

\n<p>\nAfter pressing Ctrl-Shift-f (replace it by whatever you want!), a menu with all the available resources appears in the minibuffer.\nSelect the resource you want (let's say <i>All.methods</i> if you are editing some code) and you will be able to search and jump to a method definition directly.\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-9-3\" class=\"outline-4\">\n<h4 id=\"sec-5-9-3\"><span class=\"section-number-4\">5.9.3</span> Files navigation (a.k.a fuzzy matching) with TAGS and ido</h4>\n<div class=\"outline-text-4\" id=\"text-5-9-3\">\n<p>\nIn order to find and jump easily to a file in your project thanks to TAGS, you have to add a little function to your confiugration.\nFor this you should have installed the <code>ido-mode</code> described above.\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-emacs-lisp\">(<span style=\"color: #5FB7CC;\">defun</span> <span style=\"color: #1D68C4;\">ido-find-file-in-tag-files</span> ()\n (interactive)\n (<span style=\"color: #5FB7CC;\">save-excursion</span>\n (<span style=\"color: #5FB7CC;\">let</span> ((enable-recursive-minibuffers t))\n (visit-tags-table-buffer))\n (find-file\n (expand-file-name\n (ido-completing-read\n <span style=\"color: #aa3939;\">\"Project file: \"</span> (tags-table-files) nil t)))))\n

\n\n

\n(global-set-key (kbd <span style=\"color: #aa3939;\">\"C-S-x C-S-f\"</span>) 'ido-find-file-in-tag-files)\n</pre>\n</div>\n

\n\n

\n<p>\nNow, in your project folder and once you generated your TAGS file, you can press <b>C-S-x C-S-f</b> to find files through the whole tree of directories just by typing a pattern.\n</p>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/fuzzy.gif\" alt=\"fuzzy.gif\" />\n</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-9-4\" class=\"outline-4\">\n<h4 id=\"sec-5-9-4\"><span class=\"section-number-4\">5.9.4</span> RGrep</h4>\n<div class=\"outline-text-4\" id=\"text-5-9-4\">\n<p>\n<i>rgrep</i> is a great tool to use in addition of the TAGS. It is a Unix tool that make <i>grep</i> queries recursively. In Emacs, it will bring you a new buffer with all the results of the command. To use it, simply type:\n</p>\n

\n\n

\n<p>\n<b>M-x rgrep RET yoursearchterm RET</b>\n</p>\n

\n\n

\n<p>\nOnce fired, you can swith to the newly created buffer, parse the results and jump to the wanted files very quickly.\n</p>\n

\n\n

\n<p>\nWhat is cool is that it is integrated in the editor, just beside your code and does not require to switch to a shell and then copy-paste the files path you want.\n</p>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/rgrep.gif\" alt=\"rgrep.gif\" />\n</p>\n</div>\n</div>\n</div>\n</div>\n

\n\n\n

\n<div id=\"outline-container-sec-5-10\" class=\"outline-3\">\n<h3 id=\"sec-5-10\"><span class=\"section-number-3\">5.10</span> Setting a color theme</h3>\n<div class=\"outline-text-3\" id=\"text-5-10\">\n<p>\nNow, we are talking about something very touchy and that can be a long quest &#x2026;\n</p>\n

\n\n

\n<p>\nA color theme generally includes colors for:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li>background\n</li>\n<li>syntax color (for code)\n</li>\n<li>specific modes colors (gnus, dired, git, &#x2026;)\n</li>\n</ul>\n

\n\n

\n<p>\nThere are several ways to install a color theme, but first, we will use the Emacs' internal color-theme library.\n</p>\n

\n\n

\n<p>\nLet's try to switch between different themes:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li>Type <b>M-x load-theme RET tango-dark</b>\n</li>\n<li>Then type <b>M-x load-theme RET wombat</b>\n</li>\n<li>Finally type <b>M-x load-theme RET whiteboard</b>\n</li>\n</ul>\n

\n\n

\n<p>\nThere is no secret or perfect color theme. There are so many of theme and each user has its preferences in term of colors.\n</p>\n

\n\n\n

\n<div class=\"figure\">\n<p><img src=\"../images/colors.gif\" alt=\"colors.gif\" />\n</p>\n<p><span class=\"figure-number\">Figure 15:</span> color themes</p>\n</div>\n

\n\n

\n<p>\nIn order to choose yours, try the default ones, see this <a href=\"http://gnuemacscolorthemetest.googlecode.com/svn/html/index-el.html\">showcase</a>, make your own or google a lot !\n</p>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-5-10-1\" class=\"outline-4\">\n<h4 id=\"sec-5-10-1\"><span class=\"section-number-4\">5.10.1</span> Font settings</h4>\n<div class=\"outline-text-4\" id=\"text-5-10-1\">\n<p>\nAfter setting up your theme, there are some other tweaks that are \"color theme related\".\nFonts is something very important depending on your system, your screen size, your current task in Emacs, &#x2026; etc\n</p>\n

\n\n

\n<p>\nIf you want to change the font directly from your current Emacs instance, simply type <b>M-x set-frame-font RET</b>.\nAnd if you want to see all supported fonts, type <b>TAB</b> twice. It will show you a list.\n</p>\n

\n\n

\n<p>\nThe global and easy way to do it is to add a line to your configuration:\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\">(set-default-font <span style=\"color: #aa3939;\">\"DejaVu Sans Mono-10\"</span>)\n</pre>\n</div>\n

\n\n

\n<p>\nBut to be safe, you'd better add this into your X resource settings file (~/.Xresources):\n</p>\n

\n\n

\n<div class=\"org-src-container\">\n

\n\n

\n<pre class=\"src src-lisp\">emacs.font: DejaVu Sans Mono-10\n</pre>\n</div>\n

\n\n

\n<p>\nOf course, it is possible to set a different font for any system or mode you want. It is cool since you can use different font (size) if you are on Linux or mac OR if you write a book, write code, read your emails, &#x2026; etc.\nAs an exercise, I'll let you search how to do this kind of stuff in Emacs Lisp if you need it.\n</p>\n

\n\n

\n<p>\nIf you want more about font settings and especially about font names, please see the <a href=\"http://www.emacswiki.org/emacs/SetFonts\">Emacs wiki page</a> or the <a href=\"http://www.gnu.org/software/emacs/manual/html_node/emacs/Fonts.html\">manual</a>.\n</p>\n

\n\n

\n<p>\nA last point: sometimes you want to change the font size of your current buffer. To do this, simply type:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><b>M-x text-scale-increase</b> or <b>C-x C-+</b>\n</li>\n<li><b>M-x text-scale-decrease</b> or <b>C-x C–</b> (Ctrl x, Ctrl dash)\n</li>\n</ul>\n

\n\n

\n<p>\nReally handy if you show your screen through an external display or you want to focus on a specific part of a file.\n</p>\n</div>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-6\" class=\"outline-2\">\n<h2 id=\"sec-6\"><span class=\"section-number-2\">6</span> Emacs for developers - Emacs developing environments</h2>\n<div class=\"outline-text-2\" id=\"text-6\">\n<p>\nEmacs, thanks to major or minor modes can be transformed into a powerful specific environment.\n</p>\n

\n\n

\n<p>\nAccording to the kind of files you are editing (or a command you type), it can mutate and give you specific features that fits the need of a programming language (or a task like debugging, launching unit tests, &#x2026;)\n</p>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-6-1\" class=\"outline-3\">\n<h3 id=\"sec-6-1\"><span class=\"section-number-3\">6.1</span> Emacs for Ruby developers</h3>\n<div class=\"outline-text-3\" id=\"text-6-1\">\n<p>\nThere are many ruby developer who decribe their set up around the web. Here are the most popular:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><a href=\"http://devblog.avdi.org/category/emacs-reboot/\">The Emacs reboot serie, by Avdi Grimm</a> (Avdi is a famous ruby programmer and a great Emacs hacker)\n</li>\n<li><a href=\"http://crypt.codemancers.com/posts/2013-09-26-setting-up-emacs-as-development-environment-on-osx/\">Setting up Emacs as Ruby development environment on OSX</a> (even if it is for OSX, the packages remain the same on all OSes)\n</li>\n<li><a href=\"http://lorefnon.me/2014/02/02/configuring-emacs-for-rails.html\">Configuring Emacs as a productive development environment for Rails development</a>\n</li>\n<li><a href=\"http://www.emacswiki.org/emacs/RubyOnRails\">The EmacsWiki on Ruby and RoR</a>\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-6-2\" class=\"outline-3\">\n<h3 id=\"sec-6-2\"><span class=\"section-number-3\">6.2</span> Emacs for Python developers</h3>\n<div class=\"outline-text-3\" id=\"text-6-2\">\n<p>\nHere are some resources about setting Emacs for developing in python:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><a href=\"http://caisah.info/emacs-for-python/\">Emacs for python - on caisah.info</a>\n</li>\n<li><a href=\"http://www.emacswiki.org/emacs/PythonProgrammingInEmacs\">Python programming in Emacs - on the EmacsWiki</a>\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-6-3\" class=\"outline-3\">\n<h3 id=\"sec-6-3\"><span class=\"section-number-3\">6.3</span> Emacs for C/C++/Objective-C</h3>\n<div class=\"outline-text-3\" id=\"text-6-3\">\n<p>\nC languages are very well handled by Emacs and it allows you to edit, debug and run programs with Emacs very easily, with all the control you want.\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><a href=\"http://tuhdo.github.io/c-ide.html\">C/C++ Development Environment for Emacs</a> is a very complete article about this\n</li>\n<li><a href=\"http://stackoverflow.com/questions/5800317/emacs-as-a-c-programming-ide-configuration\">A various tips and packages for C language(s)</a> on StackOverflow\n</li>\n<li><a href=\"http://truongtx.me/2013/03/10/emacs-setting-up-perfect-environment-for-cc-programming/\">Setting up perfect environment for C/C++ Programming</a> (according to its auhor. Good resource, though)\n</li>\n<li><a href=\"http://www.emacswiki.org/emacs/DebuggingWithEmacs\">Debugging with Emacs</a>\n</li>\n<li><a href=\"http://cedet.sourceforge.net/\">CEDET - Collection of Emacs Development Environment Tools</a> An amazing collection of tools for developping in many programming languages, especially for C/C++\n</li>\n<li><a href=\"http://alexott.net/en/writings/emacs-devenv/EmacsCedet.html\">How to configure CEDET</a>\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-6-4\" class=\"outline-3\">\n<h3 id=\"sec-6-4\"><span class=\"section-number-3\">6.4</span> Emacs for Go developers</h3>\n<div class=\"outline-text-3\" id=\"text-6-4\">\n<ul class=\"org-ul\">\n<li>If you develop in Go, you really should refer to the great <a href=\"http://yousefourabi.com/blog/2014/05/emacs-for-go/\">Emacs for Go</a> article, written by Yousef Ourabi.\n</li>\n<li>Another one, with videos, is written by Dominik Honnef: <a href=\"http://dominik.honnef.co/posts/2013/03/writing_go_in_emacs/\">Writing Go in Emacs</a>\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-6-5\" class=\"outline-3\">\n<h3 id=\"sec-6-5\"><span class=\"section-number-3\">6.5</span> Emacs for PHP developers</h3>\n<div class=\"outline-text-3\" id=\"text-6-5\">\n<p>\nPHP, along with all the web technologies (HTML/JS/CSS) are very well supported in Emacs. The PHP mode does almost all the job by itself.\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><a href=\"http://www.emacswiki.org/emacs/PhpMode\">The EmacsWiki page about php-mode and other assicated packages</a>\n</li>\n<li><a href=\"http://stackoverflow.com/questions/912671/what-is-a-good-setup-for-editing-php-in-emacs\">A list of useful packages for PHP - on StackOverflow</a>\n</li>\n<li><a href=\"https://drupal.org/node/59868\">An example setup for working on Drupal</a> (but can be used for PHP in general)\n</li>\n<li><a href=\"https://code.google.com/p/geben-on-emacs/\">GEBEN - remote debugging environment for Emacs</a>\n</li>\n<li><a href=\"http://web-mode.org/\">Web Mode - focused on web templates (HTML/JS/CSS)</a>\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-6-6\" class=\"outline-3\">\n<h3 id=\"sec-6-6\"><span class=\"section-number-3\">6.6</span> Emacs for Java developers</h3>\n<div class=\"outline-text-3\" id=\"text-6-6\">\n<p>\nJava development is held by Eclipse. But it is not the only editor/environment that allows you to develop in Java !\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><a href=\"http://jdee.sourceforge.net/\">JDEE - the Java Development Environment for Emacs</a>\n</li>\n<li><a href=\"http://www.emacswiki.org/emacs/JavaDevelopmentEnvironment\">The EmacsWiki article on JDEE</a>\n</li>\n<li><a href=\"http:\">A video demo of a full Java environment on Emacs</a>\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-6-7\" class=\"outline-3\">\n<h3 id=\"sec-6-7\"><span class=\"section-number-3\">6.7</span> Emacs for R and statistics</h3>\n<div class=\"outline-text-3\" id=\"text-6-7\">\n<p>\nEmacs is very useful for scientists and people dealing with data. Statistics, analysis, plotting, &#x2026; everything can be done within Emacs.\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><a href=\"https://github.com/vikasrawal/orgpaper/blob/master/orgpapers.org\">An amazing paper on working with Emacs, OrgMode and R</a>\n</li>\n<li><a href=\"http://ess.r-project.org/\">Emacs Speaks Statistics</a> is a great project that adds a full statistics environment to your Emacs\n</li>\n<li><a href=\"http://stats.blogoverflow.com/2011/08/using-emacs-to-work-with-r/\">A tutorial on using ESS</a>\n</li>\n</ul>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-7\" class=\"outline-2\">\n<h2 id=\"sec-7\"><span class=\"section-number-2\">7</span> Special features</h2>\n<div class=\"outline-text-2\" id=\"text-7\">\n</div><div id=\"outline-container-sec-7-1\" class=\"outline-3\">\n<h3 id=\"sec-7-1\"><span class=\"section-number-3\">7.1</span> Emacs as a file manager</h3>\n<div class=\"outline-text-3\" id=\"text-7-1\">\n<p>\nEmacs has a built-in mode named <i>dired</i> that allows you to manage your file system directly in Emacs really easily.\nIt is very powerful and has features that graphical file managers do not have.\n</p>\n

\n\n

\n<p>\nFirst of all, to launch it, type:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><b>M-x dired RET</b> and then select a path to open (default is the directory of the file you are editing)\n</li>\n<li>or <b>C-x d</b> if you prefer keybindings\n</li>\n</ul>\n

\n\n

\n<p>\nHere are a few quick shortcuts once you are in <i>dired mode</i>\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li><b>R</b> (capital R): rename a file\n</li>\n<li><b>D</b> (capital D): delete a file\n</li>\n<li><b>+</b>: create a new directory\n</li>\n<li><b>Z</b>: compress the file\n</li>\n<li><b>RET</b> (enter): Open the file\n</li>\n<li><b>g</b>: refresh\n</li>\n<li><b>q</b>: close the dired window\n</li>\n</ul>\n

\n\n

\n<p>\nOf course, files can be marked to operate on a selection of them. Use <b>m</b> to mark, <b>u</b> to unmark (<b>U</b> to unmark all), <b>% m</b> to mark according to a pattern.\n</p>\n

\n\n

\n<p>\nNote that there are so many tricks, extensions and features in <i>dired mode</i> that I let you see around what you need.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/emacs/DiredMode\">Read more about Dired</a>\n</p>\n

\n\n

\n<p>\n<a href=\"https://www.gnu.org/software/emacs/manual/html_node/emacs/Dired.html\">Read the manual</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-7-2\" class=\"outline-3\">\n<h3 id=\"sec-7-2\"><span class=\"section-number-3\">7.2</span> Working locally vs remotely</h3>\n<div class=\"outline-text-3\" id=\"text-7-2\">\n<p>\nEmacs, once installed on your machine will allow you to edit your file locally, obviously.\n</p>\n

\n\n

\n<p>\nOther people (non-Emacs users) will do a dirty trick to edit remote files like they were local files. They will mount the remote directory on their machine (thanks to <i>sshfs</i>).\nBut the magic in Emacs is that you can transparently edit remote files on your development servers for example.\nTo do so, Emacs comes with a genious extension named \"Tramp\". It is alreay installed and available when you install Emacs.\n</p>\n

\n\n

\n<p>\nIf you press <b>C-x C-f</b>, you can open a file. But if you ask <code>myname@myserver.com:/path/to/file</code>, it will automatically connect to the server and let you edit the remote file. Easy as pie.\n<i>Tramp</i> supports lots of protocols like ssh, ftp, and so on.\n</p>\n

\n\n

\n<p>\nAnd what is great is that if you are editing a remote file and you launch a shell in Emacs, it will automatically set the shell into your remote environment and open it as if you were in the remote directory the file is in.\n</p>\n

\n\n

\n<p>\nA last tip about TRAMP. If you simply add <code>sudo:</code> in front of your file path, you edit your file with higher privileges. It is a very useful feature if you need to edit your configuration files on a server, for example. Of course, it works remotely and locally.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/emacs/TrampMode\">Read more about Tramp</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-7-3\" class=\"outline-3\">\n<h3 id=\"sec-7-3\"><span class=\"section-number-3\">7.3</span> Organize your work, write papers and manage your agenda</h3>\n<div class=\"outline-text-3\" id=\"text-7-3\">\n<p>\nIn Emacs, you can do everything. This is a fact.\n</p>\n

\n\n

\n<p>\nOne the most amazing and complete mode is the amazing <a href=\"http://orgmode.org\">Org mode</a>, written by amazing people.\nBut when I say amazing, it is absolutly amazing. It allows you to \"live in Emacs\".\n</p>\n

\n\n

\n<p>\nHere a a few of its am&#x2026; features:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li>A full agenda / calendar\n</li>\n<li>TODO lists and project management\n</li>\n<li>Writing (research papers, books, an \"Emacs for developers\" whitepaper, your shopping list &#x2026;)\n</li>\n<li>Include code in you papers\n</li>\n<li>Tables and spreadsheets (with formulas and calculation)\n</li>\n<li>Mobile integration\n</li>\n<li>&#x2026;\n</li>\n</ul>\n

\n\n

\n<p>\nAnd what is really cool is that every thing you do in Org is exportable in:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li>PDF\n</li>\n<li>LaTex\n</li>\n<li>HTML\n</li>\n<li>Text\n</li>\n<li>ODT\n</li>\n<li>iCalendar\n</li>\n<li>TextInfo\n</li>\n<li>&#x2026; and many more.\n</li>\n</ul>\n

\n\n

\n<p>\nYou really should check their <a href=\"http://orgmode.org/features.html\">list of features</a>\n</p>\n

\n\n

\n<p>\nIf you want to see a good example of Org-mode capabilities, check <a href=\"http://home.fnal.gov/~neilsen/notebook/orgExamples/org-examples.html\">that great page</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-7-4\" class=\"outline-3\">\n<h3 id=\"sec-7-4\"><span class=\"section-number-3\">7.4</span> Emails in Emacs</h3>\n<div class=\"outline-text-3\" id=\"text-7-4\">\n<p>\nThere are packages that let you use Emacs as a full featured MUA.\nReading emails, sending emails, filtering, archiving &#x2026; etc.\n</p>\n

\n\n

\n<p>\nEmacs can be a very powerful and fast e-mail client and as it is controlled by the keyboard, it could be more efficient than a graphical e-mail client (clicking is a loss of time).\nI use it for years now and I can not imagine using another program to read my emails.\n</p>\n

\n\n

\n<p>\nThere are several package to do so, but the most used is <a href=\"http://www.gnus.org/\">Gnus</a>. It is already installed with Emacs.\n</p>\n

\n\n

\n<p>\nHere are some of its features beside the basic ones:\n</p>\n

\n\n

\n<ul class=\"org-ul\">\n<li>Gnus is in fact a newsreader used to interact with email servers. So you can use to fetch messages from newsgroups, RSS, SMTP, POP, &#x2026;\n</li>\n<li>Easy and powerful mail splitting\n</li>\n<li>Integration with BBDB, a contact manager\n</li>\n<li>Message scoring\n</li>\n<li>LDAP\n</li>\n<li>PGP signing and encrypting\n</li>\n<li>Customizable layout\n</li>\n<li>Encrypted file to manage your credentials\n</li>\n<li>&#x2026; and many more\n</li>\n<li>&#x2026; and of course, it is extensible thanks to Lisp\n</li>\n</ul>\n

\n\n

\n<p>\nYou really should try it with your personnal account. It is easy to configure and integrate with <a href=\"http://www.emacswiki.org/emacs/GnusGmail\">Gmail</a>, for example.\n</p>\n

\n\n

\n<p>\nBut be careful! If you try it, you will love it.\n</p>\n

\n\n

\n<p>\nSome alternatives to Gnus (that I do not use, but that are popular):\n</p>\n<ul class=\"org-ul\">\n<li><a href=\"http://www.emacswiki.org/emacs/WanderLust\">Wanderlust</a>\n</li>\n<li><a href=\"http://www.djcbsoftware.nl/code/mu/mu4e.html\">Mu4e</a>\n</li>\n</ul>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-7-5\" class=\"outline-3\">\n<h3 id=\"sec-7-5\"><span class=\"section-number-3\">7.5</span> Some great Emacs tips and tricks</h3>\n<div class=\"outline-text-3\" id=\"text-7-5\">\n<ul class=\"org-ul\">\n<li>Emacs is all about Macros. This is one of its most powerful feature. Record a sequence and re-play it on other lines! Here is <a href=\"http://www.thegeekstuff.com/2010/07/emacs-macro-tutorial-how-to-record-and-play/\">how</a>.\n</li>\n<li>Using <a href=\"http://www.masteringemacs.org/articles/2010/11/01/running-shells-in-emacs-overview/\">shell</a> inside Emacs is cool\n</li>\n<li>You really should use the <i><a href=\"http://www.emacswiki.org/emacs/BookMarks\">bookmarks</a></i> functionnality to save your projects locations (locally or remotely)\n</li>\n<li>When opening a file, add <i>sudo:</i> in front of its path in order to edit it as a privileged user\n</li>\n<li>You can edit files in hexadecimal directly in Emacs thanks to the <i>hexl-mode</i>\n</li>\n<li>Emacs allows you to open an archive (gz, bz2, zip, &#x2026;), edit its files on-the-fly without extracting yourself the archive. To do so, simple open the file directly in Emacs (<b>C-x C-f</b> /path/to/archive.tar.bz2)\n</li>\n<li><a href=\"http://www.gnu.org/software/emacs/manual/html_node/emacs/Rectangles.html\">Rectangle regions</a> edition is really easy\n</li>\n<li><a href=\"http://www.cs.bu.edu/teaching/tool/emacs/programming/#compile\">Compilation</a> and <a href=\"http://www.cs.bu.edu/teaching/tool/emacs/programming/#gdb\">debugging</a> is really well supported in Emacs\n</li>\n<li><a href=\"http://www.emacswiki.org/ERC\">Erc</a> is a great IRC client running in Emacs\n</li>\n</ul>\n

\n\n

\n<p>\n<i>To be continued</i>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-7-6\" class=\"outline-3\">\n<h3 id=\"sec-7-6\"><span class=\"section-number-3\">7.6</span> Coming from other editors (i.e Vim)</h3>\n<div class=\"outline-text-3\" id=\"text-7-6\">\n<p>\nSome people use other editors and want to give Emacs a try.\nSome people are really used to use a specific editor.\nSome people do not want to lose their habits and their learning curve.\n</p>\n

\n\n

\n<p>\nI am thinking about Vim, but it is also true for other editors (textmate, sublime, &#x2026;)\n</p>\n

\n\n

\n<p>\nEmacs has a mode that allows you to use it exactly like Vim.\n</p>\n

\n\n

\n<p>\nI personnaly never used this mode, but many people use it. Therefore, it allows you to switch gently and softly from Vim to Emacs.\n</p>\n

\n\n

\n<p>\n<a href=\"http://www.emacswiki.org/emacs/Evil\">Read more about Evil-mode</a>\n</p>\n</div>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-8\" class=\"outline-2\">\n<h2 id=\"sec-8\"><span class=\"section-number-2\">8</span> Readings and resources</h2>\n<div class=\"outline-text-2\" id=\"text-8\">\n<ul class=\"org-ul\">\n<li><a href=\"http://emacsrocks.com/\">Emacs rocks videos</a>\n</li>\n<li><a href=\"http://devblog.avdi.org/category/emacs-reboot/\">Avdi Grimm Emacs reboot series</a>\n</li>\n<li><a href=\"http://www.masteringemacs.org/\">Mastering Emacs</a>\n</li>\n<li><a href=\"http://sachachua.com/blog/category/geek/emacs/\">Sacha's blog</a> and her wonderful Emacs contributors interviews serie\n</li>\n<li><a href=\"http://emacsredux.com\">Emacs redux</a> by Bozhidar Batsov\n</li>\n<li><a href=\"http://planet.emacsen.org/\">Planet Emacsen</a>\n</li>\n<li><a href=\"http://reddit.com/r/emacs\">Emacs sub-reddit</a>\n</li>\n</ul>\n

\n\n

\n<p>\nAnd of course, the <a href=\"http://www.emacswiki.org/\">Emacs wiki</a>\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-9\" class=\"outline-2\">\n<h2 id=\"sec-9\"><span class=\"section-number-2\">9</span> License</h2>\n<div class=\"outline-text-2\" id=\"text-9\">\n<p>\nThe content of this project itself is licensed under the <a href=\"http://creativecommons.org/licenses/by/3.0/us/deed.en_US\">Creative Commons Attribution 3.0 license</a>, and the underlying source code used to format and display that content is licensed under the <a href=\"http://opensource.org/licenses/mit-license.php\">MIT license</a>.\n</p>\n

\n\n

\n<p>\nContributors list can be found <a href=\"https://github.com/pierre-lecocq/emacs4developers/network/members\">here</a>.\n</p>\n</div>\n</div>\n

\n\n

\n<div id=\"outline-container-sec-10\" class=\"outline-2\">\n<h2 id=\"sec-10\"><span class=\"section-number-2\">10</span> Thanks</h2>\n<div class=\"outline-text-2\" id=\"text-10\">\n<p>\nI want to thank some of the great people who make Emacs a very intersting piece of software or make its community very active (the sort order is absolutly not important here):\n</p>\n

\n\n

\n<p>\nBastien Guerry, Dimitri Fontaine, Julien Danjou, Sacha Chua, Steve Purcell, Nic Ferrier, Avdi Grimm, Magnars, Steve Yegge, Bozhidar Batsov, Xah Lee, and many more &#x2026;\n</p>\n

\n\n

\n<p>\nYou should check those people and their work over the web, twitter, youtube, &#x2026;\n</p>\n

\n\n

\n<p>\nAnd thank you for reading this !\n</p>\n</div>\n</div>\n</div>\n<div id=\"postamble\" class=\"status\">\n<p class=\"author\">Author: Pierre Lecocq</p>\n<p class=\"date\">Created: 2014-10-21 Mar 13:50</p>\n<p class=\"creator\"><a href=\"http://www.gnu.org/software/emacs/\">Emacs</a> 24.4.1 (<a href=\"http://orgmode.org\">Org</a> mode 8.2.10)</p>\n<p class=\"validation\"><a href=\"http://validator.w3.org/check?uri=referer\">Validate</a></p>\n</div>\n</body>\n</html>

\n
\n
\n

Author: Pierre Lecocq

\n

Created: 2014-10-21 Mar 13:50

\n

Emacs 24.4.1 (Org mode 8.2.10)

\n

Validate

\n
\n\n\n" }, { "path": "exports/emacs4developers.org", "content": "#+TITLE: Emacs for developers\n#+AUTHOR: Pierre Lecocq\n#+DESCRIPTION: Learn using Emacs as a developer\n#+KEYWORDS: emacs, developer\n#+STARTUP: showall\n\n* Emacs for developers\n\nThis document will (hopefully) help you to use Emacs as a developer.\n\n**** Disclaimer\n\nWork in progress, so stay tuned.\n\n** Who is the target of this tutorial\n\nWell, this is a good question. And I won't give an answer but some elements of answer.\n\nWhat is sure is that it is not written for the people thanked below (Batien, Dimitri, Sacha, Nic, Avdi, and so on ...), but what is interseting with Emacs is that even if you are a beginner, an intermediate / advanced user or an every day power user, you can learn from others each time you open a web page or a manual dealing with Emacs.\n\nTherefore, this tutorial is written for people who want to improve their experience. Simple as that. Whatever is their knowledge, their feeling, their usage, their config file size (without any pun), etc ...\n\nRemember one thing: Emacs is 30+ years old and brings new users everyday. It is a clue that this is a piece of software that deserve some attention.\n\n* Table of contents\n\n- 1. [[#introduction][Introduction]]\n - 1.1 [[#brief-history][Brief history]]\n - 1.2 [[#how-to-get-emacs][How to get Emacs?]]\n - 1.3 [[#more-than-an-editor][More than an editor]]\n - 1.4 [[#the-perfect-development-tool][The perfect development tool]]\n- 2. [[#the-basics][The basics]]\n - 2.1 [[#config-files][Config files]]\n - 2.2 [[#executing-commands][Executing commands]]\n - 2.3 [[#key-bindings][Key bindings]]\n - 2.3.1 [[#manipulate-files][Manipulate files]]\n - 2.3.2 [[#manipulate-the-current-line][Manipulate the current line]]\n - 2.3.3 [[#selecting-a-region][Selecting a region]]\n - 2.3.4 [[#commenting][Commenting]]\n - 2.3.5 [[#windows][Windows]]\n - 2.3.6 [[#buffers][Buffers]]\n - 2.3.7 [[#cancel-a-command][Cancel a command]]\n - 2.3.8 [[#the-most-useless-command][The most useless command]]\n - 2.4 [[#help][Help!]]\n- 3. [[#building-your-own-editor][Building your own editor]]\n - 3.1 [[#first-basic-configuration][First basic configuration]]\n - 3.2 [[#general-basic-configuration][General basic configuration]]\n - 3.3 [[#backup-files][Backup files]]\n - 3.4 [[#setting-up-the-locals][Setting up the locales]]\n - 3.5 [[#more-configuration][More configuration]]\n - 3.6 [[#modes][Modes]]\n - 3.7 [[#package-managers][Package managers]]\n - 3.8 [[#some-useful-packages][Some useful packages]]\n - 3.9 [[#code-navigation][Code navigation]]\n - 3.10 [[#setting-a-color-theme][Setting a color theme]]\n- 4. [[#emacs-developing-environments][Emacs developing environments]]\n - 4.1 [[#emacs-for-ruby-developers][Emacs for Ruby developers]]\n - 4.2 [[#emacs-for-python-developers][Emacs for Python developers]]\n - 4.3 [[#emacs-for-ccobjective-c][Emacs for C/C++/Objective-C developers]]\n - 4.4 [[#emacs-for-go-developers][Emacs for Go developers]]\n - 4.5 [[#emacs-for-php-developers][Emacs for PHP developers]]\n - 4.6 [[#emacs-for-java-developers][Emacs for Java developers]]\n - 4.7 [[#emacs-for-r-and-statistics][Emacs for R and statistics]]\n- 5. [[#special-features][Special features]]\n - 5.1 [[#emacs-as-a-file-manager][Emacs as a file manager]]\n - 5.2 [[#working-locally-vs-remotely][Working locally vs remotely]]\n - 5.3 [[#organize-your-work-write-papers-and-manage-your-agenda][Organize your work, write papers and manage your agenda]]\n - 5.4 [[#emails-in-emacs][Emails in Emacs]]\n - 5.5 [[#some-great-emacs-tips-and-tricks][Some great Emacs tips and tricks]]\n - 5.6 [[#coming-from-other-editors-ie-vim][Coming from other editors (i.e Vim or SublimeText)]]\n- 6. [[#readings-and-resources][Readings and resources]]\n\n* Introduction\n\n** Brief history\n\n- Originally developed by Richard Stallman and Guy Steele in MIT AI lab\n- First release in 1976\n- Inspired by TECO editor\n- Based on macros (Emacs stands for Editor MACroS)\n- Written in C and Emacs Lisp\n- Part of the GNU project (therefore, we /should/ say \"GNU Emacs\", not \"Emacs\")\n\n- Despite its age, new users are still adopting Emacs as their development platform to this day!\n\n** How to get Emacs?\n\nOn every Linux distribution, packages are available.\nSo run your favorite package manager to install it:\n\n- /apt-get install emacs/\n- /yum install emacs/\n- ...\n\nAnd if you have an exotic operating system, here are the specific distributions:\n\n- Mac OS X: http://emacsformacosx.com/\n- Windows: http://ftp.igh.cnrs.fr/pub/gnu/emacs/windows/\n\nBut, in order to get the latest version, it's _highly recommended_ that you compile Emacs yourself: http://ftp.igh.cnrs.fr/pub/gnu/emacs/\n\n\n** More than an editor\n\n- More than an editor, it is a Lisp interpretor\n- Can run any type of program written in Lisp:\n - Email clients (like [[http://www.gnus.org/][Gnus]] or [[http://www.emacswiki.org/emacs/mu4e][mu4e]])\n - Shell (like bash or eshell)\n - File and directory management (with [[http://www.gnu.org/software/emacs/manual/html_node/emacs/Dired.html][Dired mode]])\n - Agenda / Notes / TODO list / Project management (with the amazing [[http://orgmode.org][OrgMode]])\n - IRC / Twitter / Jabber / ... clients\n - Games (like Tetris, Pong, Snake, 5x5, Dunnet, ...)\n - Encrypt/decrypt files (like GPG files)\n - On-the-fly archives editing (thanks to [[http://www.emacswiki.org/emacs/ArchiveMode][archive-mode]])\n - PDF / Image / (...) viewer\n - A powerful front end to R / S+ / SPSS / Stata (with [[http://ess.r-project.org/][EmacsSpeaksStatisics)]]\n - An editor for multi-modal REPL's like IPython (with [[http://tkf.github.io/emacs-ipython-notebook/][EmacsIPythonNotebook]])\n - Music player (with emms, vlc, mplayer, ...)\n - Music programming (with [[http://vimeo.com/22798433][Overtone]])\n - Video editing\n - And so on ...\n - (and of course a document editor that can automatically generate this presentation)\n\nNaturally, you can do all of that at the same time with only one Emacs instance. Don't need to say it ...\n\n** The perfect development tool\n\n- As Emacs is a Lisp interpretor, it is extensible. Really really extensible.\n- The (unofficial) goal of Emacs is to be hacked\n- Therefore your goal is to hack Emacs to make it work perfectly as you want\n\n- Already provides so many development tools (also extensible, of course)\n - Debuggers\n - Compilers\n - Syntax checkers\n - Documentations\n - Consoles\n - ...\n\n- Also provides /modes/ (extensions) for *every* programming language for\n - Syntax highlighting\n - Documentation search\n - Indentation\n - Source code browsing\n - Compilation commands\n - Specific behaviour\n - ...\n\n* The basics\n\n** Config files\n\nIn order to customize Emacs, you will have to edit its configuration files.\nIt does not exist when you install the software (or is an empty file) and does nothing until you decide to tweak Emacs.\nSome people use Emacs for decades without any extra configuration because they like it out of the box.\n\nThere are several ways to manage your Emacs configuration:\n\n- Simply create and edit a *~/.emacs* file\n- Create a *~/.emacs.d/* directory with a *~/.emacs.d/init.el* file\n\nThe first solution is great if you have a small, tidied and exportable configuration file.\n\nThe second solution is great if you need several configuration files (keep you configuration parts separated) or you need to install external extensions (you will install them in *~/.emacs.d* to keep them centralized and exportable).\n\n** Executing commands\n\nThe main idea of Emacs is that everything is a command. For example: opening a file with a keybinding calls a command that is executed by the Emacs' core.\nAnd all the commands are written in Lisp.\n\nTo call a command, you simply have to press *Escape* and then *x*. It could be *Alt-x* for more comfort.\nThe official name is \"/Meta x/\" and is written /M-x/\n\nIf you type this key sequence, you will see at the bottom of the editor a little prompt.\nThis part of Emacs is called the /mini buffer/ and is used for every interactive actions.\n\nLet's try something:\n\n- type *M-x*\n- Then, in the minibuffer, type *version* and *RET* (return)\n\nEmacs should display the current version number of the software.\n\n#+CAPTION: Execute the version command\n[[../images/version.gif]]\n\nCongratulations! You just called your first Emacs command.\n\n** Key bindings\n\nHere are the most useful keys in Emacs. You will use them several hundreds (or thousands) times a day.\n\nHow it works?\n\n- The sequence /C-something/ means that you have to press and hold the /Control/ key while hitting the /something/ key. Example: /C-a/ means /Control + a/.\n- The sequence /C-something somethingelse/ means that you press /Control + something/, then you release Control to hit /somethingelse/.\n- The sequence /C-something C-somethingelse/ means that you have to press Control while hitting /something/ and /somethingelse/.\n\n*** Manipulate files\n\n- *C-x C-f*: open a file, which corresponds to *M-x find-file*\n- *C-x C-s*: save a file, which corresponds to *M-x save-buffer*\n\n#+CAPTION: Open a file, modify it and save it\n[[../images/open-and-save.gif]]\n\n*** Manipulate the line\n\n- *C-a*: go to the beginning of the current line, which corresponds to *M-x begining-of-line*\n- *C-e*: go to the end of the current line, which corresponds to *M-x end-of-line*\n- *C-k*: cut the rest of the line at the cursor position, which corresponds to *M-x kill-line*\n- *C-y*: paste what you had cut with the command above, which corresponds to *M-x yank*\n- *C-l*: center the buffer at the cursor position, which corresponds to *M-x recenter-top-bottom*\n\n#+CAPTION: Line manipulation\n[[../images/line.gif]]\n\n*** Selecting a region\n\nRegions are selections, in Emacs.\n\nThey are composed by two points. A starting one and and an ending one.\n\nTo select the starting point, move your cursor to the wanted location and simply press *C-Space*. In your minibuffer, you should have seen a message like \"Mark set\".\nNow, move your cursor to the location you wantyour selection to end.\n\nYou have now a selection (or a /region/) delimited by the place you set the first mark and your cursor. With this region, you can do what ever you want:\n\n- Copy (*M-w*)\n- Cut (*C-k*)\n- Paste (*C-y*)\n- Replace (*M-%*)\n- ... etc\n\n#+CAPTION: Selecting a region\n[[../images/selecting.gif]]\n\n*** Commenting\n\nIn order to comment a code block, select the region you want to comment and use:\n\n- *M-x comment-region* in order to comment the block\n- *M-x uncomment-region* in order to uncomment the block\n\nOf course, Emacs knows, according to the major mode loaded how to comment properly your code. If the major-mode is /ruby-mode/, it will add a \"#\" before the line; if the major-mode is /lisp-mode/, it will add \";;\", and so on and so forth.\n\n#+CAPTION: Commenting\n[[../images/comment.gif]]\n\n*** Windows\n\nThis might be confusing but a /window/ is a part of a /frame/.\n\nAn /Emacs frame/ is the window that you opened when you launched Emacs.\n\nAn /Emacs frame/ can be divided into /windows/ in itself.\n\n- *C-x 2*: open a new window horizontally, which corresponds to *M-x split-window-below*\n- *C-x 3*: open a new window vertically, which corresponds to *M-x split-window-right*\n- *C-x o*: switch to the next window, which corresponds to *M-x other-window*\n- *C-x 0*: close the current window, which corresponds to *M-x delete-window*\n\n#+CAPTION: Windows manipulation\n[[../images/windows.gif]]\n\n*** Buffers\n\nA /buffer/ is displayed in a /frame/.\n\n- *C-x b*: switch to an already opened buffer, which corresponds to *M-x switch-to-buffer*\n- *C-x C-b*: list opened buffer (and jump to the selected one), which corresponds to *M-x list-buffers*\n- *C-x k*: kill a buffer, which corresponds to *M-x kill-buffer*\n\n#+CAPTION: Buffer navigation\n[[../images/buffers.gif]]\n\n*** Cancel a command\n\n- *C-g* or *ESC ESC ESC*: cancel the current command running in the minibuffer, which corresponds to *M-x keyboard-quit*\n\n*** The most useless one\n\n- *C-x C-c*: quit emacs (use at your own risks!), which corresponds to *M-x save-buffers-kill-terminal*\n\n** Help!\n\nEmacs has a powerful built-in help system for key bindings and internal functionalities.\n\n- *C-h f *: Find the key binding corresponding to (ex: C-h f save-buffer)\n- *C-h k *: Find the function name corresponding to (ex: C-h k C-x C-s)\n\nWhen executing these commands, a new frame opens. To close it, switch to it (/C-x o/) and type /q/. If not, simply close it (/C-x 0/)\n\nEmacs also includes the full manual (also available online: http://www.gnu.org/software/emacs/manual/html_node/emacs/)\n\n- *C-h r*: browse the Emacs manual within Emacs\n\nFinally, there are so many other help functions: http://www.emacswiki.org/emacs/EmacsNewbieHelpReference\n\n* Building your own editor\n\nFrom this point, we will edit the configuration file.\nFor the moment, we will put everything in a single *~/.emacs.d/init.el* file. Create it if it does not exist.\n\n#+BEGIN_SRC sh\n# Backup old configuration\ncp .emacs dot-emacs.old\ncp -R .emacs.d dot-emacs.d.old\n\n# Create new and empty configuration\nmkdir ~/.emacs.d\ntouch ~/.emacs.d/init.el\n#+END_SRC\n\n** First basic configuration\n\nWhen you will have to change or add configuration, simply edit your *~/.emacs.d/init.el* file and add what you need.\n\nFor exemple, here is a tweak that does nothing visually but is useful for other packages and the Emacs engine itself.\nIt allows you to define your name and email. Emacs can use it to add author informations to a file when asked.\n\n#+BEGIN_SRC lisp\n(setq user-full-name \"Your full name\")\n(setq user-mail-address \"your@email.com\")\n#+END_SRC\n\nAfter each configuration modification, two solutions:\n\n- the soft & clever way: execute *M-x eval-buffer*\n- the hard way: restart Emacs.\n\n** General basic configuration\n\nNow, let's move to a more visual configuration basic set.\nAs before, simply add this to your configuration file:\n\n#+BEGIN_SRC lisp\n;; Ask \"y\" or \"n\" instead of \"yes\" or \"no\". Yes, laziness is great.\n(fset 'yes-or-no-p 'y-or-n-p)\n\n;; Highlight corresponding parenthese when cursor is on one\n(show-paren-mode t)\n\n;; Highlight tabulations\n(setq-default highlight-tabs t)\n\n;; Show trailing white spaces\n(setq-default show-trailing-whitespace t)\n\n;; Remove useless whitespaces before saving a file\n(add-hook 'before-save-hook 'whitespace-cleanup)\n(add-hook 'before-save-hook (lambda() (delete-trailing-whitespace)))\n#+END_SRC\n\n** Backup files\n\nYou may have notice that the files you edit are duplicated and renamed with a /~/ at the end.\nThey are the backup files that Emacs creates for you with an auto-save feature.\nSometimes it is great because you can recover a file in case of error, sometimes it is annoying because you can have some many of these files.\n\nIt is up to you to keep it or disable it.\nHere is the configuration for that:\n\n#+BEGIN_SRC lisp\n;; Remove all backup files\n(setq make-backup-files nil)\n(setq backup-inhibited t)\n(setq auto-save-default nil)\n#+END_SRC\n\nAn alternative method is to save these backups in a centralized folder:\n\n#+BEGIN_SRC lisp\n;; Save backup files in a dedicated directory\n(setq backup-directory-alist '((\".\" . \"~/.saves\")))\n#+END_SRC\n\n** Setting up the locales\n\nYou may want to set up a specific locale for your files.\nHere is the trick:\n\n#+BEGIN_SRC lisp\n;; Set locale to UTF8\n(set-language-environment 'utf-8)\n(set-terminal-coding-system 'utf-8)\n(setq locale-coding-system 'utf-8)\n(set-default-coding-systems 'utf-8)\n(set-selection-coding-system 'utf-8)\n(prefer-coding-system 'utf-8)\n#+END_SRC\n\n** More configuration\n\nThe best way to get your configuration better, is to read the [[http://www.gnu.org/software/emacs/manual/][manual]] ...\nBut you can also (this is the un-official method) read the others Emacs users' config files.\nThere are so many people who share their configuration, comment their code, and distribute their modes!\n\nHere is mine: (https://github.com/pierre-lecocq/emacs.d)\n\n** Modes\n\n/Modes/ are Emacs' /extensions/ that can be installed to extend the capabilities of Emacs. They will allow you to build a powerful tailored editor.\n\nThere are 2 kind of modes: minor and major.\n\n*** Major modes\n\nMajor modes are modes that transform Emacs to a specialized software for editing a certain type of files (i.e c-mode) or managing special tasks (i.e reading emails, managing git repository, ...)\n\nOnly one major mode can be used at a time.\n\n*** Minor modes\n\nMinor modes are additionnal modes that are added transparently to the major mode. They add more features to the main one (i.e parentheses matching, syntax or spelling checkers, ...)\n\nSeveral minor modes can be used at a time.\n\n** Package managers\n\nEmacs has brilliant package managers such as /package.el/ or /el-get/ that allows you to add and update modes really easily.\n\n*** Package.el\n\n/package.el/ is the built in package manager shipped by default with Emacs 24 or later.\n\nTo list available packages, simply type this command:\n\n#+BEGIN_SRC lisp\nM-x package-list-packages\n#+END_SRC\n\nYou will have a list of packages. Simply press ENTER on the name of one of it to install it.\n\nAdditionnaly, you can manage the packages list by adding other sources to your configuration file:\n\n#+BEGIN_SRC lisp\n;; Add package sources\n(setq package-archives '((\"gnu\" . \"http://elpa.gnu.org/packages/\")\n (\"marmalade\" . \"http://marmalade-repo.org/packages/\")\n (\"melpa\" . \"http://melpa.org/packages/\")))\n#+END_SRC\n\n*** El-Get\n\n/[[https://github.com/dimitri/el-get][el-get]]/ is one of the most popular and easy to use package manager. The \"/apt-get/\" of Emacs.\nIt is written by the great [[https://github.com/dimitri][Dimitri Fontaine]] and is based on recipe files that simply describe where is located the package and how to get/compile/install it for you.\n\nTo use it, simply add this to your configuration file. It will download and set up /el-get/ for you:\n\n#+BEGIN_SRC lisp\n;; Set up el-get\n(add-to-list 'load-path \"~/.emacs.d/el-get/el-get\")\n(unless (require 'el-get nil 'noerror)\n (with-current-buffer\n (url-retrieve-synchronously\n \"https://raw.github.com/dimitri/el-get/master/el-get-install.el\")\n (let (el-get-master-branch)\n (goto-char (point-max))\n (eval-print-last-sexp))))\n#+END_SRC\n\n*** The generic method\n\nIn order to leave you the choice of the package manager you want to use, here is a function that handles several package managers. For now, it covers /package.el/ and /el-get/.\n\nIt also allows you to automatically install packages you want.\n\nIn the following snippet, two sample packages are installed\n\n- /color-theme/ in order to allow us to change colors themes\n- /autopair/ in order to close automatically parentheses, brackets and braces when you open it\n\nSimply add this code to your configuration file:\n\n#+BEGIN_SRC lisp\n;; Set up the package manager of choice. Supports \"el-get\" and \"package.el\"\n(setq pmoc \"el-get\")\n\n;; List of all wanted packages\n(setq\n wanted-packages\n '(\n color-theme\n autopair\n))\n\n;; Package manager and packages handler\n(defun install-wanted-packages ()\n \"Install wanted packages according to a specific package manager\"\n (interactive)\n (cond\n ;; package.el\n ((string= pmoc \"package.el\")\n (require 'package)\n (add-to-list 'package-archives '(\"gnu\" . \"http://elpa.gnu.org/packages/\"))\n (add-to-list 'package-archives '(\"melpa\" . \"http://melpa.org/packages/\"))\n (add-to-list 'package-archives '(\"marmelade\" . \"http://marmalade-repo.org/packages/\"))\n (package-initialize)\n (let ((need-refresh nil))\n (mapc (lambda (package-name)\n (unless (package-installed-p package-name)\n (set 'need-refresh t))) wanted-packages)\n (if need-refresh\n (package-refresh-contents)))\n (mapc (lambda (package-name)\n (unless (package-installed-p package-name)\n (package-install package-name))) wanted-packages)\n )\n ;; el-get\n ((string= pmoc \"el-get\")\n (add-to-list 'load-path \"~/.emacs.d/el-get/el-get\")\n (unless (require 'el-get nil 'noerror)\n (with-current-buffer\n (url-retrieve-synchronously\n \"https://raw.github.com/dimitri/el-get/master/el-get-install.el\")\n (let (el-get-master-branch)\n (goto-char (point-max))\n (eval-print-last-sexp))))\n (el-get 'sync wanted-packages))\n ;; fallback\n (t (error \"Unsupported package manager\")))\n )\n\n;; Install wanted packages\n(install-wanted-packages)\n#+END_SRC\n\nNote that some of the following package names could vary if you use /package.el/ or /el-get/.\n\n*** The modern and efficient way\n\nSome upper-level packages make package management easier and cleaner.\n\nFor example, John Wiegley's =use-package= software is an elegant and efficient way to install and tidy your external packages configurations.\n\nHere is the way to use it:\n\nFirst, setup packages sources and install =use-package=\n\n#+BEGIN_SRC lisp\n(require 'package)\n(setq package-archives '((\"gnu\" . \"http://elpa.gnu.org/packages/\")\n (\"marmalade\" . \"http://marmalade-repo.org/packages/\")\n (\"melpa\" . \"http://melpa.org/packages/\")))\n(package-initialize)\n\n(unless (package-installed-p 'use-package)\n (progn\n (package-refresh-contents)\n (package-install 'use-package)))\n\n(require 'use-package)\n#+END_SRC\n\nThen, for each package you want to install, simply add this to your configuration (replace /the-package-name/ by any package name):\n\n#+BEGIN_SRC LISP\n(use-package the-package-name\n :ensure the-package-name\n :init (progn\n ;; Do something after the package is initialized\n ))\n#+END_SRC\n\n** Some useful packages\n\nAs a developer, you will need some packages that will help you to work, increase your productivity and enhance your confort while coding.\nPlease note that even if I am a Ruby/shell/Lisp/web/PHP developer, some packages are compatible and useful for every kind of development. Therefore, the base packages are listed here but some specific packages that might be useful for your work are eventually not listed here. It is up to you to adapt the list according to your needs!\n\nTip: After adding packages, restart Emacs in order to let /el-get/ download and install it properly.\n\n*** Auto complete\n\nAuto completion is a must-have feature in the development world.\nThis package simply displays a popup at the cursor position with the available completions.\n\nTo install it, add =auto-complete= to your packages list.\n\n[[http://www.emacswiki.org/emacs/AutoComplete][Read more]]\n\n[[../images/mode-autocomplete.gif]]\n\n*** Autopair\n\nWhen you open a quote/parenthese/bracket/curly bracket, this mode automatically adds the closed one and bring your cusror between the two.\nVery useful to avoid syntax errors, for example.\n\nTo install it, add =autopair= to your packages list.\n\n[[https://github.com/capitaomorte/autopair][Read more]]\n\n[[../images/mode-autopair.gif]]\n\n*** Buffer move\n\nThis mode allows you to re-organize and move the buffers from a window to another.\nUseful if you want to switch buffer places in order to have your debugging buffer on the right side, for example.\n\nTo install it, add =buffer-move= to your packages list.\n\n[[http://www.emacswiki.org/cgi-bin/wiki/buffer-move.el][Read more]]\n\n[[../images/mode-buffermove.gif]]\n\n*** Flycheck\n\nThis mode check the syntax of a buffer. It could be used for checking code syntax or typos when writing any kind of text.\n\nTo install it, add =flycheck= to your packages list.\n\n[[https://github.com/flycheck/flycheck][Read more]]\n\n*** Highlight symbol\n\nThis mode highlights all symbols that matches a pattern in your buffer\n\nTo install it, add =highlight-symbol= to your packages list.\n\n[[http://www.emacswiki.org/emacs/HighlightSymbol][Read more]]\n\n*** Ido\n\nIdo is a must have mode to navigate, find stuffs, and do things interactively.\nIt is for comfort, but is indispensable to go fast.\n\nMany extensions of this mode are available, therefore read and chose what you want.\n\nI personnaly use two of them: /vertical/ and /hack/.\n\nTo install it, add =ido-hacks= and =ido-vertical-mode= to your packages list.\n\n[[http://www.emacswiki.org/emacs/InteractivelyDoThings][Read more]]\n\n[[../images/mode-ido.gif]]\n\n*** JS3\n\nThis mode is an enhanced mode for editing Javascript files. I do not use it a lot, but it is useful for some javascript-like or NPM files.\n\nTo install it, add =js3-mode= to your packages list.\n\n[[http://www.emacswiki.org/emacs/Js2Mode][Read more]]\n\n*** Magit\n\nMagit is a very powerful and elegant mode for intercating with your git repository.\nIn order to understand how powerful it is, simply watch this amazing [[http://vimeo.com/2871241][video]]\n\nTo install it, add =magit= to your packages list.\n\n[[https://github.com/magit/magit][Read more]]\n\n*** Multiple cursors\n\nThis mode is great and super powerful. Instead of explaining what it is, check this amazing [[http://emacsrocks.com/e13.html][video]] by Magnars.\n\nTo install it, add =multiple-cursors= to your packages list.\n\n[[https://github.com/magnars/multiple-cursors.el][Read more]]\n\n*** PHP mode\n\nA basic but stable mode for editing PHP files, whatever you think about PHP ...\n\nTo install it, add =php-mode= to your packages list.\n\n[[http://php-mode.sourceforge.net/][Read more]]\n\n*** Rainbow mode\n\nA useless but indispensable mode to add colors to your CSS files when using properties like \"color\", \"background-color\".\nIt is cool since it understands every way to write a color (hex, name, ...) and gives you a preview of the color itself.\n\nTo install it, add =rainbow-mode= to your packages list.\n\n[[http://julien.danjou.info/projects/emacs-packages][Read more]]\n\n*** RHTML mode\n\nThis mode is useful for editing .rhtml files. You can also use it to edit any kinf of ruby templates (i.e .erb).\n\nTo install it, add =rhtml-mode= to your packages list.\n\n[[https://github.com/eschulte/rhtml][Read more]]\n\n*** Ruby mode\n\nDo I really need to explain ?\n\nRuby mode is already installed in Emacs and is very stable.\n\n[[http://www.emacswiki.org/emacs/RubyMode][Read more]]\n\n*** Switch window\n\nThis mode is cool when you work with a lot of windows opened.\nIf you want to switch to another one, you have to press *C-x o* until you reach the wanted window.\nWith this mode, when you press *C-x o*, big numbers replace your opened windows. Simply type the corresponding number to reach the wanted window.\n\nTo install it, add =switch-window= to your packages list.\n\nThen do not forget to override the defaut configuration by adding this to your configuration:\n\n#+BEGIN_SRC lisp\n(global-set-key (kbd \"C-x o\") 'switch-window)\n#+END_SRC\n\n[[https://github.com/dimitri/switch-window][Read more]]\n\n[[../images/mode-switchwindow.gif]]\n\n*** Visual regexp\n\nThis mode highlights the text that matches the regexp that you are writing in the mini buffer.\n\nTo install it, add =visual-regexp= to your packages list.\n\n[[https://github.com/benma/visual-regexp.el][Read more]]\n\n*** Yaml mode\n\nAlows you to edit .yml files\n\nTo install it, add =yaml-mode= to your packages list.\n\n[[http://www.emacswiki.org/emacs/YamlMode][Read more]]\n\n*** Yasnippet\n\nA mode that allows you to write code faster if you are lazy.\nIt is very easy to create your own snippets and use it whatever the file you are editing (code, non-code, emails, ...)\n\nI personnaly do not use it, but people coming from Textmate/Sublime would love it.\n\nTo install it, add =yasnippet= to your packages list.\n\n[[http://www.emacswiki.org/emacs/Yasnippet][Read more]]\n\n*** Paredit\n\nParedit is a really cool mode to \"keep parentheses balanced\" and navigating in the S-expressions. Useful and indispensable if you write Lisp code, for example.\n\nTo install it, add =paredit= to your packages list.\n\n[[http://www.emacswiki.org/emacs/ParEdit][Read more]]\n\n** Code navigation\n\nNavigate through source code is an indispensable feature in code editors. Some of other editors are focused on this (like Sublime) but the problem is that they do not leave you the choices of the weapons (like every other features).\n\nEmacs, as you noticed (yes, you did) can integrate any external tool or include a large variety of internal tools to make it more efficient. Code navigation is not an exception.\n\nThere are a lot of packages in order to navigate through code, with different methodologies and advantages:\n\n- [[http://www.emacswiki.org/emacs/EmacsTags][TAGS]] (built in. No installation required)\n- [[https://github.com/bbatsov/projectile][Projectile]] (install it by adding =projectile= to your packages list)\n- [[https://github.com/emacs-helm/helm][Helm]] (install it by adding =heml= to your packages list)\n- [[http://cedet.sourceforge.net/][Emacs CEDET]] (install it by adding =cedet= to your packages list)\n- ...\n\n(Note: use once at a time! You do not need to install them all)\n\nAfter using /Projectile/ for a certain period of time, I gave /Helm/ a shot but finally got back to the simplicity and the efficiency of the /TAGS/ system.\nNevertheless, /Projectile/ and /Helm/ are really powerful and useful. You really should look at them.\n\nFor now, I will cover the basics of /TAGS/ since it is a standard (used by other softwares) and it is built-in (so if you use another Emacs without your config, you still know how to surf in the code). And other useful tricks will be shown here.\n\n*** Tags basics\n\nBasically, the TAGS rely on an index file of the content of your code source.\nIn the root folder of a project, you must generate your index.\nSeveral methods for this, but here is one command that generates the file:\n\n#+begin_src sh\ncd /path/to/your/project\nfind . -regex \".*\\.\\(c\\|h\\|rb\\|py\\|php\\|js\\|sh\\|bash\\)\" -print | xargs etags -a\n#+end_src\n\nYou now should see a \"TAGS\" file. If needed, exclude this file from your git/svn/whatever repository/.\n\nYou are now ready to surf!\n\nNow, here are the main commands to use them:\n\n- *M-.* is the equivalent of *M-x find-tag*: find a tag\n- *M-x find-tag-other-window*: find a tag, but in another window\n- *M-x tags-search*: find a tag thanks to a regexp\n- *M-x tags-query-replace*: replace a tag in all the indexed files\n- *M-x tags-apropos*: list all tags that match a regexp\n- *M-x list-tags*: list all tags in a file\n\n*** List functions or methods\n\nIn order to list and jump easily between the functions or methods of the current file, here is a little trick:\n\n#+begin_src emacs-lisp\n(global-set-key (kbd \"C-S-f\") 'imenu) ;; use iMenu\n#+end_src\n\nAfter pressing Ctrl-Shift-f (replace it by whatever you want!), a menu with all the available resources appears in the minibuffer.\nSelect the resource you want (let's say /All.methods/ if you are editing some code) and you will be able to search and jump to a method definition directly.\n\n*** Files navigation (a.k.a fuzzy matching) with TAGS and ido\n\nIn order to find and jump easily to a file in your project thanks to TAGS, you have to add a little function to your confiugration.\nFor this you should have installed the =ido-mode= described above.\n\n#+begin_src emacs-lisp\n(defun ido-find-file-in-tag-files ()\n (interactive)\n (save-excursion\n (let ((enable-recursive-minibuffers t))\n (visit-tags-table-buffer))\n (find-file\n (expand-file-name\n (ido-completing-read\n \"Project file: \" (tags-table-files) nil t)))))\n\n(global-set-key (kbd \"C-S-x C-S-f\") 'ido-find-file-in-tag-files)\n#+end_src\n\nNow, in your project folder and once you generated your TAGS file, you can press *C-S-x C-S-f* to find files through the whole tree of directories just by typing a pattern.\n\n[[../images/fuzzy.gif]]\n\n*** RGrep\n\n/rgrep/ is a great tool to use in addition of the TAGS. It is a Unix tool that make /grep/ queries recursively. In Emacs, it will bring you a new buffer with all the results of the command. To use it, simply type:\n\n*M-x rgrep RET yoursearchterm RET*\n\nOnce fired, you can swith to the newly created buffer, parse the results and jump to the wanted files very quickly.\n\nWhat is cool is that it is integrated in the editor, just beside your code and does not require to switch to a shell and then copy-paste the files path you want.\n\n[[../images/rgrep.gif]]\n\n\n** Setting a color theme\n\nNow, we are talking about something very touchy and that can be a long quest ...\n\nA color theme generally includes colors for:\n\n- background\n- syntax color (for code)\n- specific modes colors (gnus, dired, git, ...)\n\nThere are several ways to install a color theme, but first, we will use the Emacs' internal color-theme library.\n\nLet's try to switch between different themes:\n\n- Type *M-x load-theme RET tango-dark*\n- Then type *M-x load-theme RET wombat*\n- Finally type *M-x load-theme RET whiteboard*\n\nThere is no secret or perfect color theme. There are so many of theme and each user has its preferences in term of colors.\n\n#+CAPTION: color themes\n[[../images/colors.gif]]\n\nIn order to choose yours, try the default ones, see this [[http://gnuemacscolorthemetest.googlecode.com/svn/html/index-el.html][showcase]], make your own or google a lot !\n\n*** Font settings\n\nAfter setting up your theme, there are some other tweaks that are \"color theme related\".\nFonts is something very important depending on your system, your screen size, your current task in Emacs, ... etc\n\nIf you want to change the font directly from your current Emacs instance, simply type *M-x set-frame-font RET*.\nAnd if you want to see all supported fonts, type *TAB* twice. It will show you a list.\n\nThe global and easy way to do it is to add a line to your configuration:\n\n#+BEGIN_SRC lisp\n(set-default-font \"DejaVu Sans Mono-10\")\n#+END_SRC\n\nBut to be safe, you'd better add this into your X resource settings file (~/.Xresources):\n\n#+BEGIN_SRC lisp\nemacs.font: DejaVu Sans Mono-10\n#+END_SRC\n\nOf course, it is possible to set a different font for any system or mode you want. It is cool since you can use different font (size) if you are on Linux or mac OR if you write a book, write code, read your emails, ... etc.\nAs an exercise, I'll let you search how to do this kind of stuff in Emacs Lisp if you need it.\n\nIf you want more about font settings and especially about font names, please see the [[http://www.emacswiki.org/emacs/SetFonts][Emacs wiki page]] or the [[http://www.gnu.org/software/emacs/manual/html_node/emacs/Fonts.html][manual]].\n\nA last point: sometimes you want to change the font size of your current buffer. To do this, simply type:\n\n- *M-x text-scale-increase* or *C-x C-+*\n- *M-x text-scale-decrease* or *C-x C--* (Ctrl x, Ctrl dash)\n\nReally handy if you show your screen through an external display or you want to focus on a specific part of a file.\n\n* Emacs for developers - Emacs developing environments\n\nEmacs, thanks to major or minor modes can be transformed into a powerful specific environment.\n\nAccording to the kind of files you are editing (or a command you type), it can mutate and give you specific features that fits the need of a programming language (or a task like debugging, launching unit tests, ...)\n\n** Emacs for Ruby developers\n\nThere are many ruby developer who decribe their set up around the web. Here are the most popular:\n\n- [[http://devblog.avdi.org/category/emacs-reboot/][The Emacs reboot serie, by Avdi Grimm]] (Avdi is a famous ruby programmer and a great Emacs hacker)\n- [[http://crypt.codemancers.com/posts/2013-09-26-setting-up-emacs-as-development-environment-on-osx/][Setting up Emacs as Ruby development environment on OSX]] (even if it is for OSX, the packages remain the same on all OSes)\n- [[http://lorefnon.me/2014/02/02/configuring-emacs-for-rails.html][Configuring Emacs as a productive development environment for Rails development]]\n- [[http://www.emacswiki.org/emacs/RubyOnRails][The EmacsWiki on Ruby and RoR]]\n\n** Emacs for Python developers\n\nHere are some resources about setting Emacs for developing in python:\n\n- [[http://caisah.info/emacs-for-python/][Emacs for python - on caisah.info]]\n- [[http://www.emacswiki.org/emacs/PythonProgrammingInEmacs][Python programming in Emacs - on the EmacsWiki]]\n\n** Emacs for C/C++/Objective-C\n\nC languages are very well handled by Emacs and it allows you to edit, debug and run programs with Emacs very easily, with all the control you want.\n\n- [[http://tuhdo.github.io/c-ide.html][C/C++ Development Environment for Emacs]] is a very complete article about this\n- [[http://stackoverflow.com/questions/5800317/emacs-as-a-c-programming-ide-configuration][A various tips and packages for C language(s)]] on StackOverflow\n- [[http://truongtx.me/2013/03/10/emacs-setting-up-perfect-environment-for-cc-programming/][Setting up perfect environment for C/C++ Programming]] (according to its auhor. Good resource, though)\n- [[http://www.emacswiki.org/emacs/DebuggingWithEmacs][Debugging with Emacs]]\n- [[http://cedet.sourceforge.net/][CEDET - Collection of Emacs Development Environment Tools]] An amazing collection of tools for developping in many programming languages, especially for C/C++\n- [[http://alexott.net/en/writings/emacs-devenv/EmacsCedet.html][How to configure CEDET]]\n\n** Emacs for Go developers\n\n- If you develop in Go, you really should refer to the great [[http://yousefourabi.com/blog/2014/05/emacs-for-go/][Emacs for Go]] article, written by Yousef Ourabi.\n- Another one, with videos, is written by Dominik Honnef: [[http://dominik.honnef.co/posts/2013/03/writing_go_in_emacs/][Writing Go in Emacs]]\n\n** Emacs for PHP developers\n\nPHP, along with all the web technologies (HTML/JS/CSS) are very well supported in Emacs. The PHP mode does almost all the job by itself.\n\n- [[http://www.emacswiki.org/emacs/PhpMode][The EmacsWiki page about php-mode and other assicated packages]]\n- [[http://stackoverflow.com/questions/912671/what-is-a-good-setup-for-editing-php-in-emacs][A list of useful packages for PHP - on StackOverflow]]\n- [[https://drupal.org/node/59868][An example setup for working on Drupal]] (but can be used for PHP in general)\n- [[https://code.google.com/p/geben-on-emacs/][GEBEN - remote debugging environment for Emacs]]\n- [[http://web-mode.org/][Web Mode - focused on web templates (HTML/JS/CSS)]]\n\n** Emacs for Java developers\n\nJava development is held by Eclipse. But it is not the only editor/environment that allows you to develop in Java !\n\n- [[http://jdee.sourceforge.net/][JDEE - the Java Development Environment for Emacs]]\n- [[http://www.emacswiki.org/emacs/JavaDevelopmentEnvironment][The EmacsWiki article on JDEE]]\n- [[http:][A video demo of a full Java environment on Emacs]]\n\n** Emacs for R and statistics\n\nEmacs is very useful for scientists and people dealing with data. Statistics, analysis, plotting, ... everything can be done within Emacs.\n\n- [[https://github.com/vikasrawal/orgpaper/blob/master/orgpapers.org][An amazing paper on working with Emacs, OrgMode and R]]\n- [[http://ess.r-project.org/][Emacs Speaks Statistics]] is a great project that adds a full statistics environment to your Emacs\n- [[http://stats.blogoverflow.com/2011/08/using-emacs-to-work-with-r/][A tutorial on using ESS]]\n\n* Special features\n\n** Emacs as a file manager\n\nEmacs has a built-in mode named /dired/ that allows you to manage your file system directly in Emacs really easily.\nIt is very powerful and has features that graphical file managers do not have.\n\nFirst of all, to launch it, type:\n\n- *M-x dired RET* and then select a path to open (default is the directory of the file you are editing)\n- or *C-x d* if you prefer keybindings\n\nHere are a few quick shortcuts once you are in /dired mode/\n\n- *R* (capital R): rename a file\n- *D* (capital D): delete a file\n- *+*: create a new directory\n- *Z*: compress the file\n- *RET* (enter): Open the file\n- *g*: refresh\n- *q*: close the dired window\n\nOf course, files can be marked to operate on a selection of them. Use *m* to mark, *u* to unmark (*U* to unmark all), *% m* to mark according to a pattern.\n\nNote that there are so many tricks, extensions and features in /dired mode/ that I let you see around what you need.\n\n[[http://www.emacswiki.org/emacs/DiredMode][Read more about Dired]]\n\n[[https://www.gnu.org/software/emacs/manual/html_node/emacs/Dired.html][Read the manual]]\n\n** Working locally vs remotely\n\nEmacs, once installed on your machine will allow you to edit your file locally, obviously.\n\nOther people (non-Emacs users) will do a dirty trick to edit remote files like they were local files. They will mount the remote directory on their machine (thanks to /sshfs/).\nBut the magic in Emacs is that you can transparently edit remote files on your development servers for example.\nTo do so, Emacs comes with a genious extension named \"Tramp\". It is alreay installed and available when you install Emacs.\n\nIf you press *C-x C-f*, you can open a file. But if you ask =myname@myserver.com:/path/to/file=, it will automatically connect to the server and let you edit the remote file. Easy as pie.\n/Tramp/ supports lots of protocols like ssh, ftp, and so on.\n\nAnd what is great is that if you are editing a remote file and you launch a shell in Emacs, it will automatically set the shell into your remote environment and open it as if you were in the remote directory the file is in.\n\nA last tip about TRAMP. If you simply add =sudo:= in front of your file path, you edit your file with higher privileges. It is a very useful feature if you need to edit your configuration files on a server, for example. Of course, it works remotely and locally.\n\n[[http://www.emacswiki.org/emacs/TrampMode][Read more about Tramp]]\n\n** Organize your work, write papers and manage your agenda\n\nIn Emacs, you can do everything. This is a fact.\n\nOne the most amazing and complete mode is the amazing [[http://orgmode.org][Org mode]], written by amazing people.\nBut when I say amazing, it is absolutly amazing. It allows you to \"live in Emacs\".\n\nHere a a few of its am... features:\n\n- A full agenda / calendar\n- TODO lists and project management\n- Writing (research papers, books, an \"Emacs for developers\" whitepaper, your shopping list ...)\n- Include code in you papers\n- Tables and spreadsheets (with formulas and calculation)\n- Mobile integration\n- ...\n\nAnd what is really cool is that every thing you do in Org is exportable in:\n\n- PDF\n- LaTex\n- HTML\n- Text\n- ODT\n- iCalendar\n- TextInfo\n- ... and many more.\n\nYou really should check their [[http://orgmode.org/features.html][list of features]]\n\nIf you want to see a good example of Org-mode capabilities, check [[http://home.fnal.gov/~neilsen/notebook/orgExamples/org-examples.html][that great page]]\n\n** Emails in Emacs\n\nThere are packages that let you use Emacs as a full featured MUA.\nReading emails, sending emails, filtering, archiving ... etc.\n\nEmacs can be a very powerful and fast e-mail client and as it is controlled by the keyboard, it could be more efficient than a graphical e-mail client (clicking is a loss of time).\nI use it for years now and I can not imagine using another program to read my emails.\n\nThere are several package to do so, but the most used is [[http://www.gnus.org/][Gnus]]. It is already installed with Emacs.\n\nHere are some of its features beside the basic ones:\n\n- Gnus is in fact a newsreader used to interact with email servers. So you can use to fetch messages from newsgroups, RSS, SMTP, POP, ...\n- Easy and powerful mail splitting\n- Integration with BBDB, a contact manager\n- Message scoring\n- LDAP\n- PGP signing and encrypting\n- Customizable layout\n- Encrypted file to manage your credentials\n- ... and many more\n- ... and of course, it is extensible thanks to Lisp\n\nYou really should try it with your personnal account. It is easy to configure and integrate with [[http://www.emacswiki.org/emacs/GnusGmail][Gmail]], for example.\n\nBut be careful! If you try it, you will love it.\n\nSome alternatives to Gnus (that I do not use, but that are popular):\n- [[http://www.emacswiki.org/emacs/WanderLust][Wanderlust]]\n- [[http://www.djcbsoftware.nl/code/mu/mu4e.html][Mu4e]]\n\n** Some great Emacs tips and tricks\n\n- Emacs is all about Macros. This is one of its most powerful feature. Record a sequence and re-play it on other lines! Here is [[http://www.thegeekstuff.com/2010/07/emacs-macro-tutorial-how-to-record-and-play/][how]].\n- Using [[http://www.masteringemacs.org/articles/2010/11/01/running-shells-in-emacs-overview/][shell]] inside Emacs is cool\n- You really should use the /[[http://www.emacswiki.org/emacs/BookMarks][bookmarks]]/ functionnality to save your projects locations (locally or remotely)\n- When opening a file, add /sudo:/ in front of its path in order to edit it as a privileged user\n- You can edit files in hexadecimal directly in Emacs thanks to the /hexl-mode/\n- Emacs allows you to open an archive (gz, bz2, zip, ...), edit its files on-the-fly without extracting yourself the archive. To do so, simple open the file directly in Emacs (*C-x C-f* /path/to/archive.tar.bz2)\n- [[http://www.gnu.org/software/emacs/manual/html_node/emacs/Rectangles.html][Rectangle regions]] edition is really easy\n- [[http://www.cs.bu.edu/teaching/tool/emacs/programming/#compile][Compilation]] and [[http://www.cs.bu.edu/teaching/tool/emacs/programming/#gdb][debugging]] is really well supported in Emacs\n- [[http://www.emacswiki.org/ERC][Erc]] is a great IRC client running in Emacs\n\n/To be continued/\n\n** Coming from other editors (i.e Vim)\n\nSome people use other editors and want to give Emacs a try.\nSome people are really used to use a specific editor.\nSome people do not want to lose their habits and their learning curve.\n\nI am thinking about Vim, but it is also true for other editors (textmate, sublime, ...)\n\nEmacs has a mode that allows you to use it exactly like Vim.\n\nI personnaly never used this mode, but many people use it. Therefore, it allows you to switch gently and softly from Vim to Emacs.\n\n[[http://www.emacswiki.org/emacs/Evil][Read more about Evil-mode]]\n\n* Readings and resources\n\n- [[http://emacsrocks.com/][Emacs rocks videos]]\n- [[http://devblog.avdi.org/category/emacs-reboot/][Avdi Grimm Emacs reboot series]]\n- [[http://www.masteringemacs.org/][Mastering Emacs]]\n- [[http://sachachua.com/blog/category/geek/emacs/][Sacha's blog]] and her wonderful Emacs contributors interviews serie\n- [[http://emacsredux.com][Emacs redux]] by Bozhidar Batsov\n- [[http://planet.emacsen.org/][Planet Emacsen]]\n- [[http://reddit.com/r/emacs][Emacs sub-reddit]]\n\nAnd of course, the [[http://www.emacswiki.org/][Emacs wiki]]\n\n* License\n\nThe content of this project itself is licensed under the [[http://creativecommons.org/licenses/by/3.0/us/deed.en_US][Creative Commons Attribution 3.0 license]], and the underlying source code used to format and display that content is licensed under the [[http://opensource.org/licenses/mit-license.php][MIT license]].\n\nContributors list can be found [[https://github.com/pierre-lecocq/emacs4developers/network/members][here]].\n\n* Thanks\n\nI want to thank some of the great people who make Emacs a very intersting piece of software or make its community very active (the sort order is absolutly not important here):\n\nBastien Guerry, Dimitri Fontaine, Julien Danjou, Sacha Chua, Steve Purcell, Nic Ferrier, Avdi Grimm, Magnars, Steve Yegge, Bozhidar Batsov, Xah Lee, and many more ...\n\nYou should check those people and their work over the web, twitter, youtube, ...\n\nAnd thank you for reading this !\n" } ]