|
0
|
1 \input ../texinfo @c -*-texinfo-*-
|
|
|
2 @setfilename ../../info/new-users-guide.info
|
|
|
3 @comment node-name, next, previous, up
|
|
|
4
|
|
|
5
|
|
|
6 @ifinfo
|
|
|
7 This manual serves as an introduction to the XEmacs editor.
|
|
|
8
|
|
|
9 Copyright (C) 1985, 1986, 1988 Richard M. Stallman.
|
|
|
10 Copyright @copyright{} 1991, 1992, 1993, 1994 Lucid, Inc.
|
|
|
11 Copyright @copyright{} 1993, 1994 Sun Microsystems, Inc.
|
|
|
12
|
|
|
13 Permission is granted to make and distribute verbatim copies of
|
|
|
14 this manual provided the copyright notice and this permission notice
|
|
|
15 are preserved on all copies.
|
|
|
16
|
|
|
17 @ignore
|
|
|
18 Permission is granted to process this file through TeX and print the
|
|
|
19 results, provided the printed document carries copying permission
|
|
|
20 notice identical to this one except for the removal of this paragraph
|
|
|
21 (this paragraph not being relevant to the printed manual).
|
|
|
22
|
|
|
23 @end ignore
|
|
|
24 @end ifinfo
|
|
|
25 @c
|
|
|
26 @setchapternewpage odd
|
|
|
27 @settitle Getting Started With XEmacs
|
|
|
28 @c
|
|
|
29 @titlepage
|
|
|
30 @sp 6
|
|
|
31 @center @titlefont{Getting Started With XEmacs}
|
|
|
32 @sp 4
|
|
|
33 @sp 1
|
|
|
34 @sp 1
|
|
|
35 @center July 1994
|
|
|
36 @center (General Public License upgraded, January 1991)
|
|
|
37 @sp 5
|
|
|
38 @center Richard Stallman
|
|
|
39 @sp 1
|
|
|
40 @center and
|
|
|
41 @sp 1
|
|
|
42 @center Rashmi Goyal
|
|
|
43 @page
|
|
|
44 @vskip 0pt plus 1filll
|
|
|
45 Copyright @copyright{} 1985, 1986, 1988 Richard M. Stallman.
|
|
|
46
|
|
|
47 Copyright @copyright{} 1991, 1992, 1993, 1994 Lucid, Inc.
|
|
|
48
|
|
|
49 Copyright @copyright{} 1993, 1994 Sun Microsystems, Inc.
|
|
|
50
|
|
|
51 Permission is granted to make and distribute verbatim copies of
|
|
|
52 this manual provided the copyright notice and this permission notice
|
|
|
53 are preserved on all copies.
|
|
|
54 @end titlepage
|
|
|
55 @page
|
|
|
56 @ifinfo
|
|
|
57 @node Top, Intro, (dir), (dir)
|
|
|
58
|
|
|
59 The Emacs Editor
|
|
|
60 ****************
|
|
|
61
|
|
|
62 Emacs is the extensible, customizable, self-documenting real-time
|
|
|
63 display editor. This Info file will help you get started on using
|
|
|
64 XEmacs. It corresponds to XEmacs version 19.13.
|
|
|
65
|
|
|
66 @end ifinfo
|
|
|
67
|
|
|
68 @iftex
|
|
|
69 @unnumbered Preface
|
|
|
70
|
|
|
71 This guide is intended to help you get started on using the
|
|
|
72 Emacs editor. It will show you some examples of simple customizations.
|
|
|
73
|
|
|
74 For detailed information on any topic, refer to the @b{XEmacs
|
|
|
75 User's Manual}. This document will also refer the reader to the
|
|
|
76 @b{XEmacs User's Manual} for more information on corresponding
|
|
|
77 topics. You can also use the on-line, learn-by-doing tutorial, which you
|
|
|
78 get by running Emacs and typing @kbd{C-h t} OR you can choose the
|
|
|
79 @b{Emacs Tutorial} from the @b{Help} menu on the menu bar (which is
|
|
|
80 located on the extreme right of the frame). With it, you learn Emacs by
|
|
|
81 using Emacs on a specially designed file which describes commands, tells
|
|
|
82 you when to try them, and then explains the results you see.
|
|
|
83
|
|
|
84 The first few chapters will introduce you to some basic Emacs commands.
|
|
|
85 Later on, some examples of simple customizations will be shown.
|
|
|
86
|
|
|
87 To find the documentation on a particular command, look in the index.
|
|
|
88 Keys (character commands) and command names have separate indexes. There
|
|
|
89 is also a glossary, with a cross reference for each term.
|
|
|
90
|
|
|
91 This manual comes in two forms: the published form and the Info form.
|
|
|
92 The Info form is for on-line perusal with the INFO program; it is
|
|
|
93 distributed along with XEmacs. Both forms contain substantially the
|
|
|
94 same text and are generated from a common source file, which is also
|
|
|
95 distributed along with XEmacs.
|
|
|
96
|
|
|
97 @end iftex
|
|
|
98
|
|
|
99
|
|
|
100 @c node
|
|
|
101
|
|
|
102 @menu
|
|
|
103 * Intro:: Introduction to XEmacs editor
|
|
|
104
|
|
|
105 Indices, nodes containing large menus
|
|
|
106 * Key Index:: An item for each standard Emacs key sequence.
|
|
|
107 * Command Index:: An item for each command and function name
|
|
|
108 * Variable Index:: An item for each variable in User-Guide
|
|
|
109 * Concept Index:: An item for the concepts introduced
|
|
|
110
|
|
|
111 Entering, Exiting and Editing Emacs
|
|
|
112 * Entering:: Starting Emacs from the shell and Exiting
|
|
|
113 * Windows and Menus:: Description of Pull-down menus
|
|
|
114 * Edit:: Basic Editing commands
|
|
|
115
|
|
|
116 Other Features of XEmacs
|
|
|
117 * Customization Basics:: Customize Emacs menus and keybindings
|
|
|
118 * Help:: Help menu and other help commands
|
|
|
119 * Modes:: Major and Minor modes in XEmacs
|
|
|
120 * Files:: Visiting, Saving and Listing Files
|
|
|
121 * Other Customizations:: Customizing Variables, Modes, etc
|
|
|
122 * Select and Move:: Selecting text and moving text
|
|
|
123 * Search and Replace:: Searching and Replacing text
|
|
|
124
|
|
|
125
|
|
|
126
|
|
|
127 --- The Detailed Node Listing ---
|
|
|
128
|
|
|
129 Entering and Exiting Emacs
|
|
|
130
|
|
|
131 * Enter:: Entering Emacs from the shell
|
|
|
132 * Frame:: Basic information about the XEmacs Frame
|
|
|
133 * Exiting:: Exiting Emacs
|
|
|
134 * Mode Line:: Interpreting the mode line.
|
|
|
135 * Echo Area:: Bottom of the frame where you interact
|
|
|
136 with Emacs.
|
|
|
137
|
|
|
138 XEmacs Windows and Menus
|
|
|
139
|
|
|
140 * XEmacs Window:: Manipulating XEmacs Windows
|
|
|
141 * Pull-down Menus:: Description of XEmacs Pull-down Menus
|
|
|
142
|
|
|
143 Pull-down menus
|
|
|
144
|
|
|
145 * File menu:: Items on the File Menu
|
|
|
146 * Edit menu:: Items on the Edit Menu
|
|
|
147 * Options Menu:: Items on the Options Menu
|
|
|
148 * Buffers Menu:: Items on the Buffers Menu
|
|
|
149 * Help menu:: The Help Menu at the extreme right on
|
|
|
150 the frame
|
|
|
151
|
|
|
152 Basic Editing Commands
|
|
|
153
|
|
|
154 * Insert:: Insert text in Emacs by simply typing at
|
|
|
155 the cursor position.
|
|
|
156 * Cursor Position:: Moving Around the cursor in the buffer,
|
|
|
157 * Erase:: Different commands for erasing text
|
|
|
158 * Numeric Argument:: Giving Numeric Arguments to commands
|
|
|
159 * Undo:: Undoing Changes made by mistake
|
|
|
160
|
|
|
161 Customize key bindings and menus
|
|
|
162
|
|
|
163 * Customizing key Bindings:: Changing Key Bindings
|
|
|
164 * Customizing Menus:: Adding, Deleting, Enabling and Disabling Menus
|
|
|
165
|
|
|
166 Help
|
|
|
167
|
|
|
168 * The Help Menu:: Items on the Help Menu
|
|
|
169
|
|
|
170 Major and Minor Modes
|
|
|
171
|
|
|
172 * Major Modes:: Choosing Major Modes
|
|
|
173 * Minor Modes:: Auto-Fill, Abbrev and other minor modes
|
|
|
174
|
|
|
175 Emacs Files
|
|
|
176
|
|
|
177 * File Names:: How to type and edit file name arguments.
|
|
|
178 * Visiting:: Visiting a file prepares Emacs to edit the file.
|
|
|
179 * Saving Files:: How to save Emacs files.
|
|
|
180
|
|
|
181 Other Customizations
|
|
|
182
|
|
|
183 * Setting Variables:: Customizing Emacs variables
|
|
|
184 * Init File:: Some examples of Lisp expressions in
|
|
|
185 .emacs file
|
|
|
186
|
|
|
187 Selecting and Moving Text
|
|
|
188
|
|
|
189 * Selecting Text:: Select a region of text by setting the Mark
|
|
|
190 * Mouse:: Selecting Text with Mouse
|
|
|
191 * Region Operation:: Various ways to operate on a selected text
|
|
|
192 * Moving Text:: Moving Text
|
|
|
193 * Accumulating text:: Accumulating Text from several buffers
|
|
|
194
|
|
|
195 No sub menu for the node search and replace
|
|
|
196 @end menu
|
|
|
197
|
|
|
198 @node Intro,Key Index ,Top , Top
|
|
|
199 @unnumbered Introduction
|
|
|
200
|
|
|
201 You are reading about XEmacs which is a self-documenting, customizable, extensible real-time display editor.
|
|
|
202
|
|
|
203 XEmacs is a @dfn{display} editor because normally the text
|
|
|
204 being edited is visible on the screen and is updated automatically as you
|
|
|
205 type. @xref{Frame,Display, , ,XEmacs User's Manual}.
|
|
|
206
|
|
|
207 It is a @dfn{real-time} editor because the display is updated very
|
|
|
208 frequently, usually after each character or pair of characters you type.
|
|
|
209 This minimizes the amount of information you must keep in your head as
|
|
|
210 you edit. @xref{Basic,Real-time,Basic Editing, ,XEmacs User's
|
|
|
211 Manual}.
|
|
|
212
|
|
|
213 It is advanced because it provides facilities that go beyond
|
|
|
214 simple insertion and deletion: filling of text; automatic indentation of
|
|
|
215 programs; viewing two or more files at once; and dealing in terms of
|
|
|
216 characters, words, lines, sentences, paragraphs, and pages, as well as
|
|
|
217 expressions and comments in several different programming languages. It is
|
|
|
218 much easier to type one command meaning ``go to the end of the paragraph''
|
|
|
219 than to find that spot with simple cursor keys.
|
|
|
220
|
|
|
221 @dfn{Self-documenting} means that at any time you can type a special
|
|
|
222 character, @kbd{Control-h}, to find out what your options are. You can
|
|
|
223 also use @kbd{C-h} to find out what a command does, or to find all the
|
|
|
224 commands relevant to a topic. @xref{Help,,,,XEmacs User's Manual}.
|
|
|
225
|
|
|
226 @dfn{Customizable} means you can change the definitions of Emacs
|
|
|
227 commands. For example, if you use a programming language in which
|
|
|
228 comments start with @samp{<**} and end with @samp{**>}, you can tell the
|
|
|
229 Emacs comment manipulation commands to use those strings
|
|
|
230 (@pxref{Comments,,,,XEmacs User's Manual}). Another sort of
|
|
|
231 customization is rearrangement of the command set. For example, you can
|
|
|
232 set up the four basic cursor motion commands (up, down, left and right)
|
|
|
233 on keys in a diamond pattern on the keyboard if you prefer.
|
|
|
234 @xref{Customization,,,,XEmacs User's Manual}.
|
|
|
235
|
|
|
236 @dfn{Extensible} means you can go beyond simple customization and
|
|
|
237 write entirely new commands, programs in the Lisp language to be run by
|
|
|
238 Emacs's own Lisp interpreter. Emacs is an ``on-line extensible''
|
|
|
239 system: it is divided into many functions that call each other. You can
|
|
|
240 redefine any function in the middle of an editing session and replace
|
|
|
241 any part of Emacs without making a separate copy of all of Emacs. Most
|
|
|
242 of the editing commands of Emacs are written in Lisp; the few
|
|
|
243 exceptions could have been written in Lisp but are written in C for
|
|
|
244 efficiency. Only a programmer can write an extension to Emacs, but anybody
|
|
|
245 can use it afterward.
|
|
|
246
|
|
|
247 @include enter.texi
|
|
|
248 @include xmenu.texi
|
|
|
249 @include edit.texi
|
|
|
250 @include custom1.texi
|
|
|
251 @include help.texi
|
|
|
252 @include modes.texi
|
|
|
253 @include files.texi
|
|
|
254 @include custom2.texi
|
|
|
255 @include region.texi
|
|
|
256 @include search.texi
|
|
|
257
|
|
|
258 @node Key Index, Command Index, Intro, Top
|
|
|
259 @unnumbered Key (Character) Index
|
|
|
260 @printindex ky
|
|
|
261
|
|
|
262 @node Command Index, Variable Index, Key Index, Top
|
|
|
263 @unnumbered Command and Function Index
|
|
|
264 @printindex fn
|
|
|
265
|
|
|
266 @node Variable Index, Concept Index, Command Index, Top
|
|
|
267 @unnumbered Variable Index
|
|
|
268 @printindex vr
|
|
|
269
|
|
|
270 @node Concept Index, Entering, Variable Index, Top
|
|
|
271 @unnumbered Concept Index
|
|
|
272 @printindex cp
|
|
|
273
|
|
|
274 @summarycontents
|
|
|
275 @contents
|
|
|
276 @bye
|
|
|
277
|
|
|
278 @c Remember to delete these lines before creating the info file.
|
|
|
279 @iftex
|
|
|
280 @lucidbook
|
|
|
281 @bindingoffset = 0.5in
|
|
|
282 @parindent = 0pt
|
|
|
283 @end iftex
|
|
|
284
|
