Mercurial > emacs
annotate man/text.texi @ 46271:35153dd59211
*** empty log message ***
author | Juanma Barranquero <lekktu@gmail.com> |
---|---|
date | Tue, 09 Jul 2002 09:46:38 +0000 |
parents | 2e162cb1a7ac |
children | 2f9698c0ca31 |
rev | line source |
---|---|
25829 | 1 @c This is part of the Emacs manual. |
46247
2e162cb1a7ac
(TeX Mode): Remove explicit next/prev/up in @node line.
Miles Bader <miles@gnu.org>
parents:
46234
diff
changeset
|
2 @c Copyright (C) 1985,86,87,93,94,95,97,2000,2001, 2002 |
28328 | 3 @c Free Software Foundation, Inc. |
25829 | 4 @c See file emacs.texi for copying conditions. |
5 @node Text, Programs, Indentation, Top | |
6 @chapter Commands for Human Languages | |
7 @cindex text | |
8 @cindex manipulating text | |
9 | |
10 The term @dfn{text} has two widespread meanings in our area of the | |
11 computer field. One is data that is a sequence of characters. Any file | |
12 that you edit with Emacs is text, in this sense of the word. The other | |
13 meaning is more restrictive: a sequence of characters in a human language | |
14 for humans to read (possibly after processing by a text formatter), as | |
15 opposed to a program or commands for a program. | |
16 | |
17 Human languages have syntactic/stylistic conventions that can be | |
18 supported or used to advantage by editor commands: conventions involving | |
19 words, sentences, paragraphs, and capital letters. This chapter | |
20 describes Emacs commands for all of these things. There are also | |
21 commands for @dfn{filling}, which means rearranging the lines of a | |
22 paragraph to be approximately equal in length. The commands for moving | |
23 over and killing words, sentences and paragraphs, while intended | |
24 primarily for editing text, are also often useful for editing programs. | |
25 | |
26 Emacs has several major modes for editing human-language text. If the | |
27 file contains text pure and simple, use Text mode, which customizes | |
28 Emacs in small ways for the syntactic conventions of text. Outline mode | |
29 provides special commands for operating on text with an outline | |
30 structure. | |
31 @iftex | |
32 @xref{Outline Mode}. | |
33 @end iftex | |
34 | |
35 For text which contains embedded commands for text formatters, Emacs | |
36 has other major modes, each for a particular text formatter. Thus, for | |
37 input to @TeX{}, you would use @TeX{} | |
38 @iftex | |
39 mode (@pxref{TeX Mode}). | |
40 @end iftex | |
41 @ifinfo | |
42 mode. | |
43 @end ifinfo | |
44 For input to nroff, use Nroff mode. | |
45 | |
46 Instead of using a text formatter, you can edit formatted text in | |
47 WYSIWYG style (``what you see is what you get''), with Enriched mode. | |
48 Then the formatting appears on the screen in Emacs while you edit. | |
49 @iftex | |
50 @xref{Formatted Text}. | |
51 @end iftex | |
52 | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
53 The ``automatic typing'' features may be useful when writing text. |
38134
7e62c472338b
Minor Texinfo style change.
Richard M. Stallman <rms@gnu.org>
parents:
38093
diff
changeset
|
54 @xref{Top,, Autotyping, autotype, Features for Automatic Typing}. |
27207 | 55 |
25829 | 56 @menu |
57 * Words:: Moving over and killing words. | |
58 * Sentences:: Moving over and killing sentences. | |
59 * Paragraphs:: Moving over paragraphs. | |
60 * Pages:: Moving over pages. | |
61 * Filling:: Filling or justifying text. | |
62 * Case:: Changing the case of text. | |
63 * Text Mode:: The major modes for editing text files. | |
64 * Outline Mode:: Editing outlines. | |
65 * TeX Mode:: Editing input to the formatter TeX. | |
46234
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
66 * HTML Mode:: Editing HTML files. |
25829 | 67 * Nroff Mode:: Editing input to the formatter nroff. |
68 * Formatted Text:: Editing formatted text directly in WYSIWYG fashion. | |
69 @end menu | |
70 | |
71 @node Words | |
72 @section Words | |
73 @cindex words | |
74 @cindex Meta commands and words | |
75 | |
76 Emacs has commands for moving over or operating on words. By convention, | |
77 the keys for them are all Meta characters. | |
78 | |
79 @table @kbd | |
80 @item M-f | |
81 Move forward over a word (@code{forward-word}). | |
82 @item M-b | |
83 Move backward over a word (@code{backward-word}). | |
84 @item M-d | |
85 Kill up to the end of a word (@code{kill-word}). | |
86 @item M-@key{DEL} | |
87 Kill back to the beginning of a word (@code{backward-kill-word}). | |
88 @item M-@@ | |
89 Mark the end of the next word (@code{mark-word}). | |
90 @item M-t | |
91 Transpose two words or drag a word across other words | |
92 (@code{transpose-words}). | |
93 @end table | |
94 | |
95 Notice how these keys form a series that parallels the character-based | |
96 @kbd{C-f}, @kbd{C-b}, @kbd{C-d}, @key{DEL} and @kbd{C-t}. @kbd{M-@@} is | |
97 cognate to @kbd{C-@@}, which is an alias for @kbd{C-@key{SPC}}. | |
98 | |
99 @kindex M-f | |
100 @kindex M-b | |
101 @findex forward-word | |
102 @findex backward-word | |
103 The commands @kbd{M-f} (@code{forward-word}) and @kbd{M-b} | |
104 (@code{backward-word}) move forward and backward over words. These | |
105 Meta characters are thus analogous to the corresponding control | |
106 characters, @kbd{C-f} and @kbd{C-b}, which move over single characters | |
107 in the text. The analogy extends to numeric arguments, which serve as | |
108 repeat counts. @kbd{M-f} with a negative argument moves backward, and | |
109 @kbd{M-b} with a negative argument moves forward. Forward motion | |
110 stops right after the last letter of the word, while backward motion | |
111 stops right before the first letter.@refill | |
112 | |
113 @kindex M-d | |
114 @findex kill-word | |
115 @kbd{M-d} (@code{kill-word}) kills the word after point. To be | |
116 precise, it kills everything from point to the place @kbd{M-f} would | |
117 move to. Thus, if point is in the middle of a word, @kbd{M-d} kills | |
118 just the part after point. If some punctuation comes between point and the | |
119 next word, it is killed along with the word. (If you wish to kill only the | |
120 next word but not the punctuation before it, simply do @kbd{M-f} to get | |
121 the end, and kill the word backwards with @kbd{M-@key{DEL}}.) | |
122 @kbd{M-d} takes arguments just like @kbd{M-f}. | |
123 | |
124 @findex backward-kill-word | |
125 @kindex M-DEL | |
126 @kbd{M-@key{DEL}} (@code{backward-kill-word}) kills the word before | |
127 point. It kills everything from point back to where @kbd{M-b} would | |
128 move to. If point is after the space in @w{@samp{FOO, BAR}}, then | |
129 @w{@samp{FOO, }} is killed. (If you wish to kill just @samp{FOO}, and | |
130 not the comma and the space, use @kbd{M-b M-d} instead of | |
131 @kbd{M-@key{DEL}}.) | |
132 | |
36263
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36247
diff
changeset
|
133 @c Don't index M-t and transpose-words here, they are indexed in |
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36247
diff
changeset
|
134 @c fixit.texi, in the node "Transpose". |
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36247
diff
changeset
|
135 @c @kindex M-t |
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36247
diff
changeset
|
136 @c @findex transpose-words |
25829 | 137 @kbd{M-t} (@code{transpose-words}) exchanges the word before or |
138 containing point with the following word. The delimiter characters between | |
139 the words do not move. For example, @w{@samp{FOO, BAR}} transposes into | |
140 @w{@samp{BAR, FOO}} rather than @samp{@w{BAR FOO,}}. @xref{Transpose}, for | |
141 more on transposition and on arguments to transposition commands. | |
142 | |
143 @kindex M-@@ | |
144 @findex mark-word | |
145 To operate on the next @var{n} words with an operation which applies | |
146 between point and mark, you can either set the mark at point and then move | |
147 over the words, or you can use the command @kbd{M-@@} (@code{mark-word}) | |
148 which does not move point, but sets the mark where @kbd{M-f} would move | |
149 to. @kbd{M-@@} accepts a numeric argument that says how many words to | |
150 scan for the place to put the mark. In Transient Mark mode, this command | |
151 activates the mark. | |
152 | |
153 The word commands' understanding of syntax is completely controlled by | |
154 the syntax table. Any character can, for example, be declared to be a word | |
155 delimiter. @xref{Syntax}. | |
156 | |
157 @node Sentences | |
158 @section Sentences | |
159 @cindex sentences | |
160 @cindex manipulating sentences | |
161 | |
162 The Emacs commands for manipulating sentences and paragraphs are mostly | |
163 on Meta keys, so as to be like the word-handling commands. | |
164 | |
165 @table @kbd | |
166 @item M-a | |
167 Move back to the beginning of the sentence (@code{backward-sentence}). | |
168 @item M-e | |
169 Move forward to the end of the sentence (@code{forward-sentence}). | |
170 @item M-k | |
171 Kill forward to the end of the sentence (@code{kill-sentence}). | |
172 @item C-x @key{DEL} | |
173 Kill back to the beginning of the sentence (@code{backward-kill-sentence}). | |
174 @end table | |
175 | |
176 @kindex M-a | |
177 @kindex M-e | |
178 @findex backward-sentence | |
179 @findex forward-sentence | |
180 The commands @kbd{M-a} and @kbd{M-e} (@code{backward-sentence} and | |
181 @code{forward-sentence}) move to the beginning and end of the current | |
182 sentence, respectively. They were chosen to resemble @kbd{C-a} and | |
183 @kbd{C-e}, which move to the beginning and end of a line. Unlike them, | |
184 @kbd{M-a} and @kbd{M-e} if repeated or given numeric arguments move over | |
185 successive sentences. | |
186 | |
187 Moving backward over a sentence places point just before the first | |
188 character of the sentence; moving forward places point right after the | |
189 punctuation that ends the sentence. Neither one moves over the | |
190 whitespace at the sentence boundary. | |
191 | |
192 @kindex M-k | |
193 @kindex C-x DEL | |
194 @findex kill-sentence | |
195 @findex backward-kill-sentence | |
196 Just as @kbd{C-a} and @kbd{C-e} have a kill command, @kbd{C-k}, to go | |
197 with them, so @kbd{M-a} and @kbd{M-e} have a corresponding kill command | |
198 @kbd{M-k} (@code{kill-sentence}) which kills from point to the end of | |
199 the sentence. With minus one as an argument it kills back to the | |
200 beginning of the sentence. Larger arguments serve as a repeat count. | |
201 There is also a command, @kbd{C-x @key{DEL}} | |
202 (@code{backward-kill-sentence}), for killing back to the beginning of a | |
203 sentence. This command is useful when you change your mind in the | |
204 middle of composing text.@refill | |
205 | |
206 The sentence commands assume that you follow the American typist's | |
207 convention of putting two spaces at the end of a sentence; they consider | |
208 a sentence to end wherever there is a @samp{.}, @samp{?} or @samp{!} | |
209 followed by the end of a line or two spaces, with any number of | |
210 @samp{)}, @samp{]}, @samp{'}, or @samp{"} characters allowed in between. | |
211 A sentence also begins or ends wherever a paragraph begins or ends. | |
212 | |
213 @vindex sentence-end | |
214 The variable @code{sentence-end} controls recognition of the end of a | |
215 sentence. It is a regexp that matches the last few characters of a | |
216 sentence, together with the whitespace following the sentence. Its | |
217 normal value is | |
218 | |
219 @example | |
37125
fe3c5a341a4d
Correct sentence-end regexp example.
Richard M. Stallman <rms@gnu.org>
parents:
36790
diff
changeset
|
220 "[.?!][]\"')]*\\($\\| $\\|\t\\| \\)[ \t\n]*" |
25829 | 221 @end example |
222 | |
223 @noindent | |
224 This example is explained in the section on regexps. @xref{Regexps}. | |
225 | |
226 If you want to use just one space between sentences, you should | |
227 set @code{sentence-end} to this value: | |
228 | |
229 @example | |
230 "[.?!][]\"')]*\\($\\|\t\\| \\)[ \t\n]*" | |
231 @end example | |
232 | |
233 @noindent | |
234 You should also set the variable @code{sentence-end-double-space} to | |
235 @code{nil} so that the fill commands expect and leave just one space at | |
236 the end of a sentence. Note that this makes it impossible to | |
237 distinguish between periods that end sentences and those that indicate | |
238 abbreviations. | |
239 | |
240 @node Paragraphs | |
241 @section Paragraphs | |
242 @cindex paragraphs | |
243 @cindex manipulating paragraphs | |
244 @kindex M-@{ | |
245 @kindex M-@} | |
246 @findex backward-paragraph | |
247 @findex forward-paragraph | |
248 | |
249 The Emacs commands for manipulating paragraphs are also Meta keys. | |
250 | |
251 @table @kbd | |
252 @item M-@{ | |
253 Move back to previous paragraph beginning (@code{backward-paragraph}). | |
254 @item M-@} | |
255 Move forward to next paragraph end (@code{forward-paragraph}). | |
256 @item M-h | |
257 Put point and mark around this or next paragraph (@code{mark-paragraph}). | |
258 @end table | |
259 | |
260 @kbd{M-@{} moves to the beginning of the current or previous | |
261 paragraph, while @kbd{M-@}} moves to the end of the current or next | |
262 paragraph. Blank lines and text-formatter command lines separate | |
263 paragraphs and are not considered part of any paragraph. In Fundamental | |
264 mode, but not in Text mode, an indented line also starts a new | |
265 paragraph. (If a paragraph is preceded by a blank line, these commands | |
266 treat that blank line as the beginning of the paragraph.) | |
267 | |
268 In major modes for programs, paragraphs begin and end only at blank | |
269 lines. This makes the paragraph commands continue to be useful even | |
270 though there are no paragraphs per se. | |
271 | |
272 When there is a fill prefix, then paragraphs are delimited by all lines | |
273 which don't start with the fill prefix. @xref{Filling}. | |
274 | |
275 @kindex M-h | |
276 @findex mark-paragraph | |
277 When you wish to operate on a paragraph, you can use the command | |
278 @kbd{M-h} (@code{mark-paragraph}) to set the region around it. Thus, | |
279 for example, @kbd{M-h C-w} kills the paragraph around or after point. | |
280 The @kbd{M-h} command puts point at the beginning and mark at the end of | |
281 the paragraph point was in. In Transient Mark mode, it activates the | |
282 mark. If point is between paragraphs (in a run of blank lines, or at a | |
283 boundary), the paragraph following point is surrounded by point and | |
284 mark. If there are blank lines preceding the first line of the | |
285 paragraph, one of these blank lines is included in the region. | |
286 | |
287 @vindex paragraph-start | |
288 @vindex paragraph-separate | |
289 The precise definition of a paragraph boundary is controlled by the | |
290 variables @code{paragraph-separate} and @code{paragraph-start}. The | |
291 value of @code{paragraph-start} is a regexp that should match any line | |
292 that either starts or separates paragraphs. The value of | |
293 @code{paragraph-separate} is another regexp that should match only lines | |
294 that separate paragraphs without being part of any paragraph (for | |
295 example, blank lines). Lines that start a new paragraph and are | |
296 contained in it must match only @code{paragraph-start}, not | |
297 @code{paragraph-separate}. For example, in Fundamental mode, | |
38229
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
298 @code{paragraph-start} is @w{@code{"[ \t\n\f]"}}, and |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
299 @code{paragraph-separate} is @w{@code{"[ \t\f]*$"}}. |
25829 | 300 |
301 Normally it is desirable for page boundaries to separate paragraphs. | |
302 The default values of these variables recognize the usual separator for | |
303 pages. | |
304 | |
305 @node Pages | |
306 @section Pages | |
307 | |
308 @cindex pages | |
309 @cindex formfeed | |
310 Files are often thought of as divided into @dfn{pages} by the | |
311 @dfn{formfeed} character (ASCII control-L, octal code 014). When you | |
312 print hardcopy for a file, this character forces a page break; thus, | |
313 each page of the file goes on a separate page on paper. Most Emacs | |
314 commands treat the page-separator character just like any other | |
315 character: you can insert it with @kbd{C-q C-l}, and delete it with | |
316 @key{DEL}. Thus, you are free to paginate your file or not. However, | |
317 since pages are often meaningful divisions of the file, Emacs provides | |
318 commands to move over them and operate on them. | |
319 | |
320 @table @kbd | |
321 @item C-x [ | |
322 Move point to previous page boundary (@code{backward-page}). | |
323 @item C-x ] | |
324 Move point to next page boundary (@code{forward-page}). | |
325 @item C-x C-p | |
326 Put point and mark around this page (or another page) (@code{mark-page}). | |
327 @item C-x l | |
328 Count the lines in this page (@code{count-lines-page}). | |
329 @end table | |
330 | |
331 @kindex C-x [ | |
332 @kindex C-x ] | |
333 @findex forward-page | |
334 @findex backward-page | |
335 The @kbd{C-x [} (@code{backward-page}) command moves point to immediately | |
336 after the previous page delimiter. If point is already right after a page | |
337 delimiter, it skips that one and stops at the previous one. A numeric | |
338 argument serves as a repeat count. The @kbd{C-x ]} (@code{forward-page}) | |
339 command moves forward past the next page delimiter. | |
340 | |
341 @kindex C-x C-p | |
342 @findex mark-page | |
343 The @kbd{C-x C-p} command (@code{mark-page}) puts point at the | |
344 beginning of the current page and the mark at the end. The page | |
345 delimiter at the end is included (the mark follows it). The page | |
38229
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
346 delimiter at the front is excluded (point follows it). In Transient |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
347 Mark mode, this command activates the mark. |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
348 |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
349 @kbd{C-x C-p C-w} is a handy way to kill a page to move it |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
350 elsewhere. If you move to another page delimiter with @kbd{C-x [} and |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
351 @kbd{C-x ]}, then yank the killed page, all the pages will be properly |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
352 delimited once again. The reason @kbd{C-x C-p} includes only the |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
353 following page delimiter in the region is to ensure that. |
25829 | 354 |
355 A numeric argument to @kbd{C-x C-p} is used to specify which page to go | |
356 to, relative to the current one. Zero means the current page. One means | |
357 the next page, and @minus{}1 means the previous one. | |
358 | |
359 @kindex C-x l | |
360 @findex count-lines-page | |
361 The @kbd{C-x l} command (@code{count-lines-page}) is good for deciding | |
38870
d44abb4e68b2
Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents:
38478
diff
changeset
|
362 where to break a page in two. It displays in the echo area the total number |
25829 | 363 of lines in the current page, and then divides it up into those preceding |
364 the current line and those following, as in | |
365 | |
366 @example | |
367 Page has 96 (72+25) lines | |
368 @end example | |
369 | |
370 @noindent | |
371 Notice that the sum is off by one; this is correct if point is not at the | |
372 beginning of a line. | |
373 | |
374 @vindex page-delimiter | |
375 The variable @code{page-delimiter} controls where pages begin. Its | |
376 value is a regexp that matches the beginning of a line that separates | |
38229
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
377 pages. The normal value of this variable is @code{"^\f"}, which |
25829 | 378 matches a formfeed character at the beginning of a line. |
379 | |
380 @node Filling | |
381 @section Filling Text | |
382 @cindex filling text | |
383 | |
384 @dfn{Filling} text means breaking it up into lines that fit a | |
385 specified width. Emacs does filling in two ways. In Auto Fill mode, | |
386 inserting text with self-inserting characters also automatically fills | |
387 it. There are also explicit fill commands that you can use when editing | |
388 text leaves it unfilled. When you edit formatted text, you can specify | |
389 a style of filling for each portion of the text (@pxref{Formatted | |
390 Text}). | |
391 | |
392 @menu | |
393 * Auto Fill:: Auto Fill mode breaks long lines automatically. | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
394 * Refill:: Keeping paragraphs filled. |
25829 | 395 * Fill Commands:: Commands to refill paragraphs and center lines. |
396 * Fill Prefix:: Filling paragraphs that are indented | |
397 or in a comment, etc. | |
398 * Adaptive Fill:: How Emacs can determine the fill prefix automatically. | |
399 @end menu | |
400 | |
401 @node Auto Fill | |
402 @subsection Auto Fill Mode | |
403 @cindex Auto Fill mode | |
404 @cindex mode, Auto Fill | |
405 @cindex word wrap | |
406 | |
407 @dfn{Auto Fill} mode is a minor mode in which lines are broken | |
408 automatically when they become too wide. Breaking happens only when | |
409 you type a @key{SPC} or @key{RET}. | |
410 | |
411 @table @kbd | |
412 @item M-x auto-fill-mode | |
413 Enable or disable Auto Fill mode. | |
414 @item @key{SPC} | |
415 @itemx @key{RET} | |
416 In Auto Fill mode, break lines when appropriate. | |
417 @end table | |
418 | |
419 @findex auto-fill-mode | |
420 @kbd{M-x auto-fill-mode} turns Auto Fill mode on if it was off, or off | |
421 if it was on. With a positive numeric argument it always turns Auto | |
422 Fill mode on, and with a negative argument always turns it off. You can | |
423 see when Auto Fill mode is in effect by the presence of the word | |
424 @samp{Fill} in the mode line, inside the parentheses. Auto Fill mode is | |
425 a minor mode which is enabled or disabled for each buffer individually. | |
426 @xref{Minor Modes}. | |
427 | |
428 In Auto Fill mode, lines are broken automatically at spaces when they | |
429 get longer than the desired width. Line breaking and rearrangement | |
430 takes place only when you type @key{SPC} or @key{RET}. If you wish to | |
431 insert a space or newline without permitting line-breaking, type | |
432 @kbd{C-q @key{SPC}} or @kbd{C-q C-j} (recall that a newline is really a | |
433 control-J). Also, @kbd{C-o} inserts a newline without line breaking. | |
434 | |
435 Auto Fill mode works well with programming-language modes, because it | |
436 indents new lines with @key{TAB}. If a line ending in a comment gets | |
437 too long, the text of the comment is split into two comment lines. | |
438 Optionally, new comment delimiters are inserted at the end of the first | |
439 line and the beginning of the second so that each line is a separate | |
440 comment; the variable @code{comment-multi-line} controls the choice | |
441 (@pxref{Comments}). | |
442 | |
38478
a5cae8675fe9
(Auto Fill): Fix a reference to Adaptive Fill. From Bill Richter.
Eli Zaretskii <eliz@gnu.org>
parents:
38229
diff
changeset
|
443 Adaptive filling (@pxref{Adaptive Fill}) works for Auto Filling as |
25829 | 444 well as for explicit fill commands. It takes a fill prefix |
445 automatically from the second or first line of a paragraph. | |
446 | |
447 Auto Fill mode does not refill entire paragraphs; it can break lines but | |
448 cannot merge lines. So editing in the middle of a paragraph can result in | |
449 a paragraph that is not correctly filled. The easiest way to make the | |
450 paragraph properly filled again is usually with the explicit fill commands. | |
451 @ifinfo | |
452 @xref{Fill Commands}. | |
453 @end ifinfo | |
454 | |
455 Many users like Auto Fill mode and want to use it in all text files. | |
456 The section on init files says how to arrange this permanently for yourself. | |
457 @xref{Init File}. | |
458 | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
459 @node Refill |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
460 @subsection Refill Mode |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
461 @cindex refilling text, word processor style |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
462 @cindex modes, Refill |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
463 @cindex Refill minor mode |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
464 |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
465 Refill minor mode provides support for keeping paragraphs filled as |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
466 you type or modify them in other ways. It provides an effect similar |
38017
32f10000ac35
Don't use the British spelling of "behaviour".
Eli Zaretskii <eliz@gnu.org>
parents:
37125
diff
changeset
|
467 to typical word processor behavior. This works by running a |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
468 paragraph-filling command at suitable times. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
469 |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
470 When you are typing text, only characters which normally trigger |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
471 auto filling, like the space character, will trigger refilling. This |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
472 is to avoid making it too slow. Apart from self-inserting characters, |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
473 other commands which modify the text cause refilling. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
474 |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
475 The current implementation is preliminary and probably not robust. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
476 We expect to improve on it. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
477 |
36299 | 478 To toggle the use of Refill mode in the current buffer, type |
36298
f4316132b389
(Refill): Say how to toggle Refill mode.
Gerd Moellmann <gerd@gnu.org>
parents:
36263
diff
changeset
|
479 @kbd{M-x refill-mode}. |
f4316132b389
(Refill): Say how to toggle Refill mode.
Gerd Moellmann <gerd@gnu.org>
parents:
36263
diff
changeset
|
480 |
25829 | 481 @node Fill Commands |
482 @subsection Explicit Fill Commands | |
483 | |
484 @table @kbd | |
485 @item M-q | |
486 Fill current paragraph (@code{fill-paragraph}). | |
487 @item C-x f | |
488 Set the fill column (@code{set-fill-column}). | |
489 @item M-x fill-region | |
490 Fill each paragraph in the region (@code{fill-region}). | |
491 @item M-x fill-region-as-paragraph | |
492 Fill the region, considering it as one paragraph. | |
493 @item M-s | |
494 Center a line. | |
495 @end table | |
496 | |
497 @kindex M-q | |
498 @findex fill-paragraph | |
499 To refill a paragraph, use the command @kbd{M-q} | |
500 (@code{fill-paragraph}). This operates on the paragraph that point is | |
501 inside, or the one after point if point is between paragraphs. | |
502 Refilling works by removing all the line-breaks, then inserting new ones | |
503 where necessary. | |
504 | |
505 @findex fill-region | |
506 To refill many paragraphs, use @kbd{M-x fill-region}, which | |
507 divides the region into paragraphs and fills each of them. | |
508 | |
509 @findex fill-region-as-paragraph | |
510 @kbd{M-q} and @code{fill-region} use the same criteria as @kbd{M-h} | |
511 for finding paragraph boundaries (@pxref{Paragraphs}). For more | |
512 control, you can use @kbd{M-x fill-region-as-paragraph}, which refills | |
513 everything between point and mark. This command deletes any blank lines | |
514 within the region, so separate blocks of text end up combined into one | |
515 block.@refill | |
516 | |
517 @cindex justification | |
518 A numeric argument to @kbd{M-q} causes it to @dfn{justify} the text as | |
519 well as filling it. This means that extra spaces are inserted to make | |
520 the right margin line up exactly at the fill column. To remove the | |
521 extra spaces, use @kbd{M-q} with no argument. (Likewise for | |
522 @code{fill-region}.) Another way to control justification, and choose | |
523 other styles of filling, is with the @code{justification} text property; | |
524 see @ref{Format Justification}. | |
525 | |
526 @kindex M-s @r{(Text mode)} | |
527 @cindex centering | |
528 @findex center-line | |
529 The command @kbd{M-s} (@code{center-line}) centers the current line | |
530 within the current fill column. With an argument @var{n}, it centers | |
531 @var{n} lines individually and moves past them. | |
532 | |
533 @vindex fill-column | |
534 @kindex C-x f | |
535 @findex set-fill-column | |
536 The maximum line width for filling is in the variable | |
537 @code{fill-column}. Altering the value of @code{fill-column} makes it | |
538 local to the current buffer; until that time, the default value is in | |
539 effect. The default is initially 70. @xref{Locals}. The easiest way | |
540 to set @code{fill-column} is to use the command @kbd{C-x f} | |
541 (@code{set-fill-column}). With a numeric argument, it uses that as the | |
542 new fill column. With just @kbd{C-u} as argument, it sets | |
543 @code{fill-column} to the current horizontal position of point. | |
544 | |
545 Emacs commands normally consider a period followed by two spaces or by | |
546 a newline as the end of a sentence; a period followed by just one space | |
547 indicates an abbreviation and not the end of a sentence. To preserve | |
548 the distinction between these two ways of using a period, the fill | |
549 commands do not break a line after a period followed by just one space. | |
550 | |
551 @vindex sentence-end-double-space | |
552 If the variable @code{sentence-end-double-space} is @code{nil}, the | |
553 fill commands expect and leave just one space at the end of a sentence. | |
554 Ordinarily this variable is @code{t}, so the fill commands insist on | |
555 two spaces for the end of a sentence, as explained above. @xref{Sentences}. | |
556 | |
557 @vindex colon-double-space | |
558 If the variable @code{colon-double-space} is non-@code{nil}, the | |
559 fill commands put two spaces after a colon. | |
560 | |
31950 | 561 @vindex sentence-end-without-period |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
562 Some languages do not use period to indicate end of sentence. For |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
563 example, a sentence in Thai text ends with double space but without a |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
564 period. Set the variable @code{sentence-end-without-period} to |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
565 @code{t} to tell the sentence commands that a period is not necessary. |
31950 | 566 |
46234
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
567 @vindex fill-nobreak-predicate |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
568 The variable @code{fill-nobreak-predicate} specifies additional |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
569 conditions for where line-breaking is allowed. Its value is either |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
570 @code{nil} or a Lisp function; the function is called with no |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
571 arguments, and if it returns a non-@code{nil} value, then point is not |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
572 a good place to break the line. The standard functions you can use |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
573 @code{fill-single-word-nobreak-p} (don't break after the first word of |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
574 a sentence or before the last) and @code{fill-french-nobreak-p} (don't |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
575 break after @samp{(} or before @samp{)}, @samp{:} or @samp{?}). |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
576 |
25829 | 577 @node Fill Prefix |
578 @subsection The Fill Prefix | |
579 | |
580 @cindex fill prefix | |
581 To fill a paragraph in which each line starts with a special marker | |
582 (which might be a few spaces, giving an indented paragraph), you can use | |
583 the @dfn{fill prefix} feature. The fill prefix is a string that Emacs | |
584 expects every line to start with, and which is not included in filling. | |
585 You can specify a fill prefix explicitly; Emacs can also deduce the | |
586 fill prefix automatically (@pxref{Adaptive Fill}). | |
587 | |
588 @table @kbd | |
589 @item C-x . | |
590 Set the fill prefix (@code{set-fill-prefix}). | |
591 @item M-q | |
592 Fill a paragraph using current fill prefix (@code{fill-paragraph}). | |
593 @item M-x fill-individual-paragraphs | |
594 Fill the region, considering each change of indentation as starting a | |
595 new paragraph. | |
596 @item M-x fill-nonuniform-paragraphs | |
597 Fill the region, considering only paragraph-separator lines as starting | |
598 a new paragraph. | |
599 @end table | |
600 | |
601 @kindex C-x . | |
602 @findex set-fill-prefix | |
603 To specify a fill prefix, move to a line that starts with the desired | |
604 prefix, put point at the end of the prefix, and give the command | |
605 @w{@kbd{C-x .}}@: (@code{set-fill-prefix}). That's a period after the | |
606 @kbd{C-x}. To turn off the fill prefix, specify an empty prefix: type | |
607 @w{@kbd{C-x .}}@: with point at the beginning of a line.@refill | |
608 | |
609 When a fill prefix is in effect, the fill commands remove the fill | |
610 prefix from each line before filling and insert it on each line after | |
611 filling. Auto Fill mode also inserts the fill prefix automatically when | |
612 it makes a new line. The @kbd{C-o} command inserts the fill prefix on | |
613 new lines it creates, when you use it at the beginning of a line | |
614 (@pxref{Blank Lines}). Conversely, the command @kbd{M-^} deletes the | |
615 prefix (if it occurs) after the newline that it deletes | |
616 (@pxref{Indentation}). | |
617 | |
618 For example, if @code{fill-column} is 40 and you set the fill prefix | |
619 to @samp{;; }, then @kbd{M-q} in the following text | |
620 | |
621 @example | |
622 ;; This is an | |
623 ;; example of a paragraph | |
624 ;; inside a Lisp-style comment. | |
625 @end example | |
626 | |
627 @noindent | |
628 produces this: | |
629 | |
630 @example | |
631 ;; This is an example of a paragraph | |
632 ;; inside a Lisp-style comment. | |
633 @end example | |
634 | |
635 Lines that do not start with the fill prefix are considered to start | |
636 paragraphs, both in @kbd{M-q} and the paragraph commands; this gives | |
637 good results for paragraphs with hanging indentation (every line | |
638 indented except the first one). Lines which are blank or indented once | |
639 the prefix is removed also separate or start paragraphs; this is what | |
640 you want if you are writing multi-paragraph comments with a comment | |
641 delimiter on each line. | |
642 | |
643 @findex fill-individual-paragraphs | |
644 You can use @kbd{M-x fill-individual-paragraphs} to set the fill | |
645 prefix for each paragraph automatically. This command divides the | |
646 region into paragraphs, treating every change in the amount of | |
647 indentation as the start of a new paragraph, and fills each of these | |
648 paragraphs. Thus, all the lines in one ``paragraph'' have the same | |
649 amount of indentation. That indentation serves as the fill prefix for | |
650 that paragraph. | |
651 | |
652 @findex fill-nonuniform-paragraphs | |
653 @kbd{M-x fill-nonuniform-paragraphs} is a similar command that divides | |
654 the region into paragraphs in a different way. It considers only | |
655 paragraph-separating lines (as defined by @code{paragraph-separate}) as | |
656 starting a new paragraph. Since this means that the lines of one | |
657 paragraph may have different amounts of indentation, the fill prefix | |
658 used is the smallest amount of indentation of any of the lines of the | |
659 paragraph. This gives good results with styles that indent a paragraph's | |
660 first line more or less that the rest of the paragraph. | |
661 | |
662 @vindex fill-prefix | |
663 The fill prefix is stored in the variable @code{fill-prefix}. Its value | |
664 is a string, or @code{nil} when there is no fill prefix. This is a | |
665 per-buffer variable; altering the variable affects only the current buffer, | |
666 but there is a default value which you can change as well. @xref{Locals}. | |
667 | |
668 The @code{indentation} text property provides another way to control | |
669 the amount of indentation paragraphs receive. @xref{Format Indentation}. | |
670 | |
671 @node Adaptive Fill | |
672 @subsection Adaptive Filling | |
673 | |
674 @cindex adaptive filling | |
675 The fill commands can deduce the proper fill prefix for a paragraph | |
676 automatically in certain cases: either whitespace or certain punctuation | |
677 characters at the beginning of a line are propagated to all lines of the | |
678 paragraph. | |
679 | |
680 If the paragraph has two or more lines, the fill prefix is taken from | |
681 the paragraph's second line, but only if it appears on the first line as | |
682 well. | |
683 | |
684 If a paragraph has just one line, fill commands @emph{may} take a | |
685 prefix from that line. The decision is complicated because there are | |
686 three reasonable things to do in such a case: | |
687 | |
688 @itemize @bullet | |
689 @item | |
690 Use the first line's prefix on all the lines of the paragraph. | |
691 | |
692 @item | |
693 Indent subsequent lines with whitespace, so that they line up under the | |
694 text that follows the prefix on the first line, but don't actually copy | |
695 the prefix from the first line. | |
696 | |
697 @item | |
698 Don't do anything special with the second and following lines. | |
699 @end itemize | |
700 | |
701 All three of these styles of formatting are commonly used. So the | |
702 fill commands try to determine what you would like, based on the prefix | |
703 that appears and on the major mode. Here is how. | |
704 | |
705 @vindex adaptive-fill-first-line-regexp | |
706 If the prefix found on the first line matches | |
707 @code{adaptive-fill-first-line-regexp}, or if it appears to be a | |
708 comment-starting sequence (this depends on the major mode), then the | |
709 prefix found is used for filling the paragraph, provided it would not | |
710 act as a paragraph starter on subsequent lines. | |
711 | |
712 Otherwise, the prefix found is converted to an equivalent number of | |
713 spaces, and those spaces are used as the fill prefix for the rest of the | |
714 lines, provided they would not act as a paragraph starter on subsequent | |
715 lines. | |
716 | |
717 In Text mode, and other modes where only blank lines and page | |
718 delimiters separate paragraphs, the prefix chosen by adaptive filling | |
719 never acts as a paragraph starter, so it can always be used for filling. | |
720 | |
721 @vindex adaptive-fill-mode | |
722 @vindex adaptive-fill-regexp | |
723 The variable @code{adaptive-fill-regexp} determines what kinds of line | |
724 beginnings can serve as a fill prefix: any characters at the start of | |
725 the line that match this regular expression are used. If you set the | |
726 variable @code{adaptive-fill-mode} to @code{nil}, the fill prefix is | |
727 never chosen automatically. | |
728 | |
729 @vindex adaptive-fill-function | |
730 You can specify more complex ways of choosing a fill prefix | |
731 automatically by setting the variable @code{adaptive-fill-function} to a | |
732 function. This function is called with point after the left margin of a | |
733 line, and it should return the appropriate fill prefix based on that | |
734 line. If it returns @code{nil}, that means it sees no fill prefix in | |
735 that line. | |
736 | |
737 @node Case | |
738 @section Case Conversion Commands | |
739 @cindex case conversion | |
740 | |
741 Emacs has commands for converting either a single word or any arbitrary | |
742 range of text to upper case or to lower case. | |
743 | |
744 @table @kbd | |
745 @item M-l | |
746 Convert following word to lower case (@code{downcase-word}). | |
747 @item M-u | |
748 Convert following word to upper case (@code{upcase-word}). | |
749 @item M-c | |
750 Capitalize the following word (@code{capitalize-word}). | |
751 @item C-x C-l | |
752 Convert region to lower case (@code{downcase-region}). | |
753 @item C-x C-u | |
754 Convert region to upper case (@code{upcase-region}). | |
755 @end table | |
756 | |
757 @kindex M-l | |
758 @kindex M-u | |
759 @kindex M-c | |
760 @cindex words, case conversion | |
761 @cindex converting text to upper or lower case | |
762 @cindex capitalizing words | |
763 @findex downcase-word | |
764 @findex upcase-word | |
765 @findex capitalize-word | |
766 The word conversion commands are the most useful. @kbd{M-l} | |
767 (@code{downcase-word}) converts the word after point to lower case, moving | |
768 past it. Thus, repeating @kbd{M-l} converts successive words. | |
769 @kbd{M-u} (@code{upcase-word}) converts to all capitals instead, while | |
770 @kbd{M-c} (@code{capitalize-word}) puts the first letter of the word | |
771 into upper case and the rest into lower case. All these commands convert | |
772 several words at once if given an argument. They are especially convenient | |
773 for converting a large amount of text from all upper case to mixed case, | |
774 because you can move through the text using @kbd{M-l}, @kbd{M-u} or | |
775 @kbd{M-c} on each word as appropriate, occasionally using @kbd{M-f} instead | |
776 to skip a word. | |
777 | |
778 When given a negative argument, the word case conversion commands apply | |
779 to the appropriate number of words before point, but do not move point. | |
780 This is convenient when you have just typed a word in the wrong case: you | |
781 can give the case conversion command and continue typing. | |
782 | |
783 If a word case conversion command is given in the middle of a word, it | |
784 applies only to the part of the word which follows point. This is just | |
785 like what @kbd{M-d} (@code{kill-word}) does. With a negative argument, | |
786 case conversion applies only to the part of the word before point. | |
787 | |
788 @kindex C-x C-l | |
789 @kindex C-x C-u | |
790 @findex downcase-region | |
791 @findex upcase-region | |
792 The other case conversion commands are @kbd{C-x C-u} | |
793 (@code{upcase-region}) and @kbd{C-x C-l} (@code{downcase-region}), which | |
794 convert everything between point and mark to the specified case. Point and | |
795 mark do not move. | |
796 | |
797 The region case conversion commands @code{upcase-region} and | |
798 @code{downcase-region} are normally disabled. This means that they ask | |
799 for confirmation if you try to use them. When you confirm, you may | |
800 enable the command, which means it will not ask for confirmation again. | |
801 @xref{Disabling}. | |
802 | |
803 @node Text Mode | |
804 @section Text Mode | |
805 @cindex Text mode | |
806 @cindex mode, Text | |
807 @findex text-mode | |
808 | |
809 When you edit files of text in a human language, it's more convenient | |
810 to use Text mode rather than Fundamental mode. To enter Text mode, type | |
811 @kbd{M-x text-mode}. | |
812 | |
813 In Text mode, only blank lines and page delimiters separate | |
814 paragraphs. As a result, paragraphs can be indented, and adaptive | |
815 filling determines what indentation to use when filling a paragraph. | |
816 @xref{Adaptive Fill}. | |
817 | |
818 @kindex TAB @r{(Text mode)} | |
819 Text mode defines @key{TAB} to run @code{indent-relative} | |
820 (@pxref{Indentation}), so that you can conveniently indent a line like | |
821 the previous line. When the previous line is not indented, | |
822 @code{indent-relative} runs @code{tab-to-tab-stop}, which uses Emacs tab | |
823 stops that you can set (@pxref{Tab Stops}). | |
824 | |
825 Text mode turns off the features concerned with comments except when | |
826 you explicitly invoke them. It changes the syntax table so that periods | |
827 are not considered part of a word, while apostrophes, backspaces and | |
828 underlines are considered part of words. | |
829 | |
830 @cindex Paragraph-Indent Text mode | |
831 @cindex mode, Paragraph-Indent Text | |
832 @findex paragraph-indent-text-mode | |
27207 | 833 @findex paragraph-indent-minor-mode |
25829 | 834 If you indent the first lines of paragraphs, then you should use |
835 Paragraph-Indent Text mode rather than Text mode. In this mode, you do | |
836 not need to have blank lines between paragraphs, because the first-line | |
837 indentation is sufficient to start a paragraph; however paragraphs in | |
838 which every line is indented are not supported. Use @kbd{M-x | |
27207 | 839 paragraph-indent-text-mode} to enter this mode. Use @kbd{M-x |
840 paragraph-indent-minor-mode} to enter an equivalent minor mode, for | |
841 instance during mail composition. | |
25829 | 842 |
843 @kindex M-TAB @r{(Text mode)} | |
844 Text mode, and all the modes based on it, define @kbd{M-@key{TAB}} as | |
845 the command @code{ispell-complete-word}, which performs completion of | |
846 the partial word in the buffer before point, using the spelling | |
847 dictionary as the space of possible words. @xref{Spelling}. | |
848 | |
849 @vindex text-mode-hook | |
850 Entering Text mode runs the hook @code{text-mode-hook}. Other major | |
851 modes related to Text mode also run this hook, followed by hooks of | |
852 their own; this includes Paragraph-Indent Text mode, Nroff mode, @TeX{} | |
853 mode, Outline mode, and Mail mode. Hook functions on | |
854 @code{text-mode-hook} can look at the value of @code{major-mode} to see | |
855 which of these modes is actually being entered. @xref{Hooks}. | |
856 | |
857 @ifinfo | |
858 Emacs provides two other modes for editing text that is to be passed | |
859 through a text formatter to produce fancy formatted printed output. | |
860 @xref{Nroff Mode}, for editing input to the formatter nroff. | |
861 @xref{TeX Mode}, for editing input to the formatter TeX. | |
862 | |
863 Another mode is used for editing outlines. It allows you to view the | |
864 text at various levels of detail. You can view either the outline | |
865 headings alone or both headings and text; you can also hide some of the | |
866 headings at lower levels from view to make the high level structure more | |
867 visible. @xref{Outline Mode}. | |
868 @end ifinfo | |
869 | |
870 @node Outline Mode | |
871 @section Outline Mode | |
872 @cindex Outline mode | |
873 @cindex mode, Outline | |
874 @cindex invisible lines | |
875 | |
876 @findex outline-mode | |
877 @findex outline-minor-mode | |
878 @vindex outline-minor-mode-prefix | |
879 Outline mode is a major mode much like Text mode but intended for | |
880 editing outlines. It allows you to make parts of the text temporarily | |
881 invisible so that you can see the outline structure. Type @kbd{M-x | |
882 outline-mode} to switch to Outline mode as the major mode of the current | |
883 buffer. | |
884 | |
885 When Outline mode makes a line invisible, the line does not appear on | |
886 the screen. The screen appears exactly as if the invisible line were | |
887 deleted, except that an ellipsis (three periods in a row) appears at the | |
888 end of the previous visible line (only one ellipsis no matter how many | |
889 invisible lines follow). | |
890 | |
891 Editing commands that operate on lines, such as @kbd{C-n} and | |
892 @kbd{C-p}, treat the text of the invisible line as part of the previous | |
893 visible line. Killing an entire visible line, including its terminating | |
894 newline, really kills all the following invisible lines along with it. | |
895 | |
896 Outline minor mode provides the same commands as the major mode, | |
897 Outline mode, but you can use it in conjunction with other major modes. | |
898 Type @kbd{M-x outline-minor-mode} to enable the Outline minor mode in | |
899 the current buffer. You can also specify this in the text of a file, | |
900 with a file local variable of the form @samp{mode: outline-minor} | |
901 (@pxref{File Variables}). | |
902 | |
903 @kindex C-c @@ @r{(Outline minor mode)} | |
904 The major mode, Outline mode, provides special key bindings on the | |
905 @kbd{C-c} prefix. Outline minor mode provides similar bindings with | |
906 @kbd{C-c @@} as the prefix; this is to reduce the conflicts with the | |
907 major mode's special commands. (The variable | |
908 @code{outline-minor-mode-prefix} controls the prefix used.) | |
909 | |
910 @vindex outline-mode-hook | |
911 Entering Outline mode runs the hook @code{text-mode-hook} followed by | |
912 the hook @code{outline-mode-hook} (@pxref{Hooks}). | |
913 | |
914 @menu | |
915 * Format: Outline Format. What the text of an outline looks like. | |
916 * Motion: Outline Motion. Special commands for moving through | |
917 outlines. | |
918 * Visibility: Outline Visibility. Commands to control what is visible. | |
919 * Views: Outline Views. Outlines and multiple views. | |
28328 | 920 * Foldout:: Folding editing. |
25829 | 921 @end menu |
922 | |
923 @node Outline Format | |
924 @subsection Format of Outlines | |
925 | |
926 @cindex heading lines (Outline mode) | |
927 @cindex body lines (Outline mode) | |
928 Outline mode assumes that the lines in the buffer are of two types: | |
929 @dfn{heading lines} and @dfn{body lines}. A heading line represents a | |
930 topic in the outline. Heading lines start with one or more stars; the | |
931 number of stars determines the depth of the heading in the outline | |
932 structure. Thus, a heading line with one star is a major topic; all the | |
933 heading lines with two stars between it and the next one-star heading | |
934 are its subtopics; and so on. Any line that is not a heading line is a | |
935 body line. Body lines belong with the preceding heading line. Here is | |
936 an example: | |
937 | |
938 @example | |
939 * Food | |
940 This is the body, | |
941 which says something about the topic of food. | |
942 | |
943 ** Delicious Food | |
944 This is the body of the second-level header. | |
945 | |
946 ** Distasteful Food | |
947 This could have | |
948 a body too, with | |
949 several lines. | |
950 | |
951 *** Dormitory Food | |
952 | |
953 * Shelter | |
954 Another first-level topic with its header line. | |
955 @end example | |
956 | |
957 A heading line together with all following body lines is called | |
958 collectively an @dfn{entry}. A heading line together with all following | |
959 deeper heading lines and their body lines is called a @dfn{subtree}. | |
960 | |
961 @vindex outline-regexp | |
962 You can customize the criterion for distinguishing heading lines | |
963 by setting the variable @code{outline-regexp}. Any line whose | |
964 beginning has a match for this regexp is considered a heading line. | |
965 Matches that start within a line (not at the left margin) do not count. | |
966 The length of the matching text determines the level of the heading; | |
967 longer matches make a more deeply nested level. Thus, for example, | |
968 if a text formatter has commands @samp{@@chapter}, @samp{@@section} | |
969 and @samp{@@subsection} to divide the document into chapters and | |
970 sections, you could make those lines count as heading lines by | |
971 setting @code{outline-regexp} to @samp{"@@chap\\|@@\\(sub\\)*section"}. | |
972 Note the trick: the two words @samp{chapter} and @samp{section} are equally | |
973 long, but by defining the regexp to match only @samp{chap} we ensure | |
974 that the length of the text matched on a chapter heading is shorter, | |
975 so that Outline mode will know that sections are contained in chapters. | |
976 This works as long as no other command starts with @samp{@@chap}. | |
977 | |
978 @vindex outline-level | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
979 You can change the rule for calculating the level of a heading line |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
980 by setting the variable @code{outline-level}. The value of |
25829 | 981 @code{outline-level} should be a function that takes no arguments and |
982 returns the level of the current heading. Some major modes such as C, | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
983 Nroff, and Emacs Lisp mode set this variable and @code{outline-regexp} |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
984 in order to work with Outline minor mode. |
25829 | 985 |
986 @node Outline Motion | |
987 @subsection Outline Motion Commands | |
988 | |
989 Outline mode provides special motion commands that move backward and | |
990 forward to heading lines. | |
991 | |
992 @table @kbd | |
993 @item C-c C-n | |
994 Move point to the next visible heading line | |
995 (@code{outline-next-visible-heading}). | |
996 @item C-c C-p | |
997 Move point to the previous visible heading line | |
998 (@code{outline-previous-visible-heading}). | |
999 @item C-c C-f | |
1000 Move point to the next visible heading line at the same level | |
1001 as the one point is on (@code{outline-forward-same-level}). | |
1002 @item C-c C-b | |
1003 Move point to the previous visible heading line at the same level | |
1004 (@code{outline-backward-same-level}). | |
1005 @item C-c C-u | |
1006 Move point up to a lower-level (more inclusive) visible heading line | |
1007 (@code{outline-up-heading}). | |
1008 @end table | |
1009 | |
1010 @findex outline-next-visible-heading | |
1011 @findex outline-previous-visible-heading | |
1012 @kindex C-c C-n @r{(Outline mode)} | |
1013 @kindex C-c C-p @r{(Outline mode)} | |
1014 @kbd{C-c C-n} (@code{outline-next-visible-heading}) moves down to the next | |
1015 heading line. @kbd{C-c C-p} (@code{outline-previous-visible-heading}) moves | |
1016 similarly backward. Both accept numeric arguments as repeat counts. The | |
1017 names emphasize that invisible headings are skipped, but this is not really | |
1018 a special feature. All editing commands that look for lines ignore the | |
1019 invisible lines automatically.@refill | |
1020 | |
1021 @findex outline-up-heading | |
1022 @findex outline-forward-same-level | |
1023 @findex outline-backward-same-level | |
1024 @kindex C-c C-f @r{(Outline mode)} | |
1025 @kindex C-c C-b @r{(Outline mode)} | |
1026 @kindex C-c C-u @r{(Outline mode)} | |
1027 More powerful motion commands understand the level structure of headings. | |
1028 @kbd{C-c C-f} (@code{outline-forward-same-level}) and | |
1029 @kbd{C-c C-b} (@code{outline-backward-same-level}) move from one | |
1030 heading line to another visible heading at the same depth in | |
1031 the outline. @kbd{C-c C-u} (@code{outline-up-heading}) moves | |
1032 backward to another heading that is less deeply nested. | |
1033 | |
1034 @node Outline Visibility | |
1035 @subsection Outline Visibility Commands | |
1036 | |
1037 The other special commands of outline mode are used to make lines visible | |
1038 or invisible. Their names all start with @code{hide} or @code{show}. | |
1039 Most of them fall into pairs of opposites. They are not undoable; instead, | |
1040 you can undo right past them. Making lines visible or invisible is simply | |
1041 not recorded by the undo mechanism. | |
1042 | |
1043 @table @kbd | |
1044 @item C-c C-t | |
1045 Make all body lines in the buffer invisible (@code{hide-body}). | |
1046 @item C-c C-a | |
1047 Make all lines in the buffer visible (@code{show-all}). | |
1048 @item C-c C-d | |
1049 Make everything under this heading invisible, not including this | |
1050 heading itself (@code{hide-subtree}). | |
1051 @item C-c C-s | |
1052 Make everything under this heading visible, including body, | |
1053 subheadings, and their bodies (@code{show-subtree}). | |
1054 @item C-c C-l | |
1055 Make the body of this heading line, and of all its subheadings, | |
1056 invisible (@code{hide-leaves}). | |
1057 @item C-c C-k | |
1058 Make all subheadings of this heading line, at all levels, visible | |
1059 (@code{show-branches}). | |
1060 @item C-c C-i | |
1061 Make immediate subheadings (one level down) of this heading line | |
1062 visible (@code{show-children}). | |
1063 @item C-c C-c | |
1064 Make this heading line's body invisible (@code{hide-entry}). | |
1065 @item C-c C-e | |
1066 Make this heading line's body visible (@code{show-entry}). | |
1067 @item C-c C-q | |
1068 Hide everything except the top @var{n} levels of heading lines | |
1069 (@code{hide-sublevels}). | |
1070 @item C-c C-o | |
1071 Hide everything except for the heading or body that point is in, plus | |
1072 the headings leading up from there to the top level of the outline | |
1073 (@code{hide-other}). | |
1074 @end table | |
1075 | |
1076 @findex hide-entry | |
1077 @findex show-entry | |
1078 @kindex C-c C-c @r{(Outline mode)} | |
1079 @kindex C-c C-e @r{(Outline mode)} | |
1080 Two commands that are exact opposites are @kbd{C-c C-c} | |
1081 (@code{hide-entry}) and @kbd{C-c C-e} (@code{show-entry}). They are | |
1082 used with point on a heading line, and apply only to the body lines of | |
1083 that heading. Subheadings and their bodies are not affected. | |
1084 | |
1085 @findex hide-subtree | |
1086 @findex show-subtree | |
1087 @kindex C-c C-s @r{(Outline mode)} | |
1088 @kindex C-c C-d @r{(Outline mode)} | |
1089 @cindex subtree (Outline mode) | |
1090 Two more powerful opposites are @kbd{C-c C-d} (@code{hide-subtree}) and | |
1091 @kbd{C-c C-s} (@code{show-subtree}). Both expect to be used when point is | |
1092 on a heading line, and both apply to all the lines of that heading's | |
1093 @dfn{subtree}: its body, all its subheadings, both direct and indirect, and | |
1094 all of their bodies. In other words, the subtree contains everything | |
1095 following this heading line, up to and not including the next heading of | |
1096 the same or higher rank.@refill | |
1097 | |
1098 @findex hide-leaves | |
1099 @findex show-branches | |
1100 @kindex C-c C-l @r{(Outline mode)} | |
1101 @kindex C-c C-k @r{(Outline mode)} | |
1102 Intermediate between a visible subtree and an invisible one is having | |
1103 all the subheadings visible but none of the body. There are two | |
1104 commands for doing this, depending on whether you want to hide the | |
1105 bodies or make the subheadings visible. They are @kbd{C-c C-l} | |
1106 (@code{hide-leaves}) and @kbd{C-c C-k} (@code{show-branches}). | |
1107 | |
1108 @kindex C-c C-i @r{(Outline mode)} | |
1109 @findex show-children | |
1110 A little weaker than @code{show-branches} is @kbd{C-c C-i} | |
1111 (@code{show-children}). It makes just the direct subheadings | |
1112 visible---those one level down. Deeper subheadings remain invisible, if | |
1113 they were invisible.@refill | |
1114 | |
1115 @findex hide-body | |
1116 @findex show-all | |
1117 @kindex C-c C-t @r{(Outline mode)} | |
1118 @kindex C-c C-a @r{(Outline mode)} | |
1119 Two commands have a blanket effect on the whole file. @kbd{C-c C-t} | |
1120 (@code{hide-body}) makes all body lines invisible, so that you see just | |
1121 the outline structure. @kbd{C-c C-a} (@code{show-all}) makes all lines | |
1122 visible. These commands can be thought of as a pair of opposites even | |
1123 though @kbd{C-c C-a} applies to more than just body lines. | |
1124 | |
1125 @findex hide-sublevels | |
1126 @kindex C-c C-q @r{(Outline mode)} | |
1127 The command @kbd{C-c C-q} (@code{hide-sublevels}) hides all but the | |
1128 top level headings. With a numeric argument @var{n}, it hides everything | |
1129 except the top @var{n} levels of heading lines. | |
1130 | |
1131 @findex hide-other | |
1132 @kindex C-c C-o @r{(Outline mode)} | |
1133 The command @kbd{C-c C-o} (@code{hide-other}) hides everything except | |
1134 the heading or body text that point is in, plus its parents (the headers | |
1135 leading up from there to top level in the outline). | |
1136 | |
1137 You can turn off the use of ellipses at the ends of visible lines by | |
1138 setting @code{selective-display-ellipses} to @code{nil}. Then there is | |
1139 no visible indication of the presence of invisible lines. | |
1140 | |
1141 When incremental search finds text that is hidden by Outline mode, | |
1142 it makes that part of the buffer visible. If you exit the search | |
1143 at that position, the text remains visible. | |
1144 | |
1145 @node Outline Views | |
1146 @subsection Viewing One Outline in Multiple Views | |
1147 | |
1148 @cindex multiple views of outline | |
1149 @cindex views of an outline | |
1150 @cindex outline with multiple views | |
1151 @cindex indirect buffers and outlines | |
1152 You can display two views of a single outline at the same time, in | |
1153 different windows. To do this, you must create an indirect buffer using | |
1154 @kbd{M-x make-indirect-buffer}. The first argument of this command is | |
1155 the existing outline buffer name, and its second argument is the name to | |
1156 use for the new indirect buffer. @xref{Indirect Buffers}. | |
1157 | |
1158 Once the indirect buffer exists, you can display it in a window in the | |
1159 normal fashion, with @kbd{C-x 4 b} or other Emacs commands. The Outline | |
1160 mode commands to show and hide parts of the text operate on each buffer | |
1161 independently; as a result, each buffer can have its own view. If you | |
1162 want more than two views on the same outline, create additional indirect | |
1163 buffers. | |
1164 | |
28328 | 1165 @node Foldout |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1166 @subsection Folding Editing |
28328 | 1167 |
1168 @cindex folding editing | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1169 The Foldout package extends Outline mode and Outline minor mode with |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1170 ``folding'' commands. The idea of folding is that you zoom in on a |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1171 nested portion of the outline, while hiding its relatives at higher |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1172 levels. |
30867 | 1173 |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1174 Consider an Outline mode buffer all the text and subheadings under |
28328 | 1175 level-1 headings hidden. To look at what is hidden under one of these |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1176 headings, you could use @kbd{C-c C-e} (@kbd{M-x show-entry}) to expose |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1177 the body, or @kbd{C-c C-i} to expose the child (level-2) headings. |
28328 | 1178 |
1179 @kindex C-c C-z | |
1180 @findex foldout-zoom-subtree | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1181 With Foldout, you use @kbd{C-c C-z} (@kbd{M-x foldout-zoom-subtree}). |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1182 This exposes the body and child subheadings, and narrows the buffer so |
38229
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1183 that only the @w{level-1} heading, the body and the level-2 headings are |
28328 | 1184 visible. Now to look under one of the level-2 headings, position the |
1185 cursor on it and use @kbd{C-c C-z} again. This exposes the level-2 body | |
1186 and its level-3 child subheadings and narrows the buffer again. Zooming | |
1187 in on successive subheadings can be done as much as you like. A string | |
39267 | 1188 in the mode line shows how deep you've gone. |
28328 | 1189 |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1190 When zooming in on a heading, to see only the child subheadings specify |
28328 | 1191 a numeric argument: @kbd{C-u C-c C-z}. The number of levels of children |
1192 can be specified too (compare @kbd{M-x show-children}), e.g.@: @kbd{M-2 | |
1193 C-c C-z} exposes two levels of child subheadings. Alternatively, the | |
39267 | 1194 body can be specified with a negative argument: @kbd{M-- C-c C-z}. The |
28328 | 1195 whole subtree can be expanded, similarly to @kbd{C-c C-s} (@kbd{M-x |
1196 show-subtree}), by specifying a zero argument: @kbd{M-0 C-c C-z}. | |
1197 | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1198 While you're zoomed in, you can still use Outline mode's exposure and |
28328 | 1199 hiding functions without disturbing Foldout. Also, since the buffer is |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1200 narrowed, ``global'' editing actions will only affect text under the |
28328 | 1201 zoomed-in heading. This is useful for restricting changes to a |
1202 particular chapter or section of your document. | |
1203 | |
1204 @kindex C-c C-x | |
1205 @findex foldout-exit-fold | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1206 To unzoom (exit) a fold, use @kbd{C-c C-x} (@kbd{M-x foldout-exit-fold}). |
28328 | 1207 This hides all the text and subheadings under the top-level heading and |
1208 returns you to the previous view of the buffer. Specifying a numeric | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1209 argument exits that many levels of folds. Specifying a zero argument exits all |
28328 | 1210 folds. |
1211 | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1212 To cancel the narrowing of a fold without hiding the text and |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1213 subheadings, specify a negative argument. For example, @kbd{M--2 C-c |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1214 C-x} exits two folds and leaves the text and subheadings exposed. |
28328 | 1215 |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1216 Foldout mode also provides mouse commands for entering and exiting |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1217 folds, and for showing and hiding text: |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1218 |
28328 | 1219 @table @asis |
40651 | 1220 @item @kbd{C-M-Mouse-1} zooms in on the heading clicked on |
38229
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1221 @itemize @asis |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1222 @item |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1223 single click: expose body. |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1224 @item |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1225 double click: expose subheadings. |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1226 @item |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1227 triple click: expose body and subheadings. |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1228 @item |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1229 quad click: expose entire subtree. |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1230 @end itemize |
40651 | 1231 @item @kbd{C-M-Mouse-2} exposes text under the heading clicked on |
38951
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1232 @itemize @asis |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1233 @item |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1234 single click: expose body. |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1235 @item |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1236 double click: expose subheadings. |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1237 @item |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1238 triple click: expose body and subheadings. |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1239 @item |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1240 quad click: expose entire subtree. |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1241 @end itemize |
40651 | 1242 @item @kbd{C-M-Mouse-3} hides text under the heading clicked on or exits fold |
38951
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1243 @itemize @asis |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1244 @item |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1245 single click: hide subtree. |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1246 @item |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1247 double click: exit fold and hide text. |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1248 @item |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1249 triple click: exit fold without hiding text. |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1250 @item |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1251 quad click: exit all folds and hide text. |
7495f1fcfe14
Convert subtables in Foldout mode into @itemize.
Richard M. Stallman <rms@gnu.org>
parents:
38870
diff
changeset
|
1252 @end itemize |
28328 | 1253 @end table |
1254 | |
1255 @vindex foldout-mouse-modifiers | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1256 You can specify different modifier keys (instead of |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1257 @kbd{Control-Meta-}) by setting @code{foldout-mouse-modifiers}; but if |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1258 you have already loaded the @file{foldout.el} library, you must reload |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1259 it in order for this to take effect. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1260 |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1261 To use the Foldout package, you can type @kbd{M-x load-library |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1262 @key{RET} foldout @key{RET}}; or you can arrange for to do that |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1263 automatically by putting this in your @file{.emacs} file: |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1264 |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1265 @example |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1266 (eval-after-load "outline" '(require 'foldout)) |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1267 @end example |
28328 | 1268 |
46247
2e162cb1a7ac
(TeX Mode): Remove explicit next/prev/up in @node line.
Miles Bader <miles@gnu.org>
parents:
46234
diff
changeset
|
1269 @node TeX Mode |
25829 | 1270 @section @TeX{} Mode |
1271 @cindex @TeX{} mode | |
1272 @cindex La@TeX{} mode | |
1273 @cindex Sli@TeX{} mode | |
1274 @cindex mode, @TeX{} | |
1275 @cindex mode, La@TeX{} | |
1276 @cindex mode, Sli@TeX{} | |
1277 @findex tex-mode | |
1278 @findex plain-tex-mode | |
1279 @findex latex-mode | |
1280 @findex slitex-mode | |
1281 | |
1282 @TeX{} is a powerful text formatter written by Donald Knuth; it is also | |
1283 free, like GNU Emacs. La@TeX{} is a simplified input format for @TeX{}, | |
1284 implemented by @TeX{} macros; it comes with @TeX{}. Sli@TeX{} is a special | |
30867 | 1285 form of La@TeX{}.@footnote{Sli@TeX{} is obsoleted by the @samp{slides} |
1286 document class in recent La@TeX{} versions.} | |
25829 | 1287 |
1288 Emacs has a special @TeX{} mode for editing @TeX{} input files. | |
1289 It provides facilities for checking the balance of delimiters and for | |
1290 invoking @TeX{} on all or part of the file. | |
1291 | |
1292 @vindex tex-default-mode | |
1293 @TeX{} mode has three variants, Plain @TeX{} mode, La@TeX{} mode, and | |
1294 Sli@TeX{} mode (these three distinct major modes differ only slightly). | |
1295 They are designed for editing the three different formats. The command | |
1296 @kbd{M-x tex-mode} looks at the contents of the buffer to determine | |
1297 whether the contents appear to be either La@TeX{} input or Sli@TeX{} | |
1298 input; if so, it selects the appropriate mode. If the file contents do | |
1299 not appear to be La@TeX{} or Sli@TeX{}, it selects Plain @TeX{} mode. | |
1300 If the contents are insufficient to determine this, the variable | |
1301 @code{tex-default-mode} controls which mode is used. | |
1302 | |
1303 When @kbd{M-x tex-mode} does not guess right, you can use the commands | |
1304 @kbd{M-x plain-tex-mode}, @kbd{M-x latex-mode}, and @kbd{M-x | |
1305 slitex-mode} to select explicitly the particular variants of @TeX{} | |
1306 mode. | |
1307 | |
1308 @menu | |
1309 * Editing: TeX Editing. Special commands for editing in TeX mode. | |
1310 * LaTeX: LaTeX Editing. Additional commands for LaTeX input files. | |
1311 * Printing: TeX Print. Commands for printing part of a file with TeX. | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1312 * Misc: TeX Misc. Customization of TeX mode, and related features. |
25829 | 1313 @end menu |
1314 | |
1315 @node TeX Editing | |
1316 @subsection @TeX{} Editing Commands | |
1317 | |
1318 Here are the special commands provided in @TeX{} mode for editing the | |
1319 text of the file. | |
1320 | |
1321 @table @kbd | |
1322 @item " | |
1323 Insert, according to context, either @samp{``} or @samp{"} or | |
1324 @samp{''} (@code{tex-insert-quote}). | |
1325 @item C-j | |
1326 Insert a paragraph break (two newlines) and check the previous | |
1327 paragraph for unbalanced braces or dollar signs | |
1328 (@code{tex-terminate-paragraph}). | |
1329 @item M-x tex-validate-region | |
1330 Check each paragraph in the region for unbalanced braces or dollar signs. | |
1331 @item C-c @{ | |
1332 Insert @samp{@{@}} and position point between them (@code{tex-insert-braces}). | |
1333 @item C-c @} | |
1334 Move forward past the next unmatched close brace (@code{up-list}). | |
1335 @end table | |
1336 | |
1337 @findex tex-insert-quote | |
1338 @kindex " @r{(@TeX{} mode)} | |
1339 In @TeX{}, the character @samp{"} is not normally used; we use | |
1340 @samp{``} to start a quotation and @samp{''} to end one. To make | |
1341 editing easier under this formatting convention, @TeX{} mode overrides | |
1342 the normal meaning of the key @kbd{"} with a command that inserts a pair | |
1343 of single-quotes or backquotes (@code{tex-insert-quote}). To be | |
1344 precise, this command inserts @samp{``} after whitespace or an open | |
1345 brace, @samp{"} after a backslash, and @samp{''} after any other | |
1346 character. | |
1347 | |
1348 If you need the character @samp{"} itself in unusual contexts, use | |
1349 @kbd{C-q} to insert it. Also, @kbd{"} with a numeric argument always | |
1350 inserts that number of @samp{"} characters. You can turn off the | |
1351 feature of @kbd{"} expansion by eliminating that binding in the local | |
1352 map (@pxref{Key Bindings}). | |
1353 | |
1354 In @TeX{} mode, @samp{$} has a special syntax code which attempts to | |
1355 understand the way @TeX{} math mode delimiters match. When you insert a | |
1356 @samp{$} that is meant to exit math mode, the position of the matching | |
1357 @samp{$} that entered math mode is displayed for a second. This is the | |
1358 same feature that displays the open brace that matches a close brace that | |
1359 is inserted. However, there is no way to tell whether a @samp{$} enters | |
1360 math mode or leaves it; so when you insert a @samp{$} that enters math | |
1361 mode, the previous @samp{$} position is shown as if it were a match, even | |
1362 though they are actually unrelated. | |
1363 | |
1364 @findex tex-insert-braces | |
1365 @kindex C-c @{ @r{(@TeX{} mode)} | |
1366 @findex up-list | |
1367 @kindex C-c @} @r{(@TeX{} mode)} | |
1368 @TeX{} uses braces as delimiters that must match. Some users prefer | |
1369 to keep braces balanced at all times, rather than inserting them | |
1370 singly. Use @kbd{C-c @{} (@code{tex-insert-braces}) to insert a pair of | |
1371 braces. It leaves point between the two braces so you can insert the | |
1372 text that belongs inside. Afterward, use the command @kbd{C-c @}} | |
1373 (@code{up-list}) to move forward past the close brace. | |
1374 | |
1375 @findex tex-validate-region | |
1376 @findex tex-terminate-paragraph | |
1377 @kindex C-j @r{(@TeX{} mode)} | |
1378 There are two commands for checking the matching of braces. @kbd{C-j} | |
1379 (@code{tex-terminate-paragraph}) checks the paragraph before point, and | |
38870
d44abb4e68b2
Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents:
38478
diff
changeset
|
1380 inserts two newlines to start a new paragraph. It outputs a message in |
25829 | 1381 the echo area if any mismatch is found. @kbd{M-x tex-validate-region} |
1382 checks a region, paragraph by paragraph. The errors are listed in the | |
1383 @samp{*Occur*} buffer, and you can use @kbd{C-c C-c} or @kbd{Mouse-2} in | |
1384 that buffer to go to a particular mismatch. | |
1385 | |
1386 Note that Emacs commands count square brackets and parentheses in | |
1387 @TeX{} mode, not just braces. This is not strictly correct for the | |
1388 purpose of checking @TeX{} syntax. However, parentheses and square | |
1389 brackets are likely to be used in text as matching delimiters and it is | |
1390 useful for the various motion commands and automatic match display to | |
1391 work with them. | |
1392 | |
1393 @node LaTeX Editing | |
1394 @subsection La@TeX{} Editing Commands | |
1395 | |
1396 La@TeX{} mode, and its variant, Sli@TeX{} mode, provide a few extra | |
1397 features not applicable to plain @TeX{}. | |
1398 | |
1399 @table @kbd | |
1400 @item C-c C-o | |
1401 Insert @samp{\begin} and @samp{\end} for La@TeX{} block and position | |
1402 point on a line between them (@code{tex-latex-block}). | |
1403 @item C-c C-e | |
1404 Close the innermost La@TeX{} block not yet closed | |
1405 (@code{tex-close-latex-block}). | |
1406 @end table | |
1407 | |
1408 @findex tex-latex-block | |
1409 @kindex C-c C-o @r{(La@TeX{} mode)} | |
1410 @vindex latex-block-names | |
1411 In La@TeX{} input, @samp{\begin} and @samp{\end} commands are used to | |
1412 group blocks of text. To insert a @samp{\begin} and a matching | |
1413 @samp{\end} (on a new line following the @samp{\begin}), use @kbd{C-c | |
1414 C-o} (@code{tex-latex-block}). A blank line is inserted between the | |
1415 two, and point is left there. You can use completion when you enter the | |
1416 block type; to specify additional block type names beyond the standard | |
1417 list, set the variable @code{latex-block-names}. For example, here's | |
1418 how to add @samp{theorem}, @samp{corollary}, and @samp{proof}: | |
1419 | |
1420 @example | |
1421 (setq latex-block-names '("theorem" "corollary" "proof")) | |
1422 @end example | |
1423 | |
1424 @findex tex-close-latex-block | |
1425 @kindex C-c C-e @r{(La@TeX{} mode)} | |
1426 In La@TeX{} input, @samp{\begin} and @samp{\end} commands must | |
1427 balance. You can use @kbd{C-c C-e} (@code{tex-close-latex-block}) to | |
1428 insert automatically a matching @samp{\end} to match the last unmatched | |
1429 @samp{\begin}. It indents the @samp{\end} to match the corresponding | |
1430 @samp{\begin}. It inserts a newline after @samp{\end} if point is at | |
1431 the beginning of a line. | |
1432 | |
1433 @node TeX Print | |
1434 @subsection @TeX{} Printing Commands | |
1435 | |
1436 You can invoke @TeX{} as an inferior of Emacs on either the entire | |
1437 contents of the buffer or just a region at a time. Running @TeX{} in | |
1438 this way on just one chapter is a good way to see what your changes | |
1439 look like without taking the time to format the entire file. | |
1440 | |
1441 @table @kbd | |
1442 @item C-c C-r | |
1443 Invoke @TeX{} on the current region, together with the buffer's header | |
1444 (@code{tex-region}). | |
1445 @item C-c C-b | |
1446 Invoke @TeX{} on the entire current buffer (@code{tex-buffer}). | |
1447 @item C-c @key{TAB} | |
1448 Invoke Bib@TeX{} on the current file (@code{tex-bibtex-file}). | |
1449 @item C-c C-f | |
1450 Invoke @TeX{} on the current file (@code{tex-file}). | |
1451 @item C-c C-l | |
1452 Recenter the window showing output from the inferior @TeX{} so that | |
1453 the last line can be seen (@code{tex-recenter-output-buffer}). | |
1454 @item C-c C-k | |
1455 Kill the @TeX{} subprocess (@code{tex-kill-job}). | |
1456 @item C-c C-p | |
1457 Print the output from the last @kbd{C-c C-r}, @kbd{C-c C-b}, or @kbd{C-c | |
1458 C-f} command (@code{tex-print}). | |
1459 @item C-c C-v | |
1460 Preview the output from the last @kbd{C-c C-r}, @kbd{C-c C-b}, or @kbd{C-c | |
1461 C-f} command (@code{tex-view}). | |
1462 @item C-c C-q | |
1463 Show the printer queue (@code{tex-show-print-queue}). | |
1464 @end table | |
1465 | |
1466 @findex tex-buffer | |
1467 @kindex C-c C-b @r{(@TeX{} mode)} | |
1468 @findex tex-print | |
1469 @kindex C-c C-p @r{(@TeX{} mode)} | |
1470 @findex tex-view | |
1471 @kindex C-c C-v @r{(@TeX{} mode)} | |
1472 @findex tex-show-print-queue | |
1473 @kindex C-c C-q @r{(@TeX{} mode)} | |
1474 You can pass the current buffer through an inferior @TeX{} by means of | |
1475 @kbd{C-c C-b} (@code{tex-buffer}). The formatted output appears in a | |
1476 temporary file; to print it, type @kbd{C-c C-p} (@code{tex-print}). | |
1477 Afterward, you can use @kbd{C-c C-q} (@code{tex-show-print-queue}) to | |
1478 view the progress of your output towards being printed. If your terminal | |
1479 has the ability to display @TeX{} output files, you can preview the | |
1480 output on the terminal with @kbd{C-c C-v} (@code{tex-view}). | |
1481 | |
29107 | 1482 @cindex @env{TEXINPUTS} environment variable |
25829 | 1483 @vindex tex-directory |
1484 You can specify the directory to use for running @TeX{} by setting the | |
1485 variable @code{tex-directory}. @code{"."} is the default value. If | |
29107 | 1486 your environment variable @env{TEXINPUTS} contains relative directory |
25829 | 1487 names, or if your files contains @samp{\input} commands with relative |
1488 file names, then @code{tex-directory} @emph{must} be @code{"."} or you | |
1489 will get the wrong results. Otherwise, it is safe to specify some other | |
1490 directory, such as @code{"/tmp"}. | |
1491 | |
1492 @vindex tex-run-command | |
1493 @vindex latex-run-command | |
1494 @vindex slitex-run-command | |
1495 @vindex tex-dvi-print-command | |
1496 @vindex tex-dvi-view-command | |
1497 @vindex tex-show-queue-command | |
1498 If you want to specify which shell commands are used in the inferior @TeX{}, | |
1499 you can do so by setting the values of the variables @code{tex-run-command}, | |
1500 @code{latex-run-command}, @code{slitex-run-command}, | |
1501 @code{tex-dvi-print-command}, @code{tex-dvi-view-command}, and | |
1502 @code{tex-show-queue-command}. You @emph{must} set the value of | |
1503 @code{tex-dvi-view-command} for your particular terminal; this variable | |
1504 has no default value. The other variables have default values that may | |
1505 (or may not) be appropriate for your system. | |
1506 | |
1507 Normally, the file name given to these commands comes at the end of | |
1508 the command string; for example, @samp{latex @var{filename}}. In some | |
1509 cases, however, the file name needs to be embedded in the command; an | |
1510 example is when you need to provide the file name as an argument to one | |
1511 command whose output is piped to another. You can specify where to put | |
1512 the file name with @samp{*} in the command string. For example, | |
1513 | |
1514 @example | |
1515 (setq tex-dvi-print-command "dvips -f * | lpr") | |
1516 @end example | |
1517 | |
1518 @findex tex-kill-job | |
1519 @kindex C-c C-k @r{(@TeX{} mode)} | |
1520 @findex tex-recenter-output-buffer | |
1521 @kindex C-c C-l @r{(@TeX{} mode)} | |
1522 The terminal output from @TeX{}, including any error messages, appears | |
1523 in a buffer called @samp{*tex-shell*}. If @TeX{} gets an error, you can | |
1524 switch to this buffer and feed it input (this works as in Shell mode; | |
1525 @pxref{Interactive Shell}). Without switching to this buffer you can | |
1526 scroll it so that its last line is visible by typing @kbd{C-c | |
1527 C-l}. | |
1528 | |
1529 Type @kbd{C-c C-k} (@code{tex-kill-job}) to kill the @TeX{} process if | |
1530 you see that its output is no longer useful. Using @kbd{C-c C-b} or | |
1531 @kbd{C-c C-r} also kills any @TeX{} process still running.@refill | |
1532 | |
1533 @findex tex-region | |
1534 @kindex C-c C-r @r{(@TeX{} mode)} | |
1535 You can also pass an arbitrary region through an inferior @TeX{} by typing | |
1536 @kbd{C-c C-r} (@code{tex-region}). This is tricky, however, because most files | |
1537 of @TeX{} input contain commands at the beginning to set parameters and | |
1538 define macros, without which no later part of the file will format | |
1539 correctly. To solve this problem, @kbd{C-c C-r} allows you to designate a | |
1540 part of the file as containing essential commands; it is included before | |
1541 the specified region as part of the input to @TeX{}. The designated part | |
1542 of the file is called the @dfn{header}. | |
1543 | |
1544 @cindex header (@TeX{} mode) | |
1545 To indicate the bounds of the header in Plain @TeX{} mode, you insert two | |
1546 special strings in the file. Insert @samp{%**start of header} before the | |
1547 header, and @samp{%**end of header} after it. Each string must appear | |
1548 entirely on one line, but there may be other text on the line before or | |
1549 after. The lines containing the two strings are included in the header. | |
1550 If @samp{%**start of header} does not appear within the first 100 lines of | |
1551 the buffer, @kbd{C-c C-r} assumes that there is no header. | |
1552 | |
1553 In La@TeX{} mode, the header begins with @samp{\documentclass} or | |
1554 @samp{\documentstyle} and ends with @samp{\begin@{document@}}. These | |
1555 are commands that La@TeX{} requires you to use in any case, so nothing | |
1556 special needs to be done to identify the header. | |
1557 | |
1558 @findex tex-file | |
1559 @kindex C-c C-f @r{(@TeX{} mode)} | |
1560 The commands (@code{tex-buffer}) and (@code{tex-region}) do all of their | |
1561 work in a temporary directory, and do not have available any of the auxiliary | |
1562 files needed by @TeX{} for cross-references; these commands are generally | |
1563 not suitable for running the final copy in which all of the cross-references | |
1564 need to be correct. | |
1565 | |
1566 When you want the auxiliary files for cross references, use @kbd{C-c | |
1567 C-f} (@code{tex-file}) which runs @TeX{} on the current buffer's file, | |
1568 in that file's directory. Before running @TeX{}, it offers to save any | |
1569 modified buffers. Generally, you need to use (@code{tex-file}) twice to | |
1570 get the cross-references right. | |
1571 | |
46209
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1572 @vindex tex-start-options |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1573 The value of the variable @code{tex-start-options} specifies |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1574 options for the @TeX{} run. |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1575 |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1576 @vindex tex-start-commands |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1577 The value of the variable @code{tex-start-commands} specifies @TeX{} |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1578 commands for starting @TeX{}. The default value causes @TeX{} to run |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1579 in nonstop mode. To run @TeX{} interactively, set the variable to |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1580 @code{""}. |
25829 | 1581 |
1582 @vindex tex-main-file | |
1583 Large @TeX{} documents are often split into several files---one main | |
1584 file, plus subfiles. Running @TeX{} on a subfile typically does not | |
1585 work; you have to run it on the main file. In order to make | |
1586 @code{tex-file} useful when you are editing a subfile, you can set the | |
1587 variable @code{tex-main-file} to the name of the main file. Then | |
1588 @code{tex-file} runs @TeX{} on that file. | |
1589 | |
1590 The most convenient way to use @code{tex-main-file} is to specify it | |
1591 in a local variable list in each of the subfiles. @xref{File | |
1592 Variables}. | |
1593 | |
1594 @findex tex-bibtex-file | |
1595 @kindex C-c TAB @r{(@TeX{} mode)} | |
1596 @vindex tex-bibtex-command | |
1597 For La@TeX{} files, you can use Bib@TeX{} to process the auxiliary | |
1598 file for the current buffer's file. Bib@TeX{} looks up bibliographic | |
1599 citations in a data base and prepares the cited references for the | |
1600 bibliography section. The command @kbd{C-c TAB} | |
1601 (@code{tex-bibtex-file}) runs the shell command | |
1602 (@code{tex-bibtex-command}) to produce a @samp{.bbl} file for the | |
1603 current buffer's file. Generally, you need to do @kbd{C-c C-f} | |
1604 (@code{tex-file}) once to generate the @samp{.aux} file, then do | |
1605 @kbd{C-c TAB} (@code{tex-bibtex-file}), and then repeat @kbd{C-c C-f} | |
1606 (@code{tex-file}) twice more to get the cross-references correct. | |
1607 | |
36179
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1608 @node TeX Misc |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1609 @subsection @TeX{} Mode Miscellany |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1610 |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1611 @vindex tex-shell-hook |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1612 @vindex tex-mode-hook |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1613 @vindex latex-mode-hook |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1614 @vindex slitex-mode-hook |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1615 @vindex plain-tex-mode-hook |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1616 Entering any variant of @TeX{} mode runs the hooks |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1617 @code{text-mode-hook} and @code{tex-mode-hook}. Then it runs either |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1618 @code{plain-tex-mode-hook}, @code{latex-mode-hook}, or |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1619 @code{slitex-mode-hook}, whichever is appropriate. Starting the |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1620 @TeX{} shell runs the hook @code{tex-shell-hook}. @xref{Hooks}. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1621 |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1622 @findex iso-iso2tex |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1623 @findex iso-tex2iso |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1624 @findex iso-iso2gtex |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1625 @findex iso-gtex2iso |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1626 @cindex Latin-1 @TeX{} encoding |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1627 @TeX{} encoding |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1628 The commands @kbd{M-x iso-iso2tex}, @kbd{M-x iso-tex2iso}, @kbd{M-x |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1629 iso-iso2gtex} and @kbd{M-x iso-gtex2iso} can be used to convert |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1630 between Latin-1 encoded files and @TeX{}-encoded equivalents. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1631 @ignore |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1632 @c Too cryptic to be useful, too cryptic for me to make it better -- rms. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1633 They |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1634 are included by default in the @code{format-alist} variable, so they |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1635 can be used with @kbd{M-x format-find-file}, for instance. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1636 @end ignore |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1637 |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1638 @ignore @c Not worth documenting if it is only for Czech -- rms. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1639 @findex tildify-buffer |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1640 @findex tildify-region |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1641 @cindex ties, @TeX{}, inserting |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1642 @cindex hard spaces, @TeX{}, inserting |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1643 The commands @kbd{M-x tildify-buffer} and @kbd{M-x tildify-region} |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1644 insert @samp{~} (@dfn{tie}) characters where they are conventionally |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1645 required. This is set up for Czech---customize the group |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1646 @samp{tildify} for other languages or for other sorts of markup. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1647 @end ignore |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1648 |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1649 @cindex Ref@TeX{} package |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1650 @cindex references, La@TeX{} |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1651 @cindex La@TeX{} references |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1652 For managing all kinds of references for La@TeX{}, you can use |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1653 Ref@TeX{}. @xref{Top, , RefTeX, reftex}. |
32fc1ec13574
Move the Refill Mode node.
Richard M. Stallman <rms@gnu.org>
parents:
32782
diff
changeset
|
1654 |
46234
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1655 @node HTML Mode |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1656 @section SGML and HTML Modes |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1657 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1658 The major modes for SGML and HTML include indentation support and |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1659 commands to operate on tags. This section describes the special |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1660 commands of these modes. (HTML mode is a slightly customized variant |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1661 of SGML mode.) |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1662 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1663 @table @kbd |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1664 @item C-c C-n |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1665 @kindex C-c C-n @r{(SGML mode)} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1666 @findex sgml-name-char |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1667 Interactively specify a special character and insert the SGML |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1668 @samp{&}-command for that character. |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1669 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1670 @item C-c C-t |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1671 @kindex C-c C-t @r{(SGML mode)} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1672 @findex sgml-tag |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1673 Interactively specify a tag and its attributes (@code{sgml-tag}). |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1674 This command asks you for a tag name and for the attribute values, |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1675 then inserts both the opening tag and the closing tag, leaving point |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1676 between them. |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1677 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1678 With a prefix argument @var{n}, the command puts the tag around the |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1679 @var{n} words already present in the buffer after point. With |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1680 @minus{}1 as argument, it puts the tag around the region. (In |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1681 Transient Mark mode, it does this whenever a region is active.) |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1682 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1683 @item C-c C-a |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1684 @kindex C-c C-a @r{(SGML mode)} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1685 @findex sgml-attributes |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1686 Interactively insert attribute values for the current tag |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1687 (@code{sgml-attributes}). |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1688 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1689 @item C-c C-f |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1690 @kindex C-c C-f @r{(SGML mode)} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1691 @findex sgml-skip-tag-forward |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1692 Skip across a balanced tag group (which extends from an opening tag |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1693 through its corresponding closing tag) (@code{sgml-skip-tag-forward}). |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1694 A numeric argument acts as a repeat count. |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1695 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1696 @item C-c C-b |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1697 @kindex C-c C-b @r{(SGML mode)} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1698 @findex sgml-skip-tag-backward |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1699 Skip backward across a balanced tag group (which extends from an |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1700 opening tag through its corresponding closing tag) |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1701 (@code{sgml-skip-tag-forward}). A numeric argument acts as a repeat |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1702 count. |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1703 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1704 @item C-c C-d |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1705 @kindex C-c C-d @r{(SGML mode)} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1706 @findex sgml-delete-tag |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1707 Delete the tag at or after point, and delete the matching tag too |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1708 (@code{sgml-delete-tag}). If the tag at or after point is an opening |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1709 tag, delete the closing tag too; if it is a closing tag, delete the |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1710 opening tag too. |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1711 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1712 @item C-c ? @var{tag} @key{RET} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1713 @kindex C-c ? @r{(SGML mode)} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1714 @findex sgml-tag-help |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1715 Display a description of the meaning of tag @var{tag} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1716 (@code{sgml-tag-help}). If the argument @var{tag} is empty, describe |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1717 the tag at point. |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1718 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1719 @item C-c / |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1720 @kindex C-c / @r{(SGML mode)} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1721 @findex sgml-close-tag |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1722 Insert a close tag for the innermost unterminated tag (@code{sgml-close-tag}). |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1723 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1724 @item C-c 8 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1725 @kindex C-c 8 @r{(SGML mode)} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1726 @findex sgml-name-8bit-mode |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1727 Toggle a minor mode in which Latin-1 characters insert the |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1728 corresponding SGML commands that stand for them, instead of the |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1729 characters themselves (@code{sgml-name-8bit-mode}). |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1730 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1731 @item C-c C-v |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1732 @kindex C-c C-v @r{(SGML mode)} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1733 @findex sgml-validate |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1734 Run a shell command (which you must specify) to validate the current |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1735 buffer as SGML (@code{sgml-validate}). |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1736 @end table |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1737 |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1738 @vindex sgml-xml-mode |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1739 SGML mode and HTML mode support XML also. In XML, every opening tag |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1740 must have an explicit closing tag. When @code{sgml-xml-mode} is |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1741 non-@code{nil}, SGML mode (and HTML mode) always insert explicit |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1742 closing tags. When you visit a file, these modes determine from the |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1743 file contents whether it is XML or not, and set @code{sgml-xml-mode} |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1744 accordingly, so that they does the right thing for the file in either |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1745 case. |
58b8a59669f4
New node for SGML mode, etc.
Richard M. Stallman <rms@gnu.org>
parents:
46209
diff
changeset
|
1746 |
25829 | 1747 @node Nroff Mode |
1748 @section Nroff Mode | |
1749 | |
1750 @cindex nroff | |
1751 @findex nroff-mode | |
1752 Nroff mode is a mode like Text mode but modified to handle nroff commands | |
1753 present in the text. Invoke @kbd{M-x nroff-mode} to enter this mode. It | |
1754 differs from Text mode in only a few ways. All nroff command lines are | |
1755 considered paragraph separators, so that filling will never garble the | |
1756 nroff commands. Pages are separated by @samp{.bp} commands. Comments | |
1757 start with backslash-doublequote. Also, three special commands are | |
1758 provided that are not in Text mode: | |
1759 | |
1760 @findex forward-text-line | |
1761 @findex backward-text-line | |
1762 @findex count-text-lines | |
1763 @kindex M-n @r{(Nroff mode)} | |
1764 @kindex M-p @r{(Nroff mode)} | |
1765 @kindex M-? @r{(Nroff mode)} | |
1766 @table @kbd | |
1767 @item M-n | |
1768 Move to the beginning of the next line that isn't an nroff command | |
1769 (@code{forward-text-line}). An argument is a repeat count. | |
1770 @item M-p | |
1771 Like @kbd{M-n} but move up (@code{backward-text-line}). | |
1772 @item M-? | |
38870
d44abb4e68b2
Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents:
38478
diff
changeset
|
1773 Displays in the echo area the number of text lines (lines that are not |
25829 | 1774 nroff commands) in the region (@code{count-text-lines}). |
1775 @end table | |
1776 | |
1777 @findex electric-nroff-mode | |
1778 The other feature of Nroff mode is that you can turn on Electric Nroff | |
1779 mode. This is a minor mode that you can turn on or off with @kbd{M-x | |
1780 electric-nroff-mode} (@pxref{Minor Modes}). When the mode is on, each | |
1781 time you use @key{RET} to end a line that contains an nroff command that | |
1782 opens a kind of grouping, the matching nroff command to close that | |
1783 grouping is automatically inserted on the following line. For example, | |
1784 if you are at the beginning of a line and type @kbd{.@: ( b @key{RET}}, | |
1785 this inserts the matching command @samp{.)b} on a new line following | |
1786 point. | |
1787 | |
1788 If you use Outline minor mode with Nroff mode (@pxref{Outline Mode}), | |
1789 heading lines are lines of the form @samp{.H} followed by a number (the | |
1790 header level). | |
1791 | |
1792 @vindex nroff-mode-hook | |
1793 Entering Nroff mode runs the hook @code{text-mode-hook}, followed by | |
1794 the hook @code{nroff-mode-hook} (@pxref{Hooks}). | |
1795 | |
1796 @node Formatted Text | |
1797 @section Editing Formatted Text | |
1798 | |
1799 @cindex Enriched mode | |
1800 @cindex mode, Enriched | |
1801 @cindex formatted text | |
1802 @cindex WYSIWYG | |
1803 @cindex word processing | |
1804 @dfn{Enriched mode} is a minor mode for editing files that contain | |
1805 formatted text in WYSIWYG fashion, as in a word processor. Currently, | |
1806 formatted text in Enriched mode can specify fonts, colors, underlining, | |
1807 margins, and types of filling and justification. In the future, we plan | |
1808 to implement other formatting features as well. | |
1809 | |
38229
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1810 Enriched mode is a minor mode (@pxref{Minor Modes}). It is |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1811 typically used in conjunction with Text mode (@pxref{Text Mode}), but |
ae24bb82158d
Get rid of inexplicable @t's in values of paragraph-start and
Richard M. Stallman <rms@gnu.org>
parents:
38134
diff
changeset
|
1812 you can also use it with other major modes such as Outline mode and |
25829 | 1813 Paragraph-Indent Text mode. |
1814 | |
30867 | 1815 @cindex text/enriched MIME format |
25829 | 1816 Potentially, Emacs can store formatted text files in various file |
1817 formats. Currently, only one format is implemented: @dfn{text/enriched} | |
1818 format, which is defined by the MIME protocol. @xref{Format | |
1819 Conversion,, Format Conversion, elisp, the Emacs Lisp Reference Manual}, | |
1820 for details of how Emacs recognizes and converts file formats. | |
1821 | |
1822 The Emacs distribution contains a formatted text file that can serve as | |
1823 an example. Its name is @file{etc/enriched.doc}. It contains samples | |
1824 illustrating all the features described in this section. It also | |
1825 contains a list of ideas for future enhancements. | |
1826 | |
1827 @menu | |
1828 * Requesting Formatted Text:: Entering and exiting Enriched mode. | |
1829 * Hard and Soft Newlines:: There are two different kinds of newlines. | |
1830 * Editing Format Info:: How to edit text properties. | |
1831 * Faces: Format Faces. Bold, italic, underline, etc. | |
1832 * Color: Format Colors. Changing the color of text. | |
1833 * Indent: Format Indentation. Changing the left and right margins. | |
1834 * Justification: Format Justification. | |
1835 Centering, setting text flush with the | |
1836 left or right margin, etc. | |
1837 * Other: Format Properties. The "special" text properties submenu. | |
1838 * Forcing Enriched Mode:: How to force use of Enriched mode. | |
1839 @end menu | |
1840 | |
1841 @node Requesting Formatted Text | |
1842 @subsection Requesting to Edit Formatted Text | |
1843 | |
46209
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1844 Whenever you visit a file that Emacs saved in the text/enriched |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1845 format, Emacs automatically converts the formatting information in the |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1846 file into Emacs's own internal format (known as @dfn{text |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1847 properties}), and turns on Enriched mode. |
25829 | 1848 |
1849 @findex enriched-mode | |
1850 To create a new file of formatted text, first visit the nonexistent | |
1851 file, then type @kbd{M-x enriched-mode} before you start inserting text. | |
1852 This command turns on Enriched mode. Do this before you begin inserting | |
1853 text, to ensure that the text you insert is handled properly. | |
1854 | |
1855 More generally, the command @code{enriched-mode} turns Enriched mode | |
1856 on if it was off, and off if it was on. With a prefix argument, this | |
1857 command turns Enriched mode on if the argument is positive, and turns | |
1858 the mode off otherwise. | |
1859 | |
1860 When you save a buffer while Enriched mode is enabled in it, Emacs | |
1861 automatically converts the text to text/enriched format while writing it | |
1862 into the file. When you visit the file again, Emacs will automatically | |
1863 recognize the format, reconvert the text, and turn on Enriched mode | |
1864 again. | |
1865 | |
1866 @vindex enriched-fill-after-visiting | |
1867 Normally, after visiting a file in text/enriched format, Emacs refills | |
1868 each paragraph to fit the specified right margin. You can turn off this | |
1869 refilling, to save time, by setting the variable | |
1870 @code{enriched-fill-after-visiting} to @code{nil} or to @code{ask}. | |
1871 | |
1872 However, when visiting a file that was saved from Enriched mode, there | |
1873 is no need for refilling, because Emacs saves the right margin settings | |
1874 along with the text. | |
1875 | |
1876 @vindex enriched-translations | |
1877 You can add annotations for saving additional text properties, which | |
1878 Emacs normally does not save, by adding to @code{enriched-translations}. | |
1879 Note that the text/enriched standard requires any non-standard | |
1880 annotations to have names starting with @samp{x-}, as in | |
1881 @samp{x-read-only}. This ensures that they will not conflict with | |
1882 standard annotations that may be added later. | |
1883 | |
46209
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1884 @xref{Text Properties,,, elisp, the Emacs Lisp Reference Manual}, |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1885 for more information about text properties. |
f80386540ed6
Doc tex-start-options and tex-start-commands
Richard M. Stallman <rms@gnu.org>
parents:
45312
diff
changeset
|
1886 |
25829 | 1887 @node Hard and Soft Newlines |
1888 @subsection Hard and Soft Newlines | |
1889 @cindex hard newline | |
1890 @cindex soft newline | |
1891 @cindex newlines, hard and soft | |
1892 | |
1893 In formatted text, Emacs distinguishes between two different kinds of | |
1894 newlines, @dfn{hard} newlines and @dfn{soft} newlines. | |
1895 | |
1896 Hard newlines are used to separate paragraphs, or items in a list, or | |
1897 anywhere that there should always be a line break regardless of the | |
1898 margins. The @key{RET} command (@code{newline}) and @kbd{C-o} | |
1899 (@code{open-line}) insert hard newlines. | |
1900 | |
1901 Soft newlines are used to make text fit between the margins. All the | |
1902 fill commands, including Auto Fill, insert soft newlines---and they | |
1903 delete only soft newlines. | |
1904 | |
1905 Although hard and soft newlines look the same, it is important to bear | |
1906 the difference in mind. Do not use @key{RET} to break lines in the | |
1907 middle of filled paragraphs, or else you will get hard newlines that are | |
1908 barriers to further filling. Instead, let Auto Fill mode break lines, | |
1909 so that if the text or the margins change, Emacs can refill the lines | |
1910 properly. @xref{Auto Fill}. | |
1911 | |
1912 On the other hand, in tables and lists, where the lines should always | |
1913 remain as you type them, you can use @key{RET} to end lines. For these | |
1914 lines, you may also want to set the justification style to | |
1915 @code{unfilled}. @xref{Format Justification}. | |
1916 | |
1917 @node Editing Format Info | |
1918 @subsection Editing Format Information | |
1919 | |
1920 There are two ways to alter the formatting information for a formatted | |
1921 text file: with keyboard commands, and with the mouse. | |
1922 | |
40764
d2264ed210a7
Along with Text Properties menu, mention keyboard commands
Richard M. Stallman <rms@gnu.org>
parents:
40651
diff
changeset
|
1923 The easiest way to add properties to your document is with the Text |
25829 | 1924 Properties menu. You can get to this menu in two ways: from the Edit |
40779
a09c65c0b5e2
Minor Texinfo usage fix.
Richard M. Stallman <rms@gnu.org>
parents:
40778
diff
changeset
|
1925 menu in the menu bar (use @kbd{@key{F10} e t} if you have no mouse), |
a09c65c0b5e2
Minor Texinfo usage fix.
Richard M. Stallman <rms@gnu.org>
parents:
40778
diff
changeset
|
1926 or with @kbd{C-Mouse-2} (hold the @key{CTRL} key and press the middle |
a09c65c0b5e2
Minor Texinfo usage fix.
Richard M. Stallman <rms@gnu.org>
parents:
40778
diff
changeset
|
1927 mouse button). There are also keyboard commands described in the |
a09c65c0b5e2
Minor Texinfo usage fix.
Richard M. Stallman <rms@gnu.org>
parents:
40778
diff
changeset
|
1928 following section. |
25829 | 1929 |
1930 Most of the items in the Text Properties menu lead to other submenus. | |
1931 These are described in the sections that follow. Some items run | |
1932 commands directly: | |
1933 | |
1934 @table @code | |
40778 | 1935 @findex facemenu-remove-face-props |
1936 @item Remove Face Properties | |
25829 | 1937 Delete from the region all the text properties that the Text Properties |
40778 | 1938 menu works with (@code{facemenu-remove-face-props}). |
25829 | 1939 |
1940 @findex facemenu-remove-all | |
1941 @item Remove All | |
1942 Delete @emph{all} text properties from the region | |
1943 (@code{facemenu-remove-all}). | |
1944 | |
44679
c44f2c24d43c
Document describe-text-at, not list-text-properties-at.
Richard M. Stallman <rms@gnu.org>
parents:
40779
diff
changeset
|
1945 @findex describe-text-at |
45312
2928a834a4d7
(Editing Format Info): Add index entries for text properties at point.
Eli Zaretskii <eliz@gnu.org>
parents:
44679
diff
changeset
|
1946 @cindex text properties of characters |
2928a834a4d7
(Editing Format Info): Add index entries for text properties at point.
Eli Zaretskii <eliz@gnu.org>
parents:
44679
diff
changeset
|
1947 @cindex overlays at character position |
2928a834a4d7
(Editing Format Info): Add index entries for text properties at point.
Eli Zaretskii <eliz@gnu.org>
parents:
44679
diff
changeset
|
1948 @cindex widgets at buffer position |
2928a834a4d7
(Editing Format Info): Add index entries for text properties at point.
Eli Zaretskii <eliz@gnu.org>
parents:
44679
diff
changeset
|
1949 @cindex buttons at buffer position |
44679
c44f2c24d43c
Document describe-text-at, not list-text-properties-at.
Richard M. Stallman <rms@gnu.org>
parents:
40779
diff
changeset
|
1950 @item Describe Text |
45312
2928a834a4d7
(Editing Format Info): Add index entries for text properties at point.
Eli Zaretskii <eliz@gnu.org>
parents:
44679
diff
changeset
|
1951 List all the text properties, widgets, buttons, and overlays of the |
2928a834a4d7
(Editing Format Info): Add index entries for text properties at point.
Eli Zaretskii <eliz@gnu.org>
parents:
44679
diff
changeset
|
1952 character following point (@code{describe-text-at}). |
25829 | 1953 |
1954 @item Display Faces | |
40778 | 1955 Display a list of all the defined faces (@code{list-faces-display}). |
25829 | 1956 |
1957 @item Display Colors | |
40778 | 1958 Display a list of all the defined colors (@code{list-colors-display}). |
25829 | 1959 @end table |
45312
2928a834a4d7
(Editing Format Info): Add index entries for text properties at point.
Eli Zaretskii <eliz@gnu.org>
parents:
44679
diff
changeset
|
1960 |
25829 | 1961 @node Format Faces |
1962 @subsection Faces in Formatted Text | |
1963 | |
1964 The Faces submenu lists various Emacs faces including @code{bold}, | |
1965 @code{italic}, and @code{underline}. Selecting one of these adds the | |
1966 chosen face to the region. @xref{Faces}. You can also specify a face | |
1967 with these keyboard commands: | |
1968 | |
1969 @table @kbd | |
1970 @kindex M-g d @r{(Enriched mode)} | |
1971 @findex facemenu-set-default | |
1972 @item M-g d | |
1973 Set the region, or the next inserted character, to the @code{default} face | |
1974 (@code{facemenu-set-default}). | |
1975 @kindex M-g b @r{(Enriched mode)} | |
1976 @findex facemenu-set-bold | |
1977 @item M-g b | |
1978 Set the region, or the next inserted character, to the @code{bold} face | |
1979 (@code{facemenu-set-bold}). | |
1980 @kindex M-g i @r{(Enriched mode)} | |
1981 @findex facemenu-set-italic | |
1982 @item M-g i | |
1983 Set the region, or the next inserted character, to the @code{italic} face | |
1984 (@code{facemenu-set-italic}). | |
1985 @kindex M-g l @r{(Enriched mode)} | |
1986 @findex facemenu-set-bold-italic | |
1987 @item M-g l | |
1988 Set the region, or the next inserted character, to the @code{bold-italic} face | |
1989 (@code{facemenu-set-bold-italic}). | |
1990 @kindex M-g u @r{(Enriched mode)} | |
1991 @findex facemenu-set-underline | |
1992 @item M-g u | |
1993 Set the region, or the next inserted character, to the @code{underline} face | |
1994 (@code{facemenu-set-underline}). | |
1995 @kindex M-g o @r{(Enriched mode)} | |
1996 @findex facemenu-set-face | |
1997 @item M-g o @var{face} @key{RET} | |
1998 Set the region, or the next inserted character, to the face @var{face} | |
1999 (@code{facemenu-set-face}). | |
2000 @end table | |
2001 | |
2002 If you use these commands with a prefix argument---or, in Transient Mark | |
2003 mode, if the region is not active---then these commands specify a face | |
2004 to use for your next self-inserting input. @xref{Transient Mark}. This | |
2005 applies to both the keyboard commands and the menu commands. | |
2006 | |
2007 Enriched mode defines two additional faces: @code{excerpt} and | |
2008 @code{fixed}. These correspond to codes used in the text/enriched file | |
2009 format. | |
2010 | |
2011 The @code{excerpt} face is intended for quotations. This face is the | |
2012 same as @code{italic} unless you customize it (@pxref{Face Customization}). | |
2013 | |
36790
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2014 The @code{fixed} face means, ``Use a fixed-width font for this part |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2015 of the text.'' This makes a visible difference only if you have |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2016 specified a variable-width font in the default face; however, even if |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2017 the default font is fixed-width, applying the @code{fixed} face to a |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2018 part of the text will cause that part of the text to appear in a |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2019 fixed-width font, if the file is ever displayed with a variable-width |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2020 default font. This applies to Emacs and to other systems that display |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2021 text/enriched format. So if you specifically want a certain part of |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2022 the text to use a fixed-width font, you should specify the |
25829 | 2023 @code{fixed} face for that part. |
2024 | |
36790
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2025 The @code{fixed} face is normally set up to use a different font |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2026 from the default, even if the default face is also fixed-width. |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2027 Different systems have different fonts installed, so you may need to |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2028 customize this. @xref{Face Customization}. |
25829 | 2029 |
36790
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2030 If your terminal cannot display different faces, you will not be |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2031 able to see them, but you can still edit documents containing faces, |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2032 and even add faces and colors to documents. The faces you specify |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2033 will be visible when the file is viewed on a terminal that can display |
d91ec7a1c11e
Format Faces: Update info on `fixed' face
Richard M. Stallman <rms@gnu.org>
parents:
36299
diff
changeset
|
2034 them. |
25829 | 2035 |
2036 @node Format Colors | |
2037 @subsection Colors in Formatted Text | |
2038 | |
2039 You can specify foreground and background colors for portions of the | |
2040 text. There is a menu for specifying the foreground color and a menu | |
2041 for specifying the background color. Each color menu lists all the | |
2042 colors that you have used in Enriched mode in the current Emacs session. | |
2043 | |
2044 If you specify a color with a prefix argument---or, in Transient Mark | |
2045 mode, if the region is not active---then it applies to your next | |
2046 self-inserting input. @xref{Transient Mark}. Otherwise, the command | |
2047 applies to the region. | |
2048 | |
2049 Each color menu contains one additional item: @samp{Other}. You can use | |
2050 this item to specify a color that is not listed in the menu; it reads | |
2051 the color name with the minibuffer. To display list of available colors | |
2052 and their names, use the @samp{Display Colors} menu item in the Text | |
2053 Properties menu (@pxref{Editing Format Info}). | |
2054 | |
2055 Any color that you specify in this way, or that is mentioned in a | |
2056 formatted text file that you read in, is added to both color menus for | |
2057 the duration of the Emacs session. | |
2058 | |
2059 @findex facemenu-set-foreground | |
2060 @findex facemenu-set-background | |
2061 There are no key bindings for specifying colors, but you can do so | |
2062 with the extended commands @kbd{M-x facemenu-set-foreground} and | |
2063 @kbd{M-x facemenu-set-background}. Both of these commands read the name | |
2064 of the color with the minibuffer. | |
2065 | |
2066 @node Format Indentation | |
2067 @subsection Indentation in Formatted Text | |
2068 | |
2069 When editing formatted text, you can specify different amounts of | |
2070 indentation for the right or left margin of an entire paragraph or a | |
2071 part of a paragraph. The margins you specify automatically affect the | |
2072 Emacs fill commands (@pxref{Filling}) and line-breaking commands. | |
2073 | |
2074 The Indentation submenu provides a convenient interface for specifying | |
2075 these properties. The submenu contains four items: | |
2076 | |
2077 @table @code | |
2078 @kindex C-x TAB @r{(Enriched mode)} | |
2079 @findex increase-left-margin | |
2080 @item Indent More | |
2081 Indent the region by 4 columns (@code{increase-left-margin}). In | |
2082 Enriched mode, this command is also available on @kbd{C-x @key{TAB}}; if | |
2083 you supply a numeric argument, that says how many columns to add to the | |
2084 margin (a negative argument reduces the number of columns). | |
2085 | |
2086 @item Indent Less | |
2087 Remove 4 columns of indentation from the region. | |
2088 | |
2089 @item Indent Right More | |
2090 Make the text narrower by indenting 4 columns at the right margin. | |
2091 | |
2092 @item Indent Right Less | |
2093 Remove 4 columns of indentation from the right margin. | |
2094 @end table | |
2095 | |
2096 You can use these commands repeatedly to increase or decrease the | |
2097 indentation. | |
2098 | |
2099 The most common way to use these commands is to change the indentation | |
2100 of an entire paragraph. However, that is not the only use. You can | |
2101 change the margins at any point; the new values take effect at the end | |
2102 of the line (for right margins) or the beginning of the next line (for | |
2103 left margins). | |
2104 | |
2105 This makes it possible to format paragraphs with @dfn{hanging indents}, | |
2106 which means that the first line is indented less than subsequent lines. | |
2107 To set up a hanging indent, increase the indentation of the region | |
2108 starting after the first word of the paragraph and running until the end | |
2109 of the paragraph. | |
2110 | |
2111 Indenting the first line of a paragraph is easier. Set the margin for | |
2112 the whole paragraph where you want it to be for the body of the | |
2113 paragraph, then indent the first line by inserting extra spaces or tabs. | |
2114 | |
2115 Sometimes, as a result of editing, the filling of a paragraph becomes | |
2116 messed up---parts of the paragraph may extend past the left or right | |
2117 margins. When this happens, use @kbd{M-q} (@code{fill-paragraph}) to | |
2118 refill the paragraph. | |
2119 | |
2120 @vindex standard-indent | |
2121 The variable @code{standard-indent} specifies how many columns these | |
2122 commands should add to or subtract from the indentation. The default | |
2123 value is 4. The overall default right margin for Enriched mode is | |
2124 controlled by the variable @code{fill-column}, as usual. | |
2125 | |
2126 The fill prefix, if any, works in addition to the specified paragraph | |
2127 indentation: @kbd{C-x .} does not include the specified indentation's | |
2128 whitespace in the new value for the fill prefix, and the fill commands | |
2129 look for the fill prefix after the indentation on each line. @xref{Fill | |
2130 Prefix}. | |
2131 | |
2132 @node Format Justification | |
2133 @subsection Justification in Formatted Text | |
2134 | |
2135 When editing formatted text, you can specify various styles of | |
2136 justification for a paragraph. The style you specify automatically | |
2137 affects the Emacs fill commands. | |
2138 | |
2139 The Justification submenu provides a convenient interface for specifying | |
2140 the style. The submenu contains five items: | |
2141 | |
2142 @table @code | |
2143 @item Flush Left | |
2144 This is the most common style of justification (at least for English). | |
2145 Lines are aligned at the left margin but left uneven at the right. | |
2146 | |
2147 @item Flush Right | |
2148 This aligns each line with the right margin. Spaces and tabs are added | |
2149 on the left, if necessary, to make lines line up on the right. | |
2150 | |
2151 @item Full | |
2152 This justifies the text, aligning both edges of each line. Justified | |
2153 text looks very nice in a printed book, where the spaces can all be | |
2154 adjusted equally, but it does not look as nice with a fixed-width font | |
2155 on the screen. Perhaps a future version of Emacs will be able to adjust | |
2156 the width of spaces in a line to achieve elegant justification. | |
2157 | |
2158 @item Center | |
2159 This centers every line between the current margins. | |
2160 | |
2161 @item None | |
2162 This turns off filling entirely. Each line will remain as you wrote it; | |
2163 the fill and auto-fill functions will have no effect on text which has | |
2164 this setting. You can, however, still indent the left margin. In | |
2165 unfilled regions, all newlines are treated as hard newlines (@pxref{Hard | |
2166 and Soft Newlines}) . | |
2167 @end table | |
2168 | |
2169 In Enriched mode, you can also specify justification from the keyboard | |
2170 using the @kbd{M-j} prefix character: | |
2171 | |
2172 @table @kbd | |
2173 @kindex M-j l @r{(Enriched mode)} | |
2174 @findex set-justification-left | |
2175 @item M-j l | |
2176 Make the region left-filled (@code{set-justification-left}). | |
2177 @kindex M-j r @r{(Enriched mode)} | |
2178 @findex set-justification-right | |
2179 @item M-j r | |
2180 Make the region right-filled (@code{set-justification-right}). | |
2181 @kindex M-j f @r{(Enriched mode)} | |
2182 @findex set-justification-full | |
2183 @item M-j f | |
2184 Make the region fully-justified (@code{set-justification-full}). | |
2185 @kindex M-j c @r{(Enriched mode)} | |
2186 @kindex M-S @r{(Enriched mode)} | |
2187 @findex set-justification-center | |
2188 @item M-j c | |
2189 @itemx M-S | |
2190 Make the region centered (@code{set-justification-center}). | |
2191 @kindex M-j u @r{(Enriched mode)} | |
2192 @findex set-justification-none | |
2193 @item M-j u | |
2194 Make the region unfilled (@code{set-justification-none}). | |
2195 @end table | |
2196 | |
2197 Justification styles apply to entire paragraphs. All the | |
2198 justification-changing commands operate on the paragraph containing | |
2199 point, or, if the region is active, on all paragraphs which overlap the | |
2200 region. | |
2201 | |
2202 @vindex default-justification | |
2203 The default justification style is specified by the variable | |
2204 @code{default-justification}. Its value should be one of the symbols | |
2205 @code{left}, @code{right}, @code{full}, @code{center}, or @code{none}. | |
2206 | |
2207 @node Format Properties | |
2208 @subsection Setting Other Text Properties | |
2209 | |
2210 The Other Properties menu lets you add or remove three other useful text | |
2211 properties: @code{read-only}, @code{invisible} and @code{intangible}. | |
2212 The @code{intangible} property disallows moving point within the text, | |
2213 the @code{invisible} text property hides text from display, and the | |
2214 @code{read-only} property disallows alteration of the text. | |
2215 | |
2216 Each of these special properties has a menu item to add it to the | |
2217 region. The last menu item, @samp{Remove Special}, removes all of these | |
2218 special properties from the text in the region. | |
2219 | |
2220 Currently, the @code{invisible} and @code{intangible} properties are | |
2221 @emph{not} saved in the text/enriched format. The @code{read-only} | |
2222 property is saved, but it is not a standard part of the text/enriched | |
2223 format, so other editors may not respect it. | |
2224 | |
2225 @node Forcing Enriched Mode | |
2226 @subsection Forcing Enriched Mode | |
2227 | |
2228 Normally, Emacs knows when you are editing formatted text because it | |
2229 recognizes the special annotations used in the file that you visited. | |
2230 However, there are situations in which you must take special actions | |
2231 to convert file contents or turn on Enriched mode: | |
2232 | |
2233 @itemize @bullet | |
2234 @item | |
2235 When you visit a file that was created with some other editor, Emacs may | |
2236 not recognize the file as being in the text/enriched format. In this | |
2237 case, when you visit the file you will see the formatting commands | |
2238 rather than the formatted text. Type @kbd{M-x format-decode-buffer} to | |
2239 translate it. | |
2240 | |
2241 @item | |
2242 When you @emph{insert} a file into a buffer, rather than visiting it. | |
2243 Emacs does the necessary conversions on the text which you insert, but | |
2244 it does not enable Enriched mode. If you wish to do that, type @kbd{M-x | |
2245 enriched-mode}. | |
2246 @end itemize | |
2247 | |
2248 The command @code{format-decode-buffer} translates text in various | |
2249 formats into Emacs's internal format. It asks you to specify the format | |
2250 to translate from; however, normally you can type just @key{RET}, which | |
2251 tells Emacs to guess the format. | |
2252 | |
2253 @findex format-find-file | |
2254 If you wish to look at text/enriched file in its raw form, as a | |
2255 sequence of characters rather than as formatted text, use the @kbd{M-x | |
2256 find-file-literally} command. This visits a file, like | |
2257 @code{find-file}, but does not do format conversion. It also inhibits | |
2258 character code conversion (@pxref{Coding Systems}) and automatic | |
2259 uncompression (@pxref{Compressed Files}). To disable format conversion | |
2260 but allow character code conversion and/or automatic uncompression if | |
2261 appropriate, use @code{format-find-file} with suitable arguments. | |
2262 |