Mercurial > emacs
annotate man/entering.texi @ 58022:4f686c82cfc9
(bootstrap, bootstrap-clean-before): Remove .elc
files before building.
(bootfast, bootstrap-clean-before-fast): New targets, like
bootstrap but don't remove .elc files.
author | Kim F. Storm <storm@cua.dk> |
---|---|
date | Sun, 07 Nov 2004 23:27:18 +0000 |
parents | 24bffa640391 |
children | a272a40c3635 3219f94257bc |
rev | line source |
---|---|
25829 | 1 @c This is part of the Emacs manual. |
2 @c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995 Free Software Foundation, Inc. | |
3 @c See file emacs.texi for copying conditions. | |
4 @node Entering Emacs, Exiting, Text Characters, Top | |
5 @chapter Entering and Exiting Emacs | |
6 @cindex entering Emacs | |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
46913
diff
changeset
|
7 @cindex starting Emacs |
25829 | 8 |
29107 | 9 The usual way to invoke Emacs is with the shell command @command{emacs}. |
25829 | 10 Emacs clears the screen and then displays an initial help message and |
11 copyright notice. Some operating systems discard all type-ahead when | |
12 Emacs starts up; they give Emacs no way to prevent this. Therefore, it | |
13 is advisable to wait until Emacs clears the screen before typing your | |
14 first editing command. | |
15 | |
16 If you run Emacs from a shell window under the X Window System, run it | |
29107 | 17 in the background with @command{emacs&}. This way, Emacs does not tie up |
25829 | 18 the shell window, so you can use that to run other shell commands while |
19 Emacs operates its own X windows. You can begin typing Emacs commands | |
20 as soon as you direct your keyboard input to the Emacs frame. | |
21 | |
22 @vindex initial-major-mode | |
38954 | 23 When Emacs starts up, it creates a buffer named @samp{*scratch*}. |
25829 | 24 That's the buffer you start out in. The @samp{*scratch*} buffer uses Lisp |
25 Interaction mode; you can use it to type Lisp expressions and evaluate | |
26 them, or you can ignore that capability and simply doodle. (You can | |
27 specify a different major mode for this buffer by setting the variable | |
28 @code{initial-major-mode} in your init file. @xref{Init File}.) | |
29 | |
30 It is possible to specify files to be visited, Lisp files to be | |
31 loaded, and functions to be called, by giving Emacs arguments in the | |
32 shell command line. @xref{Command Arguments}. But we don't recommend | |
33 doing this. The feature exists mainly for compatibility with other | |
34 editors. | |
35 | |
36 Many other editors are designed to be started afresh each time you | |
37 want to edit. You edit one file and then exit the editor. The next | |
38 time you want to edit either another file or the same one, you must run | |
39 the editor again. With these editors, it makes sense to use a | |
40 command-line argument to say which file to edit. | |
41 | |
42 But starting a new Emacs each time you want to edit a different file | |
37348 | 43 does not make sense. For one thing, this would be annoyingly slow. |
44 For another, this would fail to take advantage of Emacs's ability to | |
45 visit more than one file in a single editing session. And it would | |
46 lose the other accumulated context, such as the kill ring, registers, | |
47 undo history, and mark ring. | |
25829 | 48 |
49 The recommended way to use GNU Emacs is to start it only once, just | |
50 after you log in, and do all your editing in the same Emacs session. | |
51 Each time you want to edit a different file, you visit it with the | |
52 existing Emacs, which eventually comes to have many files in it ready | |
53 for editing. Usually you do not kill the Emacs until you are about to | |
54 log out. @xref{Files}, for more information on visiting more than one | |
55 file. | |
56 | |
46913
861d4dd87bd7
Mention emacsclient, with xref.
Richard M. Stallman <rms@gnu.org>
parents:
38954
diff
changeset
|
57 If you want to edit a file from another program and already have |
861d4dd87bd7
Mention emacsclient, with xref.
Richard M. Stallman <rms@gnu.org>
parents:
38954
diff
changeset
|
58 Emacs running, you can use the @command{emacsclient} program to open a |
861d4dd87bd7
Mention emacsclient, with xref.
Richard M. Stallman <rms@gnu.org>
parents:
38954
diff
changeset
|
59 file in the already running Emacs. @xref{Emacs Server}, for more |
861d4dd87bd7
Mention emacsclient, with xref.
Richard M. Stallman <rms@gnu.org>
parents:
38954
diff
changeset
|
60 information on editing files with Emacs from other programs. |
861d4dd87bd7
Mention emacsclient, with xref.
Richard M. Stallman <rms@gnu.org>
parents:
38954
diff
changeset
|
61 |
56810
24bffa640391
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
62 @ifnottex |
24bffa640391
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
63 @raisesections |
24bffa640391
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
64 @end ifnottex |
24bffa640391
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
65 |
25829 | 66 @node Exiting, Basic, Entering Emacs, Top |
67 @section Exiting Emacs | |
68 @cindex exiting | |
69 @cindex killing Emacs | |
70 @cindex suspending | |
71 @cindex leaving Emacs | |
72 @cindex quitting Emacs | |
73 | |
74 There are two commands for exiting Emacs because there are two kinds | |
75 of exiting: @dfn{suspending} Emacs and @dfn{killing} Emacs. | |
76 | |
77 @dfn{Suspending} means stopping Emacs temporarily and returning | |
78 control to its parent process (usually a shell), allowing you to resume | |
79 editing later in the same Emacs job, with the same buffers, same kill | |
80 ring, same undo history, and so on. This is the usual way to exit. | |
81 | |
82 @dfn{Killing} Emacs means destroying the Emacs job. You can run Emacs | |
83 again later, but you will get a fresh Emacs; there is no way to resume | |
84 the same editing session after it has been killed. | |
85 | |
86 @table @kbd | |
87 @item C-z | |
88 Suspend Emacs (@code{suspend-emacs}) or iconify a frame | |
89 (@code{iconify-or-deiconify-frame}). | |
90 @item C-x C-c | |
91 Kill Emacs (@code{save-buffers-kill-emacs}). | |
92 @end table | |
93 | |
94 @kindex C-z | |
95 @findex suspend-emacs | |
96 To suspend Emacs, type @kbd{C-z} (@code{suspend-emacs}). This takes | |
97 you back to the shell from which you invoked Emacs. You can resume | |
29107 | 98 Emacs with the shell command @command{%emacs} in most common shells. |
25829 | 99 |
100 On systems that do not support suspending programs, @kbd{C-z} starts | |
101 an inferior shell that communicates directly with the terminal. | |
102 Emacs waits until you exit the subshell. (The way to do that is | |
29107 | 103 probably with @kbd{C-d} or @command{exit}, but it depends on which shell |
25829 | 104 you use.) The only way on these systems to get back to the shell from |
105 which Emacs was run (to log out, for example) is to kill Emacs. | |
106 | |
107 Suspending also fails if you run Emacs under a shell that doesn't | |
108 support suspending programs, even if the system itself does support it. | |
109 In such a case, you can set the variable @code{cannot-suspend} to a | |
110 non-@code{nil} value to force @kbd{C-z} to start an inferior shell. | |
111 (One might also describe Emacs's parent shell as ``inferior'' for | |
112 failing to support job control properly, but that is a matter of taste.) | |
113 | |
114 When Emacs communicates directly with an X server and creates its own | |
115 dedicated X windows, @kbd{C-z} has a different meaning. Suspending an | |
38172 | 116 application that uses its own X windows is not meaningful or useful. |
25829 | 117 Instead, @kbd{C-z} runs the command @code{iconify-or-deiconify-frame}, |
38954 | 118 which temporarily iconifies (or ``minimizes'') the selected Emacs |
119 frame (@pxref{Frames}). Then you can use the window manager to get | |
120 back to a shell window. | |
25829 | 121 |
122 @kindex C-x C-c | |
123 @findex save-buffers-kill-emacs | |
38954 | 124 To exit and kill Emacs, type @kbd{C-x C-c} |
125 (@code{save-buffers-kill-emacs}). A two-character key is used for | |
126 this to make it harder to type by accident. This command first offers | |
127 to save any modified file-visiting buffers. If you do not save them | |
128 all, it asks for reconfirmation with @kbd{yes} before killing Emacs, | |
129 since any changes not saved will be lost forever. Also, if any | |
130 subprocesses are still running, @kbd{C-x C-c} asks for confirmation | |
131 about them, since killing Emacs will also kill the subprocesses. | |
25829 | 132 |
38920
caf015ed2aea
Document confirm-kill-emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
38172
diff
changeset
|
133 @vindex confirm-kill-emacs |
caf015ed2aea
Document confirm-kill-emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
38172
diff
changeset
|
134 If the value of the variable @code{confirm-kill-emacs} is |
caf015ed2aea
Document confirm-kill-emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
38172
diff
changeset
|
135 non-@code{nil}, @kbd{C-x C-c} assumes that its value is a predicate |
caf015ed2aea
Document confirm-kill-emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
38172
diff
changeset
|
136 function, and calls that function. If the result is non-@code{nil}, the |
caf015ed2aea
Document confirm-kill-emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
38172
diff
changeset
|
137 session is killed, otherwise Emacs continues to run. One convenient |
caf015ed2aea
Document confirm-kill-emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
38172
diff
changeset
|
138 function to use as the value of @code{confirm-kill-emacs} is the |
caf015ed2aea
Document confirm-kill-emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
38172
diff
changeset
|
139 function @code{yes-or-no-p}. The default value of |
caf015ed2aea
Document confirm-kill-emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
38172
diff
changeset
|
140 @code{confirm-kill-emacs} is @code{nil}. |
caf015ed2aea
Document confirm-kill-emacs.
Eli Zaretskii <eliz@gnu.org>
parents:
38172
diff
changeset
|
141 |
38954 | 142 There is no way to resume an Emacs session once you have killed it. |
25829 | 143 You can, however, arrange for Emacs to record certain session |
38954 | 144 information when you kill it, such as which files are visited, so that |
145 the next time you start Emacs it will try to visit the same files and | |
25829 | 146 so on. @xref{Saving Emacs Sessions}. |
147 | |
148 The operating system usually listens for certain special characters | |
149 whose meaning is to kill or suspend the program you are running. | |
150 @b{This operating system feature is turned off while you are in Emacs.} | |
151 The meanings of @kbd{C-z} and @kbd{C-x C-c} as keys in Emacs were | |
152 inspired by the use of @kbd{C-z} and @kbd{C-c} on several operating | |
153 systems as the characters for stopping or killing a program, but that is | |
154 their only relationship with the operating system. You can customize | |
155 these keys to run any commands of your choice (@pxref{Keymaps}). | |
52401 | 156 |
56810
24bffa640391
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
157 @ifnottex |
24bffa640391
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
158 @lowersections |
24bffa640391
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
159 @end ifnottex |
24bffa640391
Adapt sectioning in Info to the node structure.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
160 |
52401 | 161 @ignore |
162 arch-tag: df798d8b-f253-4113-b585-f528f078a944 | |
163 @end ignore |