In LATEX , curly braces ({}) and dollar signs ($$) should always appear in pairs; Emacs checks to make sure that each opening brace or dollar sign has a counterpart. When you type a closing brace or dollar sign, the cursor moves quickly to its counterpart (provided that it is on the screen; it shows the context in the minibuffer if it is not), then back again.
Emacs generates braces in matching pairs. The command C-c { inserts opening and closing braces and positions the cursor for typing between the braces.
Typing C-c } moves you past the right brace. It always finds the correct closing brace, given your current position. If there is no closing brace, you get an error message that says Scan error: Unbalanced parentheses. You also get this error message if you type C-c } while the cursor is in a section that is not surrounded by braces, which can be a little confusing.
To check for mismatched curly braces and dollar signs, type M-x tex-validate-buffer Enter. This command checks the entire buffer for unbalanced parentheses, curly braces, dollar signs, and the like. (If you have a large file, you might want to validate a region instead using M-x tex-validate-region Enter). If it finds any errors, Emacs displays an *Occur* buffer with Mismatches: at the top and a list of lines on which it found errors. You can then easily move to each line that contains an error with M-x goto-line.
Sometimes a mismatched parenthesis early in the buffer can start a chain reaction of "errors" through the rest of the file. If you suspect that one of the corrections you make may have fixed most of the remaining errors, simply run tex-validate-buffer again.
When you're stepping through errors, C-c } provides a good way to check where the closing brace for a given opening brace is. Position the cursor right after the opening brace and press C-c }.
8.5.2 Quotation Marks and Paragraphing
LaTeX mode also has features for handling quotation marks and paragraph separation. Typing a quotation mark (") causes Emacs to simulate left and right quotation marks. Left quotation marks are represented as two backtick characters (``) while right quotation marks are represented as two apostrophes (' '). (Left and right quotation marks are not part of the standard ASCII character set.) If you need to type a literal quotation mark for any reason, simply use the quote-character command preceding the quotation mark, like this: C-q ".
8.5.3 Command Pairs
LaTeX mode provides support for inserting command pairs. To insert a command pair, type C-c C-o (for latex-insert-block). Emacs prompts for the block name, and then for associated options. For example, type C-c C-o Enter document Enter Enter (the second Enter indicates no options). Emacs inserts the command pair and positions the cursor between them:
\begin{document}
_
\end{document}
You can use this command to mark up a text file after you write it. If you mark a region, you can type C-c C-o to wrap a command pair around that region.
A related command is C-c C-e (for latex-close-block). In this case, you type an opening command, press C-c C-e, and Emacs inserts the corresponding closing command.
These commands work with any keyword, regardless of what it is. Emacs can't check to make sure that it's a valid LATEX keyword or even that it's been defined. For example, if you type \begin{eating} C-c C-e, Emacs inserts \end{eating}. It's up to you to make sure you use valid keywords.
8.5.4 Processing and Printing Text
In addition to marking up files for LATEX , you can process files, see your errors (if any), and invoke a viewer, all without leaving Emacs. To process a file, just type C-c C-f (for tex-file).[54] Emacs saves the file before processing it. Messages that would appear on screen are channeled to a buffer called *tex-shell*, which Emacs displays on your screen. If the buffer isn't on the screen, typing C-c C-l (for tex-recenter-output-buffer) automatically displays it.
To demonstrate, let's try processing dickens.tex, a very basic file indeed.
Type: C-c C-f
Processing a LATEX file displays a special *tex-shell* buffer.
This command generates a .dvi file, which is an intermediate, device-independent file. You can view the resulting file by typing C-c C-v. On Linux, the default viewer is xdvi. Pressing C-c C-v displays the output in an xdvi window.
Type: C-c C-v
Output displayed by xdvi.
To print the .dvi file, give the command C-c C-p (for tex-print); this formats the .dvi file and sends it to your default printer. C-c C-q (tex-show-print-queue) displays the print queue so you know when to go to the printer to look for your processed output.
Two important variables tell Emacs how to print a TEX , file. You need to know about them if C-c C-p or C-c C-q doesn't work correctly; if these commands don't work, the configuration of TEX , on your system may be nonstandard, or the print and print queue commands are slightly different. The variable tex-dvi-print-command determines the command that is used to print a .dvi file; its default is lpr -d. For print queues, the command used to show the print queue is controlled by the tex-show-queue-command variable. By default, tex-show-queue-command is set to lpq.
Table 8-9 summarizes TeX and LaTeX mode commands.
Table 8-9. TeX and LaTeX mode commands
| Keystrokes | Command name | Action |
|---|---|---|
| (none) | tex-mode | Enter TeX or LaTeX mode according to file's contents. |
| (none) | plain-tex-mode | Enter TeX mode. |
| (none) | latex-mode | Enter LaTeX mode. |
| C-j | tex-terminate-paragraph | Insert two hard returns (standard end of paragraph) and check syntax of paragraph. |
| C-c { | tex-insert-braces | Insert two braces and put cursor between them. |
| C-c } | up-list | If you are between braces, position the cursor following the closing brace. |
| (none)TeX → Validate Buffer | tex-validate-buffer | Check buffer for syntax errors. |
| (none)TeX → Validate Region | tex-validate-region | Check the region for syntax errors. |
| C-c C-f TeX → TeX File | tex-file | Saves the current file, then processes it. |
| C-c C-b TeX → TeX Buffer | tex-buffer | Process buffer.[55] |
| C-c C-l TeX → TeX Recenter | tex-recenter-output-buffer | Put the message shell on the screen, showing (at least) the last error message. |
| C-c C-k TeX → TeX Kill | tex-kill-job | Kill processing. |
| C-c C-p TeX → TeX Print | tex-print | Print output. |
| C-c C-q TeX → Show Print Queue | tex-show-print-queue | Show print queue. |
| C-c C-e | latex-close-block | Provide closing element of a command pair. |
| (none) | tex-close-latex-block | Provide closing element of a command pair. |
| C-c Tab` TeX → BibTeX File | tex-bibtex-file | Process the current file using BibTeX, a system for creating bibliographies automatically. |
| C-c C-v TeX → TeX View | tex-view | View .dvi output. |
| (none)TeX → TeX Print (alt printer) | tex-alt-print | Print .dvi file using an alternative printer defined by the variable tex-alt-dvi-print-command. |
| C-c C-o | latex-insert-block | Insert a block (prompts for block name and options). |
| C-c C-u | tex-goto-last-unclosed-latex-block | Look backward in the file to find the nearest unclosed block and move the cursor there. |
| M-Enter | latex-insert-item | Insert \item. |
| (none) | latex-split-block | Insert an end to the current block and the beginning of a new one. |
| " | tex-insert-quote | Insert TeX-style quotation marks. |
54
If you don't have your TEX environment set up properly (and it isn't by default on Mac OS X, for example), this command hangs or crashes Emacs (pressing C-g may help; in one author's case it did and in another's it didn't). Try the
55
Using tex-buffer gives the resulting