add a bunch of emacs packages HELP

2 files changed, 85 insertions, 0 deletions

diff --git a/.config/emacs/lisp/evil-collection/modes/ag/README.org b/.config/emacs/lisp/evil-collection/modes/ag/README.org
new file mode 100644
index 0000000..48ceccc
--- /dev/null
+++ b/.config/emacs/lisp/evil-collection/modes/ag/README.org
@@ -0,0 +1,22 @@
+* ag
+
+  Evil bindings for [[https://github.com/Wilfred/ag.el][ag]] search result buffers.
+
+  Initial state for =ag-mode= is forced to =normal= so the buffer can be
+  edited with [[https://github.com/mhayashi1120/Emacs-wgrep][wgrep]].
+
+** Key bindings
+
+   Applied in =normal= and =visual= states.
+
+   | Command                      | Original | Evil              |
+   |------------------------------+----------+-------------------|
+   | =evil-previous-line=         |          | =k=               |
+   | =evil-backward-char=         |          | =h=               |
+   | =recompile=                  | =g=      | =gr=              |
+   | =compilation-next-error=     | =n=      | =gj=, =C-j=, =]]= |
+   | =compilation-previous-error= | =p=      | =gk=, =C-k=, =[[= |
+   | =evil-search-backward=       |          | =?=               |
+   | =evil-search-forward=        |          | =/=               |
+   | =evil-search-next=           |          | =n=               |
+   | =evil-search-previous=       |          | =N=               |
diff --git a/.config/emacs/lisp/evil-collection/modes/ag/evil-collection-ag.el b/.config/emacs/lisp/evil-collection/modes/ag/evil-collection-ag.el
new file mode 100644
index 0000000..0ce8b90
--- /dev/null
+++ b/.config/emacs/lisp/evil-collection/modes/ag/evil-collection-ag.el
@@ -0,0 +1,63 @@
+;;; evil-collection-ag.el --- Evil Bindings for Ag -*- lexical-binding: t -*-
+
+;; Copyright (C) 2017 James Nguyen
+
+;; Author: James Nguyen <james@jojojames.com>
+;; Maintainer: James Nguyen <james@jojojames.com>
+;; Pierre Neidhardt <mail@ambrevar.xyz>
+;; URL: https://github.com/emacs-evil/evil-collection
+;; Version: 0.0.1
+;; Package-Requires: ((emacs "26.3"))
+;; Keywords: evil, ag, tools
+
+;; This program is free software; you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; This program is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+;; Evil bindings for `ag-mode' from the `wgrep-ag' package.
+
+;;; Code:
+(require 'ag nil t)
+(require 'evil-collection)
+
+(defconst evil-collection-ag-maps '(ag-mode-map))
+
+;;;###autoload
+(defun evil-collection-ag-setup ()
+  "Set up `evil' bindings for `ag'."
+  (evil-collection-define-key '(normal visual) 'ag-mode-map
+    "k" 'evil-previous-line
+    "h" 'evil-backward-char
+
+    ;; refresh
+    "gr" 'recompile
+
+    ;; navigation
+    "gj" 'compilation-next-error
+    "gk" 'compilation-previous-error
+    (kbd "C-j") 'compilation-next-error
+    (kbd "C-k") 'compilation-previous-error
+    "]]" 'compilation-next-error
+    "[[" 'compilation-previous-error
+
+    ;; search
+    "?" evil-collection-evil-search-backward
+    "/" evil-collection-evil-search-forward
+    "n" evil-collection-evil-search-next
+    "N" evil-collection-evil-search-previous)
+  ;; `ag' is best set in 'normal state because its buffer can be edited.
+  ;; https://github.com/mhayashi1120/Emacs-wgrep
+  (evil-set-initial-state 'ag-mode 'normal))
+
+(provide 'evil-collection-ag)
+;;; evil-collection-ag.el ends here