updated emacs notes

1 files changed, 197 insertions, 36 deletions

diff --git a/src/tools/emacs.md b/src/tools/emacs.md
index 2fcc5de..7b28f1e 100644
--- a/src/tools/emacs.md
+++ b/src/tools/emacs.md
@@ -3,8 +3,10 @@
 ## help
 ```markdown
   C-h ?         list available help modes
+  C-h e         show message output (`*Messages*` buffer)
   C-h f         describe function
   C-h v         describe variable
+  C-h w         describe which key invoke function (where-is)
   C-h c <KEY>   print command bound to <KEY>
   C-h k <KEY>   describe command bound to <KEY>
   C-h b         list buffer local key-bindings
@@ -14,69 +16,154 @@
 
 ## package manager
 ```markdown
-  package-refresh-contents    refresh package list
-  package-list-packages       list available/installed packages
+  key    fn                          description
+------------------------------------------------
+         package-refresh-contents    refresh package list
+         package-list-packages       list available/installed packages
+                                     `U x` to mark packages for Upgrade & eXecute
 ```
 
 ## window
 ```markdown
-  C-x 0         kill focused window
-  C-x 1         kill all other windows
-  C-x 2         split horizontal
-  C-x 3         split vertical
+  key      fn                      description
+----------------------------------------------
+  C-x 0    delete-window           kill focused window
+  C-x 1    delete-other-windows    kill all other windows
+  C-x 2    split-window-below      split horizontal
+  C-x 3    split-window-right      split vertical
+  C-x o    other-window            other window (cycle)
 ```
 
-## yank/paste
+## buffer
 ```markdown
-  C-<SPACE>  set start mark to select text
-  M-w        copy selected text
-  C-w        kill selected text
-  C-y        paste selected text
-  M-y        cycle through kill-ring
+  key        fn                   description
+---------------------------------------------
+  C-x C-q    read-only-mode       toggle read-only mode for buffer
+  C-x k      kill-buffer          kill buffer
+  C-x s      save-some-buffers    save buffer
+  C-x w      write-file           write buffer (save as)
+  C-x b      switch-to-buffer     switch buffer
+  C-x C-b    list-buffers         buffer list
 ```
 
-## register
+## ibuffer
+Builtin advanced buffer selection mode
 ```markdown
-  C-x r s <reg>      save region in register <reg>
-  C-x r i <reg>      insert content of register <reg>
+  key        fn            description
+--------------------------------------
+             ibuffer       enter buffer selection
+
+  h                        ibuffer help
+
+  o                        open buffer in other window
+  C-o                      open buffer in other window keep focus in ibuffer
+
+  s a                      sort by buffer name
+  s f                      sort by file name
+  s v                      sort by last viewed
+  s v                      sort by major mode
+  ,                        cycle sorting mode
+
+  =                        compare buffer against file on disk (if file is dirty `*`)
+
+  /m                       filter by major mode
+  /n                       filter by buffer name
+  /f                       filter by file name
+  //                       remove all filter
+
+  /g                       create filter group
+  /\                       remove all filter groups
 ```
 
-## block/rect
+## isearch
 ```markdown
-  C-x <SPC>                     activate rectangle-mark-mode
-  M-x string-rectangle <RET>    insert text in marked rect
+  key    fn                           description
+-------------------------------------------------
+  C-s    isearch-forward              search forward from current position (C-s to go to next match)
+  C-r    isearch-backward             search backwards from current position (C-r to go to next match)
+  C-w    isearch-yank-word-or-char    feed next word to current search (extend)
+  M-p    isearch-ring-advance         previous search input
+  M-n    isearch-ring-retreat         next search input
 ```
 
-## mass edit
-```makrdown
-  C-x h                                 mark whole buffer (mark-whole-buffer)
-  M-x delete-matching-line <RET>        delete lines matching regex
-  M-x %                                 search & replace region (query-replace)
-  C-M-x %                               search & replace regex (query-replace-regexp)
+## occur
+```markdown
+  key      fn           description
+-----------------------------------
+  M-s o    occur        get matches for regexp in buffer
+                        use during `isearch` to use current search term
+
+  C-n                   goto next line
+  C-p                   goto previous line
+  o                     open match in other window
+  C-o                   open match in other window keep focus in ibuffer
+```
+```markdown
+  key      fn                                 description
+---------------------------------------------------------
+           multi-occur-in-matching-buffers    run occur in buffers matching regexp
 ```
 
 ## grep
 ```markdown
-  M-x find-grep <RET>           run find-grep result in *grep* buffer
-  n/p                           navigate next/previous match in *grep* buffer
+  key    fn           description
+-----------------------------------
+         rgrep        recursive grep
+         find-grep    run find-grep result in *grep* buffer
+
+  n/p                 navigate next/previous match in *grep* buffer
+  q                   quit *grep* buffer
 ```
 
-## lisp mode
+## yank/paste
 ```markdown
-  M-x lisp-interaction-mode     activate lisp mode
-  C-M-x                         evaluate top expr under cursor
-  C-x C-e                       eval-last-sexp
-  C-u C-x C-e                   eval-last-sexp and prints result in current buffer
+  key         fn                  description
+---------------------------------------------
+  C-<SPACE>   set-mark-command    set start mark to select text
+  M-w         kill-ring-save      copy selected text
+  C-w         kill-region         kill selected text
+  C-y         yank                paste selected text
+  M-y         yank-pop            cycle through kill-ring (only after paste)
+```
+
+## register
+```markdown
+  key             fn                 description
+------------------------------------------------
+  C-x r s <reg>   copy-to-register   save region in register <reg>
+  C-x r i <reg>   insert-register    insert content of register <reg>
+```
+
+## block/rect
+```markdown
+  key          fn                    description
+------------------------------------------------
+  C-x <SPC>    rectangle-mark-mode   activate rectangle-mark-mode
+               string-rectangle      insert text in marked rect
+```
+
+## mass edit
+```markdown
+  key       fn                       description
+------------------------------------------------
+  C-x h     mark-whole-buffer        mark whole buffer
+            delete-matching-line     delete lines matching regex
+  M-%       query-replace            search & replace
+  C-M-%     query-replace-regexp     search & replace regex
 ```
 
 ## narrow
 ```markdown
-  C-x n n               show only focused region (narrow)
-  C-x n w               show whole buffer (wide)
+  key       fn                    description
+---------------------------------------------
+  C-x n n   narrow-to-region      show only focused region (narrow)
+  C-x n w   widen                 show whole buffer (wide)
 ```
 
 ## org
 ```markdown
+  key              fn   description
+------------------------------------
   M-up/M-down           re-arrange items in same hierarchy
   M-left/M-right        change item hierarchy
   C-RET                 create new item below current
@@ -86,7 +173,81 @@
 
 ### org source
 ```markdown
-  <s TAB                generate a source block
-  C-c '                 edit source block (in lang specific buffer)
-  C-c C-c               eval source block
+  key       fn     description
+------------------------------
+  <s TAB           generate a source block
+  C-c '            edit source block (in lang specific buffer)
+  C-c C-c          eval source block
+```
+
+## comapny
+```markdown
+  key         fn   description
+-------------------------------
+  C-s              search through completion candidates
+  C-o              filter completion candidates based on search term
+  <f1>             get doc for completion condidate
+  M-<digit>        select completion candidate
+```
+
+## tags
+To generate `etags` using `ctags`
+```markdown
+  ctags -R -e .         generate emacs tag file (important `-e`)
+```
+Navigate using tags
+```markdown
+  key      fn                       description
+-----------------------------------------------
+           xref-find-definitions    find definition of tag
+           xref-find-apropos        find symbols matching regexp
+           xref-find-references     find references of tag
+```
+
+## lisp
+```markdown
+  key   fn        description
+------------------------------
+        ielm      open interactive elips shell
+```
+
+In `lisp-interaction-mode` (`*scratch*` buffer by defult)
+```markdown
+  key              fn                        description
+--------------------------------------------------------
+  C-j              eval-print-last-sexp      evaluate & print preceeding lisp expr
+
+  C-x C-e          eval-last-sexp            evaluate lisp expr
+  C-u C-x C-e      eval-last-sexp            evaluate & print
+```
+
+## ido
+Builtin fuzzy completion mode (eg buffer select, dired, ...).
+```markdown
+  key              fn          description
+------------------------------------------
+                  ido-mode     toggle ido mode
+  <Left>/<Right>               cycle through available competions
+  <RET>                        select completion
+```
+
+## evil
+```markdown
+  key    fn    description
+--------------------------
+  C-z          toggle emacs/evil mode
+  C-^          toggle between previous and current buffer
+  C-p          after paste cycle kill-ring back
+  C-n          after paste cycle kill-ring forward
+```
+
+## dired
+```markdown
+  key    fn    description
+--------------------------
+  i            open sub-dir in same buffer
+  +            create new directory
+  C            copy file/dir
+
+  q            quit
 ```