Run fill-paragraph on several written sections

This commit is contained in:
Ivan Malison 2016-08-10 19:49:06 -07:00
parent f380292a19
commit f3242abab6
No known key found for this signature in database
GPG Key ID: 62530EFBE99DC2F8

View File

@ -1,8 +1,10 @@
* About * About
This README is a literate version of my emacs configuration, but it also serves as the README for my dotfiles. This README is a literate version of my emacs configuration, but it
also serves as the README for my dotfiles.
* General * General
** Lexical Binding ** Lexical Binding
This makes it so that the file that is produced from tangling this file uses lexical scoping This makes it so that the file that is produced from tangling this
file uses lexical scoping.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
;;; -*- lexical-binding: t -*- ;;; -*- lexical-binding: t -*-
(setq lexical-binding t) (setq lexical-binding t)
@ -17,7 +19,7 @@ This makes it so that the file that is produced from tangling this file uses lex
"git config --get user.email"))) "git config --get user.email")))
#+END_SRC #+END_SRC
** Setup auto-compile ** Setup auto-compile
This is here because it needs to be activated as early as possible This is here because it needs to be activated as early as possible.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(when (boundp 'use-package) (when (boundp 'use-package)
(use-package auto-compile (use-package auto-compile
@ -28,14 +30,23 @@ This is here because it needs to be activated as early as possible
(auto-compile-on-save-mode)))) (auto-compile-on-save-mode))))
#+END_SRC #+END_SRC
** Prefer Newer Versions ** Prefer Newer Versions
To reduce the risk of loading outdated byte code files, we set load-prefer-newer and enable auto-compile-on-load-mode as early as possible. To reduce the risk of loading outdated byte code files, we set
load-prefer-newer and enable auto-compile-on-load-mode as early as
possible.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(setq load-prefer-newer t) (setq load-prefer-newer t)
#+END_SRC #+END_SRC
** Custom Files ** Custom Files
It's annoying to have emacs randomly add stuff to your init.el whenever you customize a variable. By setting a custom file other than init.el that is ignored in git, random commits with nothing but variable settings are avoided. It's annoying to have emacs randomly add stuff to your init.el
whenever you customize a variable. By setting a custom file other than
init.el that is ignored in git, random commits with nothing but
variable settings are avoided.
custom-before.el is loaded before the rest of init.el, while custom-after.el is loaded afterwards. this-machine.el has customizations that should only apply to the current machine. custom-before and custom-after are not version controlled in the dotfiles repo but they are shared across machines elsewhere. custom-before.el is loaded before the rest of init.el, while
custom-after.el is loaded afterwards. this-machine.el has
customizations that should only apply to the current machine.
custom-before and custom-after are not version controlled in the
dotfiles repo but they are shared across machines elsewhere.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(defvar machine-custom "~/.emacs.d/this-machine.el") (defvar machine-custom "~/.emacs.d/this-machine.el")
(defvar custom-after-file "~/.emacs.d/custom-after.el") (defvar custom-after-file "~/.emacs.d/custom-after.el")
@ -44,14 +55,17 @@ custom-before.el is loaded before the rest of init.el, while custom-after.el is
(when (file-exists-p machine-custom) (load machine-custom)) (when (file-exists-p machine-custom) (load machine-custom))
#+END_SRC #+END_SRC
** Benchmarking ** Benchmarking
This appears here so that it can accurately benchmark as much of startup as possible. This appears here so that it can accurately benchmark as much of
startup as possible.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(defvar imalison:do-benchmark) (defvar imalison:do-benchmark)
(when (bound-and-true-p imalison:do-benchmark) (when (bound-and-true-p imalison:do-benchmark)
(use-package benchmark-init)) (use-package benchmark-init))
#+END_SRC #+END_SRC
** GUI Disables ** GUI Disables
Death to any gui elements in emacs! Do this EARLY so that emacs doesn't redisplay in a way that is visually unpleasant on startup a bunch of times. Death to any gui elements in emacs! Do this EARLY so that emacs
doesn't redisplay in a way that is visually unpleasant on startup a
bunch of times.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(when (fboundp 'menu-bar-mode) (menu-bar-mode -1)) (when (fboundp 'menu-bar-mode) (menu-bar-mode -1))
(when (fboundp 'tool-bar-mode) (tool-bar-mode -1)) (when (fboundp 'tool-bar-mode) (tool-bar-mode -1))
@ -62,7 +76,7 @@ Tooltips are annoying:
(if (fboundp 'tooltip-mode) (tooltip-mode -1) (setq tooltip-use-echo-area t))' (if (fboundp 'tooltip-mode) (tooltip-mode -1) (setq tooltip-use-echo-area t))'
#+END_SRC #+END_SRC
** Byte-Compiler ** Byte-Compiler
These definitions silence the byte-compiler These definitions silence the byte-compiler.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(defvar ido-cur-item nil) (defvar ido-cur-item nil)
(defvar ido-default-item nil) (defvar ido-default-item nil)
@ -137,7 +151,10 @@ These definitions silence the byte-compiler
[[(org setup)][The org archive]] does not support https, so we set http as the protocol explicitly. [[(org setup)][The org archive]] does not support https, so we set http as the protocol explicitly.
I've decided to stop using [[(marmalade)][Marmalade]] completely I've decided to stop using [[(marmalade)][Marmalade]] completely
** Bootstrap Package Loading ** Bootstrap Package Loading
Its a shame that everyone has to have some version of this function in their init.el. I use use-package's own mechanism for ensuring packages are installed so my version of ~ensure-packages-installed~ is really only used to download use-package itself. Its a shame that everyone has to have some version of this function in
their init.el. I use use-package's own mechanism for ensuring packages
are installed so my version of ~ensure-packages-installed~ is really
only used to download use-package itself.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(defun ensure-packages-installed (packages) (defun ensure-packages-installed (packages)
(unless package-archive-contents (unless package-archive-contents
@ -176,7 +193,9 @@ Ensure by default since most of the package for which I use use-package need to
(line-number-mode t) (line-number-mode t)
(column-number-mode t) (column-number-mode t)
#+END_SRC #+END_SRC
Linum can be really slow so do not have it on by default. Its probably safe to turn it on when in a programming mode Linum can be really slow on large files so it does not make sense to
have it on by default. Its probably safe to turn it on when in a
programming mode.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(global-linum-mode -1) (global-linum-mode -1)
(add-hook 'prog-mode-hook (lambda () (linum-mode t))) (add-hook 'prog-mode-hook (lambda () (linum-mode t)))
@ -250,7 +269,8 @@ Disable CJK coding/encoding (Chinese/Japanese/Korean characters)
(setq utf-translate-cjk-mode nil) (setq utf-translate-cjk-mode nil)
#+END_SRC #+END_SRC
** Visible Bell ** Visible Bell
This is set to true to disable the annoying audible bell that plays whenever there is an error. This is set to true to disable the annoying audible bell that plays
whenever there is an error.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(setq visible-bell t) (setq visible-bell t)
#+END_SRC #+END_SRC
@ -355,7 +375,8 @@ This is set to true to disable the annoying audible bell that plays whenever the
#+END_SRC #+END_SRC
* Functions * Functions
** Required Packages ** Required Packages
The packages in this section provide no functionality on their own, but provide support for writing custom elisp The packages in this section provide no functionality on their own,
but provide support for writing custom elisp.
*** s *** s
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(use-package s :demand t) (use-package s :demand t)
@ -627,7 +648,10 @@ Works in the same way as os.path.join in python
(defvar imalison:gpg-key) (defvar imalison:gpg-key)
#+END_SRC #+END_SRC
** Flatten ~imenu~ Indexes ** Flatten ~imenu~ Indexes
I like my imenu indexes flat so I don't have to press enter multiple times to find what I'm looking for. The functions that follow allow me to get this behavior out of functions that provide a nested imenu index. I like my imenu indexes flat so I don't have to press enter multiple
times to find what I'm looking for. The functions that follow allow me
to get this behavior out of functions that provide a nested imenu
index.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(defun imalison:imenu-prefix-flattened (index) (defun imalison:imenu-prefix-flattened (index)
(let ((flattened (imalison:flatten-imenu-index (cdr index)))) (let ((flattened (imalison:flatten-imenu-index (cdr index))))
@ -649,7 +673,10 @@ I like my imenu indexes flat so I don't have to press enter multiple times to fi
(imalison:flatten-imenu-index (imalison:flatten-imenu-index
(funcall original-imenu-function)))))) (funcall original-imenu-function))))))
#+END_SRC #+END_SRC
By advising ~imenu--make-index-alist~ with ~imalison:flatten-imenu-index~ we make it so that imenu indexes are always flattened. This is still experimental, so copy to your own dotfiles with caution. By advising ~imenu--make-index-alist~ with
~imalison:flatten-imenu-index~ we make it so that imenu indexes are
always flattened. This is still experimental, so copy to your own
dotfiles with caution.
#+BEGIN_SRC emacs-lisp #+BEGIN_SRC emacs-lisp
(defun imalison:flatten-imenu-index-with-function (defun imalison:flatten-imenu-index-with-function
(index-build-function &rest args) (index-build-function &rest args)