Mercurial > hg > xemacs-beta

comparison man/new-users-guide/new-users-guide.texi @ 0:376386a54a3c r19-14

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r19-14
author cvs
date Mon, 13 Aug 2007 08:45:50 +0200
parents
children c9fe270a4101
comparison
equal deleted inserted replaced
-1:000000000000 0:376386a54a3c
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