Mercurial > emacs
annotate man/misc.texi @ 71879:d236eeffa8f7
*** empty log message ***
author | Kim F. Storm <storm@cua.dk> |
---|---|
date | Thu, 13 Jul 2006 22:52:49 +0000 |
parents | d3243ee91ba0 |
children | c7e4f78b81a6 8a8e69664178 |
rev | line source |
---|---|
25829 | 1 @c This is part of the Emacs manual. |
62473
ee50af163f00
(Emacs Server): Add menu description.
Lute Kamstra <lute@gnu.org>
parents:
61880
diff
changeset
|
2 @c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 2000, 2001, |
68639
dc2d5a6655a3
Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
68546
diff
changeset
|
3 @c 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc. |
25829 | 4 @c See file emacs.texi for copying conditions. |
5 @iftex | |
6 @chapter Miscellaneous Commands | |
7 | |
8 This chapter contains several brief topics that do not fit anywhere | |
9 else: reading netnews, running shell commands and shell subprocesses, | |
10 using a single shared Emacs for utilities that expect to run an editor | |
11 as a subprocess, printing hardcopy, sorting text, narrowing display to | |
69737 | 12 part of the buffer, editing double-column files and binary files, |
13 saving an Emacs session for later resumption, following hyperlinks, | |
14 browsing images, emulating other editors, and various diversions and | |
15 amusements. | |
25829 | 16 |
17 @end iftex | |
56807
d2c0e48f4d5a
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
56222
diff
changeset
|
18 |
d2c0e48f4d5a
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
56222
diff
changeset
|
19 @ifnottex |
d2c0e48f4d5a
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
56222
diff
changeset
|
20 @raisesections |
d2c0e48f4d5a
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
56222
diff
changeset
|
21 @end ifnottex |
d2c0e48f4d5a
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
56222
diff
changeset
|
22 |
25829 | 23 @node Gnus, Shell, Calendar/Diary, Top |
24 @section Gnus | |
25 @cindex Gnus | |
26 @cindex reading netnews | |
27 | |
28 Gnus is an Emacs package primarily designed for reading and posting | |
29 Usenet news. It can also be used to read and respond to messages from a | |
30 number of other sources---mail, remote directories, digests, and so on. | |
31 | |
32 Here we introduce Gnus and describe several basic features. | |
70752
a262d4625442
(Gnus, Where to Look, PostScript): ifinfo -> ifnottex.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70485
diff
changeset
|
33 @ifnottex |
25829 | 34 For full details, see @ref{Top, Gnus,, gnus, The Gnus Manual}. |
70752
a262d4625442
(Gnus, Where to Look, PostScript): ifinfo -> ifnottex.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70485
diff
changeset
|
35 @end ifnottex |
25829 | 36 @iftex |
37 For full details on Gnus, type @kbd{M-x info} and then select the Gnus | |
38 manual. | |
39 @end iftex | |
40 | |
41 @findex gnus | |
42 To start Gnus, type @kbd{M-x gnus @key{RET}}. | |
43 | |
44 @menu | |
45 * Buffers of Gnus:: The group, summary, and article buffers. | |
46 * Gnus Startup:: What you should know about starting Gnus. | |
47 * Summary of Gnus:: A short description of the basic Gnus commands. | |
48 @end menu | |
49 | |
50 @node Buffers of Gnus | |
51 @subsection Gnus Buffers | |
52 | |
69737 | 53 Unlike most Emacs packages, Gnus uses several buffers to display |
54 information and to receive commands. The three Gnus buffers users use | |
55 most are the @dfn{group buffer}, the @dfn{summary buffer} and the | |
56 @dfn{article buffer}. | |
57 | |
58 The @dfn{group buffer} contains a list of newsgroups. This is the | |
59 first buffer Gnus displays when it starts up. It normally displays | |
60 only the groups to which you subscribe and that contain unread | |
61 articles. Use this buffer to select a specific group. | |
25829 | 62 |
63 The @dfn{summary buffer} lists one line for each article in a single | |
64 group. By default, the author, the subject and the line number are | |
65 displayed for each article, but this is customizable, like most aspects | |
66 of Gnus display. The summary buffer is created when you select a group | |
67 in the group buffer, and is killed when you exit the group. Use this | |
68 buffer to select an article. | |
69 | |
70 The @dfn{article buffer} displays the article. In normal Gnus usage, | |
69737 | 71 you see this buffer but you don't select it---all useful |
72 article-oriented commands work in the summary buffer. But you can | |
73 select the article buffer, and execute all Gnus commands from that | |
74 buffer, if you want to. | |
25829 | 75 |
76 @node Gnus Startup | |
77 @subsection When Gnus Starts Up | |
78 | |
79 At startup, Gnus reads your @file{.newsrc} news initialization file | |
80 and attempts to communicate with the local news server, which is a | |
81 repository of news articles. The news server need not be the same | |
82 computer you are logged in on. | |
83 | |
84 If you start Gnus and connect to the server, but do not see any | |
85 newsgroups listed in the group buffer, type @kbd{L} or @kbd{A k} to get | |
86 a listing of all the groups. Then type @kbd{u} to toggle | |
87 subscription to groups. | |
88 | |
89 The first time you start Gnus, Gnus subscribes you to a few selected | |
90 groups. All other groups start out as @dfn{killed groups} for you; you | |
91 can list them with @kbd{A k}. All new groups that subsequently come to | |
92 exist at the news server become @dfn{zombie groups} for you; type @kbd{A | |
93 z} to list them. You can subscribe to a group shown in these lists | |
94 using the @kbd{u} command. | |
95 | |
96 When you quit Gnus with @kbd{q}, it automatically records in your | |
97 @file{.newsrc} and @file{.newsrc.eld} initialization files the | |
98 subscribed or unsubscribed status of all groups. You should normally | |
99 not edit these files manually, but you may if you know how. | |
100 | |
101 @node Summary of Gnus | |
102 @subsection Summary of Gnus Commands | |
103 | |
38599
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
104 Reading news is a two-step process: |
25829 | 105 |
106 @enumerate | |
107 @item | |
108 Choose a group in the group buffer. | |
109 | |
110 @item | |
111 Select articles from the summary buffer. Each article selected is | |
112 displayed in the article buffer in a large window, below the summary | |
113 buffer in its small window. | |
114 @end enumerate | |
115 | |
69737 | 116 Each Gnus buffer has its own special commands; the meanings of any |
117 given key in the various Gnus buffers are usually analogous, even if | |
118 not identical. Here are commands for the group and summary buffers: | |
25829 | 119 |
120 @table @kbd | |
121 @kindex q @r{(Gnus Group mode)} | |
122 @findex gnus-group-exit | |
123 @item q | |
124 In the group buffer, update your @file{.newsrc} initialization file | |
125 and quit Gnus. | |
126 | |
127 In the summary buffer, exit the current group and return to the | |
128 group buffer. Thus, typing @kbd{q} twice quits Gnus. | |
129 | |
130 @kindex L @r{(Gnus Group mode)} | |
131 @findex gnus-group-list-all-groups | |
132 @item L | |
133 In the group buffer, list all the groups available on your news | |
134 server (except those you have killed). This may be a long list! | |
135 | |
136 @kindex l @r{(Gnus Group mode)} | |
137 @findex gnus-group-list-groups | |
138 @item l | |
139 In the group buffer, list only the groups to which you subscribe and | |
140 which contain unread articles. | |
141 | |
142 @kindex u @r{(Gnus Group mode)} | |
143 @findex gnus-group-unsubscribe-current-group | |
144 @cindex subscribe groups | |
145 @cindex unsubscribe groups | |
146 @item u | |
147 In the group buffer, unsubscribe from (or subscribe to) the group listed | |
148 in the line that point is on. When you quit Gnus by typing @kbd{q}, | |
149 Gnus lists in your @file{.newsrc} file which groups you have subscribed | |
150 to. The next time you start Gnus, you won't see this group, | |
151 because Gnus normally displays only subscribed-to groups. | |
152 | |
153 @kindex C-k @r{(Gnus)} | |
154 @findex gnus-group-kill-group | |
155 @item C-k | |
156 In the group buffer, ``kill'' the current line's group---don't | |
157 even list it in @file{.newsrc} from now on. This affects future | |
158 Gnus sessions as well as the present session. | |
159 | |
160 When you quit Gnus by typing @kbd{q}, Gnus writes information | |
161 in the file @file{.newsrc} describing all newsgroups except those you | |
162 have ``killed.'' | |
163 | |
164 @kindex SPC @r{(Gnus)} | |
165 @findex gnus-group-read-group | |
166 @item @key{SPC} | |
167 In the group buffer, select the group on the line under the cursor | |
168 and display the first unread article in that group. | |
169 | |
170 @need 1000 | |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47650
diff
changeset
|
171 In the summary buffer, |
25829 | 172 |
173 @itemize @bullet | |
174 @item | |
175 Select the article on the line under the cursor if none is selected. | |
176 | |
177 @item | |
178 Scroll the text of the selected article (if there is one). | |
179 | |
180 @item | |
181 Select the next unread article if at the end of the current article. | |
182 @end itemize | |
183 | |
184 Thus, you can move through all the articles by repeatedly typing @key{SPC}. | |
185 | |
186 @kindex DEL @r{(Gnus)} | |
187 @item @key{DEL} | |
188 In the group buffer, move point to the previous group containing | |
189 unread articles. | |
190 | |
191 @findex gnus-summary-prev-page | |
192 In the summary buffer, scroll the text of the article backwards. | |
193 | |
194 @kindex n @r{(Gnus)} | |
195 @findex gnus-group-next-unread-group | |
196 @findex gnus-summary-next-unread-article | |
197 @item n | |
198 Move point to the next unread group, or select the next unread article. | |
199 | |
200 @kindex p @r{(Gnus)} | |
201 @findex gnus-group-prev-unread-group | |
202 @findex gnus-summary-prev-unread-article | |
203 @item p | |
204 Move point to the previous unread group, or select the previous | |
205 unread article. | |
206 | |
207 @kindex C-n @r{(Gnus Group mode)} | |
208 @findex gnus-group-next-group | |
209 @kindex C-p @r{(Gnus Group mode)} | |
210 @findex gnus-group-prev-group | |
211 @kindex C-n @r{(Gnus Summary mode)} | |
212 @findex gnus-summary-next-subject | |
213 @kindex C-p @r{(Gnus Summary mode)} | |
214 @findex gnus-summary-prev-subject | |
215 @item C-n | |
216 @itemx C-p | |
217 Move point to the next or previous item, even if it is marked as read. | |
218 This does not select the article or group on that line. | |
219 | |
220 @kindex s @r{(Gnus Summary mode)} | |
221 @findex gnus-summary-isearch-article | |
222 @item s | |
223 In the summary buffer, do an incremental search of the current text in | |
224 the article buffer, just as if you switched to the article buffer and | |
225 typed @kbd{C-s}. | |
226 | |
227 @kindex M-s @r{(Gnus Summary mode)} | |
228 @findex gnus-summary-search-article-forward | |
229 @item M-s @var{regexp} @key{RET} | |
230 In the summary buffer, search forward for articles containing a match | |
231 for @var{regexp}. | |
232 | |
233 @end table | |
234 | |
235 @ignore | |
236 @node Where to Look | |
237 @subsection Where to Look Further | |
238 | |
239 @c Too many references to the name of the manual if done with xref in TeX! | |
240 Gnus is powerful and customizable. Here are references to a few | |
70752
a262d4625442
(Gnus, Where to Look, PostScript): ifinfo -> ifnottex.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70485
diff
changeset
|
241 @ifnottex |
25829 | 242 additional topics: |
243 | |
70752
a262d4625442
(Gnus, Where to Look, PostScript): ifinfo -> ifnottex.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70485
diff
changeset
|
244 @end ifnottex |
25829 | 245 @iftex |
246 additional topics in @cite{The Gnus Manual}: | |
247 | |
248 @itemize @bullet | |
249 @item | |
250 Follow discussions on specific topics.@* | |
251 See section ``Threading.'' | |
252 | |
253 @item | |
254 Read digests. See section ``Document Groups.'' | |
255 | |
256 @item | |
257 Refer to and jump to the parent of the current article.@* | |
258 See section ``Finding the Parent.'' | |
259 | |
260 @item | |
261 Refer to articles by using Message-IDs included in the messages.@* | |
262 See section ``Article Keymap.'' | |
263 | |
264 @item | |
265 Save articles. See section ``Saving Articles.'' | |
266 | |
267 @item | |
268 Have Gnus score articles according to various criteria, like author | |
269 name, subject, or string in the body of the articles.@* | |
270 See section ``Scoring.'' | |
271 | |
272 @item | |
273 Send an article to a newsgroup.@* | |
274 See section ``Composing Messages.'' | |
275 @end itemize | |
276 @end iftex | |
70752
a262d4625442
(Gnus, Where to Look, PostScript): ifinfo -> ifnottex.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70485
diff
changeset
|
277 @ifnottex |
25829 | 278 @itemize @bullet |
279 @item | |
280 Follow discussions on specific topics.@* | |
281 @xref{Threading, , Reading Based on Conversation Threads, | |
282 gnus, The Gnus Manual}. | |
283 | |
284 @item | |
285 Read digests. @xref{Document Groups, , , gnus, The Gnus Manual}. | |
286 | |
287 @item | |
288 Refer to and jump to the parent of the current article.@* | |
289 @xref{Finding the Parent, , , gnus, The Gnus Manual}. | |
290 | |
291 @item | |
292 Refer to articles by using Message-IDs included in the messages.@* | |
293 @xref{Article Keymap, , , gnus, The Gnus Manual}. | |
294 | |
295 @item | |
296 Save articles. @xref{Saving Articles, , , gnus, The Gnus Manual}. | |
297 | |
298 @item | |
299 Have Gnus score articles according to various criteria, like author | |
300 name, subject, or string in the body of the articles.@* | |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47650
diff
changeset
|
301 @xref{Scoring, , , gnus, The Gnus Manual}. |
25829 | 302 |
303 @item | |
304 Send an article to a newsgroup.@* | |
305 @xref{Composing Messages, , , gnus, The Gnus Manual}. | |
306 @end itemize | |
70752
a262d4625442
(Gnus, Where to Look, PostScript): ifinfo -> ifnottex.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70485
diff
changeset
|
307 @end ifnottex |
25829 | 308 @end ignore |
309 | |
310 @node Shell, Emacs Server, Gnus, Top | |
311 @section Running Shell Commands from Emacs | |
312 @cindex subshell | |
313 @cindex shell commands | |
314 | |
315 Emacs has commands for passing single command lines to inferior shell | |
33382 | 316 processes; it can also run a shell interactively with input and output |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
317 to an Emacs buffer named @samp{*shell*} or run a shell inside a terminal |
33382 | 318 emulator window. |
319 | |
25829 | 320 @table @kbd |
321 @item M-! @var{cmd} @key{RET} | |
322 Run the shell command line @var{cmd} and display the output | |
323 (@code{shell-command}). | |
324 @item M-| @var{cmd} @key{RET} | |
325 Run the shell command line @var{cmd} with region contents as input; | |
326 optionally replace the region with the output | |
327 (@code{shell-command-on-region}). | |
328 @item M-x shell | |
329 Run a subshell with input and output through an Emacs buffer. | |
330 You can then give commands interactively. | |
27210 | 331 @item M-x term |
332 Run a subshell with input and output through an Emacs buffer. | |
333 You can then give commands interactively. | |
334 Full terminal emulation is available. | |
25829 | 335 @end table |
336 | |
69737 | 337 @kbd{M-x eshell} invokes a shell implemented entirely in Emacs. It |
338 is documented in a separate manual. @xref{Top,Eshell,Eshell, eshell, | |
339 Eshell: The Emacs Shell}. | |
340 | |
25829 | 341 @menu |
342 * Single Shell:: How to run one shell command and return. | |
343 * Interactive Shell:: Permanent shell taking input via Emacs. | |
344 * Shell Mode:: Special Emacs commands used with permanent shell. | |
61880
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
345 * Shell Prompts:: Two ways to recognize shell prompts. |
25829 | 346 * History: Shell History. Repeating previous commands in a shell buffer. |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
347 * Directory Tracking:: Keeping track when the subshell changes directory. |
25829 | 348 * Options: Shell Options. Options for customizing Shell mode. |
27210 | 349 * Terminal emulator:: An Emacs window as a terminal emulator. |
350 * Term Mode:: Special Emacs commands used in Term mode. | |
351 * Paging in Term:: Paging in the terminal emulator. | |
25829 | 352 * Remote Host:: Connecting to another computer. |
353 @end menu | |
354 | |
355 @node Single Shell | |
356 @subsection Single Shell Commands | |
357 | |
358 @kindex M-! | |
359 @findex shell-command | |
360 @kbd{M-!} (@code{shell-command}) reads a line of text using the | |
361 minibuffer and executes it as a shell command in a subshell made just | |
362 for that command. Standard input for the command comes from the null | |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
363 device. If the shell command produces any output, the output appears |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
364 either in the echo area (if it is short), or in an Emacs buffer named |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
365 @samp{*Shell Command Output*}, which is displayed in another window |
38132
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
366 but not selected (if the output is long). |
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
367 |
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
368 For instance, one way to decompress a file @file{foo.gz} from Emacs |
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
369 is to type @kbd{M-! gunzip foo.gz @key{RET}}. That shell command |
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
370 normally creates the file @file{foo} and produces no terminal output. |
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
371 |
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
372 A numeric argument, as in @kbd{M-1 M-!}, says to insert terminal |
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
373 output into the current buffer instead of a separate buffer. It puts |
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
374 point before the output, and sets the mark after the output. For |
38786 | 375 instance, @kbd{M-1 M-! gunzip < foo.gz @key{RET}} would insert the |
38132
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
376 uncompressed equivalent of @file{foo.gz} into the current buffer. |
25829 | 377 |
378 If the shell command line ends in @samp{&}, it runs asynchronously. | |
379 For a synchronous shell command, @code{shell-command} returns the | |
380 command's exit status (0 means success), when it is called from a Lisp | |
38132
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
381 program. You do not get any status information for an asynchronous |
69737 | 382 command, since it hasn't finished yet when @code{shell-command} returns. |
25829 | 383 |
384 @kindex M-| | |
385 @findex shell-command-on-region | |
386 @kbd{M-|} (@code{shell-command-on-region}) is like @kbd{M-!} but | |
387 passes the contents of the region as the standard input to the shell | |
69737 | 388 command, instead of no input. With a numeric argument, meaning insert |
389 the output in the current buffer, it deletes the old region and the | |
390 output replaces it as the contents of the region. It returns the | |
391 command's exit status, like @kbd{M-!}. | |
25829 | 392 |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
393 One use for @kbd{M-|} is to run @code{gpg} to see what keys are in |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
394 the buffer. For instance, if the buffer contains a GPG key, type |
69737 | 395 @kbd{C-x h M-| gpg @key{RET}} to feed the entire buffer contents to |
396 the @code{gpg} program. That program will ignore everything except | |
397 the encoded keys, and will output a list of the keys the buffer | |
398 contains. | |
38132
1471b85b3b80
Give examples for M-! and M-|.
Richard M. Stallman <rms@gnu.org>
parents:
38025
diff
changeset
|
399 |
25829 | 400 @vindex shell-file-name |
69737 | 401 Both @kbd{M-!} and @kbd{M-|} use @code{shell-file-name} to specify |
402 the shell to use. This variable is initialized based on your | |
403 @env{SHELL} environment variable when Emacs is started. If the file | |
404 name is relative, Emacs searches the directories in the list | |
405 @code{exec-path}; this list is initialized based on the environment | |
406 variable @env{PATH} when Emacs is started. Your @file{.emacs} file | |
407 can override either or both of these default initializations. | |
25829 | 408 |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
409 Both @kbd{M-!} and @kbd{M-|} wait for the shell command to complete, |
61880
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
410 unless you end the command with @samp{&} to make it asynchronous. To |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
411 stop waiting, type @kbd{C-g} to quit; that terminates the shell |
25829 | 412 command with the signal @code{SIGINT}---the same signal that @kbd{C-c} |
69737 | 413 normally generates in the shell. Emacs then waits until the command |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
414 actually terminates. If the shell command doesn't stop (because it |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
415 ignores the @code{SIGINT} signal), type @kbd{C-g} again; this sends |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
416 the command a @code{SIGKILL} signal which is impossible to ignore. |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
417 |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
418 Asynchronous commands ending in @samp{&} feed their output into |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
419 the buffer @samp{*Async Shell Command*}. Output arrives in that |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
420 buffer regardless of whether it is visible in a window. |
25829 | 421 |
422 To specify a coding system for @kbd{M-!} or @kbd{M-|}, use the command | |
68546
1a876a016f0a
(Single Shell, Interactive Shell): Fix xrefs.
Richard M. Stallman <rms@gnu.org>
parents:
66783
diff
changeset
|
423 @kbd{C-x @key{RET} c} immediately beforehand. @xref{Communication Coding}. |
25829 | 424 |
425 @vindex shell-command-default-error-buffer | |
69737 | 426 Error output from these commands is normally intermixed with the |
427 regular output. But if the variable | |
428 @code{shell-command-default-error-buffer} has a string as value, and | |
429 it's the name of a buffer, @kbd{M-!} and @kbd{M-|} insert error output | |
430 before point in that buffer. | |
25829 | 431 |
432 @node Interactive Shell | |
433 @subsection Interactive Inferior Shell | |
434 | |
435 @findex shell | |
436 To run a subshell interactively, putting its typescript in an Emacs | |
437 buffer, use @kbd{M-x shell}. This creates (or reuses) a buffer named | |
438 @samp{*shell*} and runs a subshell with input coming from and output going | |
439 to that buffer. That is to say, any ``terminal output'' from the subshell | |
440 goes into the buffer, advancing point, and any ``terminal input'' for | |
441 the subshell comes from text in the buffer. To give input to the subshell, | |
442 go to the end of the buffer and type the input, terminated by @key{RET}. | |
443 | |
444 Emacs does not wait for the subshell to do anything. You can switch | |
445 windows or buffers and edit them while the shell is waiting, or while it is | |
446 running a command. Output from the subshell waits until Emacs has time to | |
447 process it; this happens whenever Emacs is waiting for keyboard input or | |
448 for time to elapse. | |
449 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
450 @cindex @code{comint-highlight-input} face |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
451 @cindex @code{comint-highlight-prompt} face |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
452 Input lines, once you submit them, are displayed using the face |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
453 @code{comint-highlight-input}, and prompts are displayed using the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
454 face @code{comint-highlight-prompt}. This makes it easier to see |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
455 previous input lines in the buffer. @xref{Faces}. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
456 |
38786 | 457 To make multiple subshells, you can invoke @kbd{M-x shell} with a |
458 prefix argument (e.g. @kbd{C-u M-x shell}), which will read a buffer | |
459 name and create (or reuse) a subshell in that buffer. You can also | |
460 rename the @samp{*shell*} buffer using @kbd{M-x rename-uniquely}, then | |
69737 | 461 create a new @samp{*shell*} buffer using plain @kbd{M-x shell}. |
462 Subshells in different buffers run independently and in parallel. | |
25829 | 463 |
464 @vindex explicit-shell-file-name | |
38459
08aca6a91513
(Interactive Shell): Document that EMACS is only put into the shell's
Eli Zaretskii <eliz@gnu.org>
parents:
38141
diff
changeset
|
465 @cindex environment variables for subshells |
29107 | 466 @cindex @env{ESHELL} environment variable |
467 @cindex @env{SHELL} environment variable | |
25829 | 468 The file name used to load the subshell is the value of the variable |
469 @code{explicit-shell-file-name}, if that is non-@code{nil}. Otherwise, | |
29107 | 470 the environment variable @env{ESHELL} is used, or the environment |
471 variable @env{SHELL} if there is no @env{ESHELL}. If the file name | |
25829 | 472 specified is relative, the directories in the list @code{exec-path} are |
473 searched; this list is initialized based on the environment variable | |
29107 | 474 @env{PATH} when Emacs is started. Your @file{.emacs} file can override |
25829 | 475 either or both of these default initializations. |
476 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
477 Emacs sends the new shell the contents of the file |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
478 @file{~/.emacs_@var{shellname}} as input, if it exists, where |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
479 @var{shellname} is the name of the file that the shell was loaded |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
480 from. For example, if you use bash, the file sent to it is |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
481 @file{~/.emacs_bash}. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
482 |
25829 | 483 To specify a coding system for the shell, you can use the command |
69737 | 484 @kbd{C-x @key{RET} c} immediately before @kbd{M-x shell}. You can |
485 also change the coding system for a running subshell by typing | |
486 @kbd{C-x @key{RET} p} in the shell buffer. @xref{Communication | |
487 Coding}. | |
25829 | 488 |
38459
08aca6a91513
(Interactive Shell): Document that EMACS is only put into the shell's
Eli Zaretskii <eliz@gnu.org>
parents:
38141
diff
changeset
|
489 @cindex @env{EMACS} environment variable |
08aca6a91513
(Interactive Shell): Document that EMACS is only put into the shell's
Eli Zaretskii <eliz@gnu.org>
parents:
38141
diff
changeset
|
490 Unless the environment variable @env{EMACS} is already defined, |
08aca6a91513
(Interactive Shell): Document that EMACS is only put into the shell's
Eli Zaretskii <eliz@gnu.org>
parents:
38141
diff
changeset
|
491 Emacs defines it in the subshell, with value @code{t}. A shell script |
08aca6a91513
(Interactive Shell): Document that EMACS is only put into the shell's
Eli Zaretskii <eliz@gnu.org>
parents:
38141
diff
changeset
|
492 can check this variable to determine whether it has been run from an |
08aca6a91513
(Interactive Shell): Document that EMACS is only put into the shell's
Eli Zaretskii <eliz@gnu.org>
parents:
38141
diff
changeset
|
493 Emacs subshell. |
25829 | 494 |
495 @node Shell Mode | |
496 @subsection Shell Mode | |
497 @cindex Shell mode | |
498 @cindex mode, Shell | |
499 | |
500 Shell buffers use Shell mode, which defines several special keys | |
501 attached to the @kbd{C-c} prefix. They are chosen to resemble the usual | |
502 editing and job control characters present in shells that are not under | |
503 Emacs, except that you must type @kbd{C-c} first. Here is a complete list | |
504 of the special key bindings of Shell mode: | |
505 | |
506 @table @kbd | |
507 @item @key{RET} | |
508 @kindex RET @r{(Shell mode)} | |
509 @findex comint-send-input | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
510 At end of buffer send line as input; otherwise, copy current line to |
69737 | 511 end of buffer and send it (@code{comint-send-input}). Copying a line |
512 in this way omits any prompt at the beginning of the line (text output | |
513 by programs preceding your input). @xref{Shell Prompts}, for how | |
514 Shell mode recognizes prompts. | |
25829 | 515 |
516 @item @key{TAB} | |
517 @kindex TAB @r{(Shell mode)} | |
518 @findex comint-dynamic-complete | |
519 Complete the command name or file name before point in the shell buffer | |
520 (@code{comint-dynamic-complete}). @key{TAB} also completes history | |
521 references (@pxref{History References}) and environment variable names. | |
522 | |
523 @vindex shell-completion-fignore | |
524 @vindex comint-completion-fignore | |
525 The variable @code{shell-completion-fignore} specifies a list of file | |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
526 name extensions to ignore in Shell mode completion. The default |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
527 setting is @code{nil}, but some users prefer @code{("~" "#" "%")} to |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
528 ignore file names ending in @samp{~}, @samp{#} or @samp{%}. Other |
25829 | 529 related Comint modes use the variable @code{comint-completion-fignore} |
530 instead. | |
531 | |
532 @item M-? | |
533 @kindex M-? @r{(Shell mode)} | |
534 @findex comint-dynamic-list-filename@dots{} | |
535 Display temporarily a list of the possible completions of the file name | |
536 before point in the shell buffer | |
537 (@code{comint-dynamic-list-filename-completions}). | |
538 | |
539 @item C-d | |
540 @kindex C-d @r{(Shell mode)} | |
541 @findex comint-delchar-or-maybe-eof | |
52979
3649390c0f91
Replace @sc{ascii} and ASCII with @acronym{ASCII}.
Eli Zaretskii <eliz@gnu.org>
parents:
52701
diff
changeset
|
542 Either delete a character or send @acronym{EOF} |
25829 | 543 (@code{comint-delchar-or-maybe-eof}). Typed at the end of the shell |
52979
3649390c0f91
Replace @sc{ascii} and ASCII with @acronym{ASCII}.
Eli Zaretskii <eliz@gnu.org>
parents:
52701
diff
changeset
|
544 buffer, @kbd{C-d} sends @acronym{EOF} to the subshell. Typed at any other |
25829 | 545 position in the buffer, @kbd{C-d} deletes a character as usual. |
546 | |
547 @item C-c C-a | |
548 @kindex C-c C-a @r{(Shell mode)} | |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
549 @findex comint-bol-or-process-mark |
25829 | 550 Move to the beginning of the line, but after the prompt if any |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
551 (@code{comint-bol-or-process-mark}). If you repeat this command twice |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
552 in a row, the second time it moves back to the process mark, which is |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
553 the beginning of the input that you have not yet sent to the subshell. |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
554 (Normally that is the same place---the end of the prompt on this |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
555 line---but after @kbd{C-c @key{SPC}} the process mark may be in a |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
556 previous line.) |
25829 | 557 |
558 @item C-c @key{SPC} | |
559 Accumulate multiple lines of input, then send them together. This | |
560 command inserts a newline before point, but does not send the preceding | |
561 text as input to the subshell---at least, not yet. Both lines, the one | |
562 before this newline and the one after, will be sent together (along with | |
563 the newline that separates them), when you type @key{RET}. | |
564 | |
565 @item C-c C-u | |
566 @kindex C-c C-u @r{(Shell mode)} | |
567 @findex comint-kill-input | |
568 Kill all text pending at end of buffer to be sent as input | |
61880
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
569 (@code{comint-kill-input}). If point is not at end of buffer, |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
570 this only kills the part of this text that precedes point. |
25829 | 571 |
572 @item C-c C-w | |
573 @kindex C-c C-w @r{(Shell mode)} | |
574 Kill a word before point (@code{backward-kill-word}). | |
575 | |
576 @item C-c C-c | |
577 @kindex C-c C-c @r{(Shell mode)} | |
578 @findex comint-interrupt-subjob | |
579 Interrupt the shell or its current subjob if any | |
580 (@code{comint-interrupt-subjob}). This command also kills | |
581 any shell input pending in the shell buffer and not yet sent. | |
582 | |
583 @item C-c C-z | |
584 @kindex C-c C-z @r{(Shell mode)} | |
585 @findex comint-stop-subjob | |
586 Stop the shell or its current subjob if any (@code{comint-stop-subjob}). | |
587 This command also kills any shell input pending in the shell buffer and | |
588 not yet sent. | |
589 | |
590 @item C-c C-\ | |
591 @findex comint-quit-subjob | |
592 @kindex C-c C-\ @r{(Shell mode)} | |
593 Send quit signal to the shell or its current subjob if any | |
594 (@code{comint-quit-subjob}). This command also kills any shell input | |
595 pending in the shell buffer and not yet sent. | |
596 | |
597 @item C-c C-o | |
598 @kindex C-c C-o @r{(Shell mode)} | |
32637 | 599 @findex comint-delete-output |
600 Delete the last batch of output from a shell command | |
601 (@code{comint-delete-output}). This is useful if a shell command spews | |
602 out lots of output that just gets in the way. This command used to be | |
603 called @code{comint-kill-output}. | |
604 | |
605 @item C-c C-s | |
606 @kindex C-c C-s @r{(Shell mode)} | |
607 @findex comint-write-output | |
608 Write the last batch of output from a shell command to a file | |
609 (@code{comint-write-output}). With a prefix argument, the file is | |
610 appended to instead. Any prompt at the end of the output is not | |
611 written. | |
25829 | 612 |
613 @item C-c C-r | |
614 @itemx C-M-l | |
615 @kindex C-c C-r @r{(Shell mode)} | |
616 @kindex C-M-l @r{(Shell mode)} | |
617 @findex comint-show-output | |
618 Scroll to display the beginning of the last batch of output at the top | |
619 of the window; also move the cursor there (@code{comint-show-output}). | |
620 | |
621 @item C-c C-e | |
622 @kindex C-c C-e @r{(Shell mode)} | |
623 @findex comint-show-maximum-output | |
624 Scroll to put the end of the buffer at the bottom of the window | |
625 (@code{comint-show-maximum-output}). | |
626 | |
627 @item C-c C-f | |
628 @kindex C-c C-f @r{(Shell mode)} | |
629 @findex shell-forward-command | |
630 @vindex shell-command-regexp | |
631 Move forward across one shell command, but not beyond the current line | |
632 (@code{shell-forward-command}). The variable @code{shell-command-regexp} | |
633 specifies how to recognize the end of a command. | |
634 | |
635 @item C-c C-b | |
636 @kindex C-c C-b @r{(Shell mode)} | |
637 @findex shell-backward-command | |
638 Move backward across one shell command, but not beyond the current line | |
639 (@code{shell-backward-command}). | |
640 | |
641 @item M-x dirs | |
642 Ask the shell what its current directory is, so that Emacs can agree | |
643 with the shell. | |
644 | |
645 @item M-x send-invisible @key{RET} @var{text} @key{RET} | |
646 @findex send-invisible | |
647 Send @var{text} as input to the shell, after reading it without | |
648 echoing. This is useful when a shell command runs a program that asks | |
649 for a password. | |
650 | |
66708
24b48f5420b7
(Shell Mode): Describe how to activate password echoing.
Eli Zaretskii <eliz@gnu.org>
parents:
66098
diff
changeset
|
651 Please note that Emacs will not echo passwords by default. If you |
24b48f5420b7
(Shell Mode): Describe how to activate password echoing.
Eli Zaretskii <eliz@gnu.org>
parents:
66098
diff
changeset
|
652 really want them to be echoed, evaluate the following Lisp |
24b48f5420b7
(Shell Mode): Describe how to activate password echoing.
Eli Zaretskii <eliz@gnu.org>
parents:
66098
diff
changeset
|
653 expression: |
25829 | 654 |
655 @example | |
66708
24b48f5420b7
(Shell Mode): Describe how to activate password echoing.
Eli Zaretskii <eliz@gnu.org>
parents:
66098
diff
changeset
|
656 (remove-hook 'comint-output-filter-functions |
24b48f5420b7
(Shell Mode): Describe how to activate password echoing.
Eli Zaretskii <eliz@gnu.org>
parents:
66098
diff
changeset
|
657 'comint-watch-for-password-prompt) |
25829 | 658 @end example |
659 | |
660 @item M-x comint-continue-subjob | |
661 @findex comint-continue-subjob | |
662 Continue the shell process. This is useful if you accidentally suspend | |
663 the shell process.@footnote{You should not suspend the shell process. | |
664 Suspending a subjob of the shell is a completely different matter---that | |
665 is normal practice, but you must use the shell to continue the subjob; | |
666 this command won't do it.} | |
667 | |
668 @item M-x comint-strip-ctrl-m | |
669 @findex comint-strip-ctrl-m | |
670 Discard all control-M characters from the current group of shell output. | |
671 The most convenient way to use this command is to make it run | |
672 automatically when you get output from the subshell. To do that, | |
673 evaluate this Lisp expression: | |
674 | |
675 @example | |
676 (add-hook 'comint-output-filter-functions | |
677 'comint-strip-ctrl-m) | |
678 @end example | |
679 | |
680 @item M-x comint-truncate-buffer | |
681 @findex comint-truncate-buffer | |
682 This command truncates the shell buffer to a certain maximum number of | |
683 lines, specified by the variable @code{comint-buffer-maximum-size}. | |
684 Here's how to do this automatically each time you get output from the | |
685 subshell: | |
686 | |
687 @example | |
688 (add-hook 'comint-output-filter-functions | |
689 'comint-truncate-buffer) | |
690 @end example | |
691 @end table | |
692 | |
693 @cindex Comint mode | |
694 @cindex mode, Comint | |
695 Shell mode is a derivative of Comint mode, a general-purpose mode for | |
696 communicating with interactive subprocesses. Most of the features of | |
697 Shell mode actually come from Comint mode, as you can see from the | |
32516
f89fc1421b53
Update references to shell prompts and comint-prompt-regexp, etc.
Miles Bader <miles@gnu.org>
parents:
31310
diff
changeset
|
698 command names listed above. The special features of Shell mode include |
f89fc1421b53
Update references to shell prompts and comint-prompt-regexp, etc.
Miles Bader <miles@gnu.org>
parents:
31310
diff
changeset
|
699 the directory tracking feature, and a few user commands. |
25829 | 700 |
701 Other Emacs features that use variants of Comint mode include GUD | |
702 (@pxref{Debuggers}) and @kbd{M-x run-lisp} (@pxref{External Lisp}). | |
703 | |
704 @findex comint-run | |
705 You can use @kbd{M-x comint-run} to execute any program of your choice | |
706 in a subprocess using unmodified Comint mode---without the | |
707 specializations of Shell mode. | |
708 | |
61880
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
709 @node Shell Prompts |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
710 @subsection Shell Prompts |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
711 |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
712 @vindex shell-prompt-pattern |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
713 @vindex comint-prompt-regexp |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
714 @vindex comint-use-prompt-regexp |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
715 @cindex prompt, shell |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
716 A prompt is text output by a program to show that it is ready to |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
717 accept new user input. Normally, Comint mode (and thus Shell mode) |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
718 considers the prompt to be any text output by a program at the |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
719 beginning of an input line. However, if the variable |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
720 @code{comint-use-prompt-regexp} is non-@code{nil}, then Comint mode |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
721 uses a regular expression to recognize prompts. In Shell mode, |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
722 @code{shell-prompt-pattern} specifies the regular expression. |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
723 |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
724 The value of @code{comint-use-prompt-regexp} also affects many |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
725 motion and paragraph commands. If the value is non-@code{nil}, the |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
726 general Emacs motion commands behave as they normally do in buffers |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
727 without special text properties. However, if the value is @code{nil}, |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
728 the default, then Comint mode divides the buffer into two types of |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
729 ``fields'' (ranges of consecutive characters having the same |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
730 @code{field} text property): input and output. Prompts are part of |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
731 the output. Most Emacs motion commands do not cross field boundaries, |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
732 unless they move over multiple lines. For instance, when point is in |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
733 input on the same line as a prompt, @kbd{C-a} puts point at the |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
734 beginning of the input if @code{comint-use-prompt-regexp} is |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
735 @code{nil} and at the beginning of the line otherwise. |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
736 |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
737 In Shell mode, only shell prompts start new paragraphs. Thus, a |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
738 paragraph consists of a prompt and the input and output that follow |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
739 it. However, if @code{comint-use-prompt-regexp} is @code{nil}, the |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
740 default, most paragraph commands do not cross field boundaries. This |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
741 means that prompts, ranges of input, and ranges of non-prompt output |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
742 behave mostly like separate paragraphs; with this setting, numeric |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
743 arguments to most paragraph commands yield essentially undefined |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
744 behavior. For the purpose of finding paragraph boundaries, Shell mode |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
745 uses @code{shell-prompt-pattern}, regardless of |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
746 @code{comint-use-prompt-regexp}. |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
747 |
25829 | 748 @node Shell History |
749 @subsection Shell Command History | |
750 | |
751 Shell buffers support three ways of repeating earlier commands. You | |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
752 can use keys like those used for the minibuffer history; these work |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
753 much as they do in the minibuffer, inserting text from prior commands |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
754 while point remains always at the end of the buffer. You can move |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
755 through the buffer to previous inputs in their original place, then |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
756 resubmit them or copy them to the end. Or you can use a |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
757 @samp{!}-style history reference. |
25829 | 758 |
759 @menu | |
760 * Ring: Shell Ring. Fetching commands from the history list. | |
761 * Copy: Shell History Copying. Moving to a command and then copying it. | |
762 * History References:: Expanding @samp{!}-style history references. | |
763 @end menu | |
764 | |
765 @node Shell Ring | |
766 @subsubsection Shell History Ring | |
767 | |
768 @table @kbd | |
769 @findex comint-previous-input | |
770 @kindex M-p @r{(Shell mode)} | |
771 @item M-p | |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
772 @itemx C-@key{UP} |
25829 | 773 Fetch the next earlier old shell command. |
774 | |
775 @kindex M-n @r{(Shell mode)} | |
776 @findex comint-next-input | |
777 @item M-n | |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
778 @itemx C-@key{DOWN} |
25829 | 779 Fetch the next later old shell command. |
780 | |
781 @kindex M-r @r{(Shell mode)} | |
782 @kindex M-s @r{(Shell mode)} | |
783 @findex comint-previous-matching-input | |
784 @findex comint-next-matching-input | |
785 @item M-r @var{regexp} @key{RET} | |
786 @itemx M-s @var{regexp} @key{RET} | |
787 Search backwards or forwards for old shell commands that match @var{regexp}. | |
788 | |
56222
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
789 @item C-c C-x |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
790 @kindex C-c C-x @r{(Shell mode)} |
25829 | 791 @findex comint-get-next-from-history |
792 Fetch the next subsequent command from the history. | |
46244
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
793 |
56222
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
794 @item C-c . |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
795 @kindex C-c . @r{(Shell mode)} |
46244
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
796 @findex comint-input-previous-argument |
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
797 Fetch one argument from an old shell command. |
56222
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
798 |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
799 @item C-c C-l |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
800 @kindex C-c C-l @r{(Shell mode)} |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
801 @findex comint-dynamic-list-input-ring |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
802 Display the buffer's history of shell commands in another window |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
803 (@code{comint-dynamic-list-input-ring}). |
25829 | 804 @end table |
805 | |
806 Shell buffers provide a history of previously entered shell commands. To | |
807 reuse shell commands from the history, use the editing commands @kbd{M-p}, | |
808 @kbd{M-n}, @kbd{M-r} and @kbd{M-s}. These work just like the minibuffer | |
809 history commands except that they operate on the text at the end of the | |
810 shell buffer, where you would normally insert text to send to the shell. | |
811 | |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
812 @kbd{M-p} fetches an earlier shell command to the end of the shell |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
813 buffer. Successive use of @kbd{M-p} fetches successively earlier |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
814 shell commands, each replacing any text that was already present as |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
815 potential shell input. @kbd{M-n} does likewise except that it finds |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
816 successively more recent shell commands from the buffer. |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
817 @kbd{C-@key{UP}} works like @kbd{M-p}, and @kbd{C-@key{DOWN}} like |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
818 @kbd{M-n}. |
25829 | 819 |
820 The history search commands @kbd{M-r} and @kbd{M-s} read a regular | |
821 expression and search through the history for a matching command. Aside | |
822 from the choice of which command to fetch, they work just like @kbd{M-p} | |
38740 | 823 and @kbd{M-n}. If you enter an empty regexp, these commands reuse the |
25829 | 824 same regexp used last time. |
825 | |
826 When you find the previous input you want, you can resubmit it by | |
827 typing @key{RET}, or you can edit it first and then resubmit it if you | |
70117
13078b41e1eb
Added sentence on partial input being saved with M-p/M-n/M-s/M-r.
J.D. Smith <jdsmith@as.arizona.edu>
parents:
70080
diff
changeset
|
828 wish. Any partial input you were composing before navigating the |
13078b41e1eb
Added sentence on partial input being saved with M-p/M-n/M-s/M-r.
J.D. Smith <jdsmith@as.arizona.edu>
parents:
70080
diff
changeset
|
829 history list is restored when you go to the beginning or end of the |
13078b41e1eb
Added sentence on partial input being saved with M-p/M-n/M-s/M-r.
J.D. Smith <jdsmith@as.arizona.edu>
parents:
70080
diff
changeset
|
830 history ring. |
25829 | 831 |
832 Often it is useful to reexecute several successive shell commands that | |
833 were previously executed in sequence. To do this, first find and | |
834 reexecute the first command of the sequence. Then type @kbd{C-c C-x}; | |
835 that will fetch the following command---the one that follows the command | |
836 you just repeated. Then type @key{RET} to reexecute this command. You | |
837 can reexecute several successive commands by typing @kbd{C-c C-x | |
838 @key{RET}} over and over. | |
839 | |
46244
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
840 The command @kbd{C-c .}@: (@code{comint-input-previous-argument}) |
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
841 copies an individual argument from a previous command, like @kbd{ESC |
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
842 .} in Bash. The simplest use copies the last argument from the |
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
843 previous shell command. With a prefix argument @var{n}, it copies the |
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
844 @var{n}th argument instead. Repeating @kbd{C-c .} copies from an |
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
845 earlier shell command instead, always using the same value of @var{n} |
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
846 (don't give a prefix argument when you repeat the @kbd{C-c .} |
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
847 command). |
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
848 |
25829 | 849 These commands get the text of previous shell commands from a special |
850 history list, not from the shell buffer itself. Thus, editing the shell | |
851 buffer, or even killing large parts of it, does not affect the history | |
852 that these commands access. | |
853 | |
854 @vindex shell-input-ring-file-name | |
855 Some shells store their command histories in files so that you can | |
61880
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
856 refer to commands from previous shell sessions. Emacs reads |
25829 | 857 the command history file for your chosen shell, to initialize its own |
858 command history. The file name is @file{~/.bash_history} for bash, | |
859 @file{~/.sh_history} for ksh, and @file{~/.history} for other shells. | |
860 | |
861 @node Shell History Copying | |
862 @subsubsection Shell History Copying | |
863 | |
864 @table @kbd | |
865 @kindex C-c C-p @r{(Shell mode)} | |
866 @findex comint-previous-prompt | |
867 @item C-c C-p | |
868 Move point to the previous prompt (@code{comint-previous-prompt}). | |
869 | |
870 @kindex C-c C-n @r{(Shell mode)} | |
871 @findex comint-next-prompt | |
872 @item C-c C-n | |
873 Move point to the following prompt (@code{comint-next-prompt}). | |
874 | |
875 @kindex C-c RET @r{(Shell mode)} | |
71149
6a73480b8faf
(Shell History Copying): Update descriptions of `C-c RET' and Mouse-2.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70752
diff
changeset
|
876 @findex comint-copy-old-input |
25829 | 877 @item C-c @key{RET} |
878 Copy the input command which point is in, inserting the copy at the end | |
71149
6a73480b8faf
(Shell History Copying): Update descriptions of `C-c RET' and Mouse-2.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70752
diff
changeset
|
879 of the buffer (@code{comint-copy-old-input}). This is useful if you |
25829 | 880 move point back to a previous command. After you copy the command, you |
881 can submit the copy as input with @key{RET}. If you wish, you can | |
71149
6a73480b8faf
(Shell History Copying): Update descriptions of `C-c RET' and Mouse-2.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70752
diff
changeset
|
882 edit the copy before resubmitting it. If you use this command on an |
6a73480b8faf
(Shell History Copying): Update descriptions of `C-c RET' and Mouse-2.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70752
diff
changeset
|
883 output line, it copies that line to the end of the buffer. |
56222
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
884 |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
885 @item Mouse-2 |
71149
6a73480b8faf
(Shell History Copying): Update descriptions of `C-c RET' and Mouse-2.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70752
diff
changeset
|
886 If @code{comint-use-prompt-regexp} is @code{nil} (the default), copy |
6a73480b8faf
(Shell History Copying): Update descriptions of `C-c RET' and Mouse-2.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70752
diff
changeset
|
887 the old input command that you click on, inserting the copy at the end |
6a73480b8faf
(Shell History Copying): Update descriptions of `C-c RET' and Mouse-2.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70752
diff
changeset
|
888 of the buffer (@code{comint-insert-input}). If |
6a73480b8faf
(Shell History Copying): Update descriptions of `C-c RET' and Mouse-2.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70752
diff
changeset
|
889 @code{comint-use-prompt-regexp} is non-@code{nil}, or if the click is |
6a73480b8faf
(Shell History Copying): Update descriptions of `C-c RET' and Mouse-2.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70752
diff
changeset
|
890 not over old input, just yank as usual. |
25829 | 891 @end table |
892 | |
893 Moving to a previous input and then copying it with @kbd{C-c | |
56222
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
894 @key{RET}} or @kbd{Mouse-2} produces the same results---the same |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
895 buffer contents---that you would get by using @kbd{M-p} enough times |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
896 to fetch that previous input from the history list. However, @kbd{C-c |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
897 @key{RET}} copies the text from the buffer, which can be different |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
898 from what is in the history list if you edit the input text in the |
136f1c16dc45
(Shell History Copying): Document comint-insert-input.
Nick Roberts <nickrob@snap.net.nz>
parents:
54475
diff
changeset
|
899 buffer after it has been sent. |
25829 | 900 |
901 @node History References | |
902 @subsubsection Shell History References | |
903 @cindex history reference | |
904 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
905 Various shells including csh and bash support @dfn{history |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
906 references} that begin with @samp{!} and @samp{^}. Shell mode |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
907 recognizes these constructs, and can perform the history substitution |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
908 for you. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
909 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
910 If you insert a history reference and type @key{TAB}, this searches |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
911 the input history for a matching command, performs substitution if |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
912 necessary, and places the result in the buffer in place of the history |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
913 reference. For example, you can fetch the most recent command |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
914 beginning with @samp{mv} with @kbd{! m v @key{TAB}}. You can edit the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
915 command if you wish, and then resubmit the command to the shell by |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
916 typing @key{RET}. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
917 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
918 @vindex comint-input-autoexpand |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
919 @findex comint-magic-space |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
920 Shell mode can optionally expand history references in the buffer |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
921 when you send them to the shell. To request this, set the variable |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
922 @code{comint-input-autoexpand} to @code{input}. You can make |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
923 @key{SPC} perform history expansion by binding @key{SPC} to the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
924 command @code{comint-magic-space}. |
25829 | 925 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
926 Shell mode recognizes history references when they follow a prompt. |
61880
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
927 @xref{Shell Prompts}, for how Shell mode recognizes prompts. |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
928 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
929 @node Directory Tracking |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
930 @subsection Directory Tracking |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
931 @cindex directory tracking |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
932 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
933 @vindex shell-pushd-regexp |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
934 @vindex shell-popd-regexp |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
935 @vindex shell-cd-regexp |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
936 Shell mode keeps track of @samp{cd}, @samp{pushd} and @samp{popd} |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
937 commands given to the inferior shell, so it can keep the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
938 @samp{*shell*} buffer's default directory the same as the shell's |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
939 working directory. It recognizes these commands syntactically, by |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
940 examining lines of input that are sent. |
25829 | 941 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
942 If you use aliases for these commands, you can tell Emacs to |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
943 recognize them also. For example, if the value of the variable |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
944 @code{shell-pushd-regexp} matches the beginning of a shell command |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
945 line, that line is regarded as a @code{pushd} command. Change this |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
946 variable when you add aliases for @samp{pushd}. Likewise, |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
947 @code{shell-popd-regexp} and @code{shell-cd-regexp} are used to |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
948 recognize commands with the meaning of @samp{popd} and @samp{cd}. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
949 These commands are recognized only at the beginning of a shell command |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
950 line. |
25829 | 951 |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
952 @ignore @c This seems to have been deleted long ago. |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
953 @vindex shell-set-directory-error-hook |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
954 If Emacs gets an error while trying to handle what it believes is a |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
955 @samp{cd}, @samp{pushd} or @samp{popd} command, it runs the hook |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
956 @code{shell-set-directory-error-hook} (@pxref{Hooks}). |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
957 @end ignore |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
958 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
959 @findex dirs |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
960 If Emacs gets confused about changes in the current directory of the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
961 subshell, use the command @kbd{M-x dirs} to ask the shell what its |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
962 current directory is. This command works for shells that support the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
963 most common command syntax; it may not work for unusual shells. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
964 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
965 @findex dirtrack-mode |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
966 You can also use @kbd{M-x dirtrack-mode} to enable (or disable) an |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
967 alternative and more aggressive method of tracking changes in the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
968 current directory. |
25829 | 969 |
970 @node Shell Options | |
971 @subsection Shell Mode Options | |
972 | |
973 @vindex comint-scroll-to-bottom-on-input | |
974 If the variable @code{comint-scroll-to-bottom-on-input} is | |
975 non-@code{nil}, insertion and yank commands scroll the selected window | |
70080
e7bda2fbb250
* misc.texi (Shell Options): Correct default value of
Chong Yidong <cyd@stupidchicken.com>
parents:
69797
diff
changeset
|
976 to the bottom before inserting. The default is @code{nil}. |
25829 | 977 |
978 @vindex comint-scroll-show-maximum-output | |
979 If @code{comint-scroll-show-maximum-output} is non-@code{nil}, then | |
51450
676ec3dcee9d
(Shell Options): Clarify comint-scroll-show-maximum-output.
Richard M. Stallman <rms@gnu.org>
parents:
49600
diff
changeset
|
980 arrival of output when point is at the end tries to place the last line of |
38599
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
981 text at the bottom line of the window, so as to show as much useful |
70080
e7bda2fbb250
* misc.texi (Shell Options): Correct default value of
Chong Yidong <cyd@stupidchicken.com>
parents:
69797
diff
changeset
|
982 text as possible. (This mimics the scrolling behavior of most |
e7bda2fbb250
* misc.texi (Shell Options): Correct default value of
Chong Yidong <cyd@stupidchicken.com>
parents:
69797
diff
changeset
|
983 terminals.) The default is @code{t}. |
25829 | 984 |
51450
676ec3dcee9d
(Shell Options): Clarify comint-scroll-show-maximum-output.
Richard M. Stallman <rms@gnu.org>
parents:
49600
diff
changeset
|
985 @vindex comint-move-point-for-output |
676ec3dcee9d
(Shell Options): Clarify comint-scroll-show-maximum-output.
Richard M. Stallman <rms@gnu.org>
parents:
49600
diff
changeset
|
986 By setting @code{comint-move-point-for-output}, you can opt for |
25829 | 987 having point jump to the end of the buffer whenever output arrives---no |
988 matter where in the buffer point was before. If the value is | |
989 @code{this}, point jumps in the selected window. If the value is | |
38599
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
990 @code{all}, point jumps in each window that shows the Comint buffer. If |
25829 | 991 the value is @code{other}, point jumps in all nonselected windows that |
992 show the current buffer. The default value is @code{nil}, which means | |
993 point does not jump to the end. | |
994 | |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
995 @vindex comint-prompt-read-only |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
996 If you set @code{comint-prompt-read-only}, the prompts in the Comint |
60496
3a569489ffdb
(Single Shell, Shell Options): Fix previous change.
Richard M. Stallman <rms@gnu.org>
parents:
60467
diff
changeset
|
997 buffer are read-only. |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
998 |
25829 | 999 @vindex comint-input-ignoredups |
1000 The variable @code{comint-input-ignoredups} controls whether successive | |
1001 identical inputs are stored in the input history. A non-@code{nil} | |
1002 value means to omit an input that is the same as the previous input. | |
1003 The default is @code{nil}, which means to store each input even if it is | |
1004 equal to the previous input. | |
1005 | |
1006 @vindex comint-completion-addsuffix | |
1007 @vindex comint-completion-recexact | |
1008 @vindex comint-completion-autolist | |
1009 Three variables customize file name completion. The variable | |
1010 @code{comint-completion-addsuffix} controls whether completion inserts a | |
1011 space or a slash to indicate a fully completed file or directory name | |
1012 (non-@code{nil} means do insert a space or slash). | |
1013 @code{comint-completion-recexact}, if non-@code{nil}, directs @key{TAB} | |
1014 to choose the shortest possible completion if the usual Emacs completion | |
1015 algorithm cannot add even a single character. | |
1016 @code{comint-completion-autolist}, if non-@code{nil}, says to list all | |
1017 the possible completions whenever completion is not exact. | |
1018 | |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
1019 @vindex shell-completion-execonly |
25829 | 1020 Command completion normally considers only executable files. |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
1021 If you set @code{shell-completion-execonly} to @code{nil}, |
25829 | 1022 it considers nonexecutable files as well. |
1023 | |
1024 @findex shell-pushd-tohome | |
1025 @findex shell-pushd-dextract | |
1026 @findex shell-pushd-dunique | |
1027 You can configure the behavior of @samp{pushd}. Variables control | |
1028 whether @samp{pushd} behaves like @samp{cd} if no argument is given | |
1029 (@code{shell-pushd-tohome}), pop rather than rotate with a numeric | |
1030 argument (@code{shell-pushd-dextract}), and only add directories to the | |
1031 directory stack if they are not already on it | |
1032 (@code{shell-pushd-dunique}). The values you choose should match the | |
1033 underlying shell, of course. | |
1034 | |
40930
60252111f80c
(Shell Options): Add brief mention of ansi-color.
Richard M. Stallman <rms@gnu.org>
parents:
39263
diff
changeset
|
1035 If you want Shell mode to handle color output from shell commands, |
60252111f80c
(Shell Options): Add brief mention of ansi-color.
Richard M. Stallman <rms@gnu.org>
parents:
39263
diff
changeset
|
1036 you can enable ANSI Color mode. Here is how to do this: |
60252111f80c
(Shell Options): Add brief mention of ansi-color.
Richard M. Stallman <rms@gnu.org>
parents:
39263
diff
changeset
|
1037 |
60252111f80c
(Shell Options): Add brief mention of ansi-color.
Richard M. Stallman <rms@gnu.org>
parents:
39263
diff
changeset
|
1038 @example |
60252111f80c
(Shell Options): Add brief mention of ansi-color.
Richard M. Stallman <rms@gnu.org>
parents:
39263
diff
changeset
|
1039 (add-hook 'shell-mode-hook 'ansi-color-for-comint-mode-on) |
60252111f80c
(Shell Options): Add brief mention of ansi-color.
Richard M. Stallman <rms@gnu.org>
parents:
39263
diff
changeset
|
1040 @end example |
60252111f80c
(Shell Options): Add brief mention of ansi-color.
Richard M. Stallman <rms@gnu.org>
parents:
39263
diff
changeset
|
1041 |
27210 | 1042 @node Terminal emulator |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1043 @subsection Emacs Terminal Emulator |
27210 | 1044 @findex term |
1045 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1046 To run a subshell in a terminal emulator, putting its typescript in |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1047 an Emacs buffer, use @kbd{M-x term}. This creates (or reuses) a |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
1048 buffer named @samp{*terminal*}, and runs a subshell with input coming |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
1049 from your keyboard, and output going to that buffer. |
27210 | 1050 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1051 The terminal emulator uses Term mode, which has two input modes. In |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1052 line mode, Term basically acts like Shell mode; see @ref{Shell Mode}. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1053 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1054 In char mode, each character is sent directly to the inferior |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1055 subshell, as ``terminal input.'' Any ``echoing'' of your input is the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1056 responsibility of the subshell. The sole exception is the terminal |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1057 escape character, which by default is @kbd{C-c} (@pxref{Term Mode}). |
27210 | 1058 Any ``terminal output'' from the subshell goes into the buffer, |
1059 advancing point. | |
1060 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1061 Some programs (such as Emacs itself) need to control the appearance |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1062 on the terminal screen in detail. They do this by sending special |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1063 control codes. The exact control codes needed vary from terminal to |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1064 terminal, but nowadays most terminals and terminal emulators |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1065 (including @code{xterm}) understand the ANSI-standard (VT100-style) |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1066 escape sequences. Term mode recognizes these escape sequences, and |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1067 handles each one appropriately, changing the buffer so that the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1068 appearance of the window matches what it would be on a real terminal. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1069 You can actually run Emacs inside an Emacs Term window. |
27210 | 1070 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1071 The file name used to load the subshell is determined the same way |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1072 as for Shell mode. To make multiple terminal emulators, rename the |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
1073 buffer @samp{*terminal*} to something different using @kbd{M-x |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1074 rename-uniquely}, just as with Shell mode. |
27210 | 1075 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1076 Unlike Shell mode, Term mode does not track the current directory by |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1077 examining your input. But some shells can tell Term what the current |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1078 directory is. This is done automatically by @code{bash} version 1.15 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1079 and later. |
27210 | 1080 |
1081 @node Term Mode | |
1082 @subsection Term Mode | |
1083 @cindex Term mode | |
1084 @cindex mode, Term | |
1085 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1086 The terminal emulator uses Term mode, which has two input modes. In |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1087 line mode, Term basically acts like Shell mode; see @ref{Shell Mode}. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1088 In char mode, each character is sent directly to the inferior |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1089 subshell, except for the Term escape character, normally @kbd{C-c}. |
27210 | 1090 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1091 To switch between line and char mode, use these commands: |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1092 |
27210 | 1093 @table @kbd |
46244
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
1094 @kindex C-c C-j @r{(Term mode)} |
27210 | 1095 @findex term-char-mode |
46244
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
1096 @item C-c C-j |
27210 | 1097 Switch to line mode. Do nothing if already in line mode. |
1098 | |
46244
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
1099 @kindex C-c C-k @r{(Term mode)} |
27210 | 1100 @findex term-line-mode |
46244
c31280155efa
Document C-c . in Shell mode.
Richard M. Stallman <rms@gnu.org>
parents:
43044
diff
changeset
|
1101 @item C-c C-k |
27210 | 1102 Switch to char mode. Do nothing if already in char mode. |
1103 @end table | |
1104 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1105 The following commands are only available in char mode: |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1106 |
27210 | 1107 @table @kbd |
1108 @item C-c C-c | |
1109 Send a literal @key{C-c} to the sub-shell. | |
1110 | |
58765
9a73265ddd16
(Term Mode): Correcty describe C-c.
Richard M. Stallman <rms@gnu.org>
parents:
56807
diff
changeset
|
1111 @item C-c @var{char} |
9a73265ddd16
(Term Mode): Correcty describe C-c.
Richard M. Stallman <rms@gnu.org>
parents:
56807
diff
changeset
|
1112 This is equivalent to @kbd{C-x @var{char}} in normal Emacs. For |
9a73265ddd16
(Term Mode): Correcty describe C-c.
Richard M. Stallman <rms@gnu.org>
parents:
56807
diff
changeset
|
1113 example, @kbd{C-c o} invokes the global binding of @kbd{C-x o}, which |
9a73265ddd16
(Term Mode): Correcty describe C-c.
Richard M. Stallman <rms@gnu.org>
parents:
56807
diff
changeset
|
1114 is normally @samp{other-window}. |
27210 | 1115 @end table |
1116 | |
1117 @node Paging in Term | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1118 @subsection Page-At-A-Time Output |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1119 @cindex page-at-a-time |
27210 | 1120 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1121 Term mode has a page-at-a-time feature. When enabled it makes |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1122 output pause at the end of each screenful. |
27210 | 1123 |
1124 @table @kbd | |
1125 @kindex C-c C-q @r{(Term mode)} | |
1126 @findex term-pager-toggle | |
1127 @item C-c C-q | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1128 Toggle the page-at-a-time feature. This command works in both line |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1129 and char modes. When page-at-a-time is enabled, the mode-line |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1130 displays the word @samp{page}. |
27210 | 1131 @end table |
1132 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1133 With page-at-a-time enabled, whenever Term receives more than a |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1134 screenful of output since your last input, it pauses, displaying |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1135 @samp{**MORE**} in the mode-line. Type @key{SPC} to display the next |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1136 screenful of output. Type @kbd{?} to see your other options. The |
38865
62e02f5ae533
Avoid saying "Unix" in a way that includes GNU.
Richard M. Stallman <rms@gnu.org>
parents:
38786
diff
changeset
|
1137 interface is similar to the @code{more} program. |
27210 | 1138 |
25829 | 1139 @node Remote Host |
1140 @subsection Remote Host Shell | |
1141 @cindex remote host | |
1142 @cindex connecting to remote host | |
1143 @cindex Telnet | |
1144 @cindex Rlogin | |
1145 | |
27210 | 1146 You can login to a remote computer, using whatever commands you |
1147 would from a regular terminal (e.g.@: using the @code{telnet} or | |
1148 @code{rlogin} commands), from a Term window. | |
1149 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1150 A program that asks you for a password will normally suppress |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1151 echoing of the password, so the password will not show up in the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1152 buffer. This will happen just as if you were using a real terminal, |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1153 if the buffer is in char mode. If it is in line mode, the password is |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1154 temporarily visible, but will be erased when you hit return. (This |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1155 happens automatically; there is no special password processing.) |
27210 | 1156 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1157 When you log in to a different machine, you need to specify the type |
61880
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
1158 of terminal you're using, by setting the @env{TERM} environment |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
1159 variable in the environment for the remote login command. (If you use |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
1160 bash, you do that by writing the variable assignment before the remote |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
1161 login command, without separating comma.) Terminal types @samp{ansi} |
661ef1edb844
(Shell): Add `Shell Prompts' to menu.
Luc Teirlinck <teirllm@auburn.edu>
parents:
61639
diff
changeset
|
1162 or @samp{vt100} will work on most systems. |
27210 | 1163 |
1164 @c If you are talking to a Bourne-compatible | |
29107 | 1165 @c shell, and your system understands the @env{TERMCAP} variable, |
27210 | 1166 @c you can use the command @kbd{M-x shell-send-termcap}, which |
1167 @c sends a string specifying the terminal type and size. | |
1168 @c (This command is also useful after the window has changed size.) | |
1169 | |
1170 @c You can of course run @samp{gdb} on that remote computer. One useful | |
1171 @c trick: If you invoke gdb with the @code{--fullname} option, | |
1172 @c it will send special commands to Emacs that will cause Emacs to | |
1173 @c pop up the source files you're debugging. This will work | |
1174 @c whether or not gdb is running on a different computer than Emacs, | |
1175 @c as long as Emacs can access the source files specified by gdb. | |
1176 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1177 @ignore |
38599
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
1178 You cannot log in to a remote computer using the Shell mode. |
27210 | 1179 @c (This will change when Shell is re-written to use Term.) |
1180 Instead, Emacs provides two commands for logging in to another computer | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1181 and communicating with it through an Emacs buffer using Comint mode: |
25829 | 1182 |
1183 @table @kbd | |
1184 @item M-x telnet @key{RET} @var{hostname} @key{RET} | |
1185 Set up a Telnet connection to the computer named @var{hostname}. | |
1186 @item M-x rlogin @key{RET} @var{hostname} @key{RET} | |
1187 Set up an Rlogin connection to the computer named @var{hostname}. | |
1188 @end table | |
1189 | |
1190 @findex telnet | |
1191 Use @kbd{M-x telnet} to set up a Telnet connection to another | |
1192 computer. (Telnet is the standard Internet protocol for remote login.) | |
1193 It reads the host name of the other computer as an argument with the | |
1194 minibuffer. Once the connection is established, talking to the other | |
1195 computer works like talking to a subshell: you can edit input with the | |
1196 usual Emacs commands, and send it a line at a time by typing @key{RET}. | |
1197 The output is inserted in the Telnet buffer interspersed with the input. | |
1198 | |
1199 @findex rlogin | |
1200 @vindex rlogin-explicit-args | |
1201 Use @kbd{M-x rlogin} to set up an Rlogin connection. Rlogin is | |
1202 another remote login communication protocol, essentially much like the | |
1203 Telnet protocol but incompatible with it, and supported only by certain | |
1204 systems. Rlogin's advantages are that you can arrange not to have to | |
1205 give your user name and password when communicating between two machines | |
1206 you frequently use, and that you can make an 8-bit-clean connection. | |
1207 (To do that in Emacs, set @code{rlogin-explicit-args} to @code{("-8")} | |
1208 before you run Rlogin.) | |
1209 | |
1210 @kbd{M-x rlogin} sets up the default file directory of the Emacs | |
1211 buffer to access the remote host via FTP (@pxref{File Names}), and it | |
1212 tracks the shell commands that change the current directory, just like | |
1213 Shell mode. | |
1214 | |
1215 @findex rlogin-directory-tracking-mode | |
1216 There are two ways of doing directory tracking in an Rlogin | |
1217 buffer---either with remote directory names | |
1218 @file{/@var{host}:@var{dir}/} or with local names (that works if the | |
1219 ``remote'' machine shares file systems with your machine of origin). | |
1220 You can use the command @code{rlogin-directory-tracking-mode} to switch | |
1221 modes. No argument means use remote directory names, a positive | |
1222 argument means use local names, and a negative argument means turn | |
1223 off directory tracking. | |
1224 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1225 @end ignore |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1226 |
63004
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1227 @node Emacs Server, Printing, Shell, Top |
25829 | 1228 @section Using Emacs as a Server |
1229 @pindex emacsclient | |
1230 @cindex Emacs as a server | |
1231 @cindex server, using Emacs as | |
29107 | 1232 @cindex @env{EDITOR} environment variable |
25829 | 1233 |
1234 Various programs such as @code{mail} can invoke your choice of editor | |
1235 to edit a particular piece of text, such as a message that you are | |
1236 sending. By convention, most of these programs use the environment | |
29107 | 1237 variable @env{EDITOR} to specify which editor to run. If you set |
1238 @env{EDITOR} to @samp{emacs}, they invoke Emacs---but in an | |
25829 | 1239 inconvenient fashion, by starting a new, separate Emacs process. This |
1240 is inconvenient because it takes time and because the new Emacs process | |
38599
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
1241 doesn't share the buffers in any existing Emacs process. |
25829 | 1242 |
1243 You can arrange to use your existing Emacs process as the editor for | |
1244 programs like @code{mail} by using the Emacs client and Emacs server | |
1245 programs. Here is how. | |
1246 | |
29107 | 1247 @cindex @env{TEXEDIT} environment variable |
25829 | 1248 First, the preparation. Within Emacs, call the function |
1249 @code{server-start}. (Your @file{.emacs} file can do this automatically | |
1250 if you add the expression @code{(server-start)} to it.) Then, outside | |
29107 | 1251 Emacs, set the @env{EDITOR} environment variable to @samp{emacsclient}. |
25829 | 1252 (Note that some programs use a different environment variable; for |
1253 example, to make @TeX{} use @samp{emacsclient}, you should set the | |
29107 | 1254 @env{TEXEDIT} environment variable to @samp{emacsclient +%d %s}.) |
25829 | 1255 |
1256 @kindex C-x # | |
1257 @findex server-edit | |
29107 | 1258 Then, whenever any program invokes your specified @env{EDITOR} |
25829 | 1259 program, the effect is to send a message to your principal Emacs telling |
1260 it to visit a file. (That's what the program @code{emacsclient} does.) | |
1261 Emacs displays the buffer immediately and you can immediately begin | |
1262 editing it. | |
1263 | |
1264 When you've finished editing that buffer, type @kbd{C-x #} | |
1265 (@code{server-edit}). This saves the file and sends a message back to | |
1266 the @code{emacsclient} program telling it to exit. The programs that | |
29107 | 1267 use @env{EDITOR} wait for the ``editor'' (actually, @code{emacsclient}) |
25829 | 1268 to exit. @kbd{C-x #} also checks for other pending external requests |
1269 to edit various files, and selects the next such file. | |
1270 | |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
1271 You can switch to a server buffer manually if you wish; you don't |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
1272 have to arrive at it with @kbd{C-x #}. But @kbd{C-x #} is the way to |
38599
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
1273 say that you are finished with one. |
25829 | 1274 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1275 @vindex server-kill-new-buffers |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1276 @vindex server-temp-file-regexp |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1277 Finishing with a server buffer also kills the buffer, unless it |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1278 already existed in the Emacs session before the server asked to create |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1279 it. However, if you set @code{server-kill-new-buffers} to @code{nil}, |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1280 then a different criterion is used: finishing with a server buffer |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1281 kills it if the file name matches the regular expression |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1282 @code{server-temp-file-regexp}. This is set up to distinguish certain |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1283 ``temporary'' files. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1284 |
25829 | 1285 @vindex server-window |
1286 If you set the variable @code{server-window} to a window or a frame, | |
1287 @kbd{C-x #} displays the server buffer in that window or in that frame. | |
1288 | |
60954
276ede258da1
(Emacs Server): Document server-name.
Richard M. Stallman <rms@gnu.org>
parents:
60799
diff
changeset
|
1289 @vindex server-name |
276ede258da1
(Emacs Server): Document server-name.
Richard M. Stallman <rms@gnu.org>
parents:
60799
diff
changeset
|
1290 You can run multiple Emacs servers on the same machine by giving |
276ede258da1
(Emacs Server): Document server-name.
Richard M. Stallman <rms@gnu.org>
parents:
60799
diff
changeset
|
1291 each one a unique ``server name'', using the variable |
61102
7c6643312d7d
(Emacs Server): Fix Texinfo usage.
Richard M. Stallman <rms@gnu.org>
parents:
61007
diff
changeset
|
1292 @code{server-name}. For example, @kbd{M-x set-variable @key{RET} |
7c6643312d7d
(Emacs Server): Fix Texinfo usage.
Richard M. Stallman <rms@gnu.org>
parents:
61007
diff
changeset
|
1293 server-name @key{RET} foo @key{RET}} sets the server name to |
7c6643312d7d
(Emacs Server): Fix Texinfo usage.
Richard M. Stallman <rms@gnu.org>
parents:
61007
diff
changeset
|
1294 @samp{foo}. The @code{emacsclient} program can visit a server by name |
7c6643312d7d
(Emacs Server): Fix Texinfo usage.
Richard M. Stallman <rms@gnu.org>
parents:
61007
diff
changeset
|
1295 using the @samp{-s} option. @xref{Invoking emacsclient}. |
60954
276ede258da1
(Emacs Server): Document server-name.
Richard M. Stallman <rms@gnu.org>
parents:
60799
diff
changeset
|
1296 |
25829 | 1297 While @code{mail} or another application is waiting for |
1298 @code{emacsclient} to finish, @code{emacsclient} does not read terminal | |
1299 input. So the terminal that @code{mail} was using is effectively | |
1300 blocked for the duration. In order to edit with your principal Emacs, | |
1301 you need to be able to use it without using that terminal. There are | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1302 three ways to do this: |
25829 | 1303 |
1304 @itemize @bullet | |
1305 @item | |
1306 Using a window system, run @code{mail} and the principal Emacs in two | |
1307 separate windows. While @code{mail} is waiting for @code{emacsclient}, | |
1308 the window where it was running is blocked, but you can use Emacs by | |
1309 switching windows. | |
1310 | |
1311 @item | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1312 Using virtual terminals, run @code{mail} in one virtual terminal |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1313 and run Emacs in another. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1314 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1315 @item |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1316 Use Shell mode or Term mode in Emacs to run the other program such as |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1317 @code{mail}; then, @code{emacsclient} blocks only the subshell under |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1318 Emacs, and you can still use Emacs to edit the file. |
25829 | 1319 @end itemize |
1320 | |
1321 If you run @code{emacsclient} with the option @samp{--no-wait}, it | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1322 returns immediately without waiting for you to ``finish'' the buffer |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1323 in Emacs. Note that server buffers created in this way are not killed |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1324 automatically when you finish with them. |
30856 | 1325 |
25829 | 1326 @menu |
62473
ee50af163f00
(Emacs Server): Add menu description.
Lute Kamstra <lute@gnu.org>
parents:
61880
diff
changeset
|
1327 * Invoking emacsclient:: Emacs client startup options. |
25829 | 1328 @end menu |
1329 | |
1330 @node Invoking emacsclient,, Emacs Server, Emacs Server | |
56807
d2c0e48f4d5a
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
56222
diff
changeset
|
1331 @subsection Invoking @code{emacsclient} |
25829 | 1332 |
1333 To run the @code{emacsclient} program, specify file names as arguments, | |
71593 | 1334 and optionally line numbers as well, like this: |
25829 | 1335 |
1336 @example | |
38467
7f472a1b6c80
Add description of +LINE:COLUMN for emacsclient.
Gerd Moellmann <gerd@gnu.org>
parents:
38459
diff
changeset
|
1337 emacsclient @r{@{}@r{[}+@var{line}@r{[}@var{column}@r{]}@r{]} @var{filename}@r{@}}@dots{} |
25829 | 1338 @end example |
1339 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1340 @noindent |
25829 | 1341 This tells Emacs to visit each of the specified files; if you specify a |
1342 line number for a certain file, Emacs moves to that line in the file. | |
38786 | 1343 If you specify a column number as well, Emacs puts point on that column |
1344 in the line. | |
25829 | 1345 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1346 Ordinarily, @code{emacsclient} does not return until you use the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1347 @kbd{C-x #} command on each of these buffers. When that happens, |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1348 Emacs sends a message to the @code{emacsclient} program telling it to |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1349 return. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1350 |
71741
d3243ee91ba0
* misc.texi (Invoking emacsclient): Document behavior when emacsclient
Chong Yidong <cyd@stupidchicken.com>
parents:
71593
diff
changeset
|
1351 If you invoke @code{emacsclient} for more than one file, the |
d3243ee91ba0
* misc.texi (Invoking emacsclient): Document behavior when emacsclient
Chong Yidong <cyd@stupidchicken.com>
parents:
71593
diff
changeset
|
1352 additional client buffers are buried at the bottom of the buffer list |
d3243ee91ba0
* misc.texi (Invoking emacsclient): Document behavior when emacsclient
Chong Yidong <cyd@stupidchicken.com>
parents:
71593
diff
changeset
|
1353 (@pxref{Buffers}). If you call @kbd{C-x #} after you are done editing |
d3243ee91ba0
* misc.texi (Invoking emacsclient): Document behavior when emacsclient
Chong Yidong <cyd@stupidchicken.com>
parents:
71593
diff
changeset
|
1354 a client buffer, the next client buffer is automatically selected. |
d3243ee91ba0
* misc.texi (Invoking emacsclient): Document behavior when emacsclient
Chong Yidong <cyd@stupidchicken.com>
parents:
71593
diff
changeset
|
1355 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1356 But if you use the option @samp{-n} or @samp{--no-wait} when running |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1357 @code{emacsclient}, then it returns immediately. (You can take as |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1358 long as you like to edit the files in Emacs.) |
25829 | 1359 |
71593 | 1360 The option @samp{--alternate-editor=@var{command}} specifies a |
1361 command to run if @code{emacsclient} fails to contact Emacs. This is | |
1362 useful when running @code{emacsclient} in a script. For example, the | |
1363 following setting for the @env{EDITOR} environment variable will | |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
1364 always give you an editor, even if no Emacs server is running: |
25829 | 1365 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1366 @example |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
1367 EDITOR="emacsclient --alternate-editor emacs +%d %s" |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1368 @end example |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1369 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1370 @noindent |
71593 | 1371 The environment variable @env{ALTERNATE_EDITOR} has the same effect, with |
1372 the value of the @samp{--alternate-editor} option taking precedence. | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1373 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1374 @pindex emacs.bash |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1375 Alternatively, the file @file{etc/emacs.bash} defines a bash |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1376 function which will communicate with a running Emacs server, or start |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1377 one if none exists. |
25829 | 1378 |
47650
5dbc6d83f14d
Add info about --eval and --display.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46244
diff
changeset
|
1379 If you use several displays, you can tell Emacs on which display to |
5dbc6d83f14d
Add info about --eval and --display.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46244
diff
changeset
|
1380 open the given files with the option @samp{--display=@var{DISPLAY}}. |
5dbc6d83f14d
Add info about --eval and --display.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46244
diff
changeset
|
1381 This can be used typically when connecting from home to an Emacs |
5dbc6d83f14d
Add info about --eval and --display.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46244
diff
changeset
|
1382 server running on your machine at your workplace. |
5dbc6d83f14d
Add info about --eval and --display.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46244
diff
changeset
|
1383 |
60954
276ede258da1
(Emacs Server): Document server-name.
Richard M. Stallman <rms@gnu.org>
parents:
60799
diff
changeset
|
1384 If there is more than one Emacs server running, you can specify a |
276ede258da1
(Emacs Server): Document server-name.
Richard M. Stallman <rms@gnu.org>
parents:
60799
diff
changeset
|
1385 server name with the option @samp{-s @var{name}}. |
276ede258da1
(Emacs Server): Document server-name.
Richard M. Stallman <rms@gnu.org>
parents:
60799
diff
changeset
|
1386 |
47650
5dbc6d83f14d
Add info about --eval and --display.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46244
diff
changeset
|
1387 You can also use @code{emacsclient} to execute any piece of Emacs Lisp |
5dbc6d83f14d
Add info about --eval and --display.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46244
diff
changeset
|
1388 code, using the option @samp{--eval}. When this option is given, the |
5dbc6d83f14d
Add info about --eval and --display.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46244
diff
changeset
|
1389 rest of the arguments is not taken as a list of files to visit but as |
5dbc6d83f14d
Add info about --eval and --display.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46244
diff
changeset
|
1390 a list of expressions to evaluate. |
5dbc6d83f14d
Add info about --eval and --display.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46244
diff
changeset
|
1391 |
63004
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1392 @node Printing, Sorting, Emacs Server, Top |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1393 @section Printing Hard Copies |
25829 | 1394 @cindex hardcopy |
63004
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1395 @cindex printing |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1396 |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1397 Emacs provides commands for printing hard copies of either an entire |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1398 buffer or just part of one, with or without page headers. You can |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1399 invoke the printing commands directly, as detailed in the following |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1400 section, or using the @samp{File} menu on the menu bar. See also the |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1401 hardcopy commands of Dired (@pxref{Misc File Ops}) and the diary |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1402 (@pxref{Displaying the Diary}). |
25829 | 1403 |
1404 @table @kbd | |
1405 @item M-x print-buffer | |
1406 Print hardcopy of current buffer with page headings containing the file | |
1407 name and page number. | |
1408 @item M-x lpr-buffer | |
1409 Print hardcopy of current buffer without page headings. | |
1410 @item M-x print-region | |
1411 Like @code{print-buffer} but print only the current region. | |
1412 @item M-x lpr-region | |
1413 Like @code{lpr-buffer} but print only the current region. | |
1414 @end table | |
1415 | |
1416 @findex print-buffer | |
1417 @findex print-region | |
1418 @findex lpr-buffer | |
1419 @findex lpr-region | |
1420 @vindex lpr-switches | |
1421 The hardcopy commands (aside from the Postscript commands) pass extra | |
1422 switches to the @code{lpr} program based on the value of the variable | |
1423 @code{lpr-switches}. Its value should be a list of strings, each string | |
1424 an option starting with @samp{-}. For example, to specify a line width | |
1425 of 80 columns for all the printing you do in Emacs, set | |
1426 @code{lpr-switches} like this: | |
1427 | |
1428 @example | |
1429 (setq lpr-switches '("-w80")) | |
1430 @end example | |
1431 | |
1432 @vindex printer-name | |
1433 You can specify the printer to use by setting the variable | |
1434 @code{printer-name}. | |
1435 | |
1436 @vindex lpr-headers-switches | |
1437 @vindex lpr-commands | |
1438 @vindex lpr-add-switches | |
1439 The variable @code{lpr-command} specifies the name of the printer | |
1440 program to run; the default value depends on your operating system type. | |
1441 On most systems, the default is @code{"lpr"}. The variable | |
1442 @code{lpr-headers-switches} similarly specifies the extra switches to | |
1443 use to make page headers. The variable @code{lpr-add-switches} controls | |
1444 whether to supply @samp{-T} and @samp{-J} options (suitable for | |
1445 @code{lpr}) to the printer program: @code{nil} means don't add them. | |
1446 @code{lpr-add-switches} should be @code{nil} if your printer program is | |
1447 not compatible with @code{lpr}. | |
1448 | |
63004
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1449 @menu |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1450 * PostScript:: Printing buffers or regions as PostScript. |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1451 * PostScript Variables:: Customizing the PostScript printing commands. |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1452 * Printing Package:: An optional advanced printing interface. |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1453 @end menu |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1454 |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1455 @node PostScript, PostScript Variables,, Printing |
27210 | 1456 @section PostScript Hardcopy |
25829 | 1457 |
27210 | 1458 These commands convert buffer contents to PostScript, |
25829 | 1459 either printing it or leaving it in another Emacs buffer. |
1460 | |
1461 @table @kbd | |
1462 @item M-x ps-print-buffer | |
27210 | 1463 Print hardcopy of the current buffer in PostScript form. |
25829 | 1464 @item M-x ps-print-region |
27210 | 1465 Print hardcopy of the current region in PostScript form. |
25829 | 1466 @item M-x ps-print-buffer-with-faces |
27210 | 1467 Print hardcopy of the current buffer in PostScript form, showing the |
1468 faces used in the text by means of PostScript features. | |
25829 | 1469 @item M-x ps-print-region-with-faces |
27210 | 1470 Print hardcopy of the current region in PostScript form, showing the |
25829 | 1471 faces used in the text. |
1472 @item M-x ps-spool-buffer | |
27210 | 1473 Generate PostScript for the current buffer text. |
25829 | 1474 @item M-x ps-spool-region |
27210 | 1475 Generate PostScript for the current region. |
25829 | 1476 @item M-x ps-spool-buffer-with-faces |
27210 | 1477 Generate PostScript for the current buffer, showing the faces used. |
25829 | 1478 @item M-x ps-spool-region-with-faces |
27210 | 1479 Generate PostScript for the current region, showing the faces used. |
1480 @item M-x handwrite | |
1481 Generates/prints PostScript for the current buffer as if handwritten. | |
25829 | 1482 @end table |
1483 | |
1484 @findex ps-print-region | |
1485 @findex ps-print-buffer | |
1486 @findex ps-print-region-with-faces | |
1487 @findex ps-print-buffer-with-faces | |
27210 | 1488 The PostScript commands, @code{ps-print-buffer} and |
1489 @code{ps-print-region}, print buffer contents in PostScript form. One | |
25829 | 1490 command prints the entire buffer; the other, just the region. The |
1491 corresponding @samp{-with-faces} commands, | |
1492 @code{ps-print-buffer-with-faces} and @code{ps-print-region-with-faces}, | |
27210 | 1493 use PostScript features to show the faces (fonts and colors) in the text |
25829 | 1494 properties of the text being printed. |
1495 | |
1496 If you are using a color display, you can print a buffer of program | |
1497 code with color highlighting by turning on Font-Lock mode in that | |
1498 buffer, and using @code{ps-print-buffer-with-faces}. | |
1499 | |
1500 @findex ps-spool-region | |
1501 @findex ps-spool-buffer | |
1502 @findex ps-spool-region-with-faces | |
1503 @findex ps-spool-buffer-with-faces | |
1504 The commands whose names have @samp{spool} instead of @samp{print} | |
27210 | 1505 generate the PostScript output in an Emacs buffer instead of sending |
25829 | 1506 it to the printer. |
1507 | |
27210 | 1508 @findex handwrite |
1509 @cindex handwriting | |
1510 @kbd{M-x handwrite} is more frivolous. It generates a PostScript | |
1511 rendition of the current buffer as a cursive handwritten document. It | |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
1512 can be customized in group @code{handwrite}. This function only |
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
1513 supports ISO 8859-1 characters. |
27210 | 1514 |
70752
a262d4625442
(Gnus, Where to Look, PostScript): ifinfo -> ifnottex.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70485
diff
changeset
|
1515 @ifnottex |
25829 | 1516 The following section describes variables for customizing these commands. |
70752
a262d4625442
(Gnus, Where to Look, PostScript): ifinfo -> ifnottex.
Luc Teirlinck <teirllm@auburn.edu>
parents:
70485
diff
changeset
|
1517 @end ifnottex |
25829 | 1518 |
63004
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1519 @node PostScript Variables, Printing Package, PostScript, Printing |
27210 | 1520 @section Variables for PostScript Hardcopy |
25829 | 1521 |
1522 @vindex ps-lpr-command | |
1523 @vindex ps-lpr-switches | |
1524 @vindex ps-printer-name | |
27210 | 1525 All the PostScript hardcopy commands use the variables |
25829 | 1526 @code{ps-lpr-command} and @code{ps-lpr-switches} to specify how to print |
1527 the output. @code{ps-lpr-command} specifies the command name to run, | |
1528 @code{ps-lpr-switches} specifies command line options to use, and | |
1529 @code{ps-printer-name} specifies the printer. If you don't set the | |
1530 first two variables yourself, they take their initial values from | |
1531 @code{lpr-command} and @code{lpr-switches}. If @code{ps-printer-name} | |
1532 is @code{nil}, @code{printer-name} is used. | |
1533 | |
1534 @vindex ps-print-header | |
1535 The variable @code{ps-print-header} controls whether these commands | |
1536 add header lines to each page---set it to @code{nil} to turn headers | |
35648
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1537 off. |
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1538 |
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1539 @cindex color emulation on black-and-white printers |
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1540 @vindex ps-print-color-p |
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1541 If your printer doesn't support colors, you should turn off color |
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1542 processing by setting @code{ps-print-color-p} to @code{nil}. By |
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1543 default, if the display supports colors, Emacs produces hardcopy output |
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1544 with color information; on black-and-white printers, colors are emulated |
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1545 with shades of gray. This might produce illegible output, even if your |
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1546 screen colors only use shades of gray. |
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1547 |
fd06a4e20d87
(PostScript Variables): Extend the documentation of ps-print-color-p.
Eli Zaretskii <eliz@gnu.org>
parents:
33382
diff
changeset
|
1548 @vindex ps-use-face-background |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1549 By default, PostScript printing ignores the background colors of the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1550 faces, unless the variable @code{ps-use-face-background} is |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1551 non-@code{nil}. This is to avoid unwanted interference with the zebra |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
1552 stripes and background image/text. |
25829 | 1553 |
1554 @vindex ps-paper-type | |
1555 @vindex ps-page-dimensions-database | |
1556 The variable @code{ps-paper-type} specifies which size of paper to | |
1557 format for; legitimate values include @code{a4}, @code{a3}, | |
1558 @code{a4small}, @code{b4}, @code{b5}, @code{executive}, @code{ledger}, | |
1559 @code{legal}, @code{letter}, @code{letter-small}, @code{statement}, | |
1560 @code{tabloid}. The default is @code{letter}. You can define | |
1561 additional paper sizes by changing the variable | |
1562 @code{ps-page-dimensions-database}. | |
1563 | |
1564 @vindex ps-landscape-mode | |
1565 The variable @code{ps-landscape-mode} specifies the orientation of | |
1566 printing on the page. The default is @code{nil}, which stands for | |
1567 ``portrait'' mode. Any non-@code{nil} value specifies ``landscape'' | |
1568 mode. | |
1569 | |
1570 @vindex ps-number-of-columns | |
1571 The variable @code{ps-number-of-columns} specifies the number of | |
1572 columns; it takes effect in both landscape and portrait mode. The | |
1573 default is 1. | |
1574 | |
1575 @vindex ps-font-family | |
1576 @vindex ps-font-size | |
1577 @vindex ps-font-info-database | |
1578 The variable @code{ps-font-family} specifies which font family to use | |
1579 for printing ordinary text. Legitimate values include @code{Courier}, | |
1580 @code{Helvetica}, @code{NewCenturySchlbk}, @code{Palatino} and | |
1581 @code{Times}. The variable @code{ps-font-size} specifies the size of | |
1582 the font for ordinary text. It defaults to 8.5 points. | |
1583 | |
37018
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1584 @vindex ps-multibyte-buffer |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1585 @cindex Intlfonts for PostScript printing |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1586 @cindex fonts for PostScript printing |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1587 Emacs supports more scripts and characters than a typical PostScript |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1588 printer. Thus, some of the characters in your buffer might not be |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1589 printable using the fonts built into your printer. You can augment |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1590 the fonts supplied with the printer with those from the GNU Intlfonts |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1591 package, or you can instruct Emacs to use Intlfonts exclusively. The |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1592 variable @code{ps-multibyte-buffer} controls this: the default value, |
52979
3649390c0f91
Replace @sc{ascii} and ASCII with @acronym{ASCII}.
Eli Zaretskii <eliz@gnu.org>
parents:
52701
diff
changeset
|
1593 @code{nil}, is appropriate for printing @acronym{ASCII} and Latin-1 |
37018
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1594 characters; a value of @code{non-latin-printer} is for printers which |
52979
3649390c0f91
Replace @sc{ascii} and ASCII with @acronym{ASCII}.
Eli Zaretskii <eliz@gnu.org>
parents:
52701
diff
changeset
|
1595 have the fonts for @acronym{ASCII}, Latin-1, Japanese, and Korean |
37018
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1596 characters built into them. A value of @code{bdf-font} arranges for |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1597 the BDF fonts from the Intlfonts package to be used for @emph{all} |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1598 characters. Finally, a value of @code{bdf-font-except-latin} |
52979
3649390c0f91
Replace @sc{ascii} and ASCII with @acronym{ASCII}.
Eli Zaretskii <eliz@gnu.org>
parents:
52701
diff
changeset
|
1599 instructs the printer to use built-in fonts for @acronym{ASCII} and Latin-1 |
37018
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1600 characters, and Intlfonts BDF fonts for the rest. |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1601 |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1602 @vindex bdf-directory-list |
38599
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
1603 To be able to use the BDF fonts, Emacs needs to know where to find |
37018
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1604 them. The variable @code{bdf-directory-list} holds the list of |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1605 directories where Emacs should look for the fonts; the default value |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1606 includes a single directory @file{/usr/local/share/emacs/fonts/bdf}. |
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1607 |
25829 | 1608 Many other customization variables for these commands are defined and |
37018
6883b349cfd6
(PostScript Variables): Explain how to set up use of
Eli Zaretskii <eliz@gnu.org>
parents:
36263
diff
changeset
|
1609 described in the Lisp files @file{ps-print.el} and @file{ps-mule.el}. |
25829 | 1610 |
63004
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1611 @node Printing Package,, PostScript Variables, Printing |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1612 @section Printing Package |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1613 @cindex Printing package |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1614 |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1615 The basic Emacs facilities for printing hardcopy can be extended |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1616 using the Printing package. This provides an easy-to-use interface |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1617 for choosing what to print, previewing PostScript files before |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1618 printing, and setting various printing options such as print headers, |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1619 landscape or portrait modes, duplex modes, and so forth. On GNU/Linux |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1620 or Unix systems, the Printing package relies on the @file{gs} and |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1621 @file{gv} utilities, which are distributed as part of the GhostScript |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1622 program. On MS-Windows, the @file{gstools} port of Ghostscript can be |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1623 used. |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1624 |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1625 @findex pr-interface |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1626 To use the Printing package, add @code{(require 'printing)} to your |
63069
e9052cfb189a
(Printing Package): Explain how to initialize printing package.
Richard M. Stallman <rms@gnu.org>
parents:
63004
diff
changeset
|
1627 init file (@pxref{Init File}), followed by @code{(pr-update-menus)}. |
e9052cfb189a
(Printing Package): Explain how to initialize printing package.
Richard M. Stallman <rms@gnu.org>
parents:
63004
diff
changeset
|
1628 This function replaces the usual printing commands in the menu bar |
e9052cfb189a
(Printing Package): Explain how to initialize printing package.
Richard M. Stallman <rms@gnu.org>
parents:
63004
diff
changeset
|
1629 with a @samp{Printing} submenu that contains various printing options. |
e9052cfb189a
(Printing Package): Explain how to initialize printing package.
Richard M. Stallman <rms@gnu.org>
parents:
63004
diff
changeset
|
1630 You can also type @kbd{M-x pr-interface RET}; this creates a |
e9052cfb189a
(Printing Package): Explain how to initialize printing package.
Richard M. Stallman <rms@gnu.org>
parents:
63004
diff
changeset
|
1631 @samp{*Printing Interface*} buffer, similar to a customization buffer, |
e9052cfb189a
(Printing Package): Explain how to initialize printing package.
Richard M. Stallman <rms@gnu.org>
parents:
63004
diff
changeset
|
1632 where you can set the printing options. After selecting what and how |
e9052cfb189a
(Printing Package): Explain how to initialize printing package.
Richard M. Stallman <rms@gnu.org>
parents:
63004
diff
changeset
|
1633 to print, you start the print job using the @samp{Print} button (click |
e9052cfb189a
(Printing Package): Explain how to initialize printing package.
Richard M. Stallman <rms@gnu.org>
parents:
63004
diff
changeset
|
1634 @kbd{mouse-2} on it, or move point over it and type @kbd{RET}). For |
e9052cfb189a
(Printing Package): Explain how to initialize printing package.
Richard M. Stallman <rms@gnu.org>
parents:
63004
diff
changeset
|
1635 further information on the various options, use the @samp{Interface |
e9052cfb189a
(Printing Package): Explain how to initialize printing package.
Richard M. Stallman <rms@gnu.org>
parents:
63004
diff
changeset
|
1636 Help} button. |
63004
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1637 |
740a0db30c0a
(Printing): Rename node from Hardcopy. Mention menu bar options.
Eli Zaretskii <eliz@gnu.org>
parents:
62473
diff
changeset
|
1638 @node Sorting, Narrowing, Printing, Top |
25829 | 1639 @section Sorting Text |
1640 @cindex sorting | |
1641 | |
1642 Emacs provides several commands for sorting text in the buffer. All | |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
1643 operate on the contents of the region. |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
1644 They divide the text of the region into many @dfn{sort records}, |
25829 | 1645 identify a @dfn{sort key} for each record, and then reorder the records |
1646 into the order determined by the sort keys. The records are ordered so | |
1647 that their keys are in alphabetical order, or, for numeric sorting, in | |
1648 numeric order. In alphabetic sorting, all upper-case letters `A' through | |
52979
3649390c0f91
Replace @sc{ascii} and ASCII with @acronym{ASCII}.
Eli Zaretskii <eliz@gnu.org>
parents:
52701
diff
changeset
|
1649 `Z' come before lower-case `a', in accord with the @acronym{ASCII} character |
25829 | 1650 sequence. |
1651 | |
1652 The various sort commands differ in how they divide the text into sort | |
1653 records and in which part of each record is used as the sort key. Most of | |
1654 the commands make each line a separate sort record, but some commands use | |
1655 paragraphs or pages as sort records. Most of the sort commands use each | |
1656 entire sort record as its own sort key, but some use only a portion of the | |
1657 record as the sort key. | |
1658 | |
1659 @findex sort-lines | |
1660 @findex sort-paragraphs | |
1661 @findex sort-pages | |
1662 @findex sort-fields | |
1663 @findex sort-numeric-fields | |
27469 | 1664 @vindex sort-numeric-base |
25829 | 1665 @table @kbd |
1666 @item M-x sort-lines | |
1667 Divide the region into lines, and sort by comparing the entire | |
1668 text of a line. A numeric argument means sort into descending order. | |
1669 | |
1670 @item M-x sort-paragraphs | |
1671 Divide the region into paragraphs, and sort by comparing the entire | |
1672 text of a paragraph (except for leading blank lines). A numeric | |
1673 argument means sort into descending order. | |
1674 | |
1675 @item M-x sort-pages | |
1676 Divide the region into pages, and sort by comparing the entire | |
1677 text of a page (except for leading blank lines). A numeric | |
1678 argument means sort into descending order. | |
1679 | |
1680 @item M-x sort-fields | |
1681 Divide the region into lines, and sort by comparing the contents of | |
1682 one field in each line. Fields are defined as separated by | |
1683 whitespace, so the first run of consecutive non-whitespace characters | |
1684 in a line constitutes field 1, the second such run constitutes field | |
1685 2, etc. | |
1686 | |
1687 Specify which field to sort by with a numeric argument: 1 to sort by | |
1688 field 1, etc. A negative argument means count fields from the right | |
1689 instead of from the left; thus, minus 1 means sort by the last field. | |
1690 If several lines have identical contents in the field being sorted, they | |
38599
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
1691 keep the same relative order that they had in the original buffer. |
25829 | 1692 |
1693 @item M-x sort-numeric-fields | |
1694 Like @kbd{M-x sort-fields} except the specified field is converted | |
1695 to an integer for each line, and the numbers are compared. @samp{10} | |
1696 comes before @samp{2} when considered as text, but after it when | |
27469 | 1697 considered as a number. By default, numbers are interpreted according |
1698 to @code{sort-numeric-base}, but numbers beginning with @samp{0x} or | |
1699 @samp{0} are interpreted as hexadecimal and octal, respectively. | |
25829 | 1700 |
1701 @item M-x sort-columns | |
1702 Like @kbd{M-x sort-fields} except that the text within each line | |
1703 used for comparison comes from a fixed range of columns. See below | |
1704 for an explanation. | |
1705 | |
1706 @item M-x reverse-region | |
1707 Reverse the order of the lines in the region. This is useful for | |
1708 sorting into descending order by fields or columns, since those sort | |
1709 commands do not have a feature for doing that. | |
1710 @end table | |
1711 | |
1712 For example, if the buffer contains this: | |
1713 | |
1714 @smallexample | |
1715 On systems where clash detection (locking of files being edited) is | |
1716 implemented, Emacs also checks the first time you modify a buffer | |
1717 whether the file has changed on disk since it was last visited or | |
1718 saved. If it has, you are asked to confirm that you want to change | |
1719 the buffer. | |
1720 @end smallexample | |
1721 | |
1722 @noindent | |
1723 applying @kbd{M-x sort-lines} to the entire buffer produces this: | |
1724 | |
1725 @smallexample | |
1726 On systems where clash detection (locking of files being edited) is | |
1727 implemented, Emacs also checks the first time you modify a buffer | |
1728 saved. If it has, you are asked to confirm that you want to change | |
1729 the buffer. | |
1730 whether the file has changed on disk since it was last visited or | |
1731 @end smallexample | |
1732 | |
1733 @noindent | |
1734 where the upper-case @samp{O} sorts before all lower-case letters. If | |
1735 you use @kbd{C-u 2 M-x sort-fields} instead, you get this: | |
1736 | |
1737 @smallexample | |
1738 implemented, Emacs also checks the first time you modify a buffer | |
1739 saved. If it has, you are asked to confirm that you want to change | |
1740 the buffer. | |
1741 On systems where clash detection (locking of files being edited) is | |
1742 whether the file has changed on disk since it was last visited or | |
1743 @end smallexample | |
1744 | |
1745 @noindent | |
1746 where the sort keys were @samp{Emacs}, @samp{If}, @samp{buffer}, | |
1747 @samp{systems} and @samp{the}. | |
1748 | |
1749 @findex sort-columns | |
1750 @kbd{M-x sort-columns} requires more explanation. You specify the | |
1751 columns by putting point at one of the columns and the mark at the other | |
1752 column. Because this means you cannot put point or the mark at the | |
1753 beginning of the first line of the text you want to sort, this command | |
36185 | 1754 uses an unusual definition of ``region'': all of the line point is in is |
25829 | 1755 considered part of the region, and so is all of the line the mark is in, |
1756 as well as all the lines in between. | |
1757 | |
1758 For example, to sort a table by information found in columns 10 to 15, | |
1759 you could put the mark on column 10 in the first line of the table, and | |
1760 point on column 15 in the last line of the table, and then run | |
1761 @code{sort-columns}. Equivalently, you could run it with the mark on | |
1762 column 15 in the first line and point on column 10 in the last line. | |
1763 | |
1764 This can be thought of as sorting the rectangle specified by point and | |
1765 the mark, except that the text on each line to the left or right of the | |
1766 rectangle moves along with the text inside the rectangle. | |
1767 @xref{Rectangles}. | |
1768 | |
1769 @vindex sort-fold-case | |
1770 Many of the sort commands ignore case differences when comparing, if | |
1771 @code{sort-fold-case} is non-@code{nil}. | |
1772 | |
70368
8bc86cbc5164
(Diff Mode): Moved to files.texi.
Richard M. Stallman <rms@gnu.org>
parents:
70334
diff
changeset
|
1773 @node Narrowing, Two-Column, Sorting, Top |
25829 | 1774 @section Narrowing |
1775 @cindex widening | |
1776 @cindex restriction | |
1777 @cindex narrowing | |
1778 @cindex accessible portion | |
1779 | |
1780 @dfn{Narrowing} means focusing in on some portion of the buffer, | |
1781 making the rest temporarily inaccessible. The portion which you can | |
1782 still get to is called the @dfn{accessible portion}. Canceling the | |
1783 narrowing, which makes the entire buffer once again accessible, is | |
71586
044c5a8f7744
(Narrowing): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents:
71149
diff
changeset
|
1784 called @dfn{widening}. The bounds of narrowing in effect in a buffer |
044c5a8f7744
(Narrowing): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents:
71149
diff
changeset
|
1785 are called the buffer's @dfn{restriction}. |
25829 | 1786 |
1787 Narrowing can make it easier to concentrate on a single subroutine or | |
71586
044c5a8f7744
(Narrowing): Minor cleanups.
Richard M. Stallman <rms@gnu.org>
parents:
71149
diff
changeset
|
1788 paragraph by eliminating clutter. It can also be used to limit the |
25829 | 1789 range of operation of a replace command or repeating keyboard macro. |
1790 | |
1791 @table @kbd | |
1792 @item C-x n n | |
1793 Narrow down to between point and mark (@code{narrow-to-region}). | |
1794 @item C-x n w | |
1795 Widen to make the entire buffer accessible again (@code{widen}). | |
1796 @item C-x n p | |
1797 Narrow down to the current page (@code{narrow-to-page}). | |
1798 @item C-x n d | |
1799 Narrow down to the current defun (@code{narrow-to-defun}). | |
1800 @end table | |
1801 | |
1802 When you have narrowed down to a part of the buffer, that part appears | |
1803 to be all there is. You can't see the rest, you can't move into it | |
1804 (motion commands won't go outside the accessible part), you can't change | |
1805 it in any way. However, it is not gone, and if you save the file all | |
1806 the inaccessible text will be saved. The word @samp{Narrow} appears in | |
1807 the mode line whenever narrowing is in effect. | |
1808 | |
1809 @kindex C-x n n | |
1810 @findex narrow-to-region | |
1811 The primary narrowing command is @kbd{C-x n n} (@code{narrow-to-region}). | |
1812 It sets the current buffer's restrictions so that the text in the current | |
38599
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
1813 region remains accessible, but all text before the region or after the |
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
1814 region is inaccessible. Point and mark do not change. |
25829 | 1815 |
1816 @kindex C-x n p | |
1817 @findex narrow-to-page | |
1818 @kindex C-x n d | |
1819 @findex narrow-to-defun | |
1820 Alternatively, use @kbd{C-x n p} (@code{narrow-to-page}) to narrow | |
1821 down to the current page. @xref{Pages}, for the definition of a page. | |
1822 @kbd{C-x n d} (@code{narrow-to-defun}) narrows down to the defun | |
1823 containing point (@pxref{Defuns}). | |
1824 | |
1825 @kindex C-x n w | |
1826 @findex widen | |
1827 The way to cancel narrowing is to widen with @kbd{C-x n w} | |
1828 (@code{widen}). This makes all text in the buffer accessible again. | |
1829 | |
1830 You can get information on what part of the buffer you are narrowed down | |
1831 to using the @kbd{C-x =} command. @xref{Position Info}. | |
1832 | |
1833 Because narrowing can easily confuse users who do not understand it, | |
1834 @code{narrow-to-region} is normally a disabled command. Attempting to use | |
1835 this command asks for confirmation and gives you the option of enabling it; | |
1836 if you enable the command, confirmation will no longer be required for | |
1837 it. @xref{Disabling}. | |
1838 | |
70368
8bc86cbc5164
(Diff Mode): Moved to files.texi.
Richard M. Stallman <rms@gnu.org>
parents:
70334
diff
changeset
|
1839 @node Two-Column, Editing Binary Files, Narrowing, Top |
25829 | 1840 @section Two-Column Editing |
1841 @cindex two-column editing | |
1842 @cindex splitting columns | |
1843 @cindex columns, splitting | |
1844 | |
1845 Two-column mode lets you conveniently edit two side-by-side columns of | |
1846 text. It uses two side-by-side windows, each showing its own | |
1847 buffer. | |
1848 | |
1849 There are three ways to enter two-column mode: | |
1850 | |
1851 @table @asis | |
1852 @item @kbd{@key{F2} 2} or @kbd{C-x 6 2} | |
1853 @kindex F2 2 | |
1854 @kindex C-x 6 2 | |
1855 @findex 2C-two-columns | |
1856 Enter two-column mode with the current buffer on the left, and on the | |
1857 right, a buffer whose name is based on the current buffer's name | |
1858 (@code{2C-two-columns}). If the right-hand buffer doesn't already | |
1859 exist, it starts out empty; the current buffer's contents are not | |
1860 changed. | |
1861 | |
1862 This command is appropriate when the current buffer is empty or contains | |
1863 just one column and you want to add another column. | |
1864 | |
1865 @item @kbd{@key{F2} s} or @kbd{C-x 6 s} | |
1866 @kindex F2 s | |
1867 @kindex C-x 6 s | |
1868 @findex 2C-split | |
1869 Split the current buffer, which contains two-column text, into two | |
1870 buffers, and display them side by side (@code{2C-split}). The current | |
1871 buffer becomes the left-hand buffer, but the text in the right-hand | |
1872 column is moved into the right-hand buffer. The current column | |
1873 specifies the split point. Splitting starts with the current line and | |
1874 continues to the end of the buffer. | |
1875 | |
1876 This command is appropriate when you have a buffer that already contains | |
1877 two-column text, and you wish to separate the columns temporarily. | |
1878 | |
1879 @item @kbd{@key{F2} b @var{buffer} @key{RET}} | |
1880 @itemx @kbd{C-x 6 b @var{buffer} @key{RET}} | |
1881 @kindex F2 b | |
1882 @kindex C-x 6 b | |
1883 @findex 2C-associate-buffer | |
1884 Enter two-column mode using the current buffer as the left-hand buffer, | |
1885 and using buffer @var{buffer} as the right-hand buffer | |
1886 (@code{2C-associate-buffer}). | |
1887 @end table | |
1888 | |
1889 @kbd{@key{F2} s} or @kbd{C-x 6 s} looks for a column separator, which | |
1890 is a string that appears on each line between the two columns. You can | |
1891 specify the width of the separator with a numeric argument to | |
1892 @kbd{@key{F2} s}; that many characters, before point, constitute the | |
1893 separator string. By default, the width is 1, so the column separator | |
1894 is the character before point. | |
1895 | |
1896 When a line has the separator at the proper place, @kbd{@key{F2} s} | |
1897 puts the text after the separator into the right-hand buffer, and | |
1898 deletes the separator. Lines that don't have the column separator at | |
1899 the proper place remain unsplit; they stay in the left-hand buffer, and | |
1900 the right-hand buffer gets an empty line to correspond. (This is the | |
1901 way to write a line that ``spans both columns while in two-column | |
1902 mode'': write it in the left-hand buffer, and put an empty line in the | |
1903 right-hand buffer.) | |
1904 | |
1905 @kindex F2 RET | |
1906 @kindex C-x 6 RET | |
1907 @findex 2C-newline | |
1908 The command @kbd{C-x 6 @key{RET}} or @kbd{@key{F2} @key{RET}} | |
1909 (@code{2C-newline}) inserts a newline in each of the two buffers at | |
1910 corresponding positions. This is the easiest way to add a new line to | |
1911 the two-column text while editing it in split buffers. | |
1912 | |
1913 @kindex F2 1 | |
1914 @kindex C-x 6 1 | |
1915 @findex 2C-merge | |
1916 When you have edited both buffers as you wish, merge them with | |
1917 @kbd{@key{F2} 1} or @kbd{C-x 6 1} (@code{2C-merge}). This copies the | |
1918 text from the right-hand buffer as a second column in the other buffer. | |
1919 To go back to two-column editing, use @kbd{@key{F2} s}. | |
1920 | |
1921 @kindex F2 d | |
1922 @kindex C-x 6 d | |
1923 @findex 2C-dissociate | |
1924 Use @kbd{@key{F2} d} or @kbd{C-x 6 d} to dissociate the two buffers, | |
1925 leaving each as it stands (@code{2C-dissociate}). If the other buffer, | |
1926 the one not current when you type @kbd{@key{F2} d}, is empty, | |
1927 @kbd{@key{F2} d} kills it. | |
1928 | |
1929 @node Editing Binary Files, Saving Emacs Sessions, Two-Column, Top | |
1930 @section Editing Binary Files | |
1931 | |
1932 @cindex Hexl mode | |
1933 @cindex mode, Hexl | |
1934 @cindex editing binary files | |
31029 | 1935 @cindex hex editing |
25829 | 1936 There is a special major mode for editing binary files: Hexl mode. To |
1937 use it, use @kbd{M-x hexl-find-file} instead of @kbd{C-x C-f} to visit | |
1938 the file. This command converts the file's contents to hexadecimal and | |
1939 lets you edit the translation. When you save the file, it is converted | |
1940 automatically back to binary. | |
1941 | |
1942 You can also use @kbd{M-x hexl-mode} to translate an existing buffer | |
1943 into hex. This is useful if you visit a file normally and then discover | |
1944 it is a binary file. | |
1945 | |
1946 Ordinary text characters overwrite in Hexl mode. This is to reduce | |
1947 the risk of accidentally spoiling the alignment of data in the file. | |
1948 There are special commands for insertion. Here is a list of the | |
1949 commands of Hexl mode: | |
1950 | |
1951 @c I don't think individual index entries for these commands are useful--RMS. | |
1952 @table @kbd | |
1953 @item C-M-d | |
1954 Insert a byte with a code typed in decimal. | |
1955 | |
1956 @item C-M-o | |
1957 Insert a byte with a code typed in octal. | |
1958 | |
1959 @item C-M-x | |
1960 Insert a byte with a code typed in hex. | |
1961 | |
1962 @item C-x [ | |
1963 Move to the beginning of a 1k-byte ``page.'' | |
1964 | |
1965 @item C-x ] | |
1966 Move to the end of a 1k-byte ``page.'' | |
1967 | |
1968 @item M-g | |
1969 Move to an address specified in hex. | |
1970 | |
1971 @item M-j | |
1972 Move to an address specified in decimal. | |
1973 | |
1974 @item C-c C-c | |
1975 Leave Hexl mode, going back to the major mode this buffer had before you | |
1976 invoked @code{hexl-mode}. | |
1977 @end table | |
1978 | |
31029 | 1979 @noindent |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
1980 Other Hexl commands let you insert strings (sequences) of binary |
38599
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
1981 bytes, move by @code{short}s or @code{int}s, etc.; type @kbd{C-h a |
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
1982 hexl-@key{RET}} for details. |
31029 | 1983 |
1984 | |
25829 | 1985 @node Saving Emacs Sessions, Recursive Edit, Editing Binary Files, Top |
1986 @section Saving Emacs Sessions | |
1987 @cindex saving sessions | |
38025
64ee3e7394ed
Add a few more index entries for desktop.el.
Eli Zaretskii <eliz@gnu.org>
parents:
38017
diff
changeset
|
1988 @cindex restore session |
64ee3e7394ed
Add a few more index entries for desktop.el.
Eli Zaretskii <eliz@gnu.org>
parents:
38017
diff
changeset
|
1989 @cindex remember editing session |
64ee3e7394ed
Add a few more index entries for desktop.el.
Eli Zaretskii <eliz@gnu.org>
parents:
38017
diff
changeset
|
1990 @cindex reload files |
25829 | 1991 @cindex desktop |
1992 | |
52701
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
1993 Use the desktop library to save the state of Emacs from one session |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
1994 to another. Once you save the Emacs @dfn{desktop}---the buffers, |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
1995 their file names, major modes, buffer positions, and so on---then |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
1996 subsequent Emacs sessions reload the saved desktop. |
52675
131935ba4b30
Section "Saving Emacs Sessions" rewritten.
Lars Hansen <larsh@soem.dk>
parents:
52401
diff
changeset
|
1997 |
52701
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
1998 @findex desktop-save |
52675
131935ba4b30
Section "Saving Emacs Sessions" rewritten.
Lars Hansen <larsh@soem.dk>
parents:
52401
diff
changeset
|
1999 @vindex desktop-save-mode |
52701
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2000 You can save the desktop manually with the command @kbd{M-x |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
2001 desktop-save}. You can also enable automatic desktop saving when |
52701
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2002 you exit Emacs: use the Customization buffer (@pxref{Easy |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2003 Customization}) to set @code{desktop-save-mode} to @code{t} for future |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2004 sessions, or add this line in your @file{~/.emacs} file: |
25829 | 2005 |
2006 @example | |
52675
131935ba4b30
Section "Saving Emacs Sessions" rewritten.
Lars Hansen <larsh@soem.dk>
parents:
52401
diff
changeset
|
2007 (desktop-save-mode 1) |
25829 | 2008 @end example |
2009 | |
52675
131935ba4b30
Section "Saving Emacs Sessions" rewritten.
Lars Hansen <larsh@soem.dk>
parents:
52401
diff
changeset
|
2010 @findex desktop-change-dir |
131935ba4b30
Section "Saving Emacs Sessions" rewritten.
Lars Hansen <larsh@soem.dk>
parents:
52401
diff
changeset
|
2011 @findex desktop-revert |
52701
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2012 When Emacs starts, it looks for a saved desktop in the current |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2013 directory. Thus, you can have separate saved desktops in different |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2014 directories, and the starting directory determines which one Emacs |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2015 reloads. You can save the current desktop and reload one saved in |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2016 another directory by typing @kbd{M-x desktop-change-dir}. Typing |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2017 @kbd{M-x desktop-revert} reverts to the desktop previously reloaded. |
52675
131935ba4b30
Section "Saving Emacs Sessions" rewritten.
Lars Hansen <larsh@soem.dk>
parents:
52401
diff
changeset
|
2018 |
52701
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2019 Specify the option @samp{--no-desktop} on the command line when you |
61639
ed1c184086c0
(Saving Emacs Sessions): Add that "--no-desktop" turns off desktop-save-mode.
Lars Hansen <larsh@soem.dk>
parents:
61102
diff
changeset
|
2020 don't want it to reload any saved desktop. This turns off |
ed1c184086c0
(Saving Emacs Sessions): Add that "--no-desktop" turns off desktop-save-mode.
Lars Hansen <larsh@soem.dk>
parents:
61102
diff
changeset
|
2021 @code{desktop-save-mode} for the current session. |
52675
131935ba4b30
Section "Saving Emacs Sessions" rewritten.
Lars Hansen <larsh@soem.dk>
parents:
52401
diff
changeset
|
2022 |
60799
bab476ff521c
(Saving Emacs Sessions): Document desktop-restore-eager.
Richard M. Stallman <rms@gnu.org>
parents:
60496
diff
changeset
|
2023 @vindex desktop-restore-eager |
bab476ff521c
(Saving Emacs Sessions): Document desktop-restore-eager.
Richard M. Stallman <rms@gnu.org>
parents:
60496
diff
changeset
|
2024 By default, all the buffers in the desktop are restored at one go. |
bab476ff521c
(Saving Emacs Sessions): Document desktop-restore-eager.
Richard M. Stallman <rms@gnu.org>
parents:
60496
diff
changeset
|
2025 However, this may be slow if there are a lot of buffers in the |
bab476ff521c
(Saving Emacs Sessions): Document desktop-restore-eager.
Richard M. Stallman <rms@gnu.org>
parents:
60496
diff
changeset
|
2026 desktop. You can specify the maximum number of buffers to restore |
bab476ff521c
(Saving Emacs Sessions): Document desktop-restore-eager.
Richard M. Stallman <rms@gnu.org>
parents:
60496
diff
changeset
|
2027 immediately with the variable @code{desktop-restore-eager}; the |
bab476ff521c
(Saving Emacs Sessions): Document desktop-restore-eager.
Richard M. Stallman <rms@gnu.org>
parents:
60496
diff
changeset
|
2028 remaining buffers are restored ``lazily,'' when Emacs is idle. |
bab476ff521c
(Saving Emacs Sessions): Document desktop-restore-eager.
Richard M. Stallman <rms@gnu.org>
parents:
60496
diff
changeset
|
2029 |
52675
131935ba4b30
Section "Saving Emacs Sessions" rewritten.
Lars Hansen <larsh@soem.dk>
parents:
52401
diff
changeset
|
2030 @findex desktop-clear |
131935ba4b30
Section "Saving Emacs Sessions" rewritten.
Lars Hansen <larsh@soem.dk>
parents:
52401
diff
changeset
|
2031 @vindex desktop-globals-to-clear |
131935ba4b30
Section "Saving Emacs Sessions" rewritten.
Lars Hansen <larsh@soem.dk>
parents:
52401
diff
changeset
|
2032 @vindex desktop-clear-preserve-buffers-regexp |
52701
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2033 Type @kbd{M-x desktop-clear} to empty the Emacs desktop. This kills |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2034 all buffers except for internal ones, and clears the global variables |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2035 listed in @code{desktop-globals-to-clear}. If you want this to |
52675
131935ba4b30
Section "Saving Emacs Sessions" rewritten.
Lars Hansen <larsh@soem.dk>
parents:
52401
diff
changeset
|
2036 preserve certain buffers, customize the variable |
52701
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2037 @code{desktop-clear-preserve-buffers-regexp}, whose value is a regular |
594b1eb2dd76
(Saving Emacs Sessions): Shorten the section, collapsing back into one node.
Richard M. Stallman <rms@gnu.org>
parents:
52675
diff
changeset
|
2038 expression matching the names of buffers not to kill. |
29083 | 2039 |
66098
ac281b254006
(Saving Emacs Sessions): Mention savehist library.
Richard M. Stallman <rms@gnu.org>
parents:
64890
diff
changeset
|
2040 If you want to save minibuffer history from one session to |
ac281b254006
(Saving Emacs Sessions): Mention savehist library.
Richard M. Stallman <rms@gnu.org>
parents:
64890
diff
changeset
|
2041 another, use the @code{savehist} library. |
ac281b254006
(Saving Emacs Sessions): Mention savehist library.
Richard M. Stallman <rms@gnu.org>
parents:
64890
diff
changeset
|
2042 |
25829 | 2043 @node Recursive Edit, Emulation, Saving Emacs Sessions, Top |
2044 @section Recursive Editing Levels | |
2045 @cindex recursive editing level | |
2046 @cindex editing level, recursive | |
2047 | |
2048 A @dfn{recursive edit} is a situation in which you are using Emacs | |
2049 commands to perform arbitrary editing while in the middle of another | |
2050 Emacs command. For example, when you type @kbd{C-r} inside of a | |
2051 @code{query-replace}, you enter a recursive edit in which you can change | |
2052 the current buffer. On exiting from the recursive edit, you go back to | |
2053 the @code{query-replace}. | |
2054 | |
2055 @kindex C-M-c | |
2056 @findex exit-recursive-edit | |
2057 @cindex exiting recursive edit | |
2058 @dfn{Exiting} the recursive edit means returning to the unfinished | |
2059 command, which continues execution. The command to exit is @kbd{C-M-c} | |
2060 (@code{exit-recursive-edit}). | |
2061 | |
2062 You can also @dfn{abort} the recursive edit. This is like exiting, | |
2063 but also quits the unfinished command immediately. Use the command | |
2064 @kbd{C-]} (@code{abort-recursive-edit}) to do this. @xref{Quitting}. | |
2065 | |
2066 The mode line shows you when you are in a recursive edit by displaying | |
2067 square brackets around the parentheses that always surround the major and | |
38599
29e540f10e62
Proofreading changes from JDonner <jdonner0@earthlink.net>.
Eli Zaretskii <eliz@gnu.org>
parents:
38467
diff
changeset
|
2068 minor mode names. Every window's mode line shows this in the same way, |
25829 | 2069 since being in a recursive edit is true of Emacs as a whole rather than |
2070 any particular window or buffer. | |
2071 | |
2072 It is possible to be in recursive edits within recursive edits. For | |
2073 example, after typing @kbd{C-r} in a @code{query-replace}, you may type a | |
2074 command that enters the debugger. This begins a recursive editing level | |
2075 for the debugger, within the recursive editing level for @kbd{C-r}. | |
2076 Mode lines display a pair of square brackets for each recursive editing | |
2077 level currently in progress. | |
2078 | |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
2079 Exiting the inner recursive edit (such as with the debugger @kbd{c} |
25829 | 2080 command) resumes the command running in the next level up. When that |
2081 command finishes, you can then use @kbd{C-M-c} to exit another recursive | |
2082 editing level, and so on. Exiting applies to the innermost level only. | |
2083 Aborting also gets out of only one level of recursive edit; it returns | |
2084 immediately to the command level of the previous recursive edit. If you | |
2085 wish, you can then abort the next recursive editing level. | |
2086 | |
2087 Alternatively, the command @kbd{M-x top-level} aborts all levels of | |
2088 recursive edits, returning immediately to the top-level command reader. | |
2089 | |
2090 The text being edited inside the recursive edit need not be the same text | |
2091 that you were editing at top level. It depends on what the recursive edit | |
2092 is for. If the command that invokes the recursive edit selects a different | |
2093 buffer first, that is the buffer you will edit recursively. In any case, | |
2094 you can switch buffers within the recursive edit in the normal manner (as | |
2095 long as the buffer-switching keys have not been rebound). You could | |
2096 probably do all the rest of your editing inside the recursive edit, | |
2097 visiting files and all. But this could have surprising effects (such as | |
2098 stack overflow) from time to time. So remember to exit or abort the | |
2099 recursive edit when you no longer need it. | |
2100 | |
2101 In general, we try to minimize the use of recursive editing levels in | |
2102 GNU Emacs. This is because they constrain you to ``go back'' in a | |
2103 particular order---from the innermost level toward the top level. When | |
2104 possible, we present different activities in separate buffers so that | |
2105 you can switch between them as you please. Some commands switch to a | |
2106 new major mode which provides a command to switch back. These | |
2107 approaches give you more flexibility to go back to unfinished tasks in | |
2108 the order you choose. | |
2109 | |
28448 | 2110 @node Emulation, Hyperlinking, Recursive Edit, Top |
25829 | 2111 @section Emulation |
2112 @cindex emulating other editors | |
2113 @cindex other editors | |
2114 @cindex EDT | |
2115 @cindex vi | |
39263 | 2116 @cindex PC key bindings |
27210 | 2117 @cindex scrolling all windows |
39263 | 2118 @cindex PC selection |
2119 @cindex Motif key bindings | |
2120 @cindex Macintosh key bindings | |
27210 | 2121 @cindex WordStar |
25829 | 2122 |
2123 GNU Emacs can be programmed to emulate (more or less) most other | |
2124 editors. Standard facilities can emulate these: | |
2125 | |
2126 @table @asis | |
27210 | 2127 @item CRiSP/Brief (PC editor) |
2128 @findex crisp-mode | |
2129 @vindex crisp-override-meta-x | |
2130 @findex scroll-all-mode | |
30856 | 2131 @cindex CRiSP mode |
2132 @cindex Brief emulation | |
36263
11db0318031d
Remove redundant index entries.
Eli Zaretskii <eliz@gnu.org>
parents:
36185
diff
changeset
|
2133 @cindex emulation of Brief |
30856 | 2134 @cindex mode, CRiSP |
39263 | 2135 You can turn on key bindings to emulate the CRiSP/Brief editor with |
30856 | 2136 @kbd{M-x crisp-mode}. Note that this rebinds @kbd{M-x} to exit Emacs |
59798
0816b427495a
Don't say just "option" when talking about variables.
Richard M. Stallman <rms@gnu.org>
parents:
58928
diff
changeset
|
2137 unless you set the variable @code{crisp-override-meta-x}. You can |
0816b427495a
Don't say just "option" when talking about variables.
Richard M. Stallman <rms@gnu.org>
parents:
58928
diff
changeset
|
2138 also use the command @kbd{M-x scroll-all-mode} or set the variable |
30856 | 2139 @code{crisp-load-scroll-all} to emulate CRiSP's scroll-all feature |
2140 (scrolling all windows together). | |
27210 | 2141 |
25829 | 2142 @item EDT (DEC VMS editor) |
2143 @findex edt-emulation-on | |
2144 @findex edt-emulation-off | |
2145 Turn on EDT emulation with @kbd{M-x edt-emulation-on}. @kbd{M-x | |
2146 edt-emulation-off} restores normal Emacs command bindings. | |
2147 | |
2148 Most of the EDT emulation commands are keypad keys, and most standard | |
2149 Emacs key bindings are still available. The EDT emulation rebindings | |
2150 are done in the global keymap, so there is no problem switching | |
2151 buffers or major modes while in EDT emulation. | |
2152 | |
28448 | 2153 @item TPU (DEC VMS editor) |
2154 @findex tpu-edt-on | |
2155 @cindex TPU | |
2156 @kbd{M-x tpu-edt-on} turns on emulation of the TPU editor emulating EDT. | |
2157 | |
25829 | 2158 @item vi (Berkeley editor) |
2159 @findex viper-mode | |
2160 Viper is the newest emulator for vi. It implements several levels of | |
2161 emulation; level 1 is closest to vi itself, while level 5 departs | |
2162 somewhat from strict emulation to take advantage of the capabilities of | |
2163 Emacs. To invoke Viper, type @kbd{M-x viper-mode}; it will guide you | |
2164 the rest of the way and ask for the emulation level. @inforef{Top, | |
2165 Viper, viper}. | |
2166 | |
2167 @item vi (another emulator) | |
2168 @findex vi-mode | |
2169 @kbd{M-x vi-mode} enters a major mode that replaces the previously | |
2170 established major mode. All of the vi commands that, in real vi, enter | |
2171 ``input'' mode are programmed instead to return to the previous major | |
2172 mode. Thus, ordinary Emacs serves as vi's ``input'' mode. | |
2173 | |
2174 Because vi emulation works through major modes, it does not work | |
2175 to switch buffers during emulation. Return to normal Emacs first. | |
2176 | |
2177 If you plan to use vi emulation much, you probably want to bind a key | |
2178 to the @code{vi-mode} command. | |
2179 | |
2180 @item vi (alternate emulator) | |
2181 @findex vip-mode | |
2182 @kbd{M-x vip-mode} invokes another vi emulator, said to resemble real vi | |
2183 more thoroughly than @kbd{M-x vi-mode}. ``Input'' mode in this emulator | |
2184 is changed from ordinary Emacs so you can use @key{ESC} to go back to | |
2185 emulated vi command mode. To get from emulated vi command mode back to | |
2186 ordinary Emacs, type @kbd{C-z}. | |
2187 | |
2188 This emulation does not work through major modes, and it is possible | |
2189 to switch buffers in various ways within the emulator. It is not | |
2190 so necessary to assign a key to the command @code{vip-mode} as | |
2191 it is with @code{vi-mode} because terminating insert mode does | |
2192 not use it. | |
2193 | |
2194 @inforef{Top, VIP, vip}, for full information. | |
27210 | 2195 |
2196 @item WordStar (old wordprocessor) | |
2197 @findex wordstar-mode | |
2198 @kbd{M-x wordstar-mode} provides a major mode with WordStar-like | |
39263 | 2199 key bindings. |
25829 | 2200 @end table |
2201 | |
69737 | 2202 @node Hyperlinking, Thumbnails, Emulation, Top |
28448 | 2203 @section Hyperlinking and Navigation Features |
2204 | |
2205 @cindex hyperlinking | |
2206 @cindex navigation | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2207 Various modes documented elsewhere have hypertext features so that |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2208 you can follow links, usually by clicking @kbd{Mouse-2} on the link or |
60432
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
2209 typing @key{RET} while point is on the link. Clicking @kbd{Mouse-1} |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
2210 quickly on the link also follows it. (Hold @kbd{Mouse-1} for longer |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
2211 if you want to set point instead.) |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
2212 |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
2213 Info mode, Help mode and the Dired-like modes are examples of modes |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
2214 that have links in the buffer. The Tags facility links between uses |
1dd713cadb8a
(Single Shell): Replace uudecode example with gpg example.
Richard M. Stallman <rms@gnu.org>
parents:
59798
diff
changeset
|
2215 and definitions in source files, see @ref{Tags}. Imenu provides |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2216 navigation amongst items indexed in the current buffer, see |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2217 @ref{Imenu}. Info-lookup provides mode-specific lookup of definitions |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2218 in Info indexes, see @ref{Documentation}. Speedbar maintains a frame |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2219 in which links to files, and locations in files are displayed, see |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2220 @ref{Speedbar}. |
30856 | 2221 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2222 Other non-mode-specific facilities described in this section enable |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2223 following links from the current buffer in a context-sensitive |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2224 fashion. |
28448 | 2225 |
30856 | 2226 @menu |
2227 * Browse-URL:: Following URLs. | |
2228 * Goto-address:: Activating URLs. | |
2229 * FFAP:: Finding files etc. at point. | |
2230 @end menu | |
28448 | 2231 |
30856 | 2232 @node Browse-URL |
2233 @subsection Following URLs | |
28448 | 2234 @cindex World Wide Web |
30856 | 2235 @cindex Web |
28448 | 2236 @findex browse-url |
2237 @findex browse-url-at-point | |
2238 @findex browse-url-at-mouse | |
2239 @cindex Browse-URL | |
2240 @cindex URLs | |
30856 | 2241 |
2242 @table @kbd | |
37846
d8b197c6f26d
Explain M-! output can go in echo area.
Richard M. Stallman <rms@gnu.org>
parents:
37018
diff
changeset
|
2243 @item M-x browse-url @key{RET} @var{url} @key{RET} |
30856 | 2244 Load a URL into a Web browser. |
2245 @end table | |
2246 | |
28448 | 2247 The Browse-URL package provides facilities for following URLs specifying |
2248 links on the World Wide Web. Usually this works by invoking a web | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2249 browser, but you can, for instance, arrange to invoke @code{compose-mail} |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2250 from @samp{mailto:} URLs. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2251 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2252 The general way to use this feature is to type @kbd{M-x browse-url}, |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2253 which displays a specified URL. If point is located near a plausible |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2254 URL, that URL is used as the default. Other commands are available |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2255 which you might like to bind to keys, such as |
30856 | 2256 @code{browse-url-at-point} and @code{browse-url-at-mouse}. |
28448 | 2257 |
30856 | 2258 @vindex browse-url-browser-function |
38017
32f10000ac35
Don't use the British spelling of "behaviour".
Eli Zaretskii <eliz@gnu.org>
parents:
37846
diff
changeset
|
2259 You can customize Browse-URL's behavior via various options in the |
30856 | 2260 @code{browse-url} Customize group, particularly |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2261 @code{browse-url-browser-function}. You can invoke actions dependent |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2262 on the type of URL by defining @code{browse-url-browser-function} as |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2263 an association list. The package's commentary available via @kbd{C-h |
54475
01fa7e81affb
(Browse-URL, FFAP): Add information about keywords.
Juri Linkov <juri@jurta.org>
parents:
52979
diff
changeset
|
2264 p} under the @samp{hypermedia} keyword provides more information. |
01fa7e81affb
(Browse-URL, FFAP): Add information about keywords.
Juri Linkov <juri@jurta.org>
parents:
52979
diff
changeset
|
2265 Packages with facilities for following URLs should always go through |
01fa7e81affb
(Browse-URL, FFAP): Add information about keywords.
Juri Linkov <juri@jurta.org>
parents:
52979
diff
changeset
|
2266 Browse-URL, so that the customization options for Browse-URL will |
01fa7e81affb
(Browse-URL, FFAP): Add information about keywords.
Juri Linkov <juri@jurta.org>
parents:
52979
diff
changeset
|
2267 affect all browsing in Emacs. |
28448 | 2268 |
30856 | 2269 @node Goto-address |
2270 @subsection Activating URLs | |
28448 | 2271 @findex goto-address |
2272 @cindex Goto-address | |
2273 @cindex URLs, activating | |
30856 | 2274 |
2275 @table @kbd | |
2276 @item M-x goto-address | |
2277 Activate URLs and e-mail addresses in the current buffer. | |
2278 @end table | |
2279 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2280 You can make URLs in the current buffer active with @kbd{M-x |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2281 goto-address}. This finds all the URLs in the buffer, and establishes |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2282 bindings for @kbd{Mouse-2} and @kbd{C-c @key{RET}} on them. After |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2283 activation, if you click on a URL with @kbd{Mouse-2}, or move to a URL |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2284 and type @kbd{C-c @key{RET}}, that will display the web page that the URL |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2285 specifies. For a @samp{mailto} URL, it sends mail instead, using your |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2286 selected mail-composition method (@pxref{Mail Methods}). |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2287 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2288 It can be useful to add @code{goto-address} to mode hooks and the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2289 hooks used to display an incoming message. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2290 @code{rmail-show-message-hook} is the appropriate hook for Rmail, and |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2291 @code{mh-show-mode-hook} for MH-E. This is not needed for Gnus, |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2292 which has a similar feature of its own. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2293 |
28448 | 2294 |
30856 | 2295 @node FFAP |
2296 @subsection Finding Files and URLs at Point | |
28448 | 2297 @findex find-file-at-point |
2298 @findex ffap | |
58928
4a354500d0f8
ffap-dired-at-point -> dired-at-point
Juri Linkov <juri@jurta.org>
parents:
58925
diff
changeset
|
2299 @findex dired-at-point |
30856 | 2300 @findex ffap-next |
2301 @findex ffap-menu | |
2302 @cindex finding file at point | |
2303 | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2304 FFAP mode replaces certain key bindings for finding files, including |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2305 @kbd{C-x C-f}, with commands that provide more sensitive defaults. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2306 These commands behave like the ordinary ones when given a prefix |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2307 argument. Otherwise, they get the default file name or URL from the |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2308 text around point. If what is found in the buffer has the form of a |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2309 URL rather than a file name, the commands use @code{browse-url} to |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2310 view it. |
30856 | 2311 |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2312 This feature is useful for following references in mail or news |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2313 buffers, @file{README} files, @file{MANIFEST} files, and so on. The |
54475
01fa7e81affb
(Browse-URL, FFAP): Add information about keywords.
Juri Linkov <juri@jurta.org>
parents:
52979
diff
changeset
|
2314 @samp{ffap} package's commentary available via @kbd{C-h p} under the |
01fa7e81affb
(Browse-URL, FFAP): Add information about keywords.
Juri Linkov <juri@jurta.org>
parents:
52979
diff
changeset
|
2315 @samp{files} keyword and the @code{ffap} Custom group provide details. |
28448 | 2316 |
30856 | 2317 @cindex FFAP minor mode |
2318 @findex ffap-mode | |
54475
01fa7e81affb
(Browse-URL, FFAP): Add information about keywords.
Juri Linkov <juri@jurta.org>
parents:
52979
diff
changeset
|
2319 You can turn on FFAP minor mode by calling @code{ffap-bindings} to |
01fa7e81affb
(Browse-URL, FFAP): Add information about keywords.
Juri Linkov <juri@jurta.org>
parents:
52979
diff
changeset
|
2320 make the following key bindings and to install hooks for using |
01fa7e81affb
(Browse-URL, FFAP): Add information about keywords.
Juri Linkov <juri@jurta.org>
parents:
52979
diff
changeset
|
2321 @code{ffap} in Rmail, Gnus and VM article buffers. |
30856 | 2322 |
2323 @table @kbd | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2324 @item C-x C-f @var{filename} @key{RET} |
30856 | 2325 @kindex C-x C-f @r{(FFAP)} |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2326 Find @var{filename}, guessing a default from text around point |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2327 (@code{find-file-at-point}). |
58925
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2328 @item C-x C-r |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2329 @kindex C-x C-r @r{(FFAP)} |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2330 @code{ffap-read-only}, analogous to @code{find-file-read-only}. |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2331 @item C-x C-v |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2332 @kindex C-x C-v @r{(FFAP)} |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2333 @code{ffap-alternate-file}, analogous to @code{find-alternate-file}. |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2334 @item C-x d @var{directory} @key{RET} |
30856 | 2335 @kindex C-x d @r{(FFAP)} |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2336 Start Dired on @var{directory}, defaulting to the directory name at |
58928
4a354500d0f8
ffap-dired-at-point -> dired-at-point
Juri Linkov <juri@jurta.org>
parents:
58925
diff
changeset
|
2337 point (@code{dired-at-point}). |
58925
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2338 @item C-x C-d |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2339 @code{ffap-list-directory}, analogous to @code{list-directory}. |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2340 @item C-x 4 f |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2341 @kindex C-x 4 f @r{(FFAP)} |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2342 @code{ffap-other-window}, analogous to @code{find-file-other-window}. |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2343 @item C-x 4 r |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2344 @code{ffap-read-only-other-window}, analogous to |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2345 @code{find-file-read-only-other-window}. |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2346 @item C-x 4 d |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2347 @code{ffap-dired-other-window}, analogous to @code{dired-other-window}. |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2348 @item C-x 5 f |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2349 @kindex C-x 5 f @r{(FFAP)} |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2350 @code{ffap-other-frame}, analogous to @code{find-file-other-frame}. |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2351 @item C-x 5 r |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2352 @code{ffap-read-only-other-frame}, analogous to |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2353 @code{find-file-read-only-other-frame}. |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2354 @item C-x 5 d |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2355 @code{ffap-dired-other-frame}, analogous to @code{dired-other-frame}. |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2356 @item M-x ffap-next |
564c48d59721
(FFAP): Add C-x C-r, C-x C-v, C-x C-d, C-x 4 r, C-x 4 d, C-x 5 r, C-x 5 d.
Juri Linkov <juri@jurta.org>
parents:
58765
diff
changeset
|
2357 Search buffer for next file name or URL, then find that file or URL. |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2358 @item S-Mouse-3 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2359 @kindex S-Mouse-3 @r{(FFAP)} |
30856 | 2360 @code{ffap-at-mouse} finds the file guessed from text around the position |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2361 of a mouse click. |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2362 @item C-S-Mouse-3 |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2363 @kindex C-S-Mouse-3 @r{(FFAP)} |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2364 Display a menu of files and URLs mentioned in current buffer, then |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2365 find the one you select (@code{ffap-menu}). |
30856 | 2366 @end table |
2367 | |
69737 | 2368 @node Thumbnails, Dissociated Press, Hyperlinking, Top |
2369 @section Viewing Images as Thumbnails | |
2370 @cindex tumme mode | |
2371 @cindex thumbnails | |
2372 | |
2373 Tumme is a facility for browsing image files. It provides viewing | |
69788
f2d982bf90e8
(Thumbnails): Minor cleanup.
Richard M. Stallman <rms@gnu.org>
parents:
69784
diff
changeset
|
2374 the images either as thumbnails or in full size, either inside Emacs |
f2d982bf90e8
(Thumbnails): Minor cleanup.
Richard M. Stallman <rms@gnu.org>
parents:
69784
diff
changeset
|
2375 or through an external viewer. |
69737 | 2376 |
2377 To enter Tumme, type @kbd{M-x tumme}. It prompts for a directory; | |
2378 specify one that has images files. This creates thumbnails for all | |
2379 the images in that directory, and displays them all in the ``thumbnail | |
2380 buffer''. This takes a long time if the directory contains many image | |
69797
b06d1e6ea199
(Thumbnails): Minor correction.
Richard M. Stallman <rms@gnu.org>
parents:
69788
diff
changeset
|
2381 files, and it asks for confirmation if the number of image files |
b06d1e6ea199
(Thumbnails): Minor correction.
Richard M. Stallman <rms@gnu.org>
parents:
69788
diff
changeset
|
2382 exceeds @code{tumme-show-all-from-dir-max-files}. |
69737 | 2383 |
2384 @kindex C-t d @r{(Tumme)} | |
2385 @findex tumme-display-thumbs | |
2386 You can also enter Tumme through Dired. Mark the image files you | |
2387 want to look at, using @kbd{m} as usual, then type @kbd{C-t d} | |
2388 (@code{tumme-display-thumbs}). This too creates and switches to | |
2389 a buffer containing thumbnails, corresponding to the marked files. | |
2390 | |
2391 With point in the thumbnail buffer, type @kbd{RET} | |
2392 (@code{tumme-display-thumbnail-original-image}) to display a sized | |
2393 version of it in another window. This sizes the image to fit the | |
2394 window. Use the arrow keys to move around in the buffer. For easy | |
70485 | 2395 browsing, type @kbd{SPC} (@code{tumme-display-next-thumbnail-original}) |
69737 | 2396 to advance and display the next image. Typing @kbd{DEL} |
2397 (@code{tumme-display-previous-thumbnail-original}) backs up to the | |
2398 previous thumbnail and displays that instead. | |
2399 | |
2400 @vindex tumme-external-viewer | |
2401 To view and the image in its original size, either provide a prefix | |
2402 argument (@kbd{C-u}) before pressing @kbd{RET}, or type @kbd{C-@key{RET}} | |
2403 (@code{tumme-thumbnail-display-external}) to display the image in an | |
2404 external viewer. You must first configure | |
2405 @code{tumme-external-viewer}. | |
2406 | |
2407 You can delete images through Tumme also. Type @kbd{d} | |
2408 (@code{tumme-flag-thumb-original-file}) to flag the image file for | |
2409 deletion in the Dired buffer. You can also delete the thumbnail image | |
2410 from the thumbnail buffer with @kbd{C-d} (@code{tumme-delete-char}). | |
2411 | |
2412 More advanced features include @dfn{image tags}, which are metadata | |
2413 used to categorize image files. The tags are stored in a plain text | |
69784
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2414 file configured by @code{tumme-db-file}. |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2415 |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2416 To tag image files, mark them in the dired buffer (you can also mark |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2417 files in Dired from the thumbnail buffer by typing @kbd{m}) and type |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2418 @kbd{C-t t} (@code{tumme-tag-files}). You will be prompted for a tag. |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2419 To mark files having a certain tag, type @kbd{C-t f} |
69737 | 2420 (@code{tumme-mark-tagged-files}). After marking image files with a |
2421 certain tag, you can use @kbd{C-t d} to view them. | |
2422 | |
69784
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2423 You can also tag a file directly from the thumbnail buffer by typing |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2424 @kbd{t t} and you can remove a tag by typing @kbd{t r}. There is also |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2425 a special ``tag'' called ``comment'' for each file (it is not a tag in |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2426 the exact same sense as the other tags, it is handled slightly |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2427 different). That is used to enter a comment or description about the |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2428 image. You comment a file from the thumbnail buffer by typing |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2429 @kbd{c}. You will be prompted for a comment. Type @kbd{C-t c} to add |
2a84440a03fb
Small additions about tumme.
Mathias Dahl <mathias.dahl@gmail.com>
parents:
69737
diff
changeset
|
2430 a comment from Dired (@code{tumme-dired-comment-files}). |
69737 | 2431 |
2432 Tumme also provides simple image manipulation. In the thumbnail | |
2433 buffer, type @kbd{L} to rotate the original image 90 degrees anti | |
2434 clockwise, and @kbd{R} to rotate it 90 degrees clockwise. This | |
2435 rotation is lossless, and uses an external utility called JpegTRAN. | |
2436 | |
2437 @node Dissociated Press, Amusements, Thumbnails, Top | |
25829 | 2438 @section Dissociated Press |
2439 | |
2440 @findex dissociated-press | |
2441 @kbd{M-x dissociated-press} is a command for scrambling a file of text | |
2442 either word by word or character by character. Starting from a buffer of | |
2443 straight English, it produces extremely amusing output. The input comes | |
2444 from the current Emacs buffer. Dissociated Press writes its output in a | |
2445 buffer named @samp{*Dissociation*}, and redisplays that buffer after every | |
2446 couple of lines (approximately) so you can read the output as it comes out. | |
2447 | |
2448 Dissociated Press asks every so often whether to continue generating | |
2449 output. Answer @kbd{n} to stop it. You can also stop at any time by | |
2450 typing @kbd{C-g}. The dissociation output remains in the | |
2451 @samp{*Dissociation*} buffer for you to copy elsewhere if you wish. | |
2452 | |
2453 @cindex presidentagon | |
2454 Dissociated Press operates by jumping at random from one point in the | |
2455 buffer to another. In order to produce plausible output rather than | |
2456 gibberish, it insists on a certain amount of overlap between the end of | |
2457 one run of consecutive words or characters and the start of the next. | |
38869
8be184904f6c
Don't use "print" for displaying a message.
Richard M. Stallman <rms@gnu.org>
parents:
38865
diff
changeset
|
2458 That is, if it has just output `president' and then decides to jump |
25829 | 2459 to a different point in the file, it might spot the `ent' in `pentagon' |
2460 and continue from there, producing `presidentagon'.@footnote{This | |
2461 dissociword actually appeared during the Vietnam War, when it was very | |
69737 | 2462 appropriate. Bush has made it appropriate again.} Long sample texts |
2463 produce the best results. | |
25829 | 2464 |
2465 @cindex againformation | |
2466 A positive argument to @kbd{M-x dissociated-press} tells it to operate | |
2467 character by character, and specifies the number of overlap characters. A | |
69737 | 2468 negative argument tells it to operate word by word, and specifies the number |
25829 | 2469 of overlap words. In this mode, whole words are treated as the elements to |
2470 be permuted, rather than characters. No argument is equivalent to an | |
2471 argument of two. For your againformation, the output goes only into the | |
2472 buffer @samp{*Dissociation*}. The buffer you start with is not changed. | |
2473 | |
2474 @cindex Markov chain | |
2475 @cindex ignoriginal | |
2476 @cindex techniquitous | |
69737 | 2477 Dissociated Press produces results fairly like those of a Markov |
2478 chain based on a frequency table constructed from the sample text. It | |
2479 is, however, an independent, ignoriginal invention. Dissociated Press | |
25829 | 2480 techniquitously copies several consecutive characters from the sample |
69737 | 2481 between random choices, whereas a Markov chain would choose randomly |
2482 for each word or character. This makes for more plausible sounding | |
2483 results, and runs faster. | |
25829 | 2484 |
2485 @cindex outragedy | |
2486 @cindex buggestion | |
2487 @cindex properbose | |
2488 @cindex mustatement | |
2489 @cindex developediment | |
2490 @cindex userenced | |
2491 It is a mustatement that too much use of Dissociated Press can be a | |
69737 | 2492 developediment to your real work, sometimes to the point of outragedy. |
25829 | 2493 And keep dissociwords out of your documentation, if you want it to be well |
2494 userenced and properbose. Have fun. Your buggestions are welcome. | |
2495 | |
2496 @node Amusements, Customization, Dissociated Press, Top | |
2497 @section Other Amusements | |
2498 @cindex boredom | |
2499 @findex hanoi | |
2500 @findex yow | |
2501 @findex gomoku | |
2502 @cindex tower of Hanoi | |
2503 | |
2504 If you are a little bit bored, you can try @kbd{M-x hanoi}. If you are | |
38740 | 2505 considerably bored, give it a numeric argument. If you are very, very |
25829 | 2506 bored, try an argument of 9. Sit back and watch. |
2507 | |
2508 @cindex Go Moku | |
2509 If you want a little more personal involvement, try @kbd{M-x gomoku}, | |
2510 which plays the game Go Moku with you. | |
2511 | |
2512 @findex blackbox | |
2513 @findex mpuz | |
27210 | 2514 @findex 5x5 |
25829 | 2515 @cindex puzzles |
69737 | 2516 @kbd{M-x blackbox}, @kbd{M-x mpuz} and @kbd{M-x 5x5} are puzzles. |
25829 | 2517 @code{blackbox} challenges you to determine the location of objects |
2518 inside a box by tomography. @code{mpuz} displays a multiplication | |
2519 puzzle with letters standing for digits in a code that you must | |
2520 guess---to guess a value, type a letter and then the digit you think it | |
27210 | 2521 stands for. The aim of @code{5x5} is to fill in all the squares. |
25829 | 2522 |
30856 | 2523 @findex decipher |
2524 @cindex ciphers | |
2525 @cindex cryptanalysis | |
2526 @kbd{M-x decipher} helps you to cryptanalyze a buffer which is encrypted | |
2527 in a simple monoalphabetic substitution cipher. | |
2528 | |
25829 | 2529 @findex dunnet |
2530 @kbd{M-x dunnet} runs an adventure-style exploration game, which is | |
2531 a bigger sort of puzzle. | |
2532 | |
27210 | 2533 @findex lm |
2534 @cindex landmark game | |
2535 @kbd{M-x lm} runs a relatively non-participatory game in which a robot | |
2536 attempts to maneuver towards a tree at the center of the window based on | |
2537 unique olfactory cues from each of the four directions. | |
2538 | |
2539 @findex life | |
2540 @cindex Life | |
36185 | 2541 @kbd{M-x life} runs Conway's ``Life'' cellular automaton. |
27210 | 2542 |
30856 | 2543 @findex morse-region |
2544 @findex unmorse-region | |
2545 @cindex Morse code | |
2546 @cindex --/---/.-./.../. | |
2547 @kbd{M-x morse-region} converts text in a region to Morse code and | |
2548 @kbd{M-x unmorse-region} converts it back. No cause for remorse. | |
2549 | |
2550 @findex pong | |
2551 @cindex Pong game | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2552 @kbd{M-x pong} plays a Pong-like game, bouncing the ball off opposing |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2553 bats. |
30856 | 2554 |
27210 | 2555 @findex solitaire |
2556 @cindex solitaire | |
2557 @kbd{M-x solitaire} plays a game of solitaire in which you jump pegs | |
2558 across other pegs. | |
2559 | |
30856 | 2560 @findex studlify-region |
2561 @cindex StudlyCaps | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2562 @kbd{M-x studlify-region} studlify-cases the region, producing |
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2563 text like this: |
30856 | 2564 |
2565 @example | |
2566 M-x stUdlIfY-RegioN stUdlIfY-CaSeS thE region. | |
2567 @end example | |
2568 | |
27210 | 2569 @findex tetris |
2570 @cindex Tetris | |
2571 @findex snake | |
2572 @cindex Snake | |
36168
df827c1def99
Clean up close-quote punctuation.
Richard M. Stallman <rms@gnu.org>
parents:
35648
diff
changeset
|
2573 @kbd{M-x tetris} runs an implementation of the well-known Tetris game. |
27210 | 2574 Likewise, @kbd{M-x snake} provides an implementation of Snake. |
2575 | |
25829 | 2576 When you are frustrated, try the famous Eliza program. Just do |
2577 @kbd{M-x doctor}. End each input by typing @key{RET} twice. | |
2578 | |
2579 @cindex Zippy | |
2580 When you are feeling strange, type @kbd{M-x yow}. | |
30862 | 2581 |
2582 @findex zone | |
2583 The command @kbd{M-x zone} plays games with the display when Emacs is | |
2584 idle. | |
52401 | 2585 |
56807
d2c0e48f4d5a
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
56222
diff
changeset
|
2586 @ifnottex |
d2c0e48f4d5a
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
56222
diff
changeset
|
2587 @lowersections |
d2c0e48f4d5a
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
56222
diff
changeset
|
2588 @end ifnottex |
d2c0e48f4d5a
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
56222
diff
changeset
|
2589 |
52401 | 2590 @ignore |
2591 arch-tag: 8f094220-c0d5-4e9e-af7d-3e0da8187474 | |
2592 @end ignore |