mirror of
				https://github.com/larstvei/dot-emacs.git
				synced 2025-11-04 01:20:11 +00:00 
			
		
		
		
	Tweaked the markdown.
This commit is contained in:
		
							parent
							
								
									e21fc91384
								
							
						
					
					
						commit
						eac3bdfe80
					
				
							
								
								
									
										139
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										139
									
								
								README.md
									
									
									
									
									
								
							@ -62,6 +62,7 @@ To avoid doing this each time a change is made we can add a function to
 | 
			
		||||
the `after-save-hook` ensuring to always tangle and byte-compile the
 | 
			
		||||
`org`-document after changes.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun init-hook ()
 | 
			
		||||
  "If the current buffer is 'init.org' the code-blocks are
 | 
			
		||||
tangled, and the tangled file is compiled."
 | 
			
		||||
@ -71,6 +72,7 @@ the `after-save-hook` ensuring to always tangle and byte-compile the
 | 
			
		||||
    (byte-compile-file (concat user-emacs-directory "init.el"))))
 | 
			
		||||
 | 
			
		||||
(add-hook 'after-save-hook 'init-hook)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Package
 | 
			
		||||
 | 
			
		||||
@ -78,18 +80,23 @@ Managing extensions for Emacs is simplified using `package` which
 | 
			
		||||
is built in to Emacs 24 and newer. To load downloaded packages we
 | 
			
		||||
need to initialize `package`.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(require 'package)
 | 
			
		||||
(package-initialize)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Packages can be fetched from different mirrors, [melpa](http://melpa.milkbox.net/#/) is the largest
 | 
			
		||||
archive and is well maintained.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-to-list 'package-archives
 | 
			
		||||
             '("MELPA" . "http://melpa.milkbox.net/packages/") t)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
We can define a predicate that tells us wither or not the newest version
 | 
			
		||||
of a package is installed.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun newest-package-installed-p (package)
 | 
			
		||||
  "Return true if the newest available PACKAGE is installed."
 | 
			
		||||
  (when (package-installed-p package)
 | 
			
		||||
@ -99,11 +106,13 @@ of a package is installed.
 | 
			
		||||
      (and local-pkg-desc newest-pkg-desc
 | 
			
		||||
           (version-list-= (package-desc-vers (cdr local-pkg-desc))
 | 
			
		||||
                           (package-desc-vers (cdr newest-pkg-desc)))))))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Let's write a function to install a package if it is not installed or
 | 
			
		||||
upgrades it if a new version has been released. Here our predicate comes
 | 
			
		||||
in handy.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun upgrade-or-install-package (package)
 | 
			
		||||
  "Unless the newest available version of PACKAGE is installed
 | 
			
		||||
PACKAGE is installed and the current version is deleted."
 | 
			
		||||
@ -114,6 +123,7 @@ in handy.
 | 
			
		||||
                        (package-version-join
 | 
			
		||||
                         (package-desc-vers (cdr pkg-desc)))))
 | 
			
		||||
      (package-install package))))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
The `package-refresh-contents` function downloads archive descriptions,
 | 
			
		||||
this is a major bottleneck in this configuration. To avoid this we can
 | 
			
		||||
@ -123,10 +133,12 @@ second specifies wither one should update during the initialization. The
 | 
			
		||||
third is a path to a file where a time-stamp is stored in order to check
 | 
			
		||||
when packages were updated last.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defvar days-between-updates 1)
 | 
			
		||||
(defvar do-package-update-on-init t)
 | 
			
		||||
(defvar package-last-update-file
 | 
			
		||||
  (expand-file-name (concat user-emacs-directory ".package-last-update")))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
The tricky part is figuring out when the last time the Emacs was updated!
 | 
			
		||||
