git.shemshak.org - ~bandali/configs/blob - init.org

   1 #+title: =aminb='s Literate Emacs Configuration
   2 #+author: Amin Bandali
   3 #+babel: :cache yes
   4 #+property: header-args :tangle yes
   5
   6 * About
   7 :PROPERTIES:
   8 :CUSTOM_ID: about
   9 :END:
  10
  11 This org file is my literate configuration for GNU Emacs, and is
  12 tangled to [[./init.el][init.el]]. Packages are installed and managed using
  13 [[https://github.com/emacscollective/borg][Borg]]. Over the years, I've taken inspiration from configurations of
  14 many different people. Some of the configurations that I can remember
  15 off the top of my head are:
  16
  17 - [[https://github.com/dieggsy/dotfiles][dieggsy/dotfiles]]: literate Emacs and dotfiles configuration, uses
  18   straight.el for managing packages
  19 - [[https://github.com/dakra/dmacs][dakra/dmacs]]: literate Emacs configuration, using Borg for managing
  20   packages
  21 - [[http://pages.sachachua.com/.emacs.d/Sacha.html][Sacha Chua's literate Emacs configuration]]
  22 - [[https://github.com/dakrone/eos][dakrone/eos]]
  23 - Ryan Rix's [[http://doc.rix.si/cce/cce.html][Complete Computing Environment]] ([[http://doc.rix.si/projects/fsem.html][about cce]])
  24 - [[https://github.com/jwiegley/dot-emacs][jwiegley/dot-emacs]]: nix-based configuration
  25 - [[https://github.com/wasamasa/dotemacs][wasamasa/dotemacs]]
  26 - [[https://github.com/hlissner/doom-emacs][Doom Emacs]]
  27
  28 I'd like to have a fully reproducible Emacs setup (part of the reason
  29 why I store my configuration in this repository) but unfortunately out
  30 of the box, that's not achievable with =package.el=, not currently
  31 anyway. So, I've opted to use Borg. For what it's worth, I briefly
  32 experimented with [[https://github.com/raxod502/straight.el][straight.el]], but found that it added about 2 seconds
  33 to my init time; which is unacceptable for me: I use Emacs as my
  34 window manager (via EXWM) and coming from bspwm, I'm too used to
  35 having fast startup times.
  36
  37 ** Installation
  38
  39 To use this config for your Emacs, first you need to clone this repo,
  40 then bootstrap Borg, tell Borg to retrieve package submodules, and
  41 byte-compiled the packages. Something along these lines should work:
  42
  43 #+begin_src sh :tangle no
  44 git clone https://github.com/aminb/dotfiles ~/.emacs.d
  45 cd ~/.emacs.d
  46 make bootstrap-borg
  47 make bootstrap
  48 make build
  49 #+end_src
  50
  51 * Contents                                                   :toc_1:noexport:
  52
  53 - [[#about][About]]
  54 - [[#header][Header]]
  55 - [[#initial-setup][Initial setup]]
  56 - [[#core][Core]]
  57 - [[#post-initialization][Post initialization]]
  58 - [[#footer][Footer]]
  59
  60 * Header
  61 :PROPERTIES:
  62 :CUSTOM_ID: header
  63 :END:
  64
  65 ** First line
  66
  67 #+begin_src emacs-lisp :comments none
  68 ;;; init.el --- Amin Bandali's Emacs config -*- lexical-binding: t ; eval: (view-mode 1)-*-
  69 #+end_src
  70
  71 Enable =view-mode=, which both makes the file read-only (as a reminder
  72 that =init.el= is an auto-generated file, not supposed to be edited),
  73 and provides some convenient key bindings for browsing through the
  74 file.
  75
  76 ** License
  77
  78 #+begin_src emacs-lisp :comments none
  79 ;; Copyright (C) 2018  Amin Bandali <bandali@gnu.org>
  80
  81 ;; This program is free software: you can redistribute it and/or modify
  82 ;; it under the terms of the GNU General Public License as published by
  83 ;; the Free Software Foundation, either version 3 of the License, or
  84 ;; (at your option) any later version.
  85
  86 ;; This program is distributed in the hope that it will be useful,
  87 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  88 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  89 ;; GNU General Public License for more details.
  90
  91 ;; You should have received a copy of the GNU General Public License
  92 ;; along with this program.  If not, see <https://www.gnu.org/licenses/>.
  93 #+end_src
  94
  95 ** Commentary
  96
  97 #+begin_src emacs-lisp :comments none
  98 ;;; Commentary:
  99
 100 ;; Emacs configuration of Amin Bandali, computer scientist and functional
 101 ;; programmer.
 102
 103 ;; THIS FILE IS AUTO-GENERATED FROM `init.org'.
 104 #+end_src
 105
 106 ** Naming conventions
 107
 108 The conventions below were inspired by [[https://github.com/hlissner/doom-emacs][Doom]]'s, found [[https://github.com/hlissner/doom-emacs/blob/5dacbb7cb1c6ac246a9ccd15e6c4290def67757c/core/core.el#L3-L17][here]].
 109
 110 #+begin_src emacs-lisp :comments none
 111 ;; Naming conventions:
 112 ;;
 113 ;;   amin-...   public variables or non-interactive functions
 114 ;;   amin--...  private anything (non-interactive), not safe for direct use
 115 ;;   amin/...   an interactive function; safe for M-x or keybinding
 116 ;;   amin:...   an evil operator, motion, or command
 117 ;;   amin|...   a hook function
 118 ;;   amin*...   an advising function
 119 ;;   amin@...   a hydra command
 120 ;;   ...!       a macro
 121 #+end_src
 122
 123 * Initial setup
 124 :PROPERTIES:
 125 :CUSTOM_ID: initial-setup
 126 :END:
 127
 128 #+begin_src emacs-lisp :comments none
 129 ;;; Code:
 130 #+end_src
 131
 132 ** Emacs initialization
 133
 134 I'd like to do a couple of measurements of Emacs' startup time. First,
 135 let's see how long Emacs takes to start up, before even loading
 136 =init.el=, i.e. =user-init-file=:
 137
 138 #+begin_src emacs-lisp
 139 (defvar amin--before-user-init-time (current-time)
 140   "Value of `current-time' when Emacs begins loading `user-init-file'.")
 141 (message "Loading Emacs...done (%.3fs)"
 142          (float-time (time-subtract amin--before-user-init-time
 143                                     before-init-time)))
 144 #+end_src
 145
 146 Also, temporarily increase ~gc-cons-threshhold~ and
 147 ~gc-cons-percentage~ during startup to reduce garbage collection
 148 frequency. Clearing the ~file-name-handler-alist~ seems to help reduce
 149 startup time as well.
 150
 151 #+begin_src emacs-lisp
 152 (defvar amin--gc-cons-threshold gc-cons-threshold)
 153 (defvar amin--gc-cons-percentage gc-cons-percentage)
 154 (defvar amin--file-name-handler-alist file-name-handler-alist)
 155 (setq gc-cons-threshold (* 400 1024 1024)  ; 400 MiB
 156       gc-cons-percentage 0.6
 157       file-name-handler-alist nil
 158       ;; sidesteps a bug when profiling with esup
 159       esup-child-profile-require-level 0)
 160 #+end_src
 161
 162 Of course, we'd like to set them back to their defaults once we're
 163 done initializing.
 164
 165 #+begin_src emacs-lisp
 166 (add-hook
 167  'after-init-hook
 168  (lambda ()
 169    (setq gc-cons-threshold amin--gc-cons-threshold
 170          gc-cons-percentage amin--gc-cons-percentage
 171          file-name-handler-alist amin--file-name-handler-alist)))
 172 #+end_src
 173
 174 Increase the number of lines kept in message logs (the =*Messages*=
 175 buffer).
 176
 177 #+begin_src emacs-lisp
 178 (setq message-log-max 20000)
 179 #+end_src
 180
 181 Optionally, we could suppress some byte compiler warnings like below,
 182 but for now I've decided to keep them enabled. See documentation for
 183 ~byte-compile-warnings~ for more details.
 184
 185 #+begin_src emacs-lisp
 186 ;; (setq byte-compile-warnings
 187 ;;       '(not free-vars unresolved noruntime lexical make-local))
 188 #+end_src
 189
 190 ** whoami
 191
 192 #+begin_src emacs-lisp
 193 (setq user-full-name "Amin Bandali"
 194       user-mail-address "amin@aminb.org")
 195 #+end_src
 196
 197 ** Package management
 198
 199 *** No =package.el=
 200
 201 I can do all my package management things with Borg, and don't need
 202 Emacs' built-in =package.el=. Emacs 27 lets us disable =package.el= in
 203 the =early-init-file= (see [[https://git.savannah.gnu.org/cgit/emacs.git/commit/?id=24acb31c04b4048b85311d794e600ecd7ce60d3b][here]]).
 204
 205 #+begin_src emacs-lisp :tangle early-init.el
 206 (setq package-enable-at-startup nil)
 207 #+end_src
 208
 209 But since Emacs 27 isn't out yet (Emacs 26 is just around the corner
 210 right now), and even when released it'll be long before most distros
 211 ship in their repos, I'll still put the old workaround with the
 212 commented call to ~package-initialize~ here anyway.
 213
 214 #+begin_src emacs-lisp
 215 (setq package-enable-at-startup nil)
 216 ;; (package-initialize)
 217 #+end_src
 218
 219 *** Borg
 220
 221 #+begin_quote
 222 Assimilate Emacs packages as Git submodules
 223 #+end_quote
 224
 225 [[https://github.com/emacscollective/borg][Borg]] is at the heart of package management of my Emacs setup. In
 226 short, it creates a git submodule in =lib/= for each package, which
 227 can then be managed with the help of Magit or other tools.
 228
 229 #+begin_src emacs-lisp
 230 (setq user-init-file (or load-file-name buffer-file-name)
 231       user-emacs-directory (file-name-directory user-init-file))
 232 (add-to-list 'load-path
 233              (expand-file-name "lib/borg" user-emacs-directory))
 234 (require 'borg)
 235 (borg-initialize)
 236
 237 ;; (require 'borg-nix-shell)
 238 ;; (setq borg-build-shell-command 'borg-nix-shell-build-command)
 239
 240 (with-eval-after-load 'bind-key
 241   (bind-keys
 242    :package borg
 243    ("C-c b A" . borg-activate)
 244    ("C-c b a" . borg-assimilate)
 245    ("C-c b b" . borg-build)
 246    ("C-c b c" . borg-clone)
 247    ("C-c b r" . borg-remove)))
 248 #+end_src
 249
 250 *** =use-package=
 251
 252 #+begin_quote
 253 A use-package declaration for simplifying your .emacs
 254 #+end_quote
 255
 256 [[https://github.com/jwiegley/use-package][use-package]] is an awesome utility for managing and configuring
 257 packages (in our case especially the latter) in a neatly organized way
 258 and without compromising on performance.
 259
 260 #+begin_src emacs-lisp
 261 (require 'use-package)
 262 (if nil  ; set to t when need to debug init
 263     (setq use-package-verbose t
 264           use-package-expand-minimally nil
 265           use-package-compute-statistics t
 266           debug-on-error t)
 267   (setq use-package-verbose nil
 268         use-package-expand-minimally t))
 269 #+end_src
 270
 271 *** Epkg
 272
 273 #+begin_quote
 274 Browse the Emacsmirror package database
 275 #+end_quote
 276
 277 Epkg provides access to a local copy of the [[https://emacsmirror.net][Emacsmirror]] package
 278 database, low-level functions for querying the database, and a
 279 =package.el=-like user interface for browsing the available packages.
 280
 281 #+begin_src emacs-lisp
 282 (use-package epkg
 283   :defer t
 284   :bind
 285   (("C-c b d" . epkg-describe-package)
 286    ("C-c b p" . epkg-list-packages)
 287    ("C-c b u" . epkg-update)))
 288 #+end_src
 289
 290 ** No littering in =~/.emacs.d=
 291
 292 #+begin_quote
 293 Help keeping ~/.emacs.d clean
 294 #+end_quote
 295
 296 By default, even for Emacs' built-in packages, the configuration files
 297 and persistent data are all over the place. Use =no-littering= to help
 298 contain the mess.
 299
 300 #+begin_src emacs-lisp
 301 (use-package no-littering
 302   :demand t
 303   :config
 304   (savehist-mode 1)
 305   (add-to-list 'savehist-additional-variables 'kill-ring)
 306   (save-place-mode 1)
 307   (setq auto-save-file-name-transforms
 308         `((".*" ,(no-littering-expand-var-file-name "auto-save/") t))))
 309 #+end_src
 310
 311 ** Custom file (=custom.el=)
 312
 313 I'm not planning on using the custom file much, but even so, I
 314 definitely don't want it mixing with =init.el=. So, here; let's give
 315 it it's own file. While at it, treat themes as safe.
 316
 317 #+begin_src emacs-lisp
 318 (use-package custom
 319   :no-require t
 320   :config
 321   (setq custom-file (no-littering-expand-etc-file-name "custom.el"))
 322   (when (file-exists-p custom-file)
 323     (load custom-file))
 324   (setf custom-safe-themes t))
 325 #+end_src
 326
 327 ** Secrets file
 328
 329 Load the secrets file if it exists, otherwise show a warning.
 330
 331 #+begin_src emacs-lisp
 332 (with-demoted-errors
 333     (load (no-littering-expand-etc-file-name "secrets")))
 334 #+end_src
 335
 336 ** Better =$PATH= handling
 337
 338 Let's use [[https://github.com/purcell/exec-path-from-shell][exec-path-from-shell]] to make Emacs use the =$PATH= as set up
 339 in my shell.
 340
 341 #+begin_src emacs-lisp
 342 (use-package exec-path-from-shell
 343   :defer 1
 344   :init
 345   (setq exec-path-from-shell-check-startup-files nil)
 346   :config
 347   (exec-path-from-shell-initialize)
 348   ;; while we're at it, let's fix access to our running ssh-agent
 349   (exec-path-from-shell-copy-env "SSH_AGENT_PID")
 350   (exec-path-from-shell-copy-env "SSH_AUTH_SOCK"))
 351 #+end_src
 352
 353 ** Only one custom theme at a time
 354
 355 #+begin_src emacs-lisp
 356 ;; only one custom theme at a time
 357 ;;
 358 ;; (defadvice load-theme (before clear-previous-themes activate)
 359 ;;   "Clear existing theme settings instead of layering them"
 360 ;;   (mapc #'disable-theme custom-enabled-themes))
 361 #+end_src
 362
 363 ** Server
 364
 365 Start server if not already running. Alternatively, can be done by
 366 issuing =emacs --daemon= in the terminal, which can be automated with
 367 a systemd service or using =brew services start emacs= on macOS. I use
 368 Emacs as my window manager (via EXWM), so I always start Emacs on
 369 login; so starting the server from inside Emacs is good enough for me.
 370
 371 See [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Emacs-Server.html#Emacs-Server][Using Emacs as a Server]].
 372
 373 #+begin_src emacs-lisp
 374 (use-package server
 375   :defer 1
 376   :config (or (server-running-p) (server-mode)))
 377 #+end_src
 378
 379 ** Unicode support
 380
 381 Font stack with better unicode support, around =Ubuntu Mono= and
 382 =Hack=.
 383
 384 #+begin_src emacs-lisp
 385 ;; unicode support
 386 ;;
 387 ;; (dolist (ft (fontset-list))
 388 ;;   (set-fontset-font
 389 ;;    ft
 390 ;;    'unicode
 391 ;;    (font-spec :name "Source Code Pro" :size 14))
 392 ;;   (set-fontset-font
 393 ;;    ft
 394 ;;    'unicode
 395 ;;    (font-spec :name "DejaVu Sans Mono")
 396 ;;    nil
 397 ;;    'append)
 398 ;;   ;; (set-fontset-font
 399 ;;   ;;  ft
 400 ;;   ;;  'unicode
 401 ;;   ;;  (font-spec
 402 ;;   ;;   :name "Symbola monospacified for DejaVu Sans Mono")
 403 ;;   ;;  nil
 404 ;;   ;;  'append)
 405 ;;   ;; (set-fontset-font
 406 ;;   ;;  ft
 407 ;;   ;;  #x2115  ; ℕ
 408 ;;   ;;  (font-spec :name "DejaVu Sans Mono")
 409 ;;   ;;  nil
 410 ;;   ;;  'append)
 411 ;;   (set-fontset-font
 412 ;;    ft
 413 ;;    (cons ?Α ?ω)
 414 ;;    (font-spec :name "DejaVu Sans Mono" :size 14)
 415 ;;    nil
 416 ;;    'prepend))
 417 #+end_src
 418
 419 ** Gentler font resizing
 420
 421 #+begin_src emacs-lisp
 422 (setq text-scale-mode-step 1.05)
 423 #+end_src
 424
 425 ** Focus follows mouse
 426
 427 I’d like focus to follow the mouse when I move the cursor from one
 428 window to the next.
 429
 430 #+begin_src emacs-lisp
 431 (setq mouse-autoselect-window t)
 432 #+end_src
 433
 434 Let’s define a function to conveniently disable this for certain
 435 buffers and/or modes.
 436
 437 #+begin_src emacs-lisp
 438 (defun amin--no-mouse-autoselect-window ()
 439   (make-local-variable 'mouse-autoselect-window)
 440   (setq mouse-autoselect-window nil))
 441 #+end_src
 442
 443 ** Libraries
 444
 445 #+begin_src emacs-lisp
 446 (require 'cl-lib)
 447 (require 'subr-x)
 448 #+end_src
 449
 450 ** Useful utilities
 451
 452 #+begin_src emacs-lisp
 453 (defun amin-enlist (exp)
 454   "Return EXP wrapped in a list, or as-is if already a list."
 455 (if (listp exp) exp (list exp)))
 456
 457 ; from https://github.com/hlissner/doom-emacs/commit/589108fdb270f24a98ba6209f6955fe41530b3ef
 458 (defmacro after! (features &rest body)
 459   "A smart wrapper around `with-eval-after-load'. Supresses warnings during
 460 compilation."
 461   (declare (indent defun) (debug t))
 462   (list (if (or (not (bound-and-true-p byte-compile-current-file))
 463                 (dolist (next (amin-enlist features))
 464                   (if (symbolp next)
 465                       (require next nil :no-error)
 466                     (load next :no-message :no-error))))
 467             #'progn
 468           #'with-no-warnings)
 469         (cond ((symbolp features)
 470                `(eval-after-load ',features '(progn ,@body)))
 471               ((and (consp features)
 472                     (memq (car features) '(:or :any)))
 473                `(progn
 474                   ,@(cl-loop for next in (cdr features)
 475                              collect `(after! ,next ,@body))))
 476               ((and (consp features)
 477                     (memq (car features) '(:and :all)))
 478                (dolist (next (cdr features))
 479                  (setq body `(after! ,next ,@body)))
 480                body)
 481               ((listp features)
 482                `(after! (:all ,@features) ,@body)))))
 483 #+end_src
 484
 485 Convenience macro for =setq='ing multiple variables to the same value:
 486
 487 #+begin_src emacs-lisp
 488 (defmacro setq-every! (value &rest vars)
 489   "Set all the variables from VARS to value VALUE."
 490   (declare (indent defun) (debug t))
 491   `(progn ,@(mapcar (lambda (x) (list 'setq x value)) vars)))
 492 #+end_src
 493
 494 * Core
 495 :PROPERTIES:
 496 :CUSTOM_ID: core
 497 :END:
 498
 499 ** Defaults
 500
 501 *** Time and battery in mode-line
 502
 503 Enable displaying time and battery in the mode-line, since I'm not
 504 using the Xfce panel anymore. Also, I don't need to see the load
 505 average on a regular basis, so disable that.
 506
 507 Note: using =i3status= on sway at the moment, so disabling this.
 508
 509 #+begin_src emacs-lisp :tangle no
 510 (use-package time
 511   :init
 512   (setq display-time-default-load-average nil)
 513   :config
 514   (display-time-mode))
 515
 516 (use-package battery
 517   :config
 518   (display-battery-mode))
 519 #+end_src
 520
 521 *** Smaller fringe
 522
 523 Might want to set the fringe to a smaller value, especially if using
 524 EXWM. I'm fine with the default for now.
 525
 526 #+begin_src emacs-lisp
 527 ;; (fringe-mode '(3 . 1))
 528 (fringe-mode nil)
 529 #+end_src
 530
 531 *** Disable disabled commands
 532
 533 Emacs disables some commands by default that could persumably be
 534 confusing for novice users. Let's disable that.
 535
 536 #+begin_src emacs-lisp
 537 (setq disabled-command-function nil)
 538 #+end_src
 539
 540 *** Kill-ring
 541
 542 Save what I copy into clipboard from other applications into Emacs'
 543 kill-ring, which would allow me to still be able to easily access it
 544 in case I kill (cut or copy) something else inside Emacs before
 545 yanking (pasting) what I'd originally intended to.
 546
 547 #+begin_src emacs-lisp
 548 (setq save-interprogram-paste-before-kill t)
 549 #+end_src
 550
 551 *** Minibuffer
 552
 553 #+begin_src emacs-lisp
 554 (setq enable-recursive-minibuffers t
 555       resize-mini-windows t)
 556 #+end_src
 557
 558 *** Lazy-person-friendly yes/no prompts
 559
 560 Lazy people would prefer to type fewer keystrokes, especially for yes
 561 or no questions. I'm lazy.
 562
 563 #+begin_src emacs-lisp
 564 (defalias 'yes-or-no-p #'y-or-n-p)
 565 #+end_src
 566
 567 *** Startup screen and =*scratch*=
 568
 569 Firstly, let Emacs know that I'd like to have =*scratch*= as my
 570 startup buffer.
 571
 572 #+begin_src emacs-lisp
 573 (setq initial-buffer-choice t)
 574 #+end_src
 575
 576 Now let's customize the =*scratch*= buffer a bit. First off, I don't
 577 need the default hint.
 578
 579 #+begin_src emacs-lisp
 580 (setq initial-scratch-message nil)
 581 #+end_src
 582
 583 Also, let's use Text mode as the major mode, in case I want to
 584 customize it (=*scratch*='s default major mode, Fundamental mode,
 585 can't really be customized).
 586
 587 #+begin_src emacs-lisp
 588 (setq initial-major-mode 'text-mode)
 589 #+end_src
 590
 591 Inhibit the buffer list when more than 2 files are loaded.
 592
 593 #+begin_src emacs-lisp
 594 (setq inhibit-startup-buffer-menu t)
 595 #+end_src
 596
 597 I don't really need to see the startup screen or echo area message
 598 either.
 599
 600 #+begin_src emacs-lisp
 601 (advice-add #'display-startup-echo-area-message :override #'ignore)
 602 (setq inhibit-startup-screen t
 603       inhibit-startup-echo-area-message user-login-name)
 604 #+end_src
 605
 606 *** More useful frame titles
 607
 608 Show either the file name or the buffer name (in case the buffer isn't
 609 visiting a file). Borrowed from Emacs Prelude.
 610
 611 #+begin_src emacs-lisp
 612 (setq frame-title-format
 613       '("" invocation-name " - "
 614         (:eval (if (buffer-file-name)
 615                    (abbreviate-file-name (buffer-file-name))
 616                  "%b"))))
 617 #+end_src
 618
 619 *** Backups
 620
 621 Emacs' default backup settings aren't that great. Let's use more
 622 sensible options. See documentation for the ~make-backup-file~
 623 variable.
 624
 625 #+begin_src emacs-lisp
 626 (setq backup-by-copying t
 627       version-control t
 628       delete-old-versions t)
 629 #+end_src
 630
 631 *** Auto revert
 632
 633 Enable automatic reloading of changed buffers and files.
 634
 635 #+begin_src emacs-lisp
 636 (global-auto-revert-mode 1)
 637 (setq auto-revert-verbose nil
 638       global-auto-revert-non-file-buffers nil)
 639 #+end_src
 640
 641 *** Always use space for indentation
 642
 643 #+begin_src emacs-lisp
 644 (setq-default
 645  indent-tabs-mode nil
 646  require-final-newline t
 647  tab-width 4)
 648 #+end_src
 649
 650 *** Winner mode
 651
 652 Enable =winner-mode=.
 653
 654 #+begin_src emacs-lisp
 655 (winner-mode 1)
 656 #+end_src
 657
 658 *** Close =*compilation*= on success
 659
 660 #+begin_src emacs-lisp
 661 (setq compilation-exit-message-function
 662       (lambda (status code msg)
 663         "Close the compilation window if successful."
 664         ;; if M-x compile exits with 0
 665          (when (and (eq status 'exit) (zerop code))
 666            (bury-buffer)
 667            (delete-window (get-buffer-window (get-buffer "*compilation*"))))
 668          ;; return the result of compilation-exit-message-function
 669          (cons msg code)))
 670 #+end_src
 671
 672 *** Search for non-ASCII characters
 673
 674 I’d like non-ASCII characters such as ‘’“”«»‹›áⓐ𝒶 to be selected when
 675 I search for their ASCII counterpart.  Shoutout to [[http://endlessparentheses.com/new-in-emacs-25-1-easily-search-non-ascii-characters.html][endlessparentheses]]
 676 for this.
 677
 678 #+begin_src emacs-lisp
 679 (setq search-default-mode #'char-fold-to-regexp)
 680
 681 ;; uncomment to extend this behaviour to query-replace
 682 ;; (setq replace-char-fold t)
 683 #+end_src
 684
 685 ** Bindings
 686
 687 #+begin_src emacs-lisp
 688 (bind-keys
 689  ("C-c a i" . ielm)
 690
 691  ("C-c e b" . eval-buffer)
 692  ("C-c e r" . eval-region)
 693
 694  ("C-c F m" . make-frame-command)
 695  ("C-c F d" . delete-frame)
 696  ("C-c F D" . delete-other-frames)
 697
 698  ("C-c o"   . other-window)
 699
 700  ("C-c Q"   . save-buffers-kill-terminal)
 701
 702  ("C-S-h C" . describe-char)
 703  ("C-S-h F" . describe-face)
 704
 705  ("C-x K"   . kill-this-buffer)
 706
 707  ("s-p"     . beginning-of-buffer)
 708  ("s-n"     . end-of-buffer))
 709 #+end_src
 710
 711 ** Packages
 712
 713 The packages in this section are absolutely essential to my everyday
 714 workflow, and they play key roles in how I do my computing. They
 715 immensely enhance the Emacs experience for me; both using Emacs, and
 716 customizing it.
 717
 718 *** [[https://github.com/emacscollective/auto-compile][auto-compile]]
 719
 720 #+begin_src emacs-lisp
 721 (use-package auto-compile
 722   :demand t
 723   :config
 724   (auto-compile-on-load-mode)
 725   (auto-compile-on-save-mode)
 726   (setq auto-compile-display-buffer               nil
 727         auto-compile-mode-line-counter            t
 728         auto-compile-source-recreate-deletes-dest t
 729         auto-compile-toggle-deletes-nonlib-dest   t
 730         auto-compile-update-autoloads             t)
 731   (add-hook 'auto-compile-inhibit-compile-hook
 732             'auto-compile-inhibit-compile-detached-git-head))
 733 #+end_src
 734
 735 *** [[https://orgmode.org/][Org mode]]
 736
 737 #+begin_quote
 738 Org mode is for keeping notes, maintaining TODO lists, planning
 739 projects, and authoring documents with a fast and effective plain-text
 740 system.
 741 #+end_quote
 742
 743 In short, my favourite way of life.
 744
 745 #+begin_src emacs-lisp
 746 (use-package org
 747   :defer 1
 748   :config
 749   (setq org-src-tab-acts-natively t
 750         org-src-preserve-indentation nil
 751         org-edit-src-content-indentation 0
 752         org-email-link-description-format "Email %c: %s" ; %.30s
 753         org-highlight-latex-and-related '(entities)
 754         org-log-done 'time)
 755   (add-to-list 'org-structure-template-alist '("L" . "src emacs-lisp") t)
 756   (font-lock-add-keywords
 757    'org-mode
 758    '(("[ \t]*\\(#\\+\\(BEGIN\\|END\\|begin\\|end\\)_\\(\\S-+\\)\\)[ \t]*\\([^\n:]*\\)"
 759       (1 '(:foreground "#5a5b5a" :background "#292b2b") t) ; directive
 760       (3 '(:foreground "#81a2be" :background "#292b2b") t) ; kind
 761       (4 '(:foreground "#c5c8c6") t))) ; title
 762    t)
 763   :bind (:map org-mode-map ("M-L" . org-insert-last-stored-link))
 764   :hook ((org-mode . org-indent-mode)
 765          (org-mode . auto-fill-mode)
 766          (org-mode . flyspell-mode))
 767   :custom
 768   (org-latex-packages-alist '(("" "listings") ("" "color")))
 769   :custom-face
 770   '(org-block-begin-line ((t (:foreground "#5a5b5a" :background "#1d1f21"))))
 771   '(org-block ((t (:background "#1d1f21"))))
 772   '(org-latex-and-related ((t (:foreground "#b294bb")))))
 773
 774 (use-package ox-latex
 775   :after ox
 776   :config
 777   (setq org-latex-listings 'listings
 778         ;; org-latex-prefer-user-labels t
 779         )
 780   (add-to-list 'org-latex-packages-alist '("" "listings"))
 781   (add-to-list 'org-latex-packages-alist '("" "color"))
 782   (add-to-list 'org-latex-classes
 783                '("IEEEtran" "\\documentclass[11pt]{IEEEtran}"
 784                  ("\\section{%s}" . "\\section*{%s}")
 785                  ("\\subsection{%s}" . "\\subsection*{%s}")
 786                  ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
 787                  ("\\paragraph{%s}" . "\\paragraph*{%s}")
 788                  ("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
 789                t))
 790
 791 (use-package ox-beamer
 792   :after ox)
 793
 794 (use-package orgalist
 795   :after message
 796   :hook (message-mode . orgalist-mode))
 797 #+end_src
 798
 799 **** asynchronous tangle
 800
 801 =amin/async-babel-tangle= is a function closely inspired by [[https://github.com/dieggsy/dotfiles/tree/cc10edf7701958eff1cd94d4081da544d882a28c/emacs.d#dotfiles][dieggsy's
 802 d/async-babel-tangle]] which uses [[https://github.com/jwiegley/emacs-async][async]] to asynchronously tangle an org
 803 file.
 804
 805 #+begin_src emacs-lisp
 806 (after! org
 807   (defvar amin-show-async-tangle-results nil
 808     "Keep *emacs* async buffers around for later inspection.")
 809
 810   (defvar amin-show-async-tangle-time nil
 811     "Show the time spent tangling the file.")
 812
 813   (defvar amin-async-tangle-post-compile "make ti"
 814     "If non-nil, pass to `compile' after successful tangle.")
 815
 816   (defun amin/async-babel-tangle ()
 817     "Tangle org file asynchronously."
 818     (interactive)
 819     (let* ((file-tangle-start-time (current-time))
 820            (file (buffer-file-name))
 821            (file-nodir (file-name-nondirectory file))
 822            (async-quiet-switch "-q"))
 823       (async-start
 824        `(lambda ()
 825           (require 'org)
 826           (org-babel-tangle-file ,file))
 827        (unless amin-show-async-tangle-results
 828          `(lambda (result)
 829             (if result
 830                 (progn
 831                   (message "Tangled %s%s"
 832                            ,file-nodir
 833                            (if amin-show-async-tangle-time
 834                                (format " (%.3fs)"
 835                                        (float-time (time-subtract (current-time)
 836                                                                   ',file-tangle-start-time)))
 837                              ""))
 838                   (when amin-async-tangle-post-compile
 839                     (compile amin-async-tangle-post-compile)))
 840               (message "Tangling %s failed" ,file-nodir))))))))
 841
 842 (add-to-list
 843  'safe-local-variable-values
 844  '(eval add-hook 'after-save-hook #'amin/async-babel-tangle 'append 'local))
 845 #+end_src
 846
 847 *** [[https://magit.vc/][Magit]]
 848
 849 #+begin_quote
 850 It's Magit! A Git porcelain inside Emacs.
 851 #+end_quote
 852
 853 Not just how I do git, but /the/ way to do git.
 854
 855 #+begin_src emacs-lisp
 856 (use-package magit
 857   :defer 1
 858   :bind (("C-x g" . magit-status)
 859          ("s-g s" . magit-status)
 860          ("s-g l" . magit-log-buffer-file))
 861   :config
 862   (magit-add-section-hook 'magit-status-sections-hook
 863                           'magit-insert-modules
 864                           'magit-insert-stashes
 865                           'append)
 866   (setq
 867    magit-repository-directories '(("~/.emacs.d/" . 0)
 868                                   ("~/src/git/" . 1)))
 869   (nconc magit-section-initial-visibility-alist
 870          '(([unpulled status] . show)
 871            ([unpushed status] . show)))
 872   :custom-face (magit-diff-file-heading ((t (:weight normal)))))
 873 #+end_src
 874
 875 *** [[https://github.com/abo-abo/swiper][Ivy]] (and friends)
 876
 877 #+begin_quote
 878 Ivy - a generic completion frontend for Emacs, Swiper - isearch with
 879 an overview, and more. Oh, man!
 880 #+end_quote
 881
 882 There's no way I could top that, so I won't attempt to.
 883
 884 **** Ivy
 885
 886 #+begin_src emacs-lisp
 887 (use-package ivy
 888   :defer 1
 889   :bind
 890   (:map ivy-minibuffer-map
 891    ([escape] . keyboard-escape-quit)
 892    ([S-up]   . ivy-previous-history-element)
 893    ([S-down] . ivy-next-history-element)
 894    ("DEL"    . ivy-backward-delete-char))
 895   :config
 896   (setq ivy-wrap t)
 897   (ivy-mode 1)
 898   ;; :custom-face
 899   ;; (ivy-minibuffer-match-face-2 ((t (:background "#e99ce8" :weight semi-bold))))
 900   ;; (ivy-minibuffer-match-face-3 ((t (:background "#bbbbff" :weight semi-bold))))
 901   ;; (ivy-minibuffer-match-face-4 ((t (:background "#ffbbff" :weight semi-bold))))
 902 )
 903 #+end_src
 904
 905 **** Swiper
 906
 907 #+begin_src emacs-lisp
 908 (use-package swiper
 909   :bind (("C-s" . swiper)
 910          ("C-r" . swiper)))
 911 #+end_src
 912
 913 **** Counsel
 914
 915 #+begin_src emacs-lisp
 916 (use-package counsel
 917   :defer 1
 918   :bind (([remap execute-extended-command] . counsel-M-x)
 919          ([remap find-file]                . counsel-find-file)
 920          ("s-r"                            . counsel-recentf)
 921          ("C-c x"                          . counsel-M-x)
 922          ("C-c f ."                        . counsel-find-file)
 923          :map minibuffer-local-map
 924          ("C-r" . counsel-minibuffer-history))
 925   :config
 926   (counsel-mode 1)
 927   (defalias 'locate #'counsel-locate))
 928 #+end_src
 929
 930 *** eshell
 931
 932 #+begin_src emacs-lisp
 933 (use-package eshell
 934   :defer 1
 935   :commands eshell
 936   :config
 937   (eval-when-compile (defvar eshell-prompt-regexp))
 938   (defun amin/eshell-quit-or-delete-char (arg)
 939     (interactive "p")
 940     (if (and (eolp) (looking-back eshell-prompt-regexp nil))
 941         (eshell-life-is-too-much)
 942       (delete-char arg)))
 943
 944   (defun amin/eshell-clear ()
 945     (interactive)
 946     (let ((inhibit-read-only t))
 947       (erase-buffer))
 948     (eshell-send-input))
 949
 950   (defun amin|eshell-setup ()
 951     (make-local-variable 'company-idle-delay)
 952     (setq company-idle-delay nil)
 953     (bind-keys :map eshell-mode-map
 954                ("C-d"   . amin/eshell-quit-or-delete-char)
 955                ("C-S-l" . amin/eshell-clear)
 956                ("M-r"   . counsel-esh-history)
 957                ([tab]   . company-complete)))
 958
 959   :hook (eshell-mode . amin|eshell-setup)
 960   :custom
 961   (eshell-hist-ignoredups t)
 962   (eshell-input-filter 'eshell-input-filter-initial-space))
 963 #+end_src
 964
 965 *** Ibuffer
 966
 967 #+begin_src emacs-lisp
 968 (use-package ibuffer
 969   :defer t
 970   :bind
 971   (("C-x C-b" . ibuffer-other-window)
 972    :map ibuffer-mode-map
 973    ("P"   . ibuffer-backward-filter-group)
 974    ("N"   . ibuffer-forward-filter-group)
 975    ("M-p" . ibuffer-do-print)
 976    ("M-n" . ibuffer-do-shell-command-pipe-replace))
 977   :config
 978   ;; Use human readable Size column instead of original one
 979   (define-ibuffer-column size-h
 980     (:name "Size" :inline t)
 981     (cond
 982      ((> (buffer-size) 1000000) (format "%7.1fM" (/ (buffer-size) 1000000.0)))
 983      ((> (buffer-size) 100000) (format "%7.0fk" (/ (buffer-size) 1000.0)))
 984      ((> (buffer-size) 1000) (format "%7.1fk" (/ (buffer-size) 1000.0)))
 985      (t (format "%8d" (buffer-size)))))
 986   :custom
 987   (ibuffer-saved-filter-groups
 988    '(("default"
 989       ("dired" (mode . dired-mode))
 990       ("org"   (mode . org-mode))
 991       ("web"
 992        (or
 993         (mode . web-mode)
 994         (mode . css-mode)
 995         (mode . scss-mode)
 996         (mode . js2-mode)))
 997       ("shell"
 998        (or
 999         (mode . eshell-mode)
1000         (mode . shell-mode)))
1001       ("notmuch" (name . "\*notmuch\*"))
1002       ("programming"
1003        (or
1004         (mode . python-mode)
1005         (mode . c++-mode)
1006         (mode . emacs-lisp-mode)))
1007       ("emacs"
1008        (or
1009         (name . "^\\*scratch\\*$")
1010         (name . "^\\*Messages\\*$")))
1011       ("slack"
1012        (or
1013         (name . "^\\*Slack*"))))))
1014   (ibuffer-formats
1015    '((mark modified read-only locked " "
1016            (name 18 18 :left :elide)
1017            " "
1018            (size-h 9 -1 :right)
1019            " "
1020            (mode 16 16 :left :elide)
1021            " " filename-and-process)
1022      (mark " "
1023            (name 16 -1)
1024            " " filename)))
1025   :hook (ibuffer . (lambda () (ibuffer-switch-to-saved-filter-groups "default"))))
1026 #+end_src
1027
1028 *** Outline
1029
1030 #+begin_src emacs-lisp
1031 (use-package outline
1032   :defer t
1033   :hook (prog-mode . outline-minor-mode)
1034   :bind
1035   (:map
1036    outline-minor-mode-map
1037    ("<s-tab>"  . outline-toggle-children)
1038    ("M-p"      . outline-previous-visible-heading)
1039    ("M-n"      . outline-next-visible-heading)
1040    :prefix-map amin--outline-prefix-map
1041    :prefix "s-o"
1042    ("TAB" . outline-toggle-children)
1043    ("a"   . outline-hide-body)
1044    ("H"   . outline-hide-body)
1045    ("S"   . outline-show-all)
1046    ("h"   . outline-hide-subtree)
1047    ("s"   . outline-show-subtree)))
1048 #+end_src
1049
1050 * Borg's =layer/essentials=
1051
1052 TODO: break this giant source block down into individual org sections.
1053
1054 #+begin_src emacs-lisp
1055 (use-package dash
1056   :config (dash-enable-font-lock))
1057
1058 (use-package diff-hl
1059   :config
1060   (setq diff-hl-draw-borders nil)
1061   (global-diff-hl-mode)
1062   (add-hook 'magit-post-refresh-hook 'diff-hl-magit-post-refresh t))
1063
1064 (use-package dired
1065   :defer t
1066   :config (setq dired-listing-switches "-alh"))
1067
1068 (use-package eldoc
1069   :when (version< "25" emacs-version)
1070   :config (global-eldoc-mode))
1071
1072 (use-package help
1073   :defer t
1074   :config
1075   (temp-buffer-resize-mode)
1076   (setq help-window-select t))
1077
1078 (progn ;    `isearch'
1079   (setq isearch-allow-scroll t))
1080
1081 (use-package lisp-mode
1082   :config
1083   (add-hook 'emacs-lisp-mode-hook 'outline-minor-mode)
1084   (add-hook 'emacs-lisp-mode-hook 'reveal-mode)
1085   (defun indent-spaces-mode ()
1086     (setq indent-tabs-mode nil))
1087   (add-hook 'lisp-interaction-mode-hook #'indent-spaces-mode))
1088
1089 (use-package man
1090   :defer t
1091   :config (setq Man-width 80))
1092
1093 (use-package paren
1094   :config (show-paren-mode))
1095
1096 (use-package prog-mode
1097   :config (global-prettify-symbols-mode)
1098   (defun indicate-buffer-boundaries-left ()
1099     (setq indicate-buffer-boundaries 'left))
1100   (add-hook 'prog-mode-hook #'indicate-buffer-boundaries-left))
1101
1102 (use-package recentf
1103   :defer 0.5
1104   :config
1105   (add-to-list 'recentf-exclude "^/\\(?:ssh\\|su\\|sudo\\)?:")
1106   (setq recentf-max-saved-items 40))
1107
1108 (use-package savehist
1109   :config (savehist-mode))
1110
1111 (use-package saveplace
1112   :when (version< "25" emacs-version)
1113   :config (save-place-mode))
1114
1115 (use-package simple
1116   :config (column-number-mode))
1117
1118 (progn ;    `text-mode'
1119   (add-hook 'text-mode-hook #'indicate-buffer-boundaries-left)
1120   (add-hook 'text-mode-hook #'abbrev-mode))
1121
1122 (use-package tramp
1123   :defer t
1124   :config
1125   (add-to-list 'tramp-default-proxies-alist '(nil "\\`root\\'" "/ssh:%h:"))
1126   (add-to-list 'tramp-default-proxies-alist '("localhost" nil nil))
1127   (add-to-list 'tramp-default-proxies-alist
1128                (list (regexp-quote (system-name)) nil nil)))
1129
1130 (use-package undo-tree
1131   :config
1132   (global-undo-tree-mode -1))
1133   ;; :bind (("C-?" . undo-tree-undo)
1134   ;;        ("M-_" . undo-tree-redo))
1135   ;; :config
1136   ;; (global-undo-tree-mode)
1137   ;; (setq undo-tree-mode-lighter ""
1138   ;;       undo-tree-auto-save-history t))
1139 #+end_src
1140
1141 * Editing
1142
1143 ** Company
1144
1145 #+begin_src emacs-lisp
1146 (use-package company
1147   :defer 1
1148   :bind
1149   (:map company-active-map
1150         ([tab]    . company-complete-common-or-cycle)
1151         ([escape] . company-abort))
1152   :custom
1153   (company-minimum-prefix-length 1)
1154   (company-selection-wrap-around t)
1155   (company-dabbrev-char-regexp "\\sw\\|\\s_\\|[-_]")
1156   (company-dabbrev-downcase nil)
1157   (company-dabbrev-ignore-case nil)
1158   :config
1159   (global-company-mode t))
1160 #+end_src
1161
1162 * Syntax and spell checking
1163 #+begin_src emacs-lisp
1164 (use-package flycheck
1165   :defer 3
1166   :hook (prog-mode . flycheck-mode)
1167   :bind
1168   (:map flycheck-mode-map
1169         ("M-P" . flycheck-previous-error)
1170         ("M-N" . flycheck-next-error))
1171   :config
1172   ;; Use the load-path from running Emacs when checking elisp files
1173   (setq flycheck-emacs-lisp-load-path 'inherit)
1174
1175   ;; Only flycheck when I actually save the buffer
1176   (setq flycheck-check-syntax-automatically '(mode-enabled save)))
1177
1178 ;; http://endlessparentheses.com/ispell-and-apostrophes.html
1179 (use-package ispell
1180   :defer 3
1181   :config
1182   ;; ’ can be part of a word
1183   (setq ispell-local-dictionary-alist
1184         `((nil "[[:alpha:]]" "[^[:alpha:]]"
1185                "['\x2019]" nil ("-B") nil utf-8)))
1186   ;; don't send ’ to the subprocess
1187   (defun endless/replace-apostrophe (args)
1188     (cons (replace-regexp-in-string
1189            "’" "'" (car args))
1190           (cdr args)))
1191   (advice-add #'ispell-send-string :filter-args
1192               #'endless/replace-apostrophe)
1193
1194   ;; convert ' back to ’ from the subprocess
1195   (defun endless/replace-quote (args)
1196     (if (not (derived-mode-p 'org-mode))
1197         args
1198       (cons (replace-regexp-in-string
1199              "'" "’" (car args))
1200             (cdr args))))
1201   (advice-add #'ispell-parse-output :filter-args
1202               #'endless/replace-quote))
1203 #+end_src
1204 * Programming modes
1205
1206 ** [[http://alloytools.org][Alloy]] (with [[https://github.com/dwwmmn/alloy-mode][alloy-mode]])
1207
1208 #+begin_src emacs-lisp
1209 (use-package alloy-mode
1210   :defer t
1211   :config (setq alloy-basic-offset 2))
1212 #+end_src
1213
1214 ** [[https://coq.inria.fr][Coq]] (with [[https://github.com/ProofGeneral/PG][Proof General]])
1215
1216 #+begin_src emacs-lisp
1217 (use-package proof-site  ; Proof General
1218   :defer t
1219   :load-path "lib/proof-site/generic/")
1220 #+end_src
1221
1222 ** [[https://leanprover.github.io][Lean]] (with [[https://github.com/leanprover/lean-mode][lean-mode]])
1223
1224 #+begin_src emacs-lisp
1225 (eval-when-compile (defvar lean-mode-map))
1226 (use-package lean-mode
1227   :defer 1
1228   :bind (:map lean-mode-map
1229               ("S-SPC" . company-complete))
1230   :config
1231   (require 'lean-input)
1232   (setq default-input-method "Lean"
1233         lean-input-tweak-all '(lean-input-compose
1234                                (lean-input-prepend "/")
1235                                (lean-input-nonempty))
1236         lean-input-user-translations '(("/" "/")))
1237   (lean-input-setup))
1238   #+end_src
1239
1240 ** Haskell
1241
1242 *** [[https://github.com/haskell/haskell-mode][haskell-mode]]
1243
1244 #+begin_src emacs-lisp
1245 (use-package haskell-mode
1246   :defer t
1247   :config
1248   (setq haskell-indentation-layout-offset 4
1249         haskell-indentation-left-offset 4
1250         flycheck-checker 'haskell-hlint
1251         flycheck-disabled-checkers '(haskell-stack-ghc haskell-ghc)))
1252 #+end_src
1253
1254 *** [[https://github.com/jyp/dante][dante]]
1255
1256 #+begin_src emacs-lisp
1257 (use-package dante
1258   :after haskell-mode
1259   :commands dante-mode
1260   :hook (haskell-mode . dante-mode))
1261 #+end_src
1262
1263 *** [[https://github.com/mpickering/hlint-refactor-mode][hlint-refactor]]
1264
1265 Emacs bindings for [[https://github.com/ndmitchell/hlint][hlint]]'s refactor option. This requires the refact
1266 executable from [[https://github.com/mpickering/apply-refact][apply-refact]].
1267
1268 #+begin_src emacs-lisp
1269 (use-package hlint-refactor
1270   :after haskell-mode
1271   :bind (:map hlint-refactor-mode-map
1272               ("C-c l b" . hlint-refactor-refactor-buffer)
1273               ("C-c l r" . hlint-refactor-refactor-at-point))
1274   :hook (haskell-mode . hlint-refactor-mode))
1275 #+end_src
1276
1277 *** [[https://github.com/flycheck/flycheck-haskell][flycheck-haskell]]
1278
1279 #+begin_src emacs-lisp
1280 (use-package flycheck-haskell
1281   :after haskell-mode)
1282 #+end_src
1283
1284 *** [[https://github.com/ndmitchell/hlint/blob/20e116a043f2073c57b17b24ae6364b5e433ba7e/data/hs-lint.el][hs-lint.el]]
1285 :PROPERTIES:
1286 :header-args+: :tangle lisp/hs-lint.el :mkdirp yes
1287 :END:
1288
1289 Currently using =flycheck-haskell= with the =haskell-hlint= checker
1290 instead.
1291
1292 #+begin_src emacs-lisp :tangle no
1293 ;;; hs-lint.el --- minor mode for HLint code checking
1294
1295 ;; Copyright 2009 (C) Alex Ott
1296 ;;
1297 ;; Author: Alex Ott <alexott@gmail.com>
1298 ;; Keywords: haskell, lint, HLint
1299 ;; Requirements:
1300 ;; Status: distributed under terms of GPL2 or above
1301
1302 ;; Typical message from HLint looks like:
1303 ;;
1304 ;; /Users/ott/projects/lang-exp/haskell/test.hs:52:1: Eta reduce
1305 ;; Found:
1306 ;;   count1 p l = length (filter p l)
1307 ;; Why not:
1308 ;;   count1 p = length . filter p
1309
1310
1311 (require 'compile)
1312
1313 (defgroup hs-lint nil
1314   "Run HLint as inferior of Emacs, parse error messages."
1315   :group 'tools
1316   :group 'haskell)
1317
1318 (defcustom hs-lint-command "hlint"
1319   "The default hs-lint command for \\[hlint]."
1320   :type 'string
1321   :group 'hs-lint)
1322
1323 (defcustom hs-lint-save-files t
1324   "Save modified files when run HLint or no (ask user)"
1325   :type 'boolean
1326   :group 'hs-lint)
1327
1328 (defcustom hs-lint-replace-with-suggestions nil
1329   "Replace user's code with suggested replacements"
1330   :type 'boolean
1331   :group 'hs-lint)
1332
1333 (defcustom hs-lint-replace-without-ask nil
1334   "Replace user's code with suggested replacements automatically"
1335   :type 'boolean
1336   :group 'hs-lint)
1337
1338 (defun hs-lint-process-setup ()
1339   "Setup compilation variables and buffer for `hlint'."
1340   (run-hooks 'hs-lint-setup-hook))
1341
1342 ;; regex for replace suggestions
1343 ;;
1344 ;; ^\(.*?\):\([0-9]+\):\([0-9]+\): .*
1345 ;; Found:
1346 ;; \s +\(.*\)
1347 ;; Why not:
1348 ;; \s +\(.*\)
1349
1350 (defvar hs-lint-regex
1351   "^\\(.*?\\):\\([0-9]+\\):\\([0-9]+\\): .*[\n\C-m]Found:[\n\C-m]\\s +\\(.*\\)[\n\C-m]Why not:[\n\C-m]\\s +\\(.*\\)[\n\C-m]"
1352   "Regex for HLint messages")
1353
1354 (defun make-short-string (str maxlen)
1355   (if (< (length str) maxlen)
1356       str
1357     (concat (substring str 0 (- maxlen 3)) "...")))
1358
1359 (defun hs-lint-replace-suggestions ()
1360   "Perform actual replacement of suggestions"
1361   (goto-char (point-min))
1362   (while (re-search-forward hs-lint-regex nil t)
1363     (let* ((fname (match-string 1))
1364           (fline (string-to-number (match-string 2)))
1365           (old-code (match-string 4))
1366           (new-code (match-string 5))
1367           (msg (concat "Replace '" (make-short-string old-code 30)
1368                        "' with '" (make-short-string new-code 30) "'"))
1369           (bline 0)
1370           (eline 0)
1371           (spos 0)
1372           (new-old-code ""))
1373       (save-excursion
1374         (switch-to-buffer (get-file-buffer fname))
1375         (goto-char (point-min))
1376         (forward-line (1- fline))
1377         (beginning-of-line)
1378         (setf bline (point))
1379         (when (or hs-lint-replace-without-ask
1380                   (yes-or-no-p msg))
1381           (end-of-line)
1382           (setf eline (point))
1383           (beginning-of-line)
1384           (setf old-code (regexp-quote old-code))
1385           (while (string-match "\\\\ " old-code spos)
1386             (setf new-old-code (concat new-old-code
1387                                  (substring old-code spos (match-beginning 0))
1388                                  "\\ *"))
1389             (setf spos (match-end 0)))
1390           (setf new-old-code (concat new-old-code (substring old-code spos)))
1391           (remove-text-properties bline eline '(composition nil))
1392           (when (re-search-forward new-old-code eline t)
1393             (replace-match new-code nil t)))))))
1394
1395 (defun hs-lint-finish-hook (buf msg)
1396   "Function, that is executed at the end of HLint execution"
1397   (if hs-lint-replace-with-suggestions
1398       (hs-lint-replace-suggestions)
1399       (next-error 1 t)))
1400
1401 (define-compilation-mode hs-lint-mode "HLint"
1402   "Mode for check Haskell source code."
1403   (set (make-local-variable 'compilation-process-setup-function)
1404        'hs-lint-process-setup)
1405   (set (make-local-variable 'compilation-disable-input) t)
1406   (set (make-local-variable 'compilation-scroll-output) nil)
1407   (set (make-local-variable 'compilation-finish-functions)
1408        (list 'hs-lint-finish-hook))
1409   )
1410
1411 (defun hs-lint ()
1412   "Run HLint for current buffer with haskell source"
1413   (interactive)
1414   (save-some-buffers hs-lint-save-files)
1415   (compilation-start (concat hs-lint-command " \"" buffer-file-name "\"")
1416                      'hs-lint-mode))
1417
1418 (provide 'hs-lint)
1419 ;;; hs-lint.el ends here
1420 #+end_src
1421
1422 #+begin_src emacs-lisp :tangle no
1423 (use-package hs-lint
1424   :load-path "lisp/"
1425   :bind (:map haskell-mode-map
1426               ("C-c l l" . hs-lint)))
1427 #+end_src
1428
1429 ** Web dev
1430
1431 *** SGML and HTML
1432
1433 #+begin_src emacs-lisp
1434 (use-package sgml-mode
1435   :defer t
1436   :config
1437   (setq sgml-basic-offset 2))
1438 #+end_src
1439
1440 *** CSS and SCSS
1441
1442 #+begin_src emacs-lisp
1443 (use-package css-mode
1444   :defer t
1445   :config
1446   (setq css-indent-offset 2))
1447 #+end_src
1448
1449 *** Web mode
1450
1451 #+begin_src emacs-lisp
1452 (use-package web-mode
1453   :defer t
1454   :mode "\\.html\\'"
1455   :config
1456   (setq-every! 2
1457     web-mode-code-indent-offset
1458     web-mode-css-indent-offset
1459     web-mode-markup-indent-offset))
1460 #+end_src
1461
1462 *** Emmet mode
1463
1464 #+begin_src emacs-lisp
1465 (use-package emmet-mode
1466   :after (:any web-mode css-mode sgml-mode)
1467   :bind* (("C-)" . emmet-next-edit-point)
1468           ("C-(" . emmet-prev-edit-point))
1469   :config
1470   (unbind-key "C-j" emmet-mode-keymap)
1471   (setq emmet-move-cursor-between-quotes t)
1472   :hook (web-mode css-mode html-mode sgml-mode))
1473 #+end_src
1474
1475 ** Nix
1476
1477 #+begin_src emacs-lisp
1478 (use-package nix-mode
1479   :defer t
1480   :mode "\\.nix\\'")
1481 #+end_src
1482
1483 ** Java
1484
1485 *** meghanada
1486
1487 #+begin_src emacs-lisp :tangle no
1488 (use-package meghanada
1489   :bind
1490   (:map meghanada-mode-map
1491         (("C-M-o" . meghanada-optimize-import)
1492          ("C-M-t" . meghanada-import-all)))
1493   :hook (java-mode . meghanada-mode))
1494 #+end_src
1495
1496 *** lsp-java
1497
1498 #+begin_comment
1499 dependencies:
1500
1501 ace-window
1502 avy
1503 bui
1504 company-lsp
1505 dap-mode
1506 lsp-java
1507 lsp-mode
1508 lsp-ui
1509 pfuture
1510 tree-mode
1511 treemacs
1512 #+end_comment
1513
1514 #+begin_src emacs-lisp :tangle no
1515 (use-package treemacs
1516   :config (setq treemacs-never-persist t))
1517
1518 (use-package yasnippet
1519   :config
1520   ;; (yas-global-mode)
1521   )
1522
1523 (use-package lsp-mode
1524   :init (setq lsp-eldoc-render-all nil
1525               lsp-highlight-symbol-at-point nil)
1526   )
1527
1528 (use-package hydra)
1529
1530 (use-package company-lsp
1531   :after  company
1532   :config
1533   (setq company-lsp-cache-candidates t
1534         company-lsp-async t))
1535
1536 (use-package lsp-ui
1537   :config
1538   (setq lsp-ui-sideline-update-mode 'point))
1539
1540 (use-package lsp-java
1541   :config
1542   (add-hook 'java-mode-hook
1543             (lambda ()
1544               (setq-local company-backends (list 'company-lsp))))
1545
1546   (add-hook 'java-mode-hook 'lsp-java-enable)
1547   (add-hook 'java-mode-hook 'flycheck-mode)
1548   (add-hook 'java-mode-hook 'company-mode)
1549   (add-hook 'java-mode-hook 'lsp-ui-mode))
1550
1551 (use-package dap-mode
1552   :after lsp-mode
1553   :config
1554   (dap-mode t)
1555   (dap-ui-mode t))
1556
1557 (use-package dap-java
1558   :after (lsp-java))
1559
1560 (use-package lsp-java-treemacs
1561   :after (treemacs))
1562 #+end_src
1563
1564 * Emacs Enhancements
1565
1566 ** [[https://github.com/justbur/emacs-which-key][which-key]]
1567
1568 #+begin_quote
1569 Emacs package that displays available keybindings in popup
1570 #+end_quote
1571
1572 #+begin_src emacs-lisp
1573 (use-package which-key
1574   :defer 1
1575   :config (which-key-mode))
1576 #+end_src
1577
1578 ** theme
1579
1580 #+begin_src emacs-lisp
1581 (add-to-list 'custom-theme-load-path "~/.emacs.d/lisp")
1582 (load-theme 'tangomod t)
1583 #+end_src
1584
1585 ** doom-modeline
1586
1587 #+begin_src emacs-lisp
1588 (use-package doom-modeline
1589   :demand t
1590   :config (setq doom-modeline-height 32)
1591   :hook (after-init . doom-modeline-init))
1592 #+end_src
1593
1594 ** doom-themes
1595
1596 #+begin_src emacs-lisp
1597 (use-package doom-themes)
1598 #+end_src
1599
1600 ** theme helper functions
1601
1602 #+begin_src emacs-lisp
1603 (defun amin/lights-on ()
1604   "Enable my favourite light theme."
1605   (interactive)
1606   (progn
1607     (mapc #'disable-theme custom-enabled-themes)
1608     (load-theme 'tangomod t)))
1609
1610 (defun amin/lights-off ()
1611   "Go dark."
1612   (interactive)
1613   (progn
1614     (mapc #'disable-theme custom-enabled-themes)
1615     (load-theme 'doom-tomorrow-night t)))
1616
1617 (bind-keys
1618  ("s-t d" . amin/lights-off)
1619  ("s-t l" . amin/lights-on))
1620 #+end_src
1621
1622 ** [[https://github.com/bbatsov/crux][crux]]
1623
1624 #+begin_src emacs-lisp
1625 (use-package crux
1626   :defer 1
1627   :bind (("C-c b k" . crux-kill-other-buffers)
1628          ("C-c d"   . crux-duplicate-current-line-or-region)
1629          ("C-c D"   . crux-duplicate-and-comment-current-line-or-region)
1630          ("C-c f c" . crux-copy-file-preserve-attributes)
1631          ("C-c f d" . crux-delete-file-and-buffer)
1632          ("C-c f r" . crux-rename-file-and-buffer)
1633          ("C-c j"   . crux-top-join-line)
1634          ("C-S-j"   . crux-top-join-line)))
1635 #+end_src
1636
1637 ** [[https://github.com/alezost/mwim.el][mwim]]
1638
1639 #+begin_src emacs-lisp
1640 (use-package mwim
1641   :bind (("C-a"    . mwim-beginning-of-code-or-line)
1642          ("C-e"    . mwim-end-of-code-or-line)
1643          ("<home>" . mwim-beginning-of-line-or-code)
1644          ("<end>"  . mwim-end-of-line-or-code)))
1645 #+end_src
1646
1647 ** projectile
1648
1649 #+begin_src emacs-lisp
1650 (use-package projectile
1651   :defer t
1652   :bind-keymap ("C-c p" . projectile-command-map)
1653   :config
1654   (projectile-mode)
1655
1656   (defun my-projectile-invalidate-cache (&rest _args)
1657     ;; ignore the args to `magit-checkout'
1658     (projectile-invalidate-cache nil))
1659
1660   (eval-after-load 'magit-branch
1661     '(progn
1662        (advice-add 'magit-checkout
1663                    :after #'my-projectile-invalidate-cache)
1664        (advice-add 'magit-branch-and-checkout
1665                    :after #'my-projectile-invalidate-cache))))
1666 #+end_src
1667
1668 ** [[https://github.com/Wilfred/helpful][helpful]]
1669
1670 #+begin_src emacs-lisp
1671 (use-package helpful
1672   :defer 1
1673   :bind
1674   (("C-S-h c" . helpful-command)
1675    ("C-S-h f" . helpful-callable)        ; helpful-function
1676    ("C-S-h v" . helpful-variable)
1677    ("C-S-h k" . helpful-key)
1678    ("C-S-h p" . helpful-at-point)))
1679 #+end_src
1680
1681 ** [[https://github.com/knu/shell-toggle.el][shell-toggle]]
1682
1683 #+begin_src emacs-lisp
1684 (use-package shell-toggle
1685   :after eshell
1686   :bind ("C-c a s e" . amin/shell-toggle)
1687   :config
1688   (defun amin/shell-toggle (make-cd)
1689     "Toggle between the shell buffer and whatever buffer you are editing.
1690 With a prefix argument MAKE-CD also insert a \"cd DIR\" command
1691 into the shell, where DIR is the directory of the current buffer.
1692
1693 When called in the shell buffer returns you to the buffer you were editing
1694 before calling this the first time.
1695
1696 Options: `shell-toggle-goto-eob'"
1697     (interactive "P")
1698     ;; Try to decide on one of three possibilities:
1699     ;; If not in shell-buffer, switch to it.
1700     ;; If in shell-buffer, return to state before going to the shell-buffer
1701     (if (eq (current-buffer) shell-toggle-shell-buffer)
1702         (shell-toggle-buffer-return-from-shell)
1703       (progn
1704         (shell-toggle-buffer-goto-shell make-cd)
1705         (if shell-toggle-full-screen-window-only (delete-other-windows)))))
1706
1707   ;; override to split horizontally instead
1708   (defun shell-toggle-buffer-switch-to-other-window ()
1709     "Switch to other window.
1710 If the current window is the only window in the current frame,
1711 create a new window and switch to it.
1712
1713 \(This is less intrusive to the current window configuration than
1714 `switch-buffer-other-window')"
1715     (let ((this-window (selected-window)))
1716       (other-window 1)
1717       ;; If we did not switch window then we only have one window and need to
1718       ;; create a new one.
1719       (if (eq this-window (selected-window))
1720               (progn
1721                 (split-window-horizontally)
1722             (other-window 1)))))
1723
1724   :custom
1725   (shell-toggle-launch-shell 'shell-toggle-eshell))
1726 #+end_src
1727
1728 ** [[https://github.com/EricCrosson/unkillable-scratch][unkillable-scratch]]
1729
1730 Make =*scratch*= and =*Messages*= unkillable.
1731
1732 #+begin_src emacs-lisp
1733 (use-package unkillable-scratch
1734   :defer 3
1735   :config
1736   (unkillable-scratch 1)
1737   :custom
1738   (unkillable-scratch-behavior 'do-nothing)
1739   (unkillable-buffers '("^\\*scratch\\*$" "^\\*Messages\\*$")))
1740 #+end_src
1741
1742 ** [[https://github.com/davep/boxquote.el][boxquote.el]]
1743
1744 #+begin_example
1745 ,----
1746 | make pretty boxed quotes like this
1747 `----
1748 #+end_example
1749
1750 #+begin_src emacs-lisp
1751 (use-package boxquote
1752   :defer 3
1753   :bind
1754   (:prefix-map amin--boxquote-prefix-map
1755    :prefix "C-c q"
1756    ("b"   . boxquote-buffer)
1757    ("B"   . boxquote-insert-buffer)
1758    ("d"   . boxquote-defun)
1759    ("F"   . boxquote-insert-file)
1760    ("hf"  . boxquote-describe-function)
1761    ("hk"  . boxquote-describe-key)
1762    ("hv"  . boxquote-describe-variable)
1763    ("hw"  . boxquote-where-is)
1764    ("k"   . boxquote-kill)
1765    ("p"   . boxquote-paragraph)
1766    ("q"   . boxquote-boxquote)
1767    ("r"   . boxquote-region)
1768    ("s"   . boxquote-shell-command)
1769    ("t"   . boxquote-text)
1770    ("T"   . boxquote-title)
1771    ("u"   . boxquote-unbox)
1772    ("U"   . boxquote-unbox-region)
1773    ("y"   . boxquote-yank)
1774    ("M-q" . boxquote-fill-paragraph)
1775    ("M-w" . boxquote-kill-ring-save)))
1776 #+end_src
1777
1778 Also see [[https://www.emacswiki.org/emacs/rebox2][rebox2]].
1779
1780 ** [[https://github.com/DarthFennec/highlight-indent-guides][highlight-indent-guides]]
1781
1782 #+begin_src emacs-lisp
1783 (use-package highlight-indent-guides
1784   :disabled t
1785   :defer 3
1786   :hook ((prog-mode . highlight-indent-guides-mode)
1787          ;; (org-mode  . highlight-indent-guides-mode)
1788          )
1789   :config
1790   (setq highlight-indent-guides-character ?\|)
1791   (setq highlight-indent-guides-auto-enabled nil)
1792   (setq highlight-indent-guides-method 'character)
1793   (setq highlight-indent-guides-responsive 'top)
1794   (set-face-foreground 'highlight-indent-guides-character-face "gainsboro")
1795   (set-face-foreground 'highlight-indent-guides-top-character-face "grey40")) ; grey13 is nice too
1796 #+end_src
1797
1798 ** pdf-tools
1799
1800 #+begin_src emacs-lisp
1801 (use-package pdf-tools
1802   :defer t
1803   :magic ("%PDF" . pdf-view-mode)
1804   :config
1805   (setq pdf-view-resize-factor 1.05)
1806   (pdf-tools-install)
1807   :bind
1808   (:map pdf-view-mode-map
1809         ("C-s" . isearch-forward)
1810         ("C-r" . isearch-backward)
1811         ("j"   . pdf-view-next-line-or-next-page)
1812         ("k"   . pdf-view-previous-line-or-previous-page)
1813         ("h"   . image-backward-hscroll)
1814         ("l"   . image-forward-hscroll)))
1815 #+end_src
1816
1817 ** anzu
1818
1819 #+begin_src emacs-lisp
1820 (use-package anzu)
1821 #+end_src
1822
1823 ** typo.el
1824
1825 #+begin_src emacs-lisp
1826 (use-package typo
1827   :defer 2
1828   :config
1829   (typo-global-mode 1)
1830   :hook (text-mode . typo-mode))
1831 #+end_src
1832
1833 ** hl-todo
1834
1835 #+begin_src emacs-lisp
1836 (use-package hl-todo
1837   :defer 4
1838   :config
1839   (global-hl-todo-mode))
1840 #+end_src
1841
1842 ** shrink-path
1843
1844 #+begin_src emacs-lisp
1845 (use-package shrink-path
1846   :after eshell
1847   :config
1848   (setq eshell-prompt-regexp "\\(.*\n\\)*λ "
1849         eshell-prompt-function #'+eshell/prompt)
1850
1851   (defun +eshell/prompt ()
1852     (let ((base/dir (shrink-path-prompt default-directory)))
1853       (concat (propertize (car base/dir)
1854                           'face 'font-lock-comment-face)
1855               (propertize (cdr base/dir)
1856                           'face 'font-lock-constant-face)
1857               (propertize (+eshell--current-git-branch)
1858                           'face 'font-lock-function-name-face)
1859               "\n"
1860               (propertize "λ" 'face 'eshell-prompt-face)
1861               ;; needed for the input text to not have prompt face
1862               (propertize " " 'face 'default))))
1863
1864   (defun +eshell--current-git-branch ()
1865     (let ((branch (car (loop for match in (split-string (shell-command-to-string "git branch") "\n")
1866                              when (string-match "^\*" match)
1867                              collect match))))
1868       (if (not (eq branch nil))
1869           (concat " " (substring branch 2))
1870         ""))))
1871 #+end_src
1872
1873 ** slack
1874
1875 Hopefully temporary.
1876
1877 #+begin_src emacs-lisp
1878 (use-package slack
1879   :disabled t
1880   :commands (slack-start)
1881   :init
1882   (eval-when-compile                    ; silence the byte-compiler
1883     (defvar url-http-data nil)
1884     (defvar url-http-extra-headers nil)
1885     (defvar url-http-method nil)
1886     (defvar url-callback-function nil)
1887     (defvar url-callback-arguments nil)
1888     (defvar oauth--token-data nil))
1889   (setq slack-buffer-emojify t
1890         slack-prefer-current-team t)
1891   :config
1892   (slack-register-team
1893    :name "uw-apv"
1894    :default t
1895    :client-id uw-apv-client-id
1896    :client-secret uw-apv-client-secret
1897    :token uw-apv-token
1898    :subscribed-channels '(general)
1899    :full-and-display-names t)
1900   (slack-register-team
1901    :name "watform"
1902    :default nil
1903    :client-id watform-client-id
1904    :client-secret watform-client-secret
1905    :token watform-token
1906    :subscribed-channels '(general)
1907    :full-and-display-names t)
1908   (add-to-list 'swiper-font-lock-exclude 'slack-message-buffer-mode t)
1909   (setq lui-time-stamp-format "[%Y-%m-%d %H:%M:%S]"
1910         lui-time-stamp-only-when-changed-p t
1911         lui-time-stamp-position 'right)
1912   :bind
1913   (("C-c s s" . slack-start)
1914    ("C-c s u" . slack-select-unread-rooms)
1915    ("C-c s b" . slack-select-rooms)
1916    ("C-c s t" . slack-change-current-team)
1917    ("C-c s c" . slack-ws-close)
1918    :map slack-mode-map
1919    ("M-p"     . slack-buffer-goto-prev-message)
1920    ("M-n"     . slack-buffer-goto-next-message)
1921    ("C-c e"   . slack-message-edit)
1922    ("C-c k"   . slack-message-delete)
1923    ("C-c C-k" . slack-channel-leave)
1924    ("C-c r a" . slack-message-add-reaction)
1925    ("C-c r r" . slack-message-remove-reaction)
1926    ("C-c r s" . slack-message-show-reaction-users)
1927    ("C-c p l" . slack-room-pins-list)
1928    ("C-c p a" . slack-message-pins-add)
1929    ("C-c p r" . slack-message-pins-remove)
1930    ("@"       . slack-message-embed-mention)
1931    ("#"       . slack-message-embed-channel)))
1932
1933 (use-package alert
1934   :commands (alert)
1935   :init
1936   (setq alert-default-style 'notifier))
1937 #+end_src
1938
1939 ** [[https://github.com/peterwvj/eshell-up][eshell-up]]
1940
1941 #+begin_src emacs-lisp
1942 (use-package eshell-up
1943   :after eshell)
1944 #+end_src
1945
1946 ** multi-term
1947
1948 #+begin_src emacs-lisp
1949 (use-package multi-term
1950   :defer 1
1951   :bind (("C-c C-j" . term-line-mode)
1952          ("C-c m m" . multi-term)
1953          ("C-c m p" . multi-term-dedicated-toggle))
1954   :config
1955   (setq multi-term-program "/bin/screen"
1956         ;; TODO: add separate bindings for connecting to existing
1957         ;; session vs. always creating a new one
1958         multi-term-dedicated-select-after-open-p t
1959         multi-term-dedicated-window-height 20
1960         multi-term-dedicated-max-window-height 30
1961         term-bind-key-alist
1962         '(("C-c C-c" . term-interrupt-subjob)
1963           ("C-c C-e" . term-send-esc)
1964           ("C-k" . kill-line)
1965           ("C-y" . term-paste)
1966           ("M-f" . term-send-forward-word)
1967           ("M-b" . term-send-backward-word)
1968           ("M-p" . term-send-up)
1969           ("M-n" . term-send-down)
1970           ("<C-backspace>" . term-send-backward-kill-word)
1971           ("<M-DEL>" . term-send-backward-kill-word)
1972           ("M-d" . term-send-delete-word)
1973           ("M-," . term-send-raw)
1974           ("M-." . comint-dynamic-complete))
1975         term-unbind-key-alist
1976         '("C-z" "C-x" "C-c" "C-h" "C-y" "<ESC>")))
1977 #+end_src
1978
1979 * Email
1980
1981 #+begin_src emacs-lisp
1982 (defvar amin-maildir (expand-file-name "~/mail/"))
1983 (after! recentf
1984   (add-to-list 'recentf-exclude amin-maildir))
1985 #+end_src
1986
1987 ** Gnus
1988
1989 #+begin_src emacs-lisp
1990 (setq
1991  amin-gnus-init-file (no-littering-expand-etc-file-name "gnus")
1992  mail-user-agent     'gnus-user-agent
1993  read-mail-command   'gnus)
1994
1995 (use-package gnus
1996   :bind (("s-m" . gnus)
1997          ("s-M" . gnus-unplugged))
1998   :init
1999   (setq
2000    gnus-select-method '(nnnil "")
2001    gnus-secondary-select-methods
2002    '((nnimap "amin"
2003             (nnimap-stream plain)
2004             (nnimap-address "127.0.0.1")
2005             (nnimap-server-port 143)
2006             (nnimap-authenticator plain)
2007             (nnimap-user "amin@aminb.org"))
2008      (nnimap "uwaterloo"
2009              (nnimap-stream plain)
2010              (nnimap-address "127.0.0.1")
2011              (nnimap-server-port 143)
2012              (nnimap-authenticator plain)
2013              (nnimap-user "abandali@uwaterloo.ca")))
2014    gnus-message-archive-group "nnimap+amin:Sent"
2015    gnus-parameters
2016    '(("gnu.*"
2017       (gcc-self . t)))
2018    gnus-large-newsgroup  50
2019    gnus-home-directory   (no-littering-expand-var-file-name "gnus/")
2020    gnus-directory        (concat gnus-home-directory "news/")
2021    message-directory     (concat gnus-home-directory "mail/")
2022    nndraft-directory     (concat gnus-home-directory "drafts/")
2023    gnus-save-newsrc-file nil
2024    gnus-read-newsrc-file nil
2025    gnus-interactive-exit nil
2026    gnus-gcc-mark-as-read t))
2027
2028 (use-package gnus-art
2029   :config
2030   (setq
2031    gnus-visible-headers
2032    (concat gnus-visible-headers "\\|^List-Id:\\|^X-RT-Originator:\\|^User-Agent:")
2033    gnus-sorted-header-list
2034    '("^From:" "^Subject:" "^Summary:" "^Keywords:"
2035      "^Followup-To:" "^To:" "^Cc:" "X-RT-Originator"
2036      "^Newsgroups:" "List-Id:" "^Organization:"
2037      "^User-Agent:" "^Date:")
2038   ;; local-lapsed article dates
2039   ;; from https://www.emacswiki.org/emacs/GnusFormatting#toc11
2040   gnus-article-date-headers '(user-defined)
2041   gnus-article-time-format
2042   (lambda (time)
2043     (let* ((date (format-time-string "%a, %d %b %Y %T %z" time))
2044            (local (article-make-date-line date 'local))
2045            (combined-lapsed (article-make-date-line date
2046                                                     'combined-lapsed))
2047            (lapsed (progn
2048                      (string-match " (.+" combined-lapsed)
2049                      (match-string 0 combined-lapsed))))
2050       (concat local lapsed))))
2051   (bind-keys
2052    :map gnus-article-mode-map
2053    ("r"   . gnus-article-reply-with-original)
2054    ("R"   . gnus-article-wide-reply-with-original)
2055    ("M-L" . org-store-link)))
2056
2057 (use-package gnus-sum
2058   :bind (:map gnus-summary-mode-map
2059               :prefix-map amin--gnus-summary-prefix-map
2060               :prefix "v"
2061               ("r" . gnus-summary-reply)
2062               ("w" . gnus-summary-wide-reply)
2063               ("v" . gnus-summary-show-raw-article))
2064   :config
2065   (bind-keys
2066    :map gnus-summary-mode-map
2067    ("r"   . gnus-summary-reply-with-original)
2068    ("R"   . gnus-summary-wide-reply-with-original)
2069    ("M-L" . org-store-link))
2070   :hook (gnus-summary-mode . amin--no-mouse-autoselect-window))
2071
2072 (use-package gnus-msg
2073   :config
2074   (setq gnus-posting-styles
2075         '((".*"
2076            (address "amin@aminb.org")
2077            (body "\nBest,\namin\n")
2078            (eval (setq amin--message-cite-say-hi t)))
2079           ("gnu.*"
2080            (address "bandali@gnu.org"))
2081           ((header "subject" "ThankCRM")
2082            (to "webmasters-comment@gnu.org")
2083            (body "\nAdded  to 2018supporters.html.\n\nMoving to campaigns.\n\n-amin\n")
2084            (eval (setq amin--message-cite-say-hi nil)))
2085           ("nnimap\\+uwaterloo:.*"
2086            (address "abandali@uwaterloo.ca")
2087            (gcc "\"nnimap+uwaterloo:Sent Items\"")))))
2088
2089 (use-package gnus-topic
2090   :hook (gnus-group-mode . gnus-topic-mode))
2091
2092 (use-package gnus-agent
2093   :config
2094   (setq gnus-agent-synchronize-flags 'ask)
2095   :hook (gnus-group-mode . gnus-agent-mode))
2096
2097 (use-package gnus-group
2098   :config
2099   (setq gnus-permanently-visible-groups "\\((INBOX\\|gnu$\\)"))
2100
2101 (use-package mm-decode
2102   :config
2103   (setq mm-discouraged-alternatives '("text/html" "text/richtext")))
2104 #+end_src
2105
2106 ** sendmail
2107
2108 #+begin_src emacs-lisp
2109 (use-package sendmail
2110   :config
2111   (setq sendmail-program "/usr/bin/msmtp"
2112         ;; message-sendmail-extra-arguments '("-v" "-d")
2113         mail-specify-envelope-from t
2114         mail-envelope-from 'header))
2115 #+end_src
2116
2117 ** message
2118
2119 #+begin_src emacs-lisp
2120 (use-package message
2121   :config
2122   (defconst amin--message-cite-style-format "On %Y-%m-%d %l:%M %p, %N wrote:")
2123   (defconst message-cite-style-bandali
2124     '((message-cite-function  'message-cite-original)
2125       (message-citation-line-function  'message-insert-formatted-citation-line)
2126       (message-cite-reply-position 'traditional)
2127       (message-yank-prefix  "> ")
2128       (message-yank-cited-prefix  ">")
2129       (message-yank-empty-prefix  ">")
2130       (message-citation-line-format
2131        (if amin--message-cite-say-hi
2132            (concat "Hi %F,\n\n" amin--message-cite-style-format)
2133          amin--message-cite-style-format)))
2134     "Citation style based on Mozilla Thunderbird's. Use with message-cite-style.")
2135   (setq message-cite-style 'message-cite-style-bandali
2136         message-kill-buffer-on-exit t
2137         message-send-mail-function 'message-send-mail-with-sendmail
2138         message-sendmail-envelope-from 'header
2139         message-dont-reply-to-names
2140         "\\(\\(.*@aminb\\.org\\)\\|\\(amin@bandali\\.me\\)\\|\\(\\(aminb?\\|mab\\|bandali\\)@gnu\\.org\\)\\|\\(\\(m\\|a\\(min\\.\\)?\\)bandali@uwaterloo\\.ca\\)\\)"
2141         message-user-fqdn "aminb.org")
2142   :hook (;; (message-setup . mml-secure-message-sign-pgpmime)
2143          (message-mode . flyspell-mode)
2144          (message-mode . (lambda ()
2145                            ;; (setq fill-column 65
2146                            ;;       message-fill-column 65)
2147                            (make-local-variable 'company-idle-delay)
2148                            (setq company-idle-delay 0.2))))
2149   ;; :custom-face
2150   ;; (message-header-subject ((t (:foreground "#111" :weight semi-bold))))
2151   ;; (message-header-to      ((t (:foreground "#111" :weight normal))))
2152   ;; (message-header-cc      ((t (:foreground "#333" :weight normal))))
2153   )
2154
2155 (after! mml-sec
2156   (setq mml-secure-openpgp-encrypt-to-self t
2157         mml-secure-openpgp-sign-with-sender t))
2158 #+end_src
2159
2160 ** footnote
2161
2162 Convenient footnotes in =message-mode=.
2163
2164 #+begin_src emacs-lisp
2165 (use-package footnote
2166   :after message
2167   :bind
2168   (:map message-mode-map
2169         :prefix-map amin--footnote-prefix-map
2170         :prefix "C-c f"
2171         ("a" . footnote-add-footnote)
2172         ("b" . footnote-back-to-message)
2173         ("c" . footnote-cycle-style)
2174         ("d" . footnote-delete-footnote)
2175         ("g" . footnote-goto-footnote)
2176         ("r" . footnote-renumber-footnotes)
2177         ("s" . footnote-set-style))
2178   :config
2179   (setq footnote-start-tag ""
2180         footnote-end-tag   ""
2181         footnote-style     'unicode))
2182 #+end_src
2183
2184 ** bbdb
2185
2186 Manually install bbdb (=lisp/bbdb= copied from an ELPA-based setup),
2187 because installing it from source on Emacs 27 using the following
2188 submodule configuration for some reason doesn’t work and results in
2189 very strange errors when using any of the functions.
2190
2191 #+begin_src conf :tangle no
2192 [submodule "bbdb"]
2193         path = lib/bbdb
2194         url = https://git.savannah.nongnu.org/git/bbdb.git
2195         load-path = lisp
2196         info-path = doc
2197         build-step = ./autogen.sh
2198         build-step = ./configure
2199         build-step = make
2200         build-step = make install
2201 #+end_src
2202
2203 I tried using =borg-elpa= instead of doing it like this, but it added
2204 2 seconds to my startup time, which is unacceptable to me.
2205
2206 #+begin_src emacs-lisp
2207 (use-package bbdb
2208   :load-path "lisp/bbdb"
2209   :init
2210   (load (expand-file-name "lisp/bbdb/bbdb-autoloads.el" user-emacs-directory))
2211   ;; (bbdb-mua-auto-update-init 'message)
2212   (setq bbdb-mua-auto-update-p 'query
2213         bbdb-complete-mail nil)
2214   (bbdb-initialize 'gnus 'message))
2215 #+end_src
2216
2217 ** message-x
2218
2219 #+begin_src emacs-lisp
2220 (use-package message-x
2221   :disabled t
2222   :custom
2223   (message-x-completion-alist
2224    (quote
2225     (("\\([rR]esent-\\|[rR]eply-\\)?[tT]o:\\|[bB]?[cC][cC]:" . gnus-harvest-find-address)
2226      ((if
2227           (boundp
2228            (quote message-newgroups-header-regexp))
2229           message-newgroups-header-regexp message-newsgroups-header-regexp)
2230       . message-expand-group)))))
2231 #+end_src
2232
2233 ** gnus-harvest
2234
2235 #+begin_src emacs-lisp
2236 (use-package gnus-harvest
2237   :disabled t
2238   :commands gnus-harvest-install
2239   :demand t
2240   :config
2241   (if (featurep 'message-x)
2242       (gnus-harvest-install 'message-x)
2243     (gnus-harvest-install)))
2244 #+end_src
2245
2246 * Blogging
2247 ** [[https://ox-hugo.scripter.co][ox-hugo]]
2248
2249 #+begin_src emacs-lisp
2250 (use-package ox-hugo
2251   :after ox)
2252
2253 (use-package ox-hugo-auto-export
2254   :load-path "lib/ox-hugo")
2255 #+end_src
2256
2257 * Post initialization
2258 :PROPERTIES:
2259 :CUSTOM_ID: post-initialization
2260 :END:
2261
2262 Display how long it took to load the init file.
2263
2264 #+begin_src emacs-lisp
2265 (message "Loading %s...done (%.3fs)" user-init-file
2266          (float-time (time-subtract (current-time)
2267                                     amin--before-user-init-time)))
2268 #+end_src
2269
2270 * Footer
2271 :PROPERTIES:
2272 :CUSTOM_ID: footer
2273 :END:
2274
2275 #+begin_src emacs-lisp :comments none
2276 ;;; init.el ends here
2277 #+end_src
2278
2279 * COMMENT Local Variables                                           :ARCHIVE:
2280 # Local Variables:
2281 # eval: (add-hook 'after-save-hook #'amin/async-babel-tangle 'append 'local)
2282 # End: