diff options
Diffstat (limited to 'src')
-rw-r--r-- | src/tools/emacs.md | 233 |
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 ``` |