| At line 3 changed one line |
| The emacs editor |
| The emacs editor is perhaps the most powerful editor available. It runs under Unix, Linux, Macintosh, and Windows. It is highly customizable and programmable. Emacs comes with hundreds of modes and thousands of commands. The following list represents a tiny set of commands to help get you started. |
| At line 5 changed one line |
| !! Exiting Emacs |
| In what follows, "^x" would mean pressing the "x" key while the control key is held. "^x^f" would mean press "xf" while holding the control key down. "^xs" means press the "x" key while the control key is held, and then hit the "s" key after releasing the control key. The control key acts like the shift key in that it modifies the affect of the other key pressed. |
| At line 7 changed one line |
| | exit | ^X^C |
| In an effort to make things as difficult as possible, the Macintosh labels their keyboard differently from everyone else. The backspace (bksp) key is labeled "delete" on the Macintosh. They use fn-delete as a "del" key. |
| At line 9 added 15 lines |
| !!Glossary Of Terms |
|
| | file | file on the disk |
| | buffer | emacs' internal copy of a file to be edited |
| | window | a rectangular section of the display used to display an emacs buffer |
| | point | a spot between the two characters identified by the current cursor position and the character before it |
| | mark | a previously saved point (not necessarily the current point) |
| | region | a block of text between the mark and point |
|
|
| !! Exiting and Stopping Emacs |
|
| | ^x ^c | exit emacs |
| | ^g | abort the current function |
|
| At line 11 changed 4 lines |
| |^x ^f|read a file into emacs |
| |^x ^s|save a file |
| |^x s|save all files |
| |^x i|insert a file at current location |
| |^x ^f|read a file into a new emacs buffer |
| |^x ^s|save the buffer currently being edited to the original file |
| |^x s|save all modified buffers to their respective files |
| |^x i|insert a file at the current location (^x-eye) |
| At line 17 changed one line |
| !!Motion |
| !!Cursor Motion |
| At line 19 changed 2 lines |
| |^a | beginning of line |
| |^e | end of line |
| In addition to the normal motion commands using standard cursor keys (up, down, left, right, PgUp, PgDn, etc.) emacs also uses the following: |
|
| |^f | forward a character |
| |^b | back a character |
| |^n | next line |
| |^p | previous line |
| |^a | beginning of the line |
| |^e | end of the line |
| | ^right | forward a word |
| | ^left | backward a word |
| | ^down | next paragraph |
| | ^up | previous paragraph |
| At line 49 added 8 lines |
| !! Scrolling (screen motion) |
|
| |^v or PgDn|Scroll down |
| |Esc-v or PgUp|Scroll up |
| |Esc 0^l|Current line to top of screen (Esc zero Ctl-ell) |
| |Esc ^l|Current line to middle of screen (Esc Ctl-ell) |
|
|
| At line 26 changed one line |
| | ^d | delete character |
| | Del | delete the character the cursor is on |
| | bksp | delete the previous character |
| At line 28 changed one line |
| | Esc Del | delete previous word |
| | Esc bksp | delete previous word |
| At line 30 changed one line |
| | Ctl-Shft-Bksp | delete line |
| | Ctl-Shft-Bksp | delete the whole line |
| | Esc \ | delete all space and tab characters around the point |
| At line 67 added 10 lines |
| !!Undoing |
|
| If you make a mistake you can undo it with the following command. This command can be repeated to undo the prior command and so on back to the beginning of all of your edits. |
|
| | ^/ | undo edit |
|
| Consecutive undo's via consecutive ^/ |
|
| To redo, type anything except a ^/ The following ^/ will redo. |
|
| At line 40 changed one line |
| | ^u ^space | go to previous mark |
| | ^u ^space | go to the previous mark |
| At line 44 changed 2 lines |
| Unlike other editors, rather than a single cut / paste buffer where only a single item can be cut and paste at a time, |
| emacs remembers all cuts and copies so that you can paste the last cut or any prior one. |
| Unlike other editors, rather than a single cut / paste buffer where only a single item can be cut and paste at a time, emacs remembers all cuts and copies so that you can paste the last cut or any prior one. |
| At line 50 changed one line |
| | Esc y | replace last yank with prior thing in the kill ring |
| | Esc y | replace last yank with prior region in the kill ring |
| At line 54 changed 3 lines |
| Incremental search differs from a typical search feature in that it starts the search with the first character and |
| refines the search as you type each subsequent character in the search. This way one may find what one is looking for |
| as soon as possible without typing any more characters than necessary. |
| Incremental search differs from a typical search feature in that it starts the search with the first character and refines the search as you type each subsequent character in the search. This way one may find what one is looking for as soon as possible without typing any more characters than necessary. |
| At line 60 changed one line |
| | ^g | abort search |
| | ^g | abort the search |
| | Esc-^s | incremental search forward with regular expressions |
| | Esc-^r | incremental search backward with regular expressions |
| At line 106 added one line |
|
| At line 109 added 2 lines |
| Emacs's regular expression syntax corresponds to grep's extended regular expression syntax. See [grep] |
|
| At line 72 changed one line |
| | del | no replace, find next |
| | bksp | no replace, find next |
| At line 127 added 93 lines |
|
| !! Buffers |
|
| In general, buffers contain files being edited. Emacs can edit any number of files at a time. Emacs also supports multiple windows. Each window would display a particular buffer. Emacs can display any number of windows with any buffer (or the same buffer) at a time. In general, buffers have the same name as the file they hold. |
|
| Killing a buffer that contains changes to a file that you have not yet saved will cause the changes to be lost. However, emacs will warn you about this so that it doesn't happen accidentally. |
|
| | ^x b | select a different buffer to be displayed in the current window |
| | ^x ^b | list all buffers |
| | ^x 1 | delete the buffer list |
| | ^x k | kill a buffer |
|
| !!Multiple Windows |
|
| Window operations do not affect buffers. It only affects what is displayed. So, killing or creating windows does not affect files. |
|
| When you split the screen you will see two copies of the same file that may be navigated independently. Generally, after you split a window |
| you would place a different buffer (representing a different file) in the window by either utilizing a file command or buffer command. |
|
| | ^x 2 | split current window above and below |
| | ^x 3 | split window side-by-side |
| | ^x 1 | delete all other windows (doesn't hurt the buffers) |
| | ^x 0 | delete the current window (^x zero) |
| | ^x o | move cursor to the next (or other) window (^x oh) |
|
| !!Keyboard Macros |
|
| Emacs can remember a sequence of keys and emacs commands and be made to repeat them. |
|
| | ^x ( | start learning a sequence |
| | ^x ) | stop learning and remember the sequence as a macro |
| | ^x e | execute the last learned macro |
| | ^x^kbX | bind the last keyboard macro to the sequence ^x^kX (where X is any number or upper-case letter) |
|
| !!Repeating |
|
| All emacs command may be executed any number of times by preceding the command as follows: |
|
| | Esc N cmd | repeat command cmd N times |
|
| This is especially useful with keyboard macros in order to repeat a sequence many times. |
|
| !!Registers |
|
| Emacs has the ability to save and name any number of locations and text that has been cut or copied. Each location or block of text is saved in a register. Registers are simply variables with single character names. The name used is up to you. Emacs will ask you for the name. |
|
| | ^x r s | save marked region in a named register |
| | ^x r i | insert saved region into the current location |
|
| | ^x r space | save the current location in a named register |
| | ^x r j | jump to the location previously saved |
|
|
| !!Help |
|
| Emacs is fully documented. This documentation is available right with emacs. |
|
| | ^h i | info - access the embedded emacs manual |
| | ^h t | run the emacs tutorial |
| | ^h b | describe bindings - explain all current keyboard bindings |
| | ^h m | describe mode - explain all facilities for the current file type mode |
|
| Once viewing the manual, the following navigation commands are active. |
|
| | m enter | go to the menu item that you have placed the cursor on |
| | u | go up (back) to the previous menu level |
| | q | quit or exit the manual |
| | space | scroll forward a page |
| | bksp | scroll back a page |
| | . | top of current section |
| | n | next node (or section) |
| | p | previous node (or section) |
|
| !! Tags |
|
| Emacs comes with a program named “etags” that is used to create tag files. |
|
| Tag files are named “TAGS” |
|
| You can run etags in several directories producing one big tag file representing the whole project. |
|
|
| Usage: {{{etags [-o OUTFILE] [-a] *.c *.h}}} |
|
|
| | Esc-x visit-tags-table | read a TAGS file |
| | Esc-. | find tag |
| | ^u-Esc-. | find next tag |
| | Esc-* | go back to where tag was searched |
| | Esc-Tab | symbol completion |
|
| | ^x-^space | go back to previous location |
|