Difference between revisions of "Quick Tutorial"

From WikEmacs
Jump to: navigation, search
(Registers: window configuration in registers)
Line 1: Line 1:
This reference-like tutorial is aimed at Emacs beginners and probably others too. If you know how to do some basic editing and navigation in Emacs and want to quickly go through more of its capabilities, then this tutorial is for you. If you are looking for the semantics or key-bindings of a specific feature, this tutorial aims to be for you since it is a subset of the online Emacs documentation. If you are giving an introductory presentation about Emacs, this tutorial might help you.
Yup. I had a \( in that comment to avoid meissng up the syntax highlighting. That worked OK but  Org mode uses \( to indicate LaTeX code. I hunted around in the Org export code and figured out how to turn it off. I don't remember the details but I can look them up if you're interested.
== Description and History ==
* Emacs is an extensible, customizable, self-documenting, real-time display text editor.
* Originally, a set of editing macros for the TECO editor.
* GNU Emacs was developed by R. Stallman and G. Steele.
* Technically, GNU Emacs is an elisp interpreter with text editing extensions.
* GNU Emacs contains thousands of commands and allows the user to combine them into elisp procedures (called macros) to automate work.
* Commands are, themselves, elisp procedures and the GNU Emacs configuration '''init''' file is an elisp program.
== Technical Description ==
; Extensible : The user can define, un-define and redefine commands as well as re-use available commands into macros.
; Customizable : The user can change properties of emacs elements including the key-bindings and the display.
; Self-documenting : All defined commands and macros get automatic preliminary documentation (bound keys and parameters).
== Why Emacs? ==
* Easily programmable
* Kill ring
* Rectangular editing
* Registers
* Command repetition
* Macros and Lisp procedures
* Modes
* Init file
* Remote files
* Shell, Terminal Emulator, IRC, Email, News, File Manager, Process Manager, Project Manager, Tetris, Doctor and many others.
== Terminology and Structure ==
{{details|Emacs Terminology}}
; Buffer : A container for data (text, completions)
; Point : The current position in the buffer (cursor)
; Window : A visual container for a buffer
; Frame : A visual container for one or more windows
; Kill : The equivalent of cutting
; Yank : The equivalent of copying
; Kill Ring : A circular clipboard (very handy)
; Mark : The coordinates of a selection
; Region : The text inside a mark
; Modeline : A status line
; Minibuffer : A small buffer for commands and arguments
; Mode : The current type of data being edited
== Modeline ==
The Modeline is used to report different pieces of information.
<pre>-cs:ch-fr  buf      pos line   (major minor)-----</pre>
; cs : Character set (or coding system)
; &#58; : Newline mode
; ch : File modification status
; - or @ : File is local or remote
; fr : Frame name on text terminals
; buf : Buffer/file name
; pos : Point/cursor position
; line : Current line and column number
; modes (major minor) : Currently loaded major and minor modes
== Keybind Terms and Minibuffer ==
Emacs has some different naming of command/control keys (probably coming from the old days).
; M : Meta key, Alt or ESC
; C : Control key
; S : Shift key
; {{Keys|M-a}} : Press '''a''' while holding the meta key
; {{Keys|C-M-a}} : Press '''a''' while holding the control and meta keys
; {{Keys|C-a b}} : Press '''a''' while holding the control key then press '''b'''
; {{Keys|C-a C-b}} : Press '''a''' and '''b''' both while holding the control key
; {{Keys|C-a M-b}} : Press '''a''' with control then '''b''' with meta
The Minibuffer is used to input commands, arguments and setting different modes (which some of are bound to keys or menu actions).
; {{Keys|M-x}} : Execute a command by name
== Basic Usage ==
=== Loading ===
; <pre>$ emacs # opens Emacs at the scratch buffer</pre>
; <pre>$ emacs [file1] [file2] ... # opens Emacs in split-window mode</pre>
; {{Keys|C-x C-f}} ''filename'' : loads a new buffer from ''filename''
=== Saving ===
; {{Keys|C-x C-s}} : saves the current buffer
; {{Keys|C-x C-w}} ''filename'' : saves the current buffer as ''filename''
=== Other ===
; {{Keys|C-x C-c}} : quits emacs
; {{Keys|C-g C-g}} : cancels key-sequence
== Windows ==
Windows are used to display buffer contents. Windows can be split and resized inside an Emacs frame. The minibuffer has its own window.
; {{Keys|C-x 2}} : open a window vertically
; {{Keys|C-x 3}} : open a window horizontally
; {{Keys|C-x 0}} : close the current window
; {{Keys|C-x 1}} : close all other windows
; ESC ESC ESC : close all other windows
; {{Keys|C-x o}} : move to another window
; {{Keys|C-x ^}} : increase window size vertically
; {{Keys|C-x } }} : increase window size horizontally
; {{Keys|C-x {}} : decrease window size horizontally
; {{Keys|C-x -}} : shrink window to buffer size
; {{Keys|C-x +}} : make all windows equal in size
== Navigation and Movement ==
=== Word ===
; {{Keys|C-&larr;}} : moves one word backwards
; {{Keys|C-&rarr;}} : moves one word forward
=== Line ===
; {{Keys|C-a}} : goes to beginning of the line (Home)
; {{Keys|C-e}} : goes to end of the line (End)
; {{Keys|M-a}} : goes to beginning of the sentence
; {{Keys|M-e}} : goes to end of the sentence
; {{Keys|M-g g}} : goes to given line by number
; {{Keys|M-m}} : moves point to the first non-whitespace character in this line
=== Paragraph ===
; {{Keys|C-&uarr;}} : moves up one paragraph
; {{Keys|C-&darr;}} : moves down one paragraph
=== Window ===
; {{Keys|M-0 M-r}} : moves to the top of window
; {{Keys|M-r}} : moves to the middle of window
; {{Keys|M-- M-r}} : moves to the bottom of window
=== Buffer ===
; {{Keys|C-x [}} : moves to the beginning of the buffer
; {{Keys|C-x ]}} : moves to the end of the buffer
; {{Keys|C-l}} : moves the buffer to position point
; {{Keys|C-x b}} : switches to another buffer by name
; {{Keys|C-x &larr;}} or {{Keys|C-x &rarr;}} : switches to previous or next buffer
; {{Keys|C-x k}} : kills the current buffer
== Editing ==
=== Character ===
; {{Keys|C-d}} : deletes next character
; {{Keys|C-t}} : transposes current character with previous one
; {{Keys|C-q TAB}} : inserts a TAB verbatim
=== Word ===
; {{Keys|M-d}}        : kills the next word
; {{Keys|M-- M-d}}    : kills to the previous word
; {{Keys|M-/}}        : expands current word
; {{Keys|M-/ SPC M-/}} : expands current word and grabs next one
; {{Keys|M-C-/}}      : completes current word
; {{Keys|M-t}}        : transposes current word with next one
; {{Keys|M-- M-t}}    : transposes current word with previous one
; {{Keys|M-c}}        : capitalizes next word
; {{Keys|M-- M-c}}    : capitalizes previous word
; {{Keys|M-l}}        : lowercase next word
; {{Keys|M-- M-l}}    : lowercase previous word
; {{Keys|M-u}}        : uppercase next word
; {{Keys|M-- M-u}}    : uppercase previous word
=== Line ===
; {{Keys|M-o M-s}} : center a line
; {{Keys|C-S-BACKSPC}} : kills current line
; {{Keys|C-k}} : kills from point to EOL
; {{Keys|M-u C-k}} : kills to the previous line
; {{Keys|C-a C-k}} : goes to BOL then kills to EOL
; {{Keys|TAB}} : indents line depending on current mode
; {{Keys|C-o}} : breaks line before/after point
; {{Keys|C-x C-t}} : transpose current line with previous one
; {{Keys|M-0 C-x}} C-t : transpose current line with one at mark
; delete-matching-lines : delete lines matching a regexp
== Prefix Arguments and Command Repetition ==
Passing numerical arguments to commands can alter their behavior (e.g., repetition or inversion). Passing an argument can be done before M-x or key bindings.
; {{Keys|M-''n'' ''com''}}  : run ''com'' with prefix arg ''n''
; {{Keys|M-- ''com''}}      : run ''com'' with negative prefix arg
; {{Keys|C-u ''n'' ''com''}} : run ''com'' with prefix arg ''n''
; {{Keys|C-u ''com''}}      : run ''com'' with prefix arg 4 (the default)
; {{Keys|C-u C-u ''com''}}  : run ''com'' with prefix arg 16 (four times the four times the default)
; {{Keys|C-u C-u ''com''}}  : run ''com'' with prefix arg 64 (four times the four times the four times the default)
; {{Keys|C-u}}              : also terminates the prefix argument
; {{Keys|C-x [z]+}}          : repeats the previous z''th'' command (including its args)
; {{Keys|C-x ESC ESC}}      : repeats last command that used the minibuffer
=== Examples ===
; {{Keys|C-u 5 0 C-k}} : will kill 50 lines
; {{Keys|C-u 5 C-u 0}} : will insert 5 zeros
== Search and Replace ==
=== Incremental search ===
{{Details|Incremental Search}}
; {{Keys|C-s keyword}} : search forward
; {{Keys|C-r keyword}} : search backward
=== Non-incremental search ===
; {{Keys|C-s RET keyword}} : search forward
; {{Keys|C-r RET keyword}} : search backward
=== Regular Expression Search ===
{{Details|Regexp Search}}
; {{Keys|C-M-s expression}} : search regexp forward
; {{Keys|C-M-r expression}} : search regexp backward
=== Notes ===
* '''ESC''' will cancel and go to original point. '''RET''' will end at the current point.
* Searches are case-insensitive unless an uppercase letter is found in the search string.
* While searching, {{Keys|C-w}} will increment the search term with the current word.
=== Unconditional Replace ===
; replace-string : replaces a string with another
; replace-regexp : replaces a regexp match with a string
=== Query Replace (Conditional Replace) ===
; {{Keys|M-%}} : conditional replacement of a string
; query-replace-regexp : conditional replacement of a regular expression
=== Notes ===
* Replaces are case-insensitive unless an uppercase letter is found in the match string.
* Replaces work from position to end of buffer unless a mark is active.
* After a replace, the position will be at the end of the last match. {{Keys|C-u C-SPC}} to go back to the position before the replace started.
* During a query replace, '''SPC''' will apply a replace and '''DEL''' will skip.
== Undo and Redo ==
In Emacs, there is no special redo function. Instead, there is only an undo function and redo can be achieved by ''undo-ing'' an undo.
; {{Keys|C-/}} : undo a single change
; {{Keys|C-g}} : break the chain of undos
=== Notes ===
* If a mark is active, undo will only affect the marked region.
== Regions ==
Emacs uses the mark and point to denote a [[Region|region]] (i.e., a selection).
; {{Keys|C-SPC}}      : creates a region (marks area)
; {{Keys|C-x C-x}}    : swaps mark and point in a region
; {{Keys|C-u C-x C-x}} : swaps mark and point without region
; {{Keys|C-x h}}      : marks the entire buffer
; {{Keys|M-h}}        : marks the paragraph around the point
; {{Keys|TAB}}        : indents the current region
; {{Keys|M-@}}        : incrementally mark next word
=== Kill, Yank and Paste Regions ===
; {{Keys|C-w}}                : kills the currently selected region
; {{Keys|M-w}}                : copies the currently selected region
; {{Keys|C-y}} ({{Keys|M-y}})* : yanks and cycles from the kill ring
=== Notes ===
* Yank is the copy command in vi and the paste command in emacs.
== Rectangles ==
[[Rectangles]] are marked regions between the columns of the point and the mark. Applying operations on rectangles is some sort of vertical editing.
; {{Keys|C-x r k}} : kill the rectangle
; {{Keys|C-x r d}} : delete the rectangle
; {{Keys|C-x r y}} : yank the last killed rectangle
; {{Keys|C-x r o}} : push text to fill rectangle with spaces (open)
; {{Keys|C-x r c}} : replace rectangle text with spaces (clear)
; {{Keys|C-x r t}} : replace each line in rectangle with text
== Registers ==
[[Registers]] are places where you can store anything: text, position, rectangle, configuration, filename, etc... Registers are named with single character symbols: ''a'', ''A'' and ''3'' are three different registers.
; view-register              : view the contents of a register
; {{Keys|C-x r SPC ''r''}}  : record current point position in register ''r''
; {{Keys|C-x r w ''r''}}    : record current window configuration in register ''r''
; {{Keys|C-x r j ''r''}}    : jump to position (or window configuration) in register ''r''
; {{Keys|C-x r s ''r''}}    : save region to register ''r''
; {{Keys|C-u C-x r s ''r''}} : kill region to register ''r''
; {{Keys|C-x r i ''r''}}    : insert text from register ''r''
; append-to-register        : append region to register
; prepend-to-register        : prepend region to register
; {{Keys|C-x r r ''r''}}    : save rectangle into register ''r''
== Bookmarks ==
[[Bookmarks]] are like registers but persistent. They can also be named.
; {{Keys|C-x r m ''foo''}} : bookmark file and point to ''foo''
; {{Keys|C-x r b ''foo''}} : jump to bookmark called ''foo''
; {{Keys|C-x r l}}        : list all bookmarks
; bookmark-save            : save all bookmarks
; bookmark-delete          : delete a bookmark
== Macros ==
[[Keyboard macros]] are user defined commands using the Emacs command language. A user can ''record'' and ''replay'' a macro, useful for simple repeatable tasks. More complex tasks (e.g., conditions, loops) must be implemented in ''elisp''. Macros are recorded in a macro ring.
; {{Keys|F3}}          : start macro definition or insert counter
; {{Keys|C-x (}}        : start macro definition only
; {{Keys|F4}}          : end macro definition or call macro
; {{Keys|C-x e}}        : end macro definition and call macro
; {{Keys|C-x )}}        : end macro definition only
; {{Keys|C-u C-u F3}}  : append commands to last macro
; {{Keys|C-u F3}}      : re-run last macro then append commands to it
; {{Keys|C-x C-k r}}    : run macro on region
; {{Keys|C-x C-k C-n}}  : rotate to select the next macro in the ring
; {{Keys|C-x C-k C-p}}  : rotate to select the previous macro in the ring
=== Macro Counters ===
Every macro definition can have a counter to insert into the buffer.
; {{Keys|F3}}          : inside a macro definition, inserts the counter
; {{Keys|C-x C-k C-i}}  : outside a macro definition, inserts the counter
; {{Keys|C-x C-k C-c}}  : set the macro counter value
; {{Keys|C-x C-k C-f}} : set the macro counter format
=== Saving Macros ===
Macros can be named and saved.
; {{Keys|C-x C-k n}} : name the most recently defined macro
; {{Keys|C-x C-k b}} : keybind the most recently defined macro
; insert-kbd-macro  : insert macro into buffer as elisp code
=== Notes ===
* It is best to use the reserved key bindings {{Keys|C-x C-k [a-zA-Z0-9]}} as to not cause problems with other bindings. {{Keys|C-x C-k b 4}} will define {{Keys|C-x C-k 4}} as a binding.
== Alignment ==
Emacs contains alignment commands. Sometimes those depend on the current mode (i.e., the language).
; align                    : aligns depending on mode
; align-regexp              : aligns using a regular expression
; {{Keys|C-u align-regexp}} : aligns using a regular expression helper
; align-current            : aligns current paragraph depending on mode
== Sorting ==
When sorting, prefixing with {{Keys|C-u}} sorts in descending order.
; sort-lines                      : sort region by lines
; sort-paragraphs                : sort region by paragraphs
; {{Keys|C-u ''n'' sort-fields}}  : sort lines in region by n''th'' field
; {{Keys|C-u -''n'' sort-fields}} : sort lines in region by n''th'' field from right
; sort-numeric-fields            : interpret field as number and not text
; sort-columns                    : sort by column specified by marked region
; reverse-region                  : reverses current region
== Tables ==
Emacs has support for creating and editing text-based tables by keeping track of their properties (e.g., position, size) in the buffer. When a buffer is saved to file, those properties are lost.
; table-insert            : interactively insert a table into buffer
; table-recognize          : detect properties of all tables in the buffer
; table-unrecognize        : remove special table properties
; table-recognize-region  : detect properties of tables in region
; table-unrecognize-region : forget properties of tables in region
; table-recognize-table    : detect properties of table at point
; table-unrecognize-table  : remove properties of table at point
=== Cell resizing ===
; {{Keys|C-u ''n'' C-&gt;}} : widen cell at point by ''n'' characters
; {{Keys|C-u ''n'' C-&lt;}} : narrow cell at point by ''n'' characters
; {{Keys|C-u ''n'' C-&#65373;}} : heighten cell at point by ''n'' lines
; {{Keys|C-u ''n'' C-&#65371;}} : shorten cell at point by ''n'' lines
=== Cell movement ===
; {{Keys|TAB}}  : move to cell on right
; {{Keys|S-TAB}} : move to cell on left
=== Cell merging and splitting ===
; {{Keys|C-c C-c *}} : interactively merge two cells
; {{Keys|C-+}}        : split cell horizontally
; {{Keys|C--}}      : split cell vertically
=== Rows and Columns ===
; {{Keys|C-u ''n'' table-insert-row}}    : insert ''n'' rows
; {{Keys|C-u ''n'' table-delete-row}}    : delete ''n'' rows
; {{Keys|C-u ''n'' table-insert-column}} : insert ''n'' columns
; {{Keys|C-u ''n'' table-delete-column}} : delete ''n'' columns
=== Other ===
; {{Keys|C-:}}          : interactively justify cell, column or row text
; {{Keys|C-!}}          : toggle table fixed width mode
; table-generate-source : table code in Latex, HTML or Cals
== Goodies ==
; {{Keys|C-x TAB}}      : force an indentation on a region
; {{Keys|M-q}}          : indents and breaks paragraph into multiple lines
; {{Keys|M-;}}          : comments a region or adds comment to line
; {{Keys|M-(}}          : inserts a new lisp function (parenthesis)
; {{Keys|M-)}}          : checks balanced parenthesis and opens line
; {{Keys|C-x i}}        : inserts file contents at point position
; {{Keys|M-!}}          : run shell command
; {{Keys|C-u M-!}}      : run shell command and insert output
; {{Keys|M-❘}}          : run shell command on marked region
; {{Keys|C-u M-❘}}      : run shell command on and replace marked region
; insert-buffer        : inserts buffer contents at point position
; copy-to-buffer        : copy region content to a buffer
; kill-some-buffers    : interactively kill buffers
; electric-buffer-list  : interactive buffer list
; toggle-truncate-lines : do not split lines over visual lines
; visual-line-mode      : split lines by words
; viper-mode            : vi compatibility mode
== Setting Key Bindings ==
{{Details|Key Bindings}}
Emacs has a global keymap which maps between keys and commands. Each major mode can define, re-define or un-define its own key bindings, creating a local keymap (e.g., c-mode). Each minor mode can do so too (e.g., flymake). Each portion of text can also do so (e.g., tables).
=== Some prefix keys ===
; {{Keys|C-x}} : command prefix key
; {{Keys|M-}}  : command prefix key
; {{Keys|C-c}} : mode specific prefix key
; {{Keys|C-h}} : help prefix key
=== Commands to bind keys ===
; global-set-key ''k'' ''com'' : bind key ''k'' to ''com'' globally
; local-set-key ''k'' ''com''  : bind key ''k'' to ''com'' locally (major mode)
=== Notes ===
* Menu and mouse key bindings can also be set.
== Storing Key Bindings ==
In the Emacs ''init'' file, you can either set global key bindings or ''hook'' local key bindings to mode hooks (i.e., callbacks, slots).
; global-set-key      : adds a binding to the global map
; local-set-key      : adds a binding to the local (major mode) map
; kbd                : converts a string to a key sequence
=== Examples ===
==== Global key binding ====
<source lang="lisp">
(global-set-key (kbd 'C-c d') 'duplicate-line)
(global-set-key (kbd 'C-c d') (kbd 'C-a C-@ C-e M-w RET C-y'))
(global-set-key (kbd 'C-c d') '\C-a\C- \C-n\M-w\C-y')
==== Local key binding ====
<source lang="lisp">
(add-hook 'LaTeX-mode-hook (lambda () (local-set-key (kbd 'C-c n') 'forward-paragraph)))
== The Emacs Help System ==
Emacs has a handy help system for quick lookup of various features, topics, functions and key bindings.
; {{Keys|C-h ?}}      : show the help system shortcuts
; {{Keys|C-h ''key''}} : run help system with shortcut ''key''
=== Some useful help keys ===
; {{Keys|C-h a}}            : show apropos page about a keyword
; {{Keys|C-h k ''keybind''}} : show help for function bound to ''keybind''
; {{Keys|C-h b}}            : show all key bindings
; {{Keys|C-h f}}            : show documentation for function
; {{Keys|C-h m}}            : show documentation for current modes
; {{Keys|C-h v}}            : show documentation for variable
; {{Keys|C-h w}}            : show what keys a command is bound to
; {{Keys|C-h t}}            : start the emacs tutorial
; {{Keys|''prefix'' C-h}}    : show all key binds starting with ''prefix''
== Modes ==
Modes are used to define the type of data being edited in buffers, or what Emacs calls “the language”.
Every buffer has exactly one [[Major mode|major mode]] which defines its language (C, Java, English, IRC, etc...) and provides basic elements like syntax highlighting and (re)defines functions and their key bindings for relevant actions (e.g., comments).
Each buffer can have zero or more [[Minor mode|minor modes]] enabled which provide non-specific functionality such as spell checking or line wrapping (i.e., mode independent).
== Mode: ediff ==
ediff (emacs-diff) is a mode for Emacs where you can view and merge differences between two or three buffers.
; ediff        : select files to view their differences
; ediff-buffers : select buffers to view their differences
=== In ediff-mode ===
; | : switch between horizontal/vertical view
; ? : view ediff help
; p : view previous difference
; n : view next difference
; a : set buffer b’s area to what’s in a’s
; b : set buffer a’s area to what’s in b’s
; q : quit ediff session
== Mode: Spell Checking ==
{{Details|Spell check}}
; {{Keys|M-$}} : check spelling at word or active region
; ispell      : check active region or buffer, during which pressing '''i''' will accept the current word and insert it into the user's dictionary, pressing '''?''' will show help and pressing '''RET''' will end the current '''ispell''' session.
; {{Keys|ESC TAB}}    : complete current word from dictionary
; flyspell-mode      : enable “on the fly” spell checking
; flyspell-prog-mode  : spell check comments and strings (programming mode)
== References ==
* Emacs Wiki: http://emacswiki.org/
* Emacs Docs: https://www.gnu.org/software/emacs/manual/html_node/emacs/index.html
* Emacs Help

Revision as of 04:52, 22 June 2012

Yup. I had a \( in that comment to avoid meissng up the syntax highlighting. That worked OK but Org mode uses \( to indicate LaTeX code. I hunted around in the Org export code and figured out how to turn it off. I don't remember the details but I can look them up if you're interested.