Here is a hacky way of doing it, using [time-stamps](http://www.gnu.org/software/emacs/manual/html_node/emacs/Time-Stamps.html). By adding a
 | 
			
		||||
@ -134,6 +146,7 @@ time-stamp to the a file, we can determine wither or not to do an
 | 
			
		||||
update. After that we must run the `time-stamp`-function to update the
 | 
			
		||||
time-stamp.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(require 'time-stamp)
 | 
			
		||||
;; Open the package-last-update-file
 | 
			
		||||
(with-temp-file package-last-update-file
 | 
			
		||||
@ -157,11 +170,13 @@ time-stamp.
 | 
			
		||||
    ;; If no such file exists it is created with a time-stamp.
 | 
			
		||||
    (insert "Time-stamp: <>")
 | 
			
		||||
    (time-stamp)))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Now we can use the function above to make sure packages are installed and
 | 
			
		||||
up to date. Here are some packages I find useful (some of these
 | 
			
		||||
configurations are also dependent on them).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(when do-package-update-on-init
 | 
			
		||||
  (package-refresh-contents)
 | 
			
		||||
 | 
			
		||||
@ -188,12 +203,14 @@ configurations are also dependent on them).
 | 
			
		||||
             pretty-lambdada   ; the word `lambda' as the Greek letter.
 | 
			
		||||
             smex))            ; M-x interface with Ido-style fuzzy matching.
 | 
			
		||||
    (upgrade-or-install-package package)))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Require
 | 
			
		||||
 | 
			
		||||
Some features are not loaded by default to minimize initialization time,
 | 
			
		||||
so they have to be required (or loaded, if you will).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(dolist (feature
 | 
			
		||||
         '(auto-compile             ; auto-compile .el files
 | 
			
		||||
           auto-complete-config     ; a configuration for auto-complete-mode
 | 
			
		||||
@ -203,6 +220,7 @@ so they have to be required (or loaded, if you will).
 | 
			
		||||
           recentf                  ; recently opened files
 | 
			
		||||
           tex-mode))               ; TeX, LaTeX, and SliTeX mode commands
 | 
			
		||||
  (require feature))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Sane defaults
 | 
			
		||||
 | 
			
		||||
@ -210,6 +228,7 @@ These are what *I* consider to be saner defaults.
 | 
			
		||||
 | 
			
		||||
We can set variables to whatever value we'd like using `setq`.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(setq initial-scratch-message nil     ; Clean scratch buffer.
 | 
			
		||||
      inhibit-startup-message t       ; No splash screen please.
 | 
			
		||||
      default-input-method "TeX"      ; Use TeX when toggeling input method.
 | 
			
		||||
@ -221,33 +240,42 @@ We can set variables to whatever value we'd like using `setq`.
 | 
			
		||||
(when (boundp 'mac-pass-command-to-system)
 | 
			
		||||
  (setq mac-pass-command-to-system nil))
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Some variables are buffer-local, so changing them using `setq` will only
 | 
			
		||||
change them in a single buffer. Using `setq-default` we change the
 | 
			
		||||
buffer-local variable's default value.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(setq-default fill-column 76                    ; Maximum line width.
 | 
			
		||||
              indent-tabs-mode nil              ; Use spaces instead of tabs.
 | 
			
		||||
              split-width-threshold 100         ; Split verticly by default.
 | 
			
		||||
              auto-fill-function 'do-auto-fill) ; Auto-fill-mode everywhere.
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
The `load-path` specifies where Emacs should look for `.el`-files (or
 | 
			
		||||
Emacs lisp files). I have a directory called `site-lisp` where I keep all
 | 
			
		||||
extensions that have been installed manually (these are mostly my own
 | 
			
		||||
projects).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(let ((default-directory (concat user-emacs-directory "site-lisp/")))
 | 
			
		||||
  (when (file-exists-p default-directory)
 | 
			
		||||
    (normal-top-level-add-to-load-path '("."))
 | 
			
		||||
    (normal-top-level-add-subdirs-to-load-path)))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Answering *yes* and *no* to each question from Emacs can be tedious, a
 | 
			
		||||
single *y* or *n* will suffice.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(fset 'yes-or-no-p 'y-or-n-p)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To avoid file system clutter we put all auto saved files in a single
 | 
			
		||||
directory.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defvar emacs-autosave-directory
 | 
			
		||||
  (concat user-emacs-directory "autosaves/")
 | 
			
		||||
  "This variable dictates where to put auto saves. It is set to a
 | 
			
		||||
@ -259,25 +287,34 @@ directory.
 | 
			
		||||
      `((".*" . ,emacs-autosave-directory))
 | 
			
		||||
      auto-save-file-name-transforms
 | 
			
		||||
      `((".*" ,emacs-autosave-directory t)))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Set `utf-8` as preferred coding system.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(set-language-environment "UTF-8")
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
By default the `narrow-to-region` command is disabled and issues a
 | 
			
		||||
warning, because it might confuse new users. I find it useful sometimes,
 | 
			
		||||
and don't want to be warned.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(put 'narrow-to-region 'disabled nil)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Call `auto-complete` default configuration, which enables `auto-complete`
 | 
			
		||||
globally.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(ac-config-default)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Automaticly revert `doc-view`-buffers when the file changes on disk.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-hook 'doc-view-mode-hook 'auto-revert-mode)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Modes
 | 
			
		||||
 | 
			
		||||
@ -285,15 +322,18 @@ There are some modes that are enabled by default that I don't find
 | 
			
		||||
particularly useful. We create a list of these modes, and disable all of
 | 
			
		||||
these.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(dolist (mode
 | 
			
		||||
         '(tool-bar-mode                ; No toolbars, more room for text.
 | 
			
		||||
           scroll-bar-mode              ; No scroll bars either.
 | 
			
		||||
           blink-cursor-mode))          ; The blinking cursor gets old.
 | 
			
		||||
  (funcall mode 0))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Let's apply the same technique for enabling modes that are disabled by
 | 
			
		||||
default.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(dolist (mode
 | 
			
		||||
         '(abbrev-mode                ; E.g. sopl -> System.out.println.
 | 
			
		||||
           auto-compile-on-load-mode  ; Compile .el files on load ...
 | 
			
		||||
@ -303,21 +343,28 @@ default.
 | 
			
		||||
           recentf-mode               ; Recently opened files.
 | 
			
		||||
           show-paren-mode))          ; Highlight matching parentheses.
 | 
			
		||||
  (funcall mode 1))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
This makes `.md`-files open in `markdown-mode`.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-to-list 'auto-mode-alist '("\\.md\\'" . markdown-mode))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Visual
 | 
			
		||||
 | 
			
		||||
Change the color-theme to `monokai` (downloaded using `package`).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(load-theme 'monokai t)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Use the [Inconsolata](http://www.levien.com/type/myfonts/inconsolata.html) font if it's installed on the system.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(when (member "Inconsolata" (font-family-list))
 | 
			
		||||
  (set-face-attribute 'default nil :font "Inconsolata-13"))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Ido
 | 
			
		||||
 | 
			
		||||
@ -327,37 +374,46 @@ names you can write a part of it and select one from a list of
 | 
			
		||||
possibilities. Using `ido-vertical-mode` changes the way possibilities
 | 
			
		||||
are displayed, and `flx-ido-mode` enables fuzzy matching.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(dolist (mode
 | 
			
		||||
         '(ido-mode                   ; Interactivly do.
 | 
			
		||||
           ido-everywhere             ; Use Ido for all buffer/file reading.
 | 
			
		||||
           ido-vertical-mode          ; Makes ido-mode display vertically.
 | 
			
		||||
           flx-ido-mode))             ; Toggle flx ido mode.
 | 
			
		||||
  (funcall mode 1))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
We can set the order of file selections in `ido`. I prioritize source
 | 
			
		||||
files along with `org`- and `tex`-files.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(setq ido-file-extensions-order
 | 
			
		||||
      '(".el" ".scm" ".lisp" ".java" ".c" ".h" ".org" ".tex"))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Sometimes when using `ido-switch-buffer` the `*Messages*` buffer get in
 | 
			
		||||
the way, so we set it to be ignored (it can be accessed using `C-h e`, so
 | 
			
		||||
there is really no need for it in the buffer list).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-to-list 'ido-ignore-buffers "*Messages*")
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To make `M-x` behave more like `ido-mode` we can use the `smex`
 | 
			
		||||
package. It needs to be initialized, and we can replace the binding to
 | 
			
		||||
the standard `execute-extended-command` with `smex`.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(smex-initialize)
 | 
			
		||||
(global-set-key (kbd "M-x") 'smex)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Calendar
 | 
			
		||||
 | 
			
		||||
Define a function to display week numbers in `calender-mode`. The snippet
 | 
			
		||||
is from [EmacsWiki](http://www.emacswiki.org/emacs/CalendarWeekNumbers).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun calendar-show-week (arg)
 | 
			
		||||
  "Displaying week number in calendar-mode."
 | 
			
		||||
  (interactive "P")
 | 
			
		||||
@ -373,17 +429,22 @@ is from [EmacsWiki](http://www.emacswiki.org/emacs/CalendarWeekNumbers).
 | 
			
		||||
                      (calendar-absolute-from-gregorian
 | 
			
		||||
                       (list month day year)))))
 | 
			
		||||
               'font-lock-face 'calendar-iso-week-face))))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Evaluate the `calendar-show-week` function.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(calendar-show-week t)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Set Monday as the first day of the week, and set my location.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(setq calendar-week-start-day 1
 | 
			
		||||
      calendar-latitude 60.0
 | 
			
		||||
      calendar-longitude 10.7
 | 
			
		||||
      calendar-location-name "Oslo, Norway")
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Mail
 | 
			
		||||
 | 
			
		||||
@ -392,6 +453,7 @@ computers. Because the mail-setup wont work without these programs
 | 
			
		||||
installed we bind `load-mail-setup` to `nil`. If the value is changed to
 | 
			
		||||
a `non-nil` value mail is setup.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defvar load-mail-setup nil)
 | 
			
		||||
 | 
			
		||||
(when load-mail-setup
 | 
			
		||||
@ -442,49 +504,62 @@ a `non-nil` value mail is setup.
 | 
			
		||||
 | 
			
		||||
  ;; Overwrite the native 'compose-mail' binding to 'show-mu4e'.
 | 
			
		||||
  (global-set-key (kbd "C-x m") 'mu4e))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Flyspell
 | 
			
		||||
 | 
			
		||||
Flyspell offers on-the-fly spell checking. We can enable flyspell for all
 | 
			
		||||
text-modes with this snippet.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-hook 'text-mode-hook 'turn-on-flyspell)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To use flyspell for programming there is `flyspell-prog-mode`, that only
 | 
			
		||||
enables spell checking for comments and strings. We can enable it for all
 | 
			
		||||
programming modes using the `prog-mode-hook`. Flyspell interferes with
 | 
			
		||||
auto-complete mode, but there is a workaround provided by auto complete.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-hook 'prog-mode-hook 'flyspell-prog-mode)
 | 
			
		||||
(ac-flyspell-workaround)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To cycle through dictionary's we can define a variable containing a
 | 
			
		||||
cyclic list of installed language packs.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defvar ispell-languages '#1=("english" "norsk" . #1#))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Now we only need a small function to change set the language and shift
 | 
			
		||||
the list.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun cycle-languages ()
 | 
			
		||||
  "Changes the ispell-dictionary to whatever is the next (or cdr) in the
 | 
			
		||||
LANGUAGES (cyclic) list."
 | 
			
		||||
  (interactive)
 | 
			
		||||
  (ispell-change-dictionary
 | 
			
		||||
   (car (setq ispell-languages (cdr ispell-languages)))))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Org
 | 
			
		||||
 | 
			
		||||
I use `org-agenda` for appointments and such.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(setq org-agenda-start-on-weekday nil              ; Show agenda from today.
 | 
			
		||||
      org-agenda-files '("~/Dropbox/life.org")     ; A list of agenda files.
 | 
			
		||||
      org-agenda-default-appointment-duration 120) ; 2 hours appointments.
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
When editing org-files with source-blocks, we want the source blocks to
 | 
			
		||||
be themed as they would in their native mode.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(setq org-src-fontify-natively t)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Interactive functions
 | 
			
		||||
 | 
			
		||||
@ -493,35 +568,42 @@ be themed as they would in their native mode.
 | 
			
		||||
To search recent files useing `ido-mode` we add this snippet from
 | 
			
		||||
[EmacsWiki](http://www.emacswiki.org/emacs/CalendarWeekNumbers).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun recentf-ido-find-file ()
 | 
			
		||||
  "Find a recent file using Ido."
 | 
			
		||||
  (interactive)
 | 
			
		||||
  (let ((f (ido-completing-read "Choose recent file: " recentf-list nil t)))
 | 
			
		||||
    (when f
 | 
			
		||||
      (find-file f))))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
`just-one-space` removes all whitespace around a point - giving it a
 | 
			
		||||
negative argument it removes newlines as well. We wrap a interactive
 | 
			
		||||
function around it to be able to bind it to a key.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun remove-whitespace-inbetween ()
 | 
			
		||||
  "Removes whitespace before and after the point."
 | 
			
		||||
  (interactive)
 | 
			
		||||
  (just-one-space -1))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
This interactive function switches you to a `shell`, and if triggered in
 | 
			
		||||
the shell it switches back to the previous buffer.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun switch-to-shell ()
 | 
			
		||||
  "Jumps to eshell or back."
 | 
			
		||||
  (interactive)
 | 
			
		||||
  (if (string= (buffer-name) "*shell*")
 | 
			
		||||
      (switch-to-prev-buffer)
 | 
			
		||||
    (shell)))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To duplicate either selected text or a line we define this interactive
 | 
			
		||||
function.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun duplicate-thing ()
 | 
			
		||||
  "Ethier duplicates the line or the region"
 | 
			
		||||
  (interactive)
 | 
			
		||||
@ -532,9 +614,11 @@ function.
 | 
			
		||||
      (unless (region-active-p)
 | 
			
		||||
        (newline))
 | 
			
		||||
      (insert (buffer-substring start end)))))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To tidy up a buffer we define this function borrowed from [simenheg](https://github.com/simenheg).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun tidy ()
 | 
			
		||||
  "Ident, untabify and unwhitespacify current buffer, or region if active."
 | 
			
		||||
  (interactive)
 | 
			
		||||
@ -543,47 +627,62 @@ To tidy up a buffer we define this function borrowed from [simenheg](https://git
 | 
			
		||||
    (indent-region beg end)
 | 
			
		||||
    (whitespace-cleanup)
 | 
			
		||||
    (untabify beg (if (< end (point-max)) end (point-max)))))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Key bindings
 | 
			
		||||
 | 
			
		||||
Bindings for [expand-region](https://github.com/magnars/expand-region.el).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(global-set-key (kbd "C-'")  'er/expand-region)
 | 
			
		||||
(global-set-key (kbd "C-;")  'er/contract-region)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Bindings for [multiple-cursors](https://github.com/magnars/multiple-cursors.el).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(global-set-key (kbd "C-c e")  'mc/edit-lines)
 | 
			
		||||
(global-set-key (kbd "C-c a")  'mc/mark-all-like-this)
 | 
			
		||||
(global-set-key (kbd "C-c n")  'mc/mark-next-like-this)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Bindings for [Magit](http://magit.github.io).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(global-set-key (kbd "C-c m") 'magit-status)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Bindings for [ace-jump-mode](https://github.com/winterTTr/ace-jump-mode).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(global-set-key (kbd "C-c SPC") 'ace-jump-mode)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Bindings for `move-text`.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(global-set-key (kbd "<M-S-up>")    'move-text-up)
 | 
			
		||||
(global-set-key (kbd "<M-S-down>")  'move-text-down)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Bind some native Emacs functions.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(global-set-key (kbd "C-c s")    'ispell-word)
 | 
			
		||||
(global-set-key (kbd "C-c t")    'org-agenda-list)
 | 
			
		||||
(global-set-key (kbd "C-x k")    'kill-this-buffer)
 | 
			
		||||
(global-set-key (kbd "C-x C-r")  'recentf-ido-find-file)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Bind the functions defined above.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(global-set-key (kbd "C-c l")    'cycle-languages)
 | 
			
		||||
(global-set-key (kbd "C-c j")    'remove-whitespace-inbetween)
 | 
			
		||||
(global-set-key (kbd "C-x t")    'switch-to-shell)
 | 
			
		||||
(global-set-key (kbd "C-c d")    'duplicate-thing)
 | 
			
		||||
(global-set-key (kbd "<C-tab>")  'tidy)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Advice
 | 
			
		||||
 | 
			
		||||
@ -591,6 +690,7 @@ An advice can be given to a function to make it behave differently. This
 | 
			
		||||
advice makes `eval-last-sexp` (bound to `C-x C-e`) replace the sexp with
 | 
			
		||||
the value.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defadvice eval-last-sexp (around replace-sexp (arg) activate)
 | 
			
		||||
  "Replace sexp when called with a prefix argument."
 | 
			
		||||
  (if arg
 | 
			
		||||
@ -600,20 +700,25 @@ the value.
 | 
			
		||||
        (backward-kill-sexp)
 | 
			
		||||
        (forward-sexp))
 | 
			
		||||
    ad-do-it))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
`Flyspell` signals an error if there is no spell-checking tool is
 | 
			
		||||
installed. We can advice `turn-on=flyspell` and `flyspell-prog-mode` to
 | 
			
		||||
only try to enable `flyspell` if a spell-checking tool is avalible.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defadvice turn-on-flyspell (around check nil activate)
 | 
			
		||||
  "Turns on flyspell only if a spell-checking tool is installed."
 | 
			
		||||
  (when (executable-find ispell-program-name)
 | 
			
		||||
    ad-do-it))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defadvice flyspell-prog-mode (around check nil activate)
 | 
			
		||||
  "Turns on flyspell only if a spell-checking tool is installed."
 | 
			
		||||
  (when (executable-find ispell-program-name)
 | 
			
		||||
    ad-do-it))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
# Language mode specific
 | 
			
		||||
 | 
			
		||||
@ -624,25 +729,31 @@ only try to enable `flyspell` if a spell-checking tool is avalible.
 | 
			
		||||
can add some extra lisp-modes. We run the `pretty-lambda-for-modes`
 | 
			
		||||
function to activate `pretty-lambda-mode` in lisp modes.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(dolist (mode '(slime-repl-mode geiser-repl-mode))
 | 
			
		||||
  (add-to-list 'pretty-lambda-auto-modes mode))
 | 
			
		||||
 | 
			
		||||
(pretty-lambda-for-modes)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
I use `Paredit` when editing lisp code, we enable this for all lisp-modes
 | 
			
		||||
in the `pretty-lambda-auto-modes` list.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(dolist (mode pretty-lambda-auto-modes)
 | 
			
		||||
  ;; add paredit-mode to all mode-hooks
 | 
			
		||||
  (add-hook (intern (concat (symbol-name mode) "-hook")) 'paredit-mode))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Emacs Lisp
 | 
			
		||||
 | 
			
		||||
In `emacs-lisp-mode` we can enable `eldoc-mode` to display information
 | 
			
		||||
about a function or a variable in the echo area.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-hook 'emacs-lisp-mode-hook 'turn-on-eldoc-mode)
 | 
			
		||||
(add-hook 'lisp-interaction-mode-hook 'turn-on-eldoc-mode)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Common lisp
 | 
			
		||||
 | 
			
		||||
@ -652,21 +763,27 @@ Common Lisp developer. [Quicklisp](http://www.quicklisp.org/beta/) is a library
 | 
			
		||||
and you can install Slime following the instructions from the site along
 | 
			
		||||
with this snippet.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(when (file-exists-p "~/quicklisp/slime-helper.elc")
 | 
			
		||||
  (load (expand-file-name "~/quicklisp/slime-helper.elc")))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
We can specify what Common Lisp program Slime should use (I use SBCL).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(setq inferior-lisp-program "sbcl")
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To improve auto completion for Common Lisp editing we can use `ac-slime`
 | 
			
		||||
which uses slime completions as a source.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-hook 'slime-mode-hook 'set-up-slime-ac)
 | 
			
		||||
(add-hook 'slime-repl-mode-hook 'set-up-slime-ac)
 | 
			
		||||
 | 
			
		||||
(eval-after-load "auto-complete"
 | 
			
		||||
  '(add-to-list 'ac-modes 'slime-repl-mode))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Scheme
 | 
			
		||||
 | 
			
		||||
@ -674,11 +791,13 @@ which uses slime completions as a source.
 | 
			
		||||
works pretty much out of the box, we only need to add auto completion,
 | 
			
		||||
and specify which scheme-interpreter we prefer.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-hook 'geiser-mode-hook 'ac-geiser-setup)
 | 
			
		||||
(add-hook 'geiser-repl-mode-hook 'ac-geiser-setup)
 | 
			
		||||
(eval-after-load "auto-complete"
 | 
			
		||||
  '(add-to-list 'ac-modes 'geiser-repl-mode))
 | 
			
		||||
(setq geiser-active-implementations '(racket))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Java and C
 | 
			
		||||
 | 
			
		||||
@ -686,27 +805,33 @@ The `c-mode-common-hook` is a general hook that work on all C-like
 | 
			
		||||
languages (C, C++, Java, etc…). I like being able to quickly compile
 | 
			
		||||
using `C-c C-c` (instead of `M-x compile`), a habit from `latex-mode`.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun c-setup ()
 | 
			
		||||
  (local-set-key (kbd "C-c C-c") 'compile))
 | 
			
		||||
 | 
			
		||||
(add-hook 'c-mode-common-hook 'c-setup)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Some statements in Java appear often, and become tedious to write
 | 
			
		||||
out. We can use abbrevs to speed this up.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(define-abbrev-table 'java-mode-abbrev-table
 | 
			
		||||
  '(("psv" "public static void main(String[] args) {" nil 0)
 | 
			
		||||
    ("sopl" "System.out.println" nil 0)
 | 
			
		||||
    ("sop" "System.out.printf" nil 0)))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To be able to use the abbrev table defined above, `abbrev-mode` must be
 | 
			
		||||
activated.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun java-setup ()
 | 
			
		||||
  (abbrev-mode t)
 | 
			
		||||
  (setq-local compile-command (concat "javac " (buffer-name))))
 | 
			
		||||
 | 
			
		||||
(add-hook 'java-mode-hook 'java-setup)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Assembler
 | 
			
		||||
 | 
			
		||||
@ -714,24 +839,30 @@ When writing assembler code I use `#` for comments. By defining
 | 
			
		||||
`comment-start` we can add comments using `M-;` like in other programming
 | 
			
		||||
modes. Also in assembler should one be able to compile using `C-c C-c`.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(defun asm-setup ()
 | 
			
		||||
  (setq comment-start "#")
 | 
			
		||||
  (local-set-key (kbd "C-c C-c") 'compile))
 | 
			
		||||
 | 
			
		||||
(add-hook 'asm-mode-hook 'asm-setup)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## LaTeX
 | 
			
		||||
 | 
			
		||||
`.tex`-files should be associated with `latex-mode` instead of
 | 
			
		||||
`tex-mode`.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-to-list 'auto-mode-alist '("\\.tex\\'" . latex-mode))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
I like using the [Minted](https://code.google.com/p/minted/) package for source blocks in LaTeX. To make org
 | 
			
		||||
use this we add the following snippet.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-to-list 'org-latex-packages-alist '("" "minted"))
 | 
			
		||||
(setq org-latex-listings 'minted)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Because [Minted](https://code.google.com/p/minted/) uses [Pygments](http://pygments.org) (an external process), we must add the
 | 
			
		||||
`-shell-escape` option to the `org-latex-pdf-process` commands. The
 | 
			
		||||
@ -739,6 +870,7 @@ Because [Minted](https://code.google.com/p/minted/) uses [Pygments](http://pygme
 | 
			
		||||
Tex- and LaTeX-mode, we can add the flag with a rather dirty statement
 | 
			
		||||
(if anyone finds a nicer way to do this, please let me know).
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(setq org-latex-pdf-process
 | 
			
		||||
      (mapcar
 | 
			
		||||
       (lambda (str)
 | 
			
		||||
@ -747,6 +879,7 @@ Tex- and LaTeX-mode, we can add the flag with a rather dirty statement
 | 
			
		||||
       org-latex-pdf-process))
 | 
			
		||||
 | 
			
		||||
(setcar (cdr (cddaar tex-compile-commands)) " -shell-escape ")
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Python
 | 
			
		||||
 | 
			
		||||
@ -754,12 +887,14 @@ Tex- and LaTeX-mode, we can add the flag with a rather dirty statement
 | 
			
		||||
dependent on some python programs as well, so make sure you follow the
 | 
			
		||||
instructions from the site.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(setq jedi:server-command
 | 
			
		||||
      (cons "python3" (cdr jedi:server-command))
 | 
			
		||||
      python-shell-interpreter "python3")
 | 
			
		||||
(add-hook 'python-mode-hook 'jedi:setup)
 | 
			
		||||
(setq jedi:complete-on-dot t)
 | 
			
		||||
(add-hook 'python-mode-hook 'jedi:ac-setup)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Haskell
 | 
			
		||||
 | 
			
		||||
@ -767,12 +902,16 @@ instructions from the site.
 | 
			
		||||
the echo area. Haskell has several indentation modes - I prefer using
 | 
			
		||||
`haskell-indent`.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-hook 'haskell-mode-hook 'turn-on-haskell-doc-mode)
 | 
			
		||||
(add-hook 'haskell-mode-hook 'turn-on-haskell-indent)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Matlab
 | 
			
		||||
 | 
			
		||||
Matlab is very similar to Octave, which is supported by Emacs. We just
 | 
			
		||||
need to let `.m`-files be associated with `octave-mode`.
 | 
			
		||||
 | 
			
		||||
```lisp
 | 
			
		||||
(add-to-list 'auto-mode-alist '("\\.m$" . octave-mode))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
		Loading…
	
		Reference in New Issue
	
	Block a user