update.
[chise/xemacs-chise.git] / man / new-users-guide / enter.texi
1 @comment  node-name,  next,  previous,  up
2 @node Entering, Windows and Menus, Concept Index, Top
3 @chapter Entering and Exiting Emacs
4 @cindex buffer
5 @cindex file
6 @cindex windows
7
8 While using Emacs you should be familiar with the following three terms:
9
10 @table @asis
11 @item Buffer
12 A @b{buffer} is a region of memory holding characters. It is the basic
13 editing unit; one buffer corresponds to one piece of text being
14 edited. You can have multiple buffers but you can edit only one buffer
15 at any one time. For more information, @xref{Buffers,,,xemacs,XEmacs User's
16 Manual}.
17
18 @item File
19 A @b{file} is a region of disk space holding characters. Emacs edits a file by 
20 reading it into a buffer, editing that buffer and writing out the buffer 
21 back to the file. To save your work permanently you have to write it to a file.
22 So after you load and work with a file, you have to save it back.
23
24 @item Windows
25 A @b{window} is a rectangular region in which a buffer is displayed. You can 
26 open multiple windows with multiple buffers and edit them by selecting the 
27 corresponding buffer. Initially, when you start emacs, it will automatically 
28 open up a window for you.
29 @end table
30
31 @comment  node-name,  next,  previous,  up
32 @menu
33 * Enter::                       Entering Emacs from the shell
34 * Frame::                      Basic information about the XEmacs Frame
35 * Exiting::                     Exiting Emacs
36 * Mode Line::                   Interpreting the mode line.
37 * Echo Area::                   Bottom of the frame where you interact
38                                 with Emacs.
39 @end menu
40
41 @node Enter, Frame, Entering, Entering
42 @section Entering Emacs
43 @cindex entering Emacs
44 @cindex entering XEmacs
45
46 To enter Emacs type @kbd{xemacs} and press the Return key at the
47 shell i.e. @kbd{xemacs @key{RET}}. 
48 This will bring up an emacs window with @samp{*scratch*} as the default
49 buffer because Emacs must always have a buffer to work on. Then choose 
50 the @b{Open...} option from the @b{File} menu on the menubar at the top 
51 of the frame. It will prompt you to enter a filename. After you enter
52 the filename, Emacs will read that file into the current buffer. You can
53 also type :
54 @example
55 @kbd{xemacs <filename> @key{RET}} 
56 @end example
57 directly which will bring up
58 an Emacs frame with the @dfn{filename} as the buffer. 
59  
60
61 @comment 
62 @node Frame, Exiting, Enter, Entering
63 @section Emacs Frame
64 @cindex open another file
65
66 When you run XEmacs under X, a menu bar on top of the Emacs frame
67 provides access to pull-down menus of file, edit, and help-related
68 commands. The menus only provide convenient shortcuts, the options that
69 they provide are available via key commands. You can invoke those
70 commands from the keyboard also. For many of the options, their
71 corresponding key commands are displayed right besides them. The five
72 default menus on the menubar that you will see on the frame are
73 @b{File}, @b{Edit}, @b{Options}, @b{Buffers} and @b{Help}. @xref{XEmacs
74 Pull-down Menus,,,xemacs,XEmacs User's Manual}, for detailed information on
75 the functions provided by the pull-down menus.
76
77   The Emacs frame has a rectangle shaped box at the extreme right and you can
78 drag it up or down to scroll the window accordingly. Clicking on the
79 arrows also serves the same purpose. 
80
81   The last line in your window is @samp{the Mode line} which will give
82 you a description of what's going on in that particular
83 window. @xref{Mode Line}, for more
84 information. Below the mode line is the @samp{Echo area}. Emacs uses
85 this area to interact with the user. @xref{Echo Area}. 
86
87   If you wish to open another file in a new window after you enter
88 XEmacs, select @b{Open in New Frame...} from the @b{File} menu, which
89 will prompt you for a filename and open a new window with that filename
90 as the current buffer. If you want to open a new file in the same
91 window, select @b{Open..} from the @b{File} menu. You need to enter
92 XEmacs only once, you can edit multiple files by opening several other
93 frames or by switching between buffers.
94
95
96 @comment new section
97 @node Exiting, Mode Line, Frame, Entering
98 @section Exiting Emacs
99 @cindex exiting
100 @cindex killing Emacs
101 @cindex suspending
102 @cindex shrinking XEmacs frame
103
104 There are two commands for exiting Emacs, one for @dfn{suspending} Emacs
105 and the other for @dfn{killing} Emacs. @dfn{Suspending} means stopping 
106 Emacs temporarily and returning control to the shell, allowing you to 
107 resume editing 
108 later in the same Emacs job, with the same files, same kill ring, same
109 undo history, and so on.  This is the usual way to exit.  @dfn{Killing}
110 Emacs means destroying the Emacs job.  You can run Emacs again later,
111 but you will get a fresh Emacs; there is no way to resume the same
112 editing session after it has been killed. 
113
114 @kindex C-z
115 @findex suspend-emacs
116 @kindex C-x C-c
117 @findex save-buffers-kill-emacs
118  
119 @table @kbd
120 @item C-z
121 Suspend Emacs (@code{suspend-emacs}).  If used under the X window system,
122 this command will shrink the X window containing the Emacs frame to an 
123 icon. Clicking on the icon will resume that Emacs process
124 again. @xref{Exiting Emacs,,,xemacs,XEmacs User's Manual}. 
125
126 @item C-x C-c
127 Kill Emacs (@code{save-buffers-kill-emacs}). You can also select 
128 @b{Exit Emacs} option from the @b{File} menu to kill that Emacs
129 process. If you haven't saved the file, Emacs will ask you if you wish
130 to save the file before killing that process. 
131 @end table
132
133
134
135 @comment node-name,  next,  previous,  up
136 @node Mode Line, Echo Area, Exiting, Entering
137 @section The Mode Line
138 @cindex mode line
139 @cindex top level
140
141   When you enter XEmacs, each text window's last line is a @dfn{mode
142 line} which describes what is going on in that window. Normally, the
143 mode line looks like :
144
145 @example
146 @cartouche
147 --@var{ch}-XEmacs: @var{buf}     (@var{major} @var{minor})----@var{pos}------
148 @end cartouche
149 @end example
150
151 @noindent
152 This gives information about the buffer being displayed in the window: the
153 buffer's name, what major and minor modes are in use, whether the buffer's
154 text has been changed, and how far down the buffer you are currently
155 looking.
156
157   The @var{ch} contains :
158 @table @samp
159 @item **
160 if the text in the buffer has been edited
161
162 @item --
163 if the text in the buffer has not been edited
164
165 @item %%
166 if the buffer is a read-only-buffer i.e. it cannot be edited
167 @end table
168
169   @var{buf} is the name of the window's chosen @dfn{buffer}. If you are
170 editing a file (which is the selected buffer), the file name appears
171 in @var{buf}.  @xref{Buffers,,,xemacs,XEmacs User's Manual}.
172
173   @var{pos} contains :
174 @table @samp
175 @item All
176 if your entire file is visible on the screen.
177 @item Top
178 if you are looking at the beginning of the file.
179 @item Bot
180 if you are looking at the end of the file.
181 @item @var{nn}%
182 @var{nn} will be a number corresponding to the percentage of the file
183 above the top of the screen, for example @samp{52}, which means that 52%
184 of the file is above the top of the screen.
185 @end table
186
187    @var{major} is the name of the @dfn{major mode} in effect in the
188 buffer.  At any time, each buffer is in one and only one major mode.
189 The available major modes include Fundamental mode (the least
190 specialized), Text mode, Lisp mode, and C mode.  @xref{Major
191 Modes,,,xemacs,XEmacs User's Manual}, for details on how the modes differ
192 and how you select one.
193
194    @var{minor} is a list of some of the @dfn{minor modes} that are
195 turned on in the window's chosen buffer.  For example, @samp{Fill} means
196 that Auto Fill mode is on which means that lines are broken
197 automatically when they become too wide. @xref{Minor
198 Modes,,,xemacs,XEmacs User's Manual}, for more information on various
199 minor modes and how to enable them.
200
201   You can also display time in the mode line. @xref{The Mode
202 Line,,,xemacs,XEmacs User's Manual}, for more information regarding the
203 mode line.
204
205
206 @comment  node-name,  next,  previous,  up
207 @node Echo Area,  , Mode Line, Entering
208 @section The Echo Area
209 @cindex echo area
210
211   The line at the bottom of the frame (below the mode line) is the
212 @dfn{echo area}.  Emacs uses this area to communicate with you:
213
214 @itemize @bullet
215 @item
216   The @dfn{echo area} will print out the characters that you type. For
217 example, if you choose the @b{Open...} option from the @b{File} menu you
218 might get the following in the echo area:
219
220 @example
221 Find file: /usr/lib/x11/
222 @end example
223
224 @noindent
225 Now you need to give a file name to open, for example if the file name
226 is @file{myfile}, you will type @file{myfile} after
227 @file{/usr/lib/x11/} and press the @key{Return} key. If you pause for
228 more than a second while typing, you will see the characters that you
229 type in the @dfn{echo area}. 
230 @item
231   The @dfn{echo area} also prints error messages. For example, if you
232 misspell @samp{usr} and type @file{/urs/lib/x11/myfile} @key{RETURN} in
233 the above example you might get an error message. Since 
234 Emacs will not be able to find the @file{/urs} 
235 directory, the @dfn{echo area} will say:
236
237 @example
238 @error{} Opening directory: no such file or directory, /urs/lib/x11/myfile
239 @end example
240
241 @noindent
242 This error message will be accompanied by a beep. Some XEmacs commands
243 will print informative messages in the @dfn{echo area}. @xref{The Echo
244 Area,,,xemacs,XEmacs User's Manual}, for more information on the @dfn{echo
245 area}.
246 @end itemize
247
248
249
250
251
252