annotate man/new-users-guide/new-users-guide.texi @ 793:e38acbeb1cae

[xemacs-hg @ 2002-03-29 04:46:17 by ben] lots o' fixes etc/ChangeLog: New file. Separated out all entries for etc/ into their own ChangeLog. Includes entries for the following files: etc/BABYL, etc/BETA, etc/CHARSETS, etc/DISTRIB, etc/Emacs.ad, etc/FTP, etc/GNUS-NEWS, etc/GOATS, etc/HELLO, etc/INSTALL, etc/MACHINES, etc/MAILINGLISTS, etc/MSDOS, etc/MYTHOLOGY, etc/NEWS, etc/OXYMORONS, etc/PACKAGES, etc/README, etc/TUTORIAL, etc/TUTORIAL.de, etc/TUTORIAL.ja, etc/TUTORIAL.ko, etc/TUTORIAL.se, etc/aliases.ksh, etc/altrasoft-logo.xpm, etc/check_cygwin_setup.sh, etc/custom/example-themes/europe-theme.el, etc/custom/example-themes/ex-custom-file, etc/custom/example-themes/example-theme.el, etc/e/eterm.ti, etc/edt-user.doc, etc/enriched.doc, etc/etags.1, etc/gnuserv.1, etc/gnuserv.README, etc/package-index.LATEST.gpg, etc/package-index.LATEST.pgp, etc/photos/jan.png, etc/recycle.xpm, etc/refcard.tex, etc/sample.Xdefaults, etc/sample.emacs, etc/sgml/CATALOG, etc/sgml/HTML32.dtd, etc/skk/SKK.tut.E, etc/smilies/Face_ase.xbm, etc/smilies/Face_ase2.xbm, etc/smilies/Face_ase3.xbm, etc/smilies/Face_smile.xbm, etc/smilies/Face_weep.xbm, etc/sounds, etc/toolbar, etc/toolbar/workshop-cap-up.xpm, etc/xemacs-ja.1, etc/xemacs.1, etc/yow.lines, etc\BETA, etc\NEWS, etc\README, etc\TUTORIAL, etc\TUTORIAL.de, etc\check_cygwin_setup.sh, etc\sample.init.el, etc\unicode\README, etc\unicode\mule-ucs\*, etc\unicode\other\* unicode/unicode-consortium/8859-16.TXT: New file. mule/english.el: Define this charset now, since a bug was fixed that formerly prevented it. mule/ethio-util.el: Fix compile errors involving Unicode `characters', which should be integers. Makefile.in.in: Always include gui.c, to fix compile error when TTY-only. EmacsFrame.c, abbrev.c, alloc.c, buffer.c, buffer.h, bytecode.c, bytecode.h, callint.c, callproc.c, casetab.c, casetab.h, charset.h, chartab.c, chartab.h, cmds.c, console-msw.c, console-msw.h, console-tty.c, console-x.c, console-x.h, console.c, console.h, data.c, database.c, device-gtk.c, device-msw.c, device-x.c, device.c, device.h, dialog-msw.c, doc.c, doprnt.c, dumper.c, dynarr.c, editfns.c, eldap.c, eldap.h, elhash.c, elhash.h, emacs.c, eval.c, event-Xt.c, event-gtk.c, event-msw.c, event-stream.c, event-tty.c, event-unixoid.c, events.c, events.h, extents.c, extents.h, faces.c, faces.h, file-coding.c, file-coding.h, fileio.c, filelock.c, fns.c, frame-gtk.c, frame-msw.c, frame-tty.c, frame-x.c, frame.c, frame.h, free-hook.c, general-slots.h, glyphs-eimage.c, glyphs-gtk.c, glyphs-msw.c, glyphs-widget.c, glyphs-x.c, glyphs.c, glyphs.h, gpmevent.c, gtk-xemacs.c, gui-msw.c, gui-x.c, gui-x.h, gui.c, gui.h, gutter.c, gutter.h, indent.c, input-method-xlib.c, insdel.c, keymap.c, keymap.h, lisp-disunion.h, lisp-union.h, lisp.h, lread.c, lrecord.h, lstream.c, lstream.h, marker.c, menubar-gtk.c, menubar-msw.c, menubar-x.c, menubar.c, minibuf.c, mule-canna.c, mule-ccl.c, mule-charset.c, mule-wnnfns.c, native-gtk-toolbar.c, objects-msw.c, objects-tty.c, objects-x.c, objects.c, objects.h, opaque.c, opaque.h, postgresql.c, postgresql.h, print.c, process-unix.c, process.c, process.h, rangetab.c, rangetab.h, redisplay-gtk.c, redisplay-msw.c, redisplay-output.c, redisplay-tty.c, redisplay-x.c, redisplay.c, scrollbar-gtk.c, scrollbar-msw.c, scrollbar-x.c, scrollbar.c, scrollbar.h, search.c, select-gtk.c, select-x.c, sound.c, specifier.c, specifier.h, strftime.c, symbols.c, symeval.h, syntax.h, text.c, text.h, toolbar-common.c, toolbar-msw.c, toolbar.c, toolbar.h, tooltalk.c, tooltalk.h, ui-gtk.c, ui-gtk.h, undo.c, vm-limit.c, window.c, window.h: Eliminate XSETFOO. Replace all usages with wrap_foo(). Make symbol->name a Lisp_Object, not Lisp_String *. Eliminate nearly all uses of Lisp_String * in favor of Lisp_Object, and correct macros so most of them favor Lisp_Object. Create new error-behavior ERROR_ME_DEBUG_WARN -- output warnings, but at level `debug' (usually ignored). Use it when instantiating specifiers, so problems can be debugged. Move log-warning-minimum-level into C so that we can optimize ERROR_ME_DEBUG_WARN. Fix warning levels consistent with new definitions. Add default_ and parent fields to char table; not yet implemented. New fun Dynarr_verify(); use for further error checking on Dynarrs. Rearrange code at top of lisp.h in conjunction with dynarr changes. Fix eifree(). Use Eistrings in various places (format_event_object(), where_is_to_char(), and callers thereof) to avoid fixed-size strings buffers. New fun write_eistring(). Reindent and fix GPM code to follow standards. Set default MS Windows font to Lucida Console (same size as Courier New but less interline spacing, so more lines fit). Increase default frame size on Windows to 50 lines. (If that's too big for the workspace, the frame will be shrunk as necessary.) Fix problem with text files with no newlines (). (Change `convert-eol' coding system to use `nil' for autodetect, consistent with make-coding-system.) Correct compile warnings in vm-limit.c. Fix handling of reverse-direction charsets to avoid errors when opening (e.g.) mule-ucs/lisp/reldata/uiso8859-6.el. Recode some object printing methods to use write_fmt_string() instead of a fixed buffer and sprintf. Turn on display of png comments as warnings (level `info'), now that they're unobtrusive. Revamped the sound documentation. Fixed bug in redisplay w.r.t. hscroll/truncation/continuation glyphs causing jumping up and down of the lines, since they're bigger than the line size. (It was seen most obviously when there's a horizontal scroll bar, e.g. do C-h a glyph or something like that.) The problem was that the glyph-contrib-p setting on glyphs was ignored even if it was set properly, which it wasn't until now.
author ben
date Fri, 29 Mar 2002 04:49:13 +0000
parents 0784d089fdc9
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1 \input texinfo @c -*-texinfo-*-
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2 @setfilename ../../info/new-users-guide.info
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3 @comment node-name, next, previous, up
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
4
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
5
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
6 @ifinfo
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
7 @dircategory XEmacs Editor
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
8 @direntry
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
9 * Intro: (new-users-guide). Introduction to the XEmacs Editor.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
10 @end direntry
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
11
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
12 This manual serves as an introduction to the XEmacs editor.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
13
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
14 Copyright (C) 1985, 1986, 1988 Richard M. Stallman.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
15 Copyright @copyright{} 1991, 1992, 1993, 1994 Lucid, Inc.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
16 Copyright @copyright{} 1993, 1994 Sun Microsystems, Inc.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
17
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
18 Permission is granted to make and distribute verbatim copies of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
19 this manual provided the copyright notice and this permission notice
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
20 are preserved on all copies.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
21
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
22 @ignore
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
23 Permission is granted to process this file through TeX and print the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
24 results, provided the printed document carries copying permission
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
25 notice identical to this one except for the removal of this paragraph
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
26 (this paragraph not being relevant to the printed manual).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
27
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
28 @end ignore
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
29 @end ifinfo
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
30 @c
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
31 @setchapternewpage odd
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
32 @settitle Getting Started With XEmacs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
33 @c
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
34 @titlepage
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
35 @sp 6
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
36 @center @titlefont{Getting Started With XEmacs}
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
37 @sp 4
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
38 @sp 1
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
39 @sp 1
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
40 @center July 1994
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
41 @center (General Public License upgraded, January 1991)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
42 @sp 5
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
43 @center Richard Stallman
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
44 @sp 1
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
45 @center and
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
46 @sp 1
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
47 @center Rashmi Goyal
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
48 @page
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
49 @vskip 0pt plus 1filll
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
50 Copyright @copyright{} 1985, 1986, 1988 Richard M. Stallman.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
51
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
52 Copyright @copyright{} 1991, 1992, 1993, 1994 Lucid, Inc.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
53
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
54 Copyright @copyright{} 1993, 1994 Sun Microsystems, Inc.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
55
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
56 Permission is granted to make and distribute verbatim copies of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
57 this manual provided the copyright notice and this permission notice
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
58 are preserved on all copies.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
59 @end titlepage
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
60 @page
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
61 @ifinfo
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
62 @node Top, Intro, (dir), (dir)
438
84b14dcb0985 Import from CVS: tag r21-2-27
cvs
parents: 428
diff changeset
63 @top The Emacs Editor
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
64
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
65
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
66 Emacs is the extensible, customizable, self-documenting real-time
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
67 display editor. This Info file will help you get started on using
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
68 XEmacs. It corresponds to XEmacs version 19.13.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
69
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
70 @end ifinfo
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
71
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
72 @iftex
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
73 @unnumbered Preface
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
74
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
75 This guide is intended to help you get started on using the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
76 Emacs editor. It will show you some examples of simple customizations.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
77
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
78 For detailed information on any topic, refer to the @b{XEmacs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
79 User's Manual}. This document will also refer the reader to the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
80 @b{XEmacs User's Manual} for more information on corresponding
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
81 topics. You can also use the on-line, learn-by-doing tutorial, which you
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
82 get by running Emacs and typing @kbd{C-h t} OR you can choose the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
83 @b{Emacs Tutorial} from the @b{Help} menu on the menu bar (which is
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
84 located on the extreme right of the frame). With it, you learn Emacs by
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
85 using Emacs on a specially designed file which describes commands, tells
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
86 you when to try them, and then explains the results you see.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
87
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
88 The first few chapters will introduce you to some basic Emacs commands.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
89 Later on, some examples of simple customizations will be shown.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
90
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
91 To find the documentation on a particular command, look in the index.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
92 Keys (character commands) and command names have separate indexes. There
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
93 is also a glossary, with a cross reference for each term.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
94
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
95 This manual comes in two forms: the published form and the Info form.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
96 The Info form is for on-line perusal with the INFO program; it is
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
97 distributed along with XEmacs. Both forms contain substantially the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
98 same text and are generated from a common source file, which is also
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
99 distributed along with XEmacs.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
100
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
101 @end iftex
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
102
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
103
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
104 @c node
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
105
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
106 @menu
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
107 * Intro:: Introduction to XEmacs editor
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
108
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
109 Indices, nodes containing large menus
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
110 * Key Index:: An item for each standard Emacs key sequence.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
111 * Command Index:: An item for each command and function name
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
112 * Variable Index:: An item for each variable in User-Guide
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
113 * Concept Index:: An item for the concepts introduced
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
114
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
115 Entering, Exiting and Editing Emacs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
116 * Entering:: Starting Emacs from the shell and Exiting
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
117 * Windows and Menus:: Description of Pull-down menus
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
118 * Edit:: Basic Editing commands
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
119
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
120 Other Features of XEmacs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
121 * Customization Basics:: Customize Emacs menus and keybindings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
122 * Help:: Help menu and other help commands
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
123 * Modes:: Major and Minor modes in XEmacs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
124 * Files:: Visiting, Saving and Listing Files
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
125 * Other Customizations:: Customizing Variables, Modes, etc
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
126 * Select and Move:: Selecting text and moving text
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
127 * Search and Replace:: Searching and Replacing text
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
128
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
129
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
130
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
131 --- The Detailed Node Listing ---
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
132
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
133 Entering and Exiting Emacs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
134
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
135 * Enter:: Entering Emacs from the shell
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
136 * Frame:: Basic information about the XEmacs Frame
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
137 * Exiting:: Exiting Emacs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
138 * Mode Line:: Interpreting the mode line.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
139 * Echo Area:: Bottom of the frame where you interact
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
140 with Emacs.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
141
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
142 XEmacs Windows and Menus
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
143
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
144 * XEmacs Window:: Manipulating XEmacs Windows
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
145 * Pull-down Menus:: Description of XEmacs Pull-down Menus
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
146
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
147 Pull-down menus
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
148
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
149 * File menu:: Items on the File Menu
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
150 * Edit menu:: Items on the Edit Menu
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
151 * Options Menu:: Items on the Options Menu
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
152 * Buffers Menu:: Items on the Buffers Menu
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
153 * Help menu:: The Help Menu at the extreme right on
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
154 the frame
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
155
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
156 Basic Editing Commands
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
157
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
158 * Insert:: Insert text in Emacs by simply typing at
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
159 the cursor position.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
160 * Cursor Position:: Moving Around the cursor in the buffer,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
161 * Erase:: Different commands for erasing text
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
162 * Numeric Argument:: Giving Numeric Arguments to commands
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
163 * Undo:: Undoing Changes made by mistake
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
164
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
165 Customize key bindings and menus
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
166
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
167 * Customizing key Bindings:: Changing Key Bindings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
168 * Customizing Menus:: Adding, Deleting, Enabling and Disabling Menus
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
169
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
170 Help
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
171
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
172 * The Help Menu:: Items on the Help Menu
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
173
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
174 Major and Minor Modes
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
175
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
176 * Major Modes:: Choosing Major Modes
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
177 * Minor Modes:: Auto-Fill, Abbrev and other minor modes
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
178
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
179 Emacs Files
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
180
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
181 * File Names:: How to type and edit file name arguments.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
182 * Visiting:: Visiting a file prepares Emacs to edit the file.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
183 * Saving Files:: How to save Emacs files.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
184
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
185 Other Customizations
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
186
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
187 * Setting Variables:: Customizing Emacs variables
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
188 * Init File:: Some examples of Lisp expressions in
462
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 438
diff changeset
189 init.el file
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
190
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
191 Selecting and Moving Text
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
192
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
193 * Selecting Text:: Select a region of text by setting the Mark
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
194 * Mouse:: Selecting Text with Mouse
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
195 * Region Operation:: Various ways to operate on a selected text
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
196 * Moving Text:: Moving Text
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
197 * Accumulating text:: Accumulating Text from several buffers
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
198
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
199 No sub menu for the node search and replace
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
200 @end menu
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
201
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
202 @node Intro,Key Index ,Top , Top
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
203 @unnumbered Introduction
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
204
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
205 You are reading about XEmacs which is a self-documenting, customizable, extensible real-time display editor.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
206
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
207 XEmacs is a @dfn{display} editor because normally the text
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
208 being edited is visible on the screen and is updated automatically as you
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
209 type. @xref{Frame,Display,,xemacs,XEmacs User's Manual}.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
210
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
211 It is a @dfn{real-time} editor because the display is updated very
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
212 frequently, usually after each character or pair of characters you type.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
213 This minimizes the amount of information you must keep in your head as
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
214 you edit. @xref{Basic,Real-time,Basic Editing,xemacs,XEmacs User's
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
215 Manual}.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
216
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
217 It is advanced because it provides facilities that go beyond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
218 simple insertion and deletion: filling of text; automatic indentation of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
219 programs; viewing two or more files at once; and dealing in terms of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
220 characters, words, lines, sentences, paragraphs, and pages, as well as
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
221 expressions and comments in several different programming languages. It is
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
222 much easier to type one command meaning ``go to the end of the paragraph''
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
223 than to find that spot with simple cursor keys.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
224
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
225 @dfn{Self-documenting} means that at any time you can type a special
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
226 character, @kbd{Control-h}, to find out what your options are. You can
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
227 also use @kbd{C-h} to find out what a command does, or to find all the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
228 commands relevant to a topic. @xref{Help,,,xemacs,XEmacs User's Manual}.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
229
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
230 @dfn{Customizable} means you can change the definitions of Emacs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
231 commands. For example, if you use a programming language in which
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
232 comments start with @samp{<**} and end with @samp{**>}, you can tell the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
233 Emacs comment manipulation commands to use those strings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
234 (@pxref{Comments,,,xemacs,XEmacs User's Manual}). Another sort of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
235 customization is rearrangement of the command set. For example, you can
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
236 set up the four basic cursor motion commands (up, down, left and right)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
237 on keys in a diamond pattern on the keyboard if you prefer.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
238 @xref{Customization,,,xemacs,XEmacs User's Manual}.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
239
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
240 @dfn{Extensible} means you can go beyond simple customization and
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
241 write entirely new commands, programs in the Lisp language to be run by
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
242 Emacs's own Lisp interpreter. Emacs is an ``on-line extensible''
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
243 system: it is divided into many functions that call each other. You can
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
244 redefine any function in the middle of an editing session and replace
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
245 any part of Emacs without making a separate copy of all of Emacs. Most
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
246 of the editing commands of Emacs are written in Lisp; the few
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
247 exceptions could have been written in Lisp but are written in C for
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
248 efficiency. Only a programmer can write an extension to Emacs, but anybody
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
249 can use it afterward.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
250
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
251 @include enter.texi
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
252 @include xmenu.texi
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
253 @include edit.texi
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
254 @include custom1.texi
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
255 @include help.texi
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
256 @include modes.texi
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
257 @include files.texi
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
258 @include custom2.texi
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
259 @include region.texi
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
260 @include search.texi
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
261
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
262 @node Key Index, Command Index, Intro, Top
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
263 @unnumbered Key (Character) Index
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
264 @printindex ky
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
265
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
266 @node Command Index, Variable Index, Key Index, Top
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
267 @unnumbered Command and Function Index
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
268 @printindex fn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
269
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
270 @node Variable Index, Concept Index, Command Index, Top
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
271 @unnumbered Variable Index
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
272 @printindex vr
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
273
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
274 @node Concept Index, Entering, Variable Index, Top
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
275 @unnumbered Concept Index
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
276 @printindex cp
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
277
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
278 @summarycontents
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
279 @contents
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
280 @bye
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
281
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
282 @c Remember to delete these lines before creating the info file.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
283 @iftex
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
284 @lucidbook
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
285 @bindingoffset = 0.5in
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
286 @parindent = 0pt
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
287 @end iftex
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
288