\input ../texinfo  @c -*-texinfo-*-
@setfilename ../../info/new-users-guide.info
@comment  node-name,  next,  previous,  up


@ifinfo
This file will serve as the User's Manual for the  XEmacs editor.

Copyright (C) 1985, 1986, 1988 Richard M. Stallman.
Copyright @copyright{} 1991, 1992, 1993, 1994 Lucid, Inc.
Copyright @copyright{} 1993, 1994 Sun Microsystems, Inc.

Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.

@ignore
Permission is granted to process this file through Tex and print the
results, provided the printed document carries copying permission
notice identical to this one except for the removal of this paragraph
(this paragraph not being relevant to the printed manual).

@end ignore
@end ifinfo
@c
@setchapternewpage odd
@settitle XEmacs User's Manual
@c
@titlepage
@sp 6
@center @titlefont{XEmacs User's Manual}
@sp 4
@sp 1
@sp 1
@center July 1994
@center (General Public License upgraded, January 1991)
@sp 5
@center Richard Stallman
@sp 1
@center and
@sp 1
@center Rashmi Goyal
@page
@vskip 0pt plus 1filll
Copyright @copyright{} 1985, 1986, 1988 Richard M. Stallman.

Copyright @copyright{} 1991, 1992, 1993, 1994 Lucid, Inc.

Copyright @copyright{} 1993, 1994 Sun Microsystems, Inc.

Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.
@end titlepage
@page
@ifinfo
@node Top, Intro, (dir), (dir)

The Emacs Editor
****************

Emacs is the extensible, customizable, self-documenting real-time
display editor.  This Info file will help you get started on using 
XEmacs. It corresponds to XEmacs version 19.11.

@end ifinfo

@iftex
@unnumbered Preface

  This User's manual is intended to help you get started on using the Emacs 
editor. It will show you some examples of simple customizations.

  For detailed information on any topic, refer to the @b{XEmacs Manual}. This 
document will also refer the reader to the @b{XEmacs manual} for more 
information on corresponding topics. You can also use the on-line,
learn-by-doing tutorial, which you get by running Emacs and typing
@kbd{C-h t} OR you can choose the @b{Emacs Tutorial} from the @b{Help}
menu on the menu bar (which is located on the extreme right of the
screen). With it, you learn Emacs by using Emacs on a specially designed
file which describes commands, tells you when to try them, and then
explains the results you see. 

  The first few chapters will introduce you to some basic Emacs commands. 
Later on, some examples of simple customizations will be shown. 

  To find the documentation on a particular command, look in the index.
Keys (character commands) and command names have separate indexes.  There
is also a glossary, with a cross reference for each term.

@ignore
  If you know vaguely what the command
does, look in the command summary.  The command summary contains a line or
two about each command, and a cross reference to the section of the
manual that describes the command in more detail; related commands
are grouped together.
@end ignore

  This manual comes in two forms: the published form and the Info form.
The Info form is for on-line perusal with the INFO program; it is
distributed along with GNU Emacs.  Both forms contain substantially the
same text and are generated from a common source file, which is also
distributed along with GNU Emacs.

This manual is for GNU Emacs installed on UNIX systems.  GNU
Emacs can also be used on VMS systems, which have different file name
syntax and don't support all GNU Emacs features.  A VMS edition of this
manual may appear in the future.
@end iftex


@c node

@menu
* Intro::                       Introduction to XEmacs editor

Indices, nodes containing large menus
* Key Index::                   An item for each standard Emacs key sequence.
* Command Index::               An item for each command and function name
* Variable Index::              An item for each variable in User-Guide
* Concept Index::               An item for the concepts introduced

Entering, Exiting and Editing Emacs
* Entering::                    Starting Emacs from the shell and Exiting
* Windows and Menus::           Description of Pull-down menus
* Edit::                        Basic Editing commands

Other Features of XEmacs
* Customization Basics::        Customize Emacs menus and keybindings
* Help::                        Help menu and other help commands
* Modes::                       Major and Minor modes in XEmacs
* Files::                       Visiting, Saving and Listing Files
* Other Customizations::        Customizing Variables, Modes, etc
* Select and Move::             Selecting text and moving text 
* Search and Replace::          Searching and Replacing text



 --- The Detailed Node Listing ---

Entering and Exiting Emacs

* Enter::                       Entering Emacs from the shell
* Screen::                      Basic information about the XEmacs Screen
* Exiting::                     Exiting Emacs
* Mode Line::                   Interpreting the mode line.
* Echo Area::                   Bottom of the screen where you interact
                                with Emacs.

XEmacs Windows and Menus

* XEmacs Window::               Manipulating XEmacs Windows
* Pull-down Menus::             Description of XEmacs Pull-down Menus

Pull-down menus

* File menu::                   Items on the File Menu
* Edit menu::                   Items on the Edit Menu
* Options Menu::                Items on the Options Menu
* Buffers Menu::                Items on the Buffers Menu
* Help menu::                   The Help Menu at the extreme right on
                                the screen

Basic Editing Commands

* Insert::                      Insert text in Emacs by simply typing at
                                the cursor position.
* Cursor Position::             Moving Around the cursor in the buffer,
* Erase::                       Different commands for erasing text 
* Numeric Argument::            Giving Numeric Arguments to commands
* Undo::                        Undoing Changes made by mistake

Customize key bindings and menus 

* Customizing key Bindings::    Changing Key Bindings
* Customizing Menus::           Adding, Deleting, Enabling and Disabling Menus

Help

* The Help Menu::               Items on the Help Menu                

Major and Minor Modes

* Major Modes::                 Choosing Major Modes
* Minor Modes::                 Auto-Fill, Abbrev and other minor modes

Emacs Files

* File Names::                  How to type and edit file name arguments.
* Visiting::                    Visiting a file prepares Emacs to edit the file.
* Saving Files::                How to save Emacs files.

Other Customizations

* Setting Variables::           Customizing Emacs variables
* Init File::                   Some examples of Lisp expressions in
                                .emacs file

Selecting and Moving Text

* Selecting Text::              Select a region of text by setting the Mark
* Mouse::                       Selecting Text with Mouse
* Region Operation::            Various ways to operate on a selected text
* Moving Text::                 Moving Text 
* Accumulating text::           Accumulating Text from several buffers

No sub menu for the node search and replace
@end menu

@node Intro,Key Index  ,Top , Top
@unnumbered Introduction

  You are reading about XEmacs which is a self-documenting, customizable, extensible real-time display editor.

  XEmacs is a @dfn{display} editor because normally the text
being edited is visible on the screen and is updated automatically as you
type.  @xref{Screen,Display, , ,XEmacs Manual}.

  It is a @dfn{real-time} editor because the display is updated very
frequently, usually after each character or pair of characters you
type.  This minimizes the amount of information you must keep in your
head as you edit.  @xref{Basic,Real-time,Basic Editing, ,XEmacs Manual}.

  It is advanced because it provides facilities that go beyond
simple insertion and deletion: filling of text; automatic indentation of
programs; viewing two or more files at once; and dealing in terms of
characters, words, lines, sentences, paragraphs, and pages, as well as
expressions and comments in several different programming languages.  It is
much easier to type one command meaning ``go to the end of the paragraph''
than to find that spot with simple cursor keys.

  @dfn{Self-documenting} means that at any time you can type a special
character, @kbd{Control-h}, to find out what your options are.  You can
also use @kbd{C-h} to find out what a command does, or to find all the
commands relevant to a topic.  @xref{Help,,,,XEmacs Manual}.

  @dfn{Customizable} means you can change the definitions of Emacs
commands.  For example, if you use a programming language in
which comments start with @samp{<**} and end with @samp{**>}, you can tell
the Emacs comment manipulation commands to use those strings
(@pxref{Comments,,,,XEmacs Manual}).  Another sort of customization is 
rearrangement of the
command set.  For example, you can set up the four basic cursor motion
commands (up, down, left and right) on keys in a diamond pattern on the
keyboard if you prefer.  @xref{Customization,,,,XEmacs Manual}.

  @dfn{Extensible} means you can go beyond simple customization and
write entirely new commands, programs in the Lisp language to be run by
Emacs's own Lisp interpreter.  Emacs is an ``on-line extensible''
system: it is divided into many functions that call each other.  You can
redefine any function in the middle of an editing session and replace
any part of Emacs without making a separate copy of all of Emacs.  Most
of the editing commands of Emacs are written in Lisp; the few
exceptions could have been written in Lisp but are written in C for
efficiency.  Only a programmer can write an extension to Emacs, but anybody
can use it afterward.

@include enter.texinfo
@include xmenu.texinfo
@include edit.texinfo
@include custom1.texinfo
@include help.texinfo
@include modes.texinfo
@include files.texinfo
@include custom2.texinfo
@include region.texinfo
@include search.texinfo

@node Key Index, Command Index, Intro, Top
@unnumbered Key (Character) Index
@printindex ky

@node Command Index, Variable Index, Key Index, Top
@unnumbered Command and Function Index
@printindex fn

@node Variable Index, Concept Index, Command Index, Top
@unnumbered Variable Index
@printindex vr

@node Concept Index, Entering, Variable Index, Top
@unnumbered Concept Index
@printindex cp

@summarycontents
@contents
@bye

@c Remember to delete these lines before creating the info file.
@iftex
@lucidbook
@bindingoffset = 0.5in
@parindent = 0pt
@end iftex

