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.

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.

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.

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

Files#

^x ^fread a file into a new emacs buffer
^x ^ssave the buffer currently being edited to the original file
^x ssave all modified buffers to their respective files
^x iinsert a file at the current location (^x-eye)
^x ^wwrite buffer to a named file

Cursor Motion#

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
Esc < beginning of buffer
Esc > end of buffer

Scrolling (screen motion)#

^v or PgDnScroll down
Esc-v or PgUpScroll up
Esc 0^lCurrent line to top of screen (Esc zero Ctl-ell)
Esc ^lCurrent line to middle of screen (Esc Ctl-ell)

Deleting#

Del delete the character the cursor is on
bksp delete the previous character
Esc d delete following word
Esc bksp delete previous word
^k delete to end-of-line
Ctl-Shft-Bksp delete the whole line
Esc \ delete all space and tab characters around the point

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.

Locations and Regions#

The current position/location is considered the space between the location of the cursor and the previous character. This is called the point. A point that is remembered is called a mark. A region is between the last mark and the current cursor position (the point).

^space set mark here
^x ^x exchange point and mark
^u ^space go to the previous mark

Cutting and Pasting#

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.

^w delete region and put on kill ring
Esc w copy region to kill ring
^y yank back (paste) the last thing in the kill ring
Esc y replace last yank with prior region in the kill ring

Incremental Search#

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.

^s incremental search forward
^r incremental search backward
^g abort the search
Esc-^s incremental search forward with regular expressions
Esc-^r incremental search backward with regular expressions

^s and ^r can be used while searching in order to find the next occurrence.

Emacs's regular expression syntax corresponds to grep's extended regular expression syntax. See grep

Search and Replace#

Esc % interactive search & replace
Esc x query-replace-regexp interactive search & replace utilizing regular expressions

The following valid responses are accepted during the interactive search and replace process.

space replace and find next
bksp no replace, find next
! replace all remaining non-interactively
^ go back to previous find
, replace current one and don't find next
return exit function
^r recursive edit *
  • recursive edit allows you to go back to a normal edit process. You then type "Esc ^c" to exist the recursive edit and return to the search and replace process.

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

Add new attachment

Only authorized users are allowed to upload new attachments.
« This page (revision-36) was last changed on 03-Mar-2017 14:49 by BlakeMcBride