Mercurial > hg > xemacs-beta
diff man/new-users-guide/new-users-guide.texi @ 0:376386a54a3c r19-14
Import from CVS: tag r19-14
author | cvs |
---|---|
date | Mon, 13 Aug 2007 08:45:50 +0200 |
parents | |
children | c9fe270a4101 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/new-users-guide/new-users-guide.texi Mon Aug 13 08:45:50 2007 +0200 @@ -0,0 +1,284 @@ +\input ../texinfo @c -*-texinfo-*- +@setfilename ../../info/new-users-guide.info +@comment node-name, next, previous, up + + +@ifinfo +This manual serves as an introduction to 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 Getting Started With XEmacs +@c +@titlepage +@sp 6 +@center @titlefont{Getting Started With XEmacs} +@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.13. + +@end ifinfo + +@iftex +@unnumbered Preface + + This guide 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 +User's Manual}. This document will also refer the reader to the +@b{XEmacs User's 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 frame). 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. + + 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 XEmacs. Both forms contain substantially the +same text and are generated from a common source file, which is also +distributed along with XEmacs. + +@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 +* Frame:: Basic information about the XEmacs Frame +* Exiting:: Exiting Emacs +* Mode Line:: Interpreting the mode line. +* Echo Area:: Bottom of the frame 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 frame + +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{Frame,Display, , ,XEmacs User's 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 User's +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 User's 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 User's 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 User's 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.texi +@include xmenu.texi +@include edit.texi +@include custom1.texi +@include help.texi +@include modes.texi +@include files.texi +@include custom2.texi +@include region.texi +@include search.texi + +@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 +