\input texinfo @c -*-texinfo-*-
@c %**start of header
@setfilename elisp
-@smallbook
@settitle GNU Emacs Lisp Reference Manual
@c %**end of header
@ifinfo
-This version is the edition 2.3 of the GNU Emacs Lisp
-Reference Manual. It corresponds to Emacs Version 19.23.
+This version is the edition 2.4.2 of the GNU Emacs Lisp
+Reference Manual. It corresponds to Emacs Version 19.34.
@c Please REMEMBER to update edition number in *four* places in this file
@c and also in *one* place in intro.texi
Published by the Free Software Foundation
-675 Massachusetts Avenue
-Cambridge, MA 02139 USA
+59 Temple Place, Suite 330
+Boston, MA 02111-1307 USA
-Copyright (C) 1990, 1991, 1992, 1993, 1994 Free Software Foundation, Inc.
+Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@subtitle for Unix Users
@c The edition number appears in several places in this file
@c and also in the file intro.texi.
-@subtitle Second Edition, June 1993
-@subtitle Revision 2.3, April 1994
+@subtitle Revision 2.4.2, December 1996
@author by Bil Lewis, Dan LaLiberte, Richard Stallman
@author and the GNU Manual Group
@page
@vskip 0pt plus 1filll
-Copyright @copyright{} 1990, 1991, 1992, 1993, 1994 Free Software Foundation, Inc.
+Copyright @copyright{} 1990, 1991, 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
@sp 2
-Second Edition @*
-Revised for Emacs Version 19.23,@*
-April 1994.@*
+Edition 2.4.2 @*
+Revised for Emacs Version 19.34,@*
+July 1996.@*
@sp 2
-ISBN 1-882114-40-X
+ISBN 1-882114-71-X
@sp 2
Published by the Free Software Foundation @*
-675 Massachusetts Avenue @*
-Cambridge, MA 02139 USA
+59 Temple Place, Suite 330@*
+Boston, MA 02111-1307 USA
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@node Top, Copying, (dir), (dir)
@ifinfo
-This Info file contains edition 2.3 of the GNU Emacs Lisp
-Reference Manual, corresponding to GNU Emacs version 19.23.
+This Info file contains edition 2.4.2 of the GNU Emacs Lisp
+Reference Manual, corresponding to GNU Emacs version 19.34.
@end ifinfo
@menu
* Copying:: Conditions for copying and changing GNU Emacs.
* Introduction:: Introduction and conventions used.
+* Standards: Coding Conventions. Coding conventions for Emacs Lisp.
-* Types of Lisp Object:: Data types in Emacs Lisp.
+* Lisp Data Types:: Data types of objects in Emacs Lisp.
* Numbers:: Numbers and arithmetic functions.
* Strings and Characters:: Strings, and functions that work on them.
* Lists:: Lists, cons cells, and related functions.
* Byte Compilation:: Compilation makes programs run faster.
* Debugging:: Tools and tips for debugging Lisp programs.
-* Streams:: Converting Lisp objects to text and back.
+* Read and Print:: Converting Lisp objects to text and back.
* Minibuffers:: Using the minibuffer to read input.
* Command Loop:: How the editor command loop works,
and how you can call its subroutines.
Appendices
-* Tips:: Advice for writing Lisp programs.
+* Tips:: Advice and coding conventions for Emacs Lisp.
* GNU Emacs Internals:: Building and dumping Emacs;
internal data structures.
* Standard Errors:: List of all error symbols.
* Standard Keymaps:: List of standard keymaps.
* Standard Hooks:: List of standard hook variables.
-* Antinews:: Information about Emacs 18.
-
* Index:: Index including concepts, functions, variables,
and other terms.
* Buffer Text Notation:: The format we use for buffer contents in examples.
* Format of Descriptions:: Notation for describing functions, variables, etc.
+Tips and Conventions
+
+* Coding Conventions:: Conventions for clean and robust programs.
+* Compilation Tips:: Making compiled code run fast.
+* Documentation Tips:: Writing readable documentation strings.
+* Comment Tips:: Conventions for writing comments.
+* Library Headers:: Standard headers for library packages.
+
Format of Descriptions
* A Sample Function Description::
* Character Type:: The representation of letters, numbers and
control characters.
* Sequence Type:: Both lists and arrays are classified as sequences.
-* List Type:: Lists gave Lisp its name (not to mention reputation).
+* Cons Cell Type:: Cons cells, and lists (which are made from cons cells).
* Array Type:: Arrays include strings and vectors.
* String Type:: An (efficient) array of characters.
* Vector Type:: One-dimensional arrays.
* Symbol Type:: A multi-use object that refers to a function,
variable, property list, or itself.
-* Lisp Function Type:: A piece of executable code you can call from elsewhere.
-* Lisp Macro Type:: A method of expanding an expression into another
+* Function Type:: A piece of executable code you can call from elsewhere.
+* Macro Type:: A method of expanding an expression into another
expression, more fundamental but less pretty.
* Primitive Function Type:: A function written in C, callable from Lisp.
* Byte-Code Type:: A function written in Lisp, then compiled.
* Arithmetic Operations:: How to add, subtract, multiply and divide.
* Bitwise Operations:: Logical and, or, not, shifting.
* Numeric Conversions:: Converting float to integer and vice versa.
-* Transcendental Functions:: Trig, exponential and logarithmic functions.
+* Math Functions:: Trig, exponential and logarithmic functions.
* Random Numbers:: Obtaining random integers, predictable or not.
Strings and Characters
* Signaling Errors:: How to report an error.
* Processing of Errors:: What Emacs does when you report an error.
* Handling Errors:: How you can trap errors and continue execution.
-* Error Names:: How errors are classified for trapping them.
+* Error Symbols:: How errors are classified for trapping them.
Variables
* How Programs Do Loading:: The @code{load} function and others.
* Autoload:: Setting up a function to autoload.
-* Features:: Loading a library if it isn't already loaded.
+* Named Features:: Loading a library if it isn't already loaded.
* Repeated Loading:: Precautions about loading a file twice.
Byte Compilation
* Window Start:: The display-start position controls which text
is on-screen in the window.
* Vertical Scrolling:: Moving text up and down in the window.
+* Scrolling Hooks:: Hooks that run when you scroll a window.
* Horizontal Scrolling:: Moving text sideways on the window.
* Size of Window:: Accessing the size of a window.
* Resizing Windows:: Changing the size of a window.
* Window Configurations:: Saving and restoring the state of the screen.
+Frames
+
+* Creating Frames:: Creating additional frames.
+* Multiple Displays:: Creating frames on other X displays.
+* Frame Parameters:: Controlling frame size, position, font, etc.
+* Frame Titles:: Automatic updating of frame titles.
+* Deleting Frames:: Frames last until explicitly deleted.
+* Finding All Frames:: How to examine all existing frames.
+* Frames and Windows:: A frame contains windows;
+ display of text always works through windows.
+* Minibuffers and Frames:: How a frame finds the minibuffer to use.
+* Input Focus:: Specifying the selected frame.
+* Visibility of Frames:: Frames may be visible or invisible, or icons.
+* Raising and Lowering:: Raising a frame makes it hide other X windows;
+ lowering it makes the others hide them.
+* Frame Configurations:: Saving the state of all frames.
+* Mouse Tracking:: Getting events that say when the mouse moves.
+* Mouse Position:: Asking where the mouse is, or moving it.
+* Pop-Up Menus:: Displaying a menu for the user to select from.
+* Dialog Boxes:: Displaying a box to ask yes or no.
+* Pointer Shapes:: Specifying the shape of the mouse pointer.
+* X Selections:: Transferring text to and from other X clients.
+* Color Names:: Getting the definitions of color names.
+* Resources:: Getting resource values from the server.
+* Server Data:: Getting info about the X server.
+
Positions
* Point:: The special position where editing takes place.
* Buffer End Motion:: Moving to the beginning or end of the buffer.
* Text Lines:: Moving in terms of lines of text.
* Screen Lines:: Moving in terms of lines as displayed.
-* Vertical Motion:: Implementation of @code{next-line} and
- @code{previous-line}.
* List Motion:: Moving by parsing lists and sexps.
* Skipping Characters:: Skipping characters belonging to a certain set.
* Undo:: Undoing changes to the text of a buffer.
* Auto Filling:: How auto-fill mode is implemented to break lines.
* Filling:: Functions for explicit filling.
+* Margins:: How to specify margins for filling commands.
* Sorting:: Functions for sorting parts of the buffer.
* Indentation:: Functions to insert or adjust indentation.
* Columns:: Computing horizontal positions, and using them.
* Case Changes:: Case conversion of parts of the buffer.
+* Text Properties:: Assigning Lisp property lists to text characters.
* Substitution:: Replacing a given character wherever it appears.
-* Underlining:: Inserting or deleting underlining-by-overstrike.
+* Transposition:: Swapping two portions of a buffer.
* Registers:: How registers are implemented. Accessing
the text or position stored in a register.
+* Change Hooks:: Supplying functions to be run when text is changed.
The Kill Ring
* Kill Ring Concepts:: What text looks like in the kill ring.
* Kill Functions:: Functions that kill text.
* Yank Commands:: Commands that access the kill ring.
-* Low Level Kill Ring:: Functions and variables for kill ring access.
+* Low-Level Kill Ring:: Functions and variables for kill ring access.
* Internals of Kill Ring:: Variables that hold kill-ring data.
Indentation
* Indent Tabs:: Adjustable, typewriter-like tab stops.
* Motion by Indent:: Move to first non-blank character.
+Text Properties
+
+* Examining Properties:: Looking at the properties of one character.
+* Changing Properties:: Setting the properties of a range of text.
+* Property Search:: Searching for where a property changes value.
+* Special Properties:: Particular properties with special meanings.
+* Format Properties:: Properties for representing formatting of text.
+* Sticky Properties:: How inserted text gets properties from
+ neighboring text.
+* Saving Properties:: Saving text properties in files, and reading
+ them back.
+* Lazy Properties:: Computing text properties in a lazy fashion
+ only when text is examined.
+* Not Intervals:: Why text properties do not use
+ Lisp-visible text intervals.
+
Searching and Matching
* String Search:: Search for an exact match.
an asynchronous subprocess.
* Output from Processes:: Collecting output from an asynchronous subprocess.
* Sentinels:: Sentinels run when process run-status changes.
-* TCP:: Opening network connections.
+* Network:: Opening network connections.
Receiving Output from Processes
@include locals.texi
@include maps.texi
@include hooks.texi
-@include anti.texi
@include index.texi