diff options
Diffstat (limited to 'lispref')
60 files changed, 477 insertions, 477 deletions
diff --git a/lispref/Makefile.in b/lispref/Makefile.in index 5e4f9d85435..c05acc15bb2 100644 --- a/lispref/Makefile.in +++ b/lispref/Makefile.in @@ -44,7 +44,7 @@ VERSION=2.9 manual = elisp-manual-21-$(VERSION) # Uncomment this line for permuted index. -# permuted_index = 1 +# permuted_index = 1 # List of all the texinfo files in the manual: @@ -144,7 +144,7 @@ install: elisp clean: rm -f *.toc *.aux *.log *.cp *.cps *.fn *.fns *.tp *.tps \ *.vr *.vrs *.pg *.pgs *.ky *.kys - rm -f make.out core + rm -f make.out core rm -f index.texi distclean: clean diff --git a/lispref/README b/lispref/README index 358b4193ff7..1600a5344b3 100644 --- a/lispref/README +++ b/lispref/README @@ -15,7 +15,7 @@ newsgroup gnu.emacs.help. 2.5 megabytes. * You can format this manual either for Info or for printing hardcopy -using TeX. +using TeX. * You can buy nicely printed copies from the Free Software Foundation. For info, send mail to gnu@gnu.org or phone 617-542-5942. Buying a @@ -42,7 +42,7 @@ commands in the shell: % make elisp.dvi *** To create a DVI file with a permuted index, you may experiment -with `make-permuted-index'. +with `make-permuted-index'. ** To make an Info file, you need to install Texinfo, then run `./configure' and `make info'. To install the Info files, run diff --git a/lispref/abbrevs.texi b/lispref/abbrevs.texi index 8e31c7c870d..5d7dad62a14 100644 --- a/lispref/abbrevs.texi +++ b/lispref/abbrevs.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1999 -@c Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1999 +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/abbrevs @node Abbrevs, Processes, Syntax Tables, Top @@ -46,7 +46,7 @@ Mode, emacs, The GNU Emacs Manual}. @node Abbrev Mode, Abbrev Tables, Abbrevs, Abbrevs @comment node-name, next, previous, up -@section Setting Up Abbrev Mode +@section Setting Up Abbrev Mode Abbrev mode is a minor mode controlled by the value of the variable @code{abbrev-mode}. diff --git a/lispref/advice.texi b/lispref/advice.texi index 3221753a1fc..cb877efe310 100644 --- a/lispref/advice.texi +++ b/lispref/advice.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1998, 1999 Free Software Foundation, Inc. +@c Copyright (C) 1998, 1999 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/advising @node Advising Functions, Debugging, Byte Compilation, Top @@ -726,7 +726,7 @@ The body forms of the various advice in each class are assembled according to their specified order. The forms of around-advice @var{l} are included in one of the forms of around-advice @var{l} @minus{} 1. -The innermost part of the around advice onion is +The innermost part of the around advice onion is @display apply original definition to @var{arglist} diff --git a/lispref/anti.texi b/lispref/anti.texi index 63035a0d23a..7925a8831df 100644 --- a/lispref/anti.texi +++ b/lispref/anti.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1999 Free Software Foundation, Inc. +@c Copyright (C) 1999 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @c This node must have no pointers. @@ -176,7 +176,7 @@ The function @code{buffer-size} always reports on the current buffer. @item -The function @code{assq-delete-all} has itself been deleted. +The function @code{assq-delete-all} has itself been deleted. So there! @item @@ -270,13 +270,13 @@ The meaning of the second argument to @code{read-char}, they use the current input method if the argument is if @code{nil}. @item -The function @code{with-temp-message} has been eliminated. +The function @code{with-temp-message} has been eliminated. @item -The function @code{clear-this-command-keys} has been eliminated. +The function @code{clear-this-command-keys} has been eliminated. @item -The functions @code{gap-position} and @code{gap-size} have been eliminated. +The functions @code{gap-position} and @code{gap-size} have been eliminated. @item In @code{modify-face}, an argument of @code{(nil)} has no special diff --git a/lispref/backups.texi b/lispref/backups.texi index 7c35ecdd817..858d6dfa9d5 100644 --- a/lispref/backups.texi +++ b/lispref/backups.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/backups @node Backups and Auto-Saving, Buffers, Files, Top @@ -78,9 +78,9 @@ save disk space. (You would put this code in your init file.) @smallexample @group -(add-hook 'rmail-mode-hook +(add-hook 'rmail-mode-hook (function (lambda () - (make-local-variable + (make-local-variable 'make-backup-files) (setq make-backup-files nil)))) @end group @@ -157,7 +157,7 @@ files. If you define it, you may need to change @subsection Backup by Renaming or by Copying? @cindex backup files, how to make them - There are two ways that Emacs can make a backup file: + There are two ways that Emacs can make a backup file: @itemize @bullet @item @@ -405,7 +405,7 @@ This function returns the name of the most recent backup file for Some file comparison commands use this function so that they can automatically compare a file with its most recent backup. -@end defun +@end defun @node Auto-Saving @section Auto-Saving diff --git a/lispref/buffers.texi b/lispref/buffers.texi index b0c79cd28d5..23239ebc48d 100644 --- a/lispref/buffers.texi +++ b/lispref/buffers.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/buffers @node Buffers, Windows, Backups and Auto-Saving, Top @@ -138,7 +138,7 @@ Next, @code{set-buffer} makes the specified buffer current. Finally, @code{insert-buffer-substring} copies the string from the original current buffer to the specified (and now current) buffer. - If the buffer appended to happens to be displayed in some window, + If the buffer appended to happens to be displayed in some window, the next redisplay will show how its text has changed. Otherwise, you will not see the change immediately on the screen. The buffer becomes current temporarily during the execution of the command, but this does @@ -307,7 +307,7 @@ make @var{unique} non-@code{nil} with a numeric prefix argument. This function returns the buffer specified by @var{buffer-or-name}. If @var{buffer-or-name} is a string and there is no buffer with that name, the value is @code{nil}. If @var{buffer-or-name} is a buffer, it -is returned as given; that is not very useful, so the argument is usually +is returned as given; that is not very useful, so the argument is usually a name. For example: @example @@ -534,7 +534,7 @@ counter that increments every time the buffer is modified. If @comment node-name, next, previous, up @section Comparison of Modification Time @cindex comparison of modification time -@cindex modification time, comparison of +@cindex modification time, comparison of Suppose that you visit a file and make changes in its buffer, and meanwhile the file itself is changed on disk. At this point, saving the @@ -602,7 +602,7 @@ some other program has probably altered the file. Depending on the user's answer, the function may return normally, in which case the modification of the buffer proceeds, or it may signal a @code{file-supersession} error with data @code{(@var{filename})}, in which -case the proposed buffer modification is not allowed. +case the proposed buffer modification is not allowed. This function is called automatically by Emacs on the proper occasions. It exists so you can customize Emacs by redefining it. @@ -617,7 +617,7 @@ See also the file locking mechanism in @ref{File Locks}. @cindex buffer, read-only If a buffer is @dfn{read-only}, then you cannot change its contents, -although you may change your view of the contents by scrolling and +although you may change your view of the contents by scrolling and narrowing. Read-only buffers are used in two kinds of situations: @@ -716,7 +716,7 @@ which frames they were selected in. ;; @r{Note that the name of the minibuffer} ;; @r{begins with a space!} (mapcar (function buffer-name) (buffer-list)) - @result{} ("buffers.texi" " *Minibuf-1*" + @result{} ("buffers.texi" " *Minibuf-1*" "buffer.c" "*Help*" "TAGS") @end group @end example @@ -982,7 +982,7 @@ ever again be the current buffer. This creates an indirect buffer named @var{name} whose base buffer is @var{base-buffer}. The argument @var{base-buffer} may be a buffer or a string. - + If @var{base-buffer} is an indirect buffer, its base buffer is used as the base for the new buffer. @end deffn diff --git a/lispref/calendar.texi b/lispref/calendar.texi index 6b62582993b..eeee2d118b5 100644 --- a/lispref/calendar.texi +++ b/lispref/calendar.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1995, 1998 Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1995, 1998 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Calendar, System Interface, Display, Top @chapter Customizing the Calendar and Diary @@ -16,7 +16,7 @@ diary suit your personal tastes. * Daylight Savings:: Changing the default. * Diary Customizing:: Defaults you can set. * Hebrew/Islamic Entries:: How to obtain them. -* Fancy Diary Display:: Enhancing the diary display, sorting entries, +* Fancy Diary Display:: Enhancing the diary display, sorting entries, using included diary files. * Sexp Diary Entries:: Fancy things you can do. * Appt Customizing:: Customizing appointment reminders. @@ -543,7 +543,7 @@ the fourth pattern. well as entries based on the world-standard Gregorian calendar. However, because recognition of such entries is time-consuming and most people don't use them, you must explicitly enable their use. If you -want the diary to recognize Hebrew-date diary entries, for example, +want the diary to recognize Hebrew-date diary entries, for example, you must do this: @vindex nongregorian-diary-listing-hook @@ -603,7 +603,7 @@ entry matches any date that has the same Hebrew day-within-month as the selected date. @item i h y Add a diary entry for the day of the Hebrew year corresponding to the -selected date (@code{insert-yearly-hebrew-diary-entry}). This diary +selected date (@code{insert-yearly-hebrew-diary-entry}). This diary entry matches any date which has the same Hebrew month and day-within-month as the selected date. @item i i d @@ -626,7 +626,7 @@ selected date (@code{insert-yearly-islamic-diary-entry}). These commands work much like the corresponding commands for ordinary diary entries: they apply to the date that point is on in the calendar window, and what they do is insert just the date portion of a diary entry -at the end of your diary file. You must then insert the rest of the +at the end of your diary file. You must then insert the rest of the diary entry. @node Fancy Diary Display diff --git a/lispref/commands.texi b/lispref/commands.texi index b33cace7ebe..340ff01857b 100644 --- a/lispref/commands.texi +++ b/lispref/commands.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/commands @node Command Loop, Keymaps, Minibuffers, Top @@ -12,7 +12,7 @@ When you run Emacs, it enters the @dfn{editor command loop} almost immediately. This loop reads key sequences, executes their definitions, and displays the results. In this chapter, we describe how these things -are done, and the subroutines that allow Lisp programs to do them. +are done, and the subroutines that allow Lisp programs to do them. @menu * Command Overview:: How the command loop reads commands. @@ -442,7 +442,7 @@ argument value. Completion, Existing, Prompt. @comment node-name, next, previous, up @subsection Examples of Using @code{interactive} @cindex examples of using @code{interactive} -@cindex @code{interactive}, examples of using +@cindex @code{interactive}, examples of using Here are some examples of @code{interactive}: @@ -501,7 +501,7 @@ command. You can also call these functions yourself. @defun commandp object Returns @code{t} if @var{object} is suitable for calling interactively; -that is, if @var{object} is a command. Otherwise, returns @code{nil}. +that is, if @var{object} is a command. Otherwise, returns @code{nil}. The interactively callable objects include strings and vectors (treated as keyboard macros), lambda expressions that contain a top-level call to @@ -664,7 +664,7 @@ non-@code{nil}. Here's how: @section Information from the Command Loop The editor command loop sets several Lisp variables to keep status -records for itself and for commands that are run. +records for itself and for commands that are run. @defvar last-command This variable records the name of the previous command executed by the @@ -1272,7 +1272,7 @@ The event type of a double-click event contains the prefix @key{meta} held down comes to the Lisp program as @code{M-double-mouse-2}. If a double-click event has no binding, the binding of the corresponding ordinary click event is used to execute -it. Thus, you need not pay attention to the double click feature +it. Thus, you need not pay attention to the double click feature unless you really want to. When the user performs a double click, Emacs generates first an ordinary @@ -2131,7 +2131,7 @@ functions to read command input. For example, the function that implements numeric prefix arguments reads any number of digits. When it finds a non-digit event, it must unread the event so that it can be read normally by the command loop. -Likewise, incremental search uses this feature to unread events with no +Likewise, incremental search uses this feature to unread events with no special meaning in a search, because these events should exit the search and then execute normally. @@ -2200,7 +2200,7 @@ It returns @code{nil}. In the following example, the user may type a number of characters right after starting the evaluation of the form. After the @code{sleep-for} -finishes sleeping, @code{discard-input} discards any characters typed +finishes sleeping, @code{discard-input} discards any characters typed during the sleep. @example @@ -2251,7 +2251,7 @@ screen. This function performs redisplay (provided there is no pending input from the user), then waits @var{seconds} seconds, or until input is available. The value is @code{t} if @code{sit-for} waited the full -time with no input arriving (see @code{input-pending-p} in @ref{Event +time with no input arriving (see @code{input-pending-p} in @ref{Event Input Misc}). Otherwise, the value is @code{nil}. The argument @var{seconds} need not be an integer. If it is a floating @@ -2334,7 +2334,7 @@ non-@code{nil} in any way thus causes a quit. At the level of C code, quitting cannot happen just anywhere; only at the special places that check @code{quit-flag}. The reason for this is that quitting at other places might leave an inconsistency in Emacs's -internal state. Because quitting is delayed until a safe place, quitting +internal state. Because quitting is delayed until a safe place, quitting cannot make Emacs crash. Certain functions such as @code{read-key-sequence} or @@ -2343,7 +2343,7 @@ for input. Instead of quitting, @kbd{C-g} serves as the requested input. In the case of @code{read-key-sequence}, this serves to bring about the special behavior of @kbd{C-g} in the command loop. In the case of @code{read-quoted-char}, this is so that @kbd{C-q} can be used -to quote a @kbd{C-g}. +to quote a @kbd{C-g}. @cindex prevent quitting You can prevent quitting for a portion of a Lisp function by binding @@ -2399,7 +2399,7 @@ in @ref{Errors}.) You can specify a character other than @kbd{C-g} to use for quitting. See the function @code{set-input-mode} in @ref{Terminal Input}. - + @node Prefix Command Arguments @section Prefix Command Arguments @cindex prefix argument @@ -2468,11 +2468,11 @@ C-u 3 M-x display-prefix @print{} 3 M-3 M-x display-prefix @print{} 3 ; @r{(Same as @code{C-u 3}.)} -C-u - M-x display-prefix @print{} - +C-u - M-x display-prefix @print{} - M-- M-x display-prefix @print{} - ; @r{(Same as @code{C-u -}.)} -C-u - 7 M-x display-prefix @print{} -7 +C-u - 7 M-x display-prefix @print{} -7 M-- 7 M-x display-prefix @print{} -7 ; @r{(Same as @code{C-u -7}.)} @end example @@ -2633,12 +2633,12 @@ then type @kbd{C-M-c} to exit and continue executing @code{simple-rec}. @deffn Command exit-recursive-edit This function exits from the innermost recursive edit (including minibuffer input). Its definition is effectively @code{(throw 'exit -nil)}. +nil)}. @end deffn @deffn Command abort-recursive-edit This function aborts the command that requested the innermost recursive -edit (including minibuffer input), by signaling @code{quit} +edit (including minibuffer input), by signaling @code{quit} after exiting the recursive edit. Its definition is effectively @code{(throw 'exit t)}. @xref{Quitting}. @end deffn @@ -2780,7 +2780,7 @@ not a symbol, string, or vector, an error is signaled. The argument @var{count} is a repeat count; @var{kbdmacro} is executed that many times. If @var{count} is omitted or @code{nil}, @var{kbdmacro} is executed once. If it is 0, @var{kbdmacro} is executed over and over until it -encounters an error or a failing search. +encounters an error or a failing search. @xref{Reading One Event}, for an example of using @code{execute-kbd-macro}. @end defun diff --git a/lispref/compile.texi b/lispref/compile.texi index b854fc86edf..c5615b0ec5e 100644 --- a/lispref/compile.texi +++ b/lispref/compile.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1994 Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1994 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/compile @node Byte Compilation, Advising Functions, Loading, Top @@ -64,7 +64,7 @@ Here is an example: (defun silly-loop (n) "Return time before and after N iterations of a loop." (let ((t1 (current-time-string))) - (while (> (setq n (1- n)) + (while (> (setq n (1- n)) 0)) (list t1 (current-time-string)))) @result{} silly-loop @@ -530,7 +530,7 @@ they still serve their purpose. @group 0 constant 1 ; @r{Push 1 onto stack.} -1 varref integer ; @r{Get value of @code{integer}} +1 varref integer ; @r{Get value of @code{integer}} ; @r{from the environment} ; @r{and push the value} ; @r{onto the stack.} @@ -573,7 +573,7 @@ they still serve their purpose. @group ; @r{Stack now contains:} ; @minus{} @r{decremented value of @code{integer}} - ; @minus{} @r{@code{factorial}} + ; @minus{} @r{@code{factorial}} ; @minus{} @r{value of @code{integer}} ; @minus{} @r{@code{*}} @end group @@ -616,7 +616,7 @@ The @code{silly-loop} function is somewhat more complex: (defun silly-loop (n) "Return time before and after N iterations of a loop." (let ((t1 (current-time-string))) - (while (> (setq n (1- n)) + (while (> (setq n (1- n)) 0)) (list t1 (current-time-string)))) @result{} silly-loop @@ -717,7 +717,7 @@ The @code{silly-loop} function is somewhat more complex: @end group @group -19 constant current-time-string ; @r{Push} +19 constant current-time-string ; @r{Push} ; @r{@code{current-time-string}} ; @r{onto top of stack.} @end group diff --git a/lispref/configure b/lispref/configure index ddf8dc7c907..93cc63efd65 100755 --- a/lispref/configure +++ b/lispref/configure @@ -1,7 +1,7 @@ #! /bin/sh # Guess values for system-dependent variables and create Makefiles. -# Generated automatically using autoconf version 2.13 +# Generated automatically using autoconf version 2.13 # Copyright (C) 1992, 93, 94, 95, 96 Free Software Foundation, Inc. # # This configure script is free software; the Free Software Foundation diff --git a/lispref/control.texi b/lispref/control.texi index adea5277061..a9f4d7c9d22 100644 --- a/lispref/control.texi +++ b/lispref/control.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/control @node Control Structures, Variables, Evaluation, Top @@ -154,7 +154,7 @@ based on the value of @var{condition}. If the evaluated @var{condition} is non-@code{nil}, @var{then-form} is evaluated and the result returned. Otherwise, the @var{else-forms} are evaluated in textual order, and the value of the last one is returned. (The @var{else} part of @code{if} is -an example of an implicit @code{progn}. @xref{Sequencing}.) +an example of an implicit @code{progn}. @xref{Sequencing}.) If @var{condition} has the value @code{nil}, and no @var{else-forms} are given, @code{if} returns @code{nil}. @@ -165,8 +165,8 @@ never evaluated---it is ignored. Thus, in the example below, @example @group -(if nil - (print 'true) +(if nil + (print 'true) 'very-false) @result{} very-false @end group @@ -260,7 +260,7 @@ clauses was successful. To do this, we use @code{t} as the never @code{nil}, so this clause never fails, provided the @code{cond} gets to it at all. -For example, +For example, @example @group @@ -376,7 +376,7 @@ expression returns @code{nil}. Just @code{(or)}, with no @var{conditions} turned out @code{nil}. (Think about it; which one did not?) -For example, this expression tests whether @code{x} is either +For example, this expression tests whether @code{x} is either @code{nil} or the integer zero: @example @@ -401,7 +401,7 @@ You could almost write @code{or} in terms of @code{if}, but not quite: @example @group (if @var{arg1} @var{arg1} - (if @var{arg2} @var{arg2} + (if @var{arg2} @var{arg2} @var{arg3})) @end group @end example @@ -663,7 +663,7 @@ return points at once. First, two return points with the same tag, @end group @group -(catch 'hack +(catch 'hack (print (catch2 'hack)) 'no) @print{} yes @@ -745,7 +745,7 @@ which you call for other purposes, such as if you try to take the buffer. You can also signal errors explicitly with the functions @code{error} and @code{signal}. - Quitting, which happens when the user types @kbd{C-g}, is not + Quitting, which happens when the user types @kbd{C-g}, is not considered an error, but it is handled almost like an error. @xref{Quitting}. @@ -1000,9 +1000,9 @@ message (but without a beep), then returns a very large number. @smallexample @group (defun safe-divide (dividend divisor) - (condition-case err + (condition-case err ;; @r{Protected form.} - (/ dividend divisor) + (/ dividend divisor) @end group @group ;; @r{The handler.} @@ -1046,7 +1046,7 @@ including those signaled with @code{error}: ;; @r{This is a call to the function @code{error}.} (error "Rats! The variable %s was %s, not 35" 'baz baz)) ;; @r{This is the handler; it is not a form.} - (error (princ (format "The error was: %s" err)) + (error (princ (format "The error was: %s" err)) 2)) @print{} The error was: (error "Rats! The variable baz was 34, not 35") @result{} 2 @@ -1096,7 +1096,7 @@ message @samp{peculiar error} is used. @group (put 'new-error 'error-conditions - '(error my-own-errors new-error)) + '(error my-own-errors new-error)) @result{} (error my-own-errors new-error) @end group @group @@ -1112,7 +1112,7 @@ classification; and @code{error}, which is the widest of all. The error string should start with a capital letter but it should not end with a period. This is for consistency with the rest of Emacs. - + Naturally, Emacs will never signal @code{new-error} on its own; only an explicit call to @code{signal} (@pxref{Signaling Errors}) in your code can do this: diff --git a/lispref/customize.texi b/lispref/customize.texi index d37e4fca983..b7699a19802 100644 --- a/lispref/customize.texi +++ b/lispref/customize.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1997, 1998, 1999, 2000, 2002 Free Software Foundation, Inc. +@c Copyright (C) 1997, 1998, 1999, 2000, 2002 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/customize @node Customization, Loading, Macros, Top @@ -13,8 +13,8 @@ definitions---as well as face definitions (@pxref{Defining Faces}). @menu * Common Keywords:: -* Group Definitions:: -* Variable Definitions:: +* Group Definitions:: +* Variable Definitions:: * Customization Types:: @end menu @@ -502,7 +502,7 @@ example, @end smallexample @noindent -instead of +instead of @smallexample (defcustom cons-alist '(("foo" . 1) ("bar" . 2) ("baz" . 3)) @@ -527,14 +527,14 @@ Similarily, you can have alists with more values associated with each key, using variations of this trick: @smallexample -(defcustom person-data '(("brian" 50 t) +(defcustom person-data '(("brian" 50 t) ("dorith" 55 nil) ("ken" 52 t)) "Alist of basic info about people. Each element has the form (NAME AGE MALE-FLAG)." :type '(alist :value-type (group age boolean))) -(defcustom pets '(("brian") +(defcustom pets '(("brian") ("dorith" "dog" "guppy") ("ken" "cat")) "Alist of people's pets. @@ -930,7 +930,7 @@ Substitute the tag here. You specify the tag with the @code{:tag} keyword. @item %% -Display a literal @samp{%}. +Display a literal @samp{%}. @end table @item :action @var{action} @@ -1033,7 +1033,7 @@ implemented. @item Widgets with tabbing order @code{-1} are ignored. -@item +@item (Unimplemented) When on a widget with tabbing order @var{n}, go to the next widget in the buffer with tabbing order @var{n+1} or @code{nil}, whichever comes first. diff --git a/lispref/debugging.texi b/lispref/debugging.texi index aa0cd0e1797..f0bbc9207cb 100644 --- a/lispref/debugging.texi +++ b/lispref/debugging.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/debugging @node Debugging, Read and Print, Advising Functions, Top diff --git a/lispref/display.texi b/lispref/display.texi index bc22fd48f17..85b21a045b9 100644 --- a/lispref/display.texi +++ b/lispref/display.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000, 2001, 2002 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/display @node Display, Calendar, Processes, Top @@ -409,9 +409,9 @@ major mode should use the mode's own name as an element of @example ;; @r{If you want to display an ellipsis:} -(add-to-invisibility-spec '(my-symbol . t)) +(add-to-invisibility-spec '(my-symbol . t)) ;; @r{If you don't want ellipsis:} -(add-to-invisibility-spec 'my-symbol) +(add-to-invisibility-spec 'my-symbol) (overlay-put (make-overlay beginning end) 'invisible 'my-symbol) @@ -483,7 +483,7 @@ effect is seen only within Emacs. @defvar selective-display This buffer-local variable enables selective display. This means that -lines, or portions of lines, may be made invisible. +lines, or portions of lines, may be made invisible. @itemize @bullet @item @@ -1336,7 +1336,7 @@ kind of customization item (@pxref{Customization}) which the user can customize using the Customization buffer (@pxref{Easy Customization,,, emacs, The GNU Emacs Manual}). -@defmac defface face spec doc [keyword value]... +@defmac defface face spec doc [keyword value]... This declares @var{face} as a customizable face that defaults according to @var{spec}. You should not quote the symbol @var{face}. The argument @var{doc} specifies the face documentation. The keywords you @@ -1473,13 +1473,13 @@ set width. This should be one of the symbols @code{ultra-condensed}, @code{extra-condensed}, @code{condensed}, @code{semi-condensed}, @code{normal}, @code{semi-expanded}, @code{expanded}, @code{extra-expanded}, or @code{ultra-expanded}. - + @item :height Either the font height, an integer in units of 1/10 point, a floating point number specifying the amount by which to scale the height of any underlying face, or a function, which is called with the old height (from the underlying face), and should return the new height. - + @item :weight Font weight---a symbol from this series (from most dense to most faint): @code{ultra-bold}, @code{extra-bold}, @code{bold}, @code{semi-bold}, @@ -1499,7 +1499,7 @@ the terminal supports the feature. @item :foreground Foreground color, a string. - + @item :background Background color, a string. @@ -1852,7 +1852,7 @@ With a region that is active. In Transient Mark mode, the region is highlighted with the face @code{region} (@pxref{Standard Faces}). @item -With special glyphs. Each glyph can specify a particular face +With special glyphs. Each glyph can specify a particular face number. @xref{Glyphs}. @end itemize @@ -2285,7 +2285,7 @@ they mean. @menu * Specified Space:: Displaying one space with a specified width. * Other Display Specs:: Displaying an image; magnifying text; moving it - up or down on the page; adjusting the width + up or down on the page; adjusting the width of spaces within text. * Display Margins:: Displaying text or images to the side of the main text. * Conditional Display:: Making any of the above features conditional @@ -2465,7 +2465,7 @@ Thus, you can make changes take effect by calling @defun set-window-margins window left &optional right @tindex set-window-margins This function specifies the margin widths for window @var{window}. -The argument @var{left} controls the left margin and +The argument @var{left} controls the left margin and @var{right} controls the right margin (default @code{0}). @end defun @@ -3409,7 +3409,7 @@ variable @code{glyph-table}. @defvar glyph-table The value of this variable is the current glyph table. It should be a -vector; the @var{g}th element defines glyph code @var{g}. +vector; the @var{g}th element defines glyph code @var{g}. If a glyph code is greater than or equal to the length of the glyph table, that code is automatically simple. If the value of diff --git a/lispref/edebug.texi b/lispref/edebug.texi index 7df8a7f2c55..b94ba8838ba 100644 --- a/lispref/edebug.texi +++ b/lispref/edebug.texi @@ -1,10 +1,10 @@ @comment -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1992, 1993, 1994, 1998, 1999 Free Software Foundation, Inc. +@c Copyright (C) 1992, 1993, 1994, 1998, 1999 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. -@c This file can also be used by an independent Edebug User -@c Manual in which case the Edebug node below should be used +@c This file can also be used by an independent Edebug User +@c Manual in which case the Edebug node below should be used @c with the following links to the Bugs section and to the top level: @c , Bugs and Todo List, Top, Top @@ -35,7 +35,7 @@ at each breakpoint. Display expression results and evaluate expressions as if outside of Edebug. -@item +@item Automatically re-evaluate a list of expressions and display their results each time Edebug updates the display. @@ -117,7 +117,7 @@ at the open-parenthesis before @code{if}. @cindex stop points The places within a function where Edebug can stop execution are called @dfn{stop points}. These occur both before and after each subexpression -that is a list, and also after each variable reference. +that is a list, and also after each variable reference. Here we use periods to show the stop points in the function @code{fac}: @@ -142,7 +142,7 @@ display you will see: @end example When Edebug stops execution after an expression, it displays the -expression's value in the echo area. +expression's value in the echo area. Other frequently used commands are @kbd{b} to set a breakpoint at a stop point, @kbd{g} to execute until a breakpoint is reached, and @kbd{q} to @@ -445,7 +445,7 @@ breakpoint is temporary---it turns off the first time it stops the program. @item u -Unset the breakpoint (if any) at the stop point at or after +Unset the breakpoint (if any) at the stop point at or after point (@code{edebug-unset-breakpoint}). @item x @var{condition} @key{RET} @@ -490,7 +490,7 @@ breakpoints. This command does not continue execution---it just moves point in the buffer. @menu -* Global Break Condition:: Breaking on an event. +* Global Break Condition:: Breaking on an event. * Source Breakpoints:: Embedding breakpoints in source code. @end menu @@ -692,7 +692,7 @@ but they are evaluated in the context outside of Edebug. The expressions you enter interactively (and their results) are lost when you continue execution; but you can set up an @dfn{evaluation list} -consisting of expressions to be evaluated each time execution stops. +consisting of expressions to be evaluated each time execution stops. @cindex evaluation list group To do this, write one or more @dfn{evaluation list groups} in the @@ -771,7 +771,7 @@ If non-@code{nil}, Edebug binds @code{print-length} to this value while printing results. The default value is @code{50}. @end defopt -@defopt edebug-print-level +@defopt edebug-print-level If non-@code{nil}, Edebug binds @code{print-level} to this value while printing results. The default value is @code{50}. @end defopt @@ -794,7 +794,7 @@ Custom printing prints this as @samp{Result: #1=(#1# y)}. The structure. This notation is used for any shared elements of lists or vectors. -@defopt edebug-print-circle +@defopt edebug-print-circle If non-@code{nil}, Edebug binds @code{print-circle} to this value while printing results. The default value is @code{nil}. @end defopt @@ -900,13 +900,13 @@ the breakpoint is reached, the frequency data looks like this: @example (defun fac (n) (if (= n 0) (edebug)) -;#6 1 0 =5 +;#6 1 0 =5 (if (< 0 n) -;#5 = +;#5 = (* n (fac (1- n))) -;# 5 0 +;# 5 0 1)) -;# 0 +;# 0 @end example The comment lines show that @code{fac} was called 6 times. The @@ -939,12 +939,12 @@ before even deciding whether to make trace information or stop the program. @itemize @bullet -@item +@item @code{max-lisp-eval-depth} and @code{max-specpdl-size} are both incremented once to reduce Edebug's impact on the stack. You could, however, still run out of stack space when using Edebug. -@item +@item The state of keyboard macro execution is saved and restored. While Edebug is active, @code{executing-macro} is bound to @code{edebug-continue-kbd-macro}. @@ -958,7 +958,7 @@ Edebug is active, @code{executing-macro} is bound to @c This paragraph is not filled, because LaLiberte's conversion script @c needs an xref to be on just one line. When Edebug needs to display something (e.g., in trace mode), it saves -the current window configuration from ``outside'' Edebug +the current window configuration from ``outside'' Edebug (@pxref{Window Configurations}). When you exit Edebug (by continuing the program), it restores the previous window configuration. @@ -974,12 +974,12 @@ following data (though some of them are deliberately not restored if an error or quit signal occurs). @itemize @bullet -@item +@item @cindex current buffer point and mark (Edebug) Which buffer is current, and the positions of point and the mark in the current buffer, are saved and restored. -@item +@item @cindex window configuration (Edebug) The outside window configuration is saved and restored if @code{edebug-save-windows} is non-@code{nil} (@pxref{Edebug Display Update}). @@ -1002,7 +1002,7 @@ The variables @code{overlay-arrow-position} and @code{overlay-arrow-string} are saved and restored. So you can safely invoke Edebug from the recursive edit elsewhere in the same buffer. -@item +@item @code{cursor-in-echo-area} is locally bound to @code{nil} so that the cursor shows up in the window. @end itemize @@ -1047,7 +1047,7 @@ evaluation list window. by the @code{recursive-edit}, but Edebug temporarily restores them during evaluations. -@item +@item The state of keyboard macro definition is saved and restored. While Edebug is active, @code{defining-kbd-macro} is bound to @code{edebug-continue-kbd-macro}. @@ -1187,7 +1187,7 @@ A lambda expression with no quoting. @item &optional @kindex &optional @r{(Edebug)} All following elements in the specification list are optional; as soon -as one does not match, Edebug stops matching at this level. +as one does not match, Edebug stops matching at this level. To make just a few elements optional followed by non-optional elements, use @code{[&optional @var{specs}@dots{}]}. To specify that several @@ -1222,7 +1222,7 @@ Each of the following elements is matched as alternatives as if by using of them match, nothing is matched, but the @code{¬} specification succeeds. -@item &define +@item &define @kindex &define @r{(Edebug)} Indicates that the specification is for a defining form. The defining form itself is not instrumented (that is, Edebug does not stop before and @@ -1302,7 +1302,7 @@ Here is a list of additional specifications that may appear only after @table @code @item name -The argument, a symbol, is the name of the defining form. +The argument, a symbol, is the name of the defining form. A defining form is not required to have a name field; and it may have multiple name fields. @@ -1349,7 +1349,7 @@ necessarily mean a syntax error will be signaled; instead, exhausted. Eventually every element of the argument list must be matched by some element in the specification, and every required element in the specification must match some argument. - + When a syntax error is detected, it might not be reported until much later after higher-level alternatives have been exhausted, and with the point positioned further from the real error. But if backtracking is @@ -1405,8 +1405,8 @@ function body. @smallexample (def-edebug-spec defmacro defun) ; @r{Indirect ref to @code{defun} spec.} -(def-edebug-spec defun - (&define name lambda-list +(def-edebug-spec defun + (&define name lambda-list [&optional stringp] ; @r{Match the doc string, if present.} [&optional ("interactive" interactive)] def-body)) @@ -1479,7 +1479,7 @@ what happens to the window configurations, it is better to set this variable to @code{nil}. If the value is a list, only the listed windows are saved and -restored. +restored. You can use the @kbd{W} command in Edebug to change this variable interactively. @xref{Edebug Display Update}. @@ -1505,26 +1505,26 @@ mode for Edebug when it is first activated. Possible values are @code{step}, @code{next}, @code{go}, @code{Go-nonstop}, @code{trace}, @code{Trace-fast}, @code{continue}, and @code{Continue-fast}. -The default value is @code{step}. +The default value is @code{step}. @xref{Edebug Execution Modes}. @end defopt @defopt edebug-trace Non-@code{nil} means display a trace of function entry and exit. Tracing output is displayed in a buffer named @samp{*edebug-trace*}, one -function entry or exit per line, indented by the recursion level. +function entry or exit per line, indented by the recursion level. -The default value is @code{nil}. +The default value is @code{nil}. Also see @code{edebug-tracing}, in @ref{Trace Buffer}. @end defopt -@defopt edebug-test-coverage +@defopt edebug-test-coverage If non-@code{nil}, Edebug tests coverage of all expressions debugged. @xref{Coverage Testing}. @end defopt -@defopt edebug-continue-kbd-macro +@defopt edebug-continue-kbd-macro If non-@code{nil}, continue defining or executing any keyboard macro that is executing outside of Edebug. Use this with caution since it is not debugged. diff --git a/lispref/elisp-covers.texi b/lispref/elisp-covers.texi index aa9d23b8444..c536e9e6b25 100644 --- a/lispref/elisp-covers.texi +++ b/lispref/elisp-covers.texi @@ -24,7 +24,7 @@ @sp 2 @center @titlefont{Volume 1} @sp 2 -@center by Bil Lewis, Dan LaLiberte, +@center by Bil Lewis, Dan LaLiberte, @center and the GNU Manual Group @page @@ -47,7 +47,7 @@ @sp 2 @center @titlefont{Volume 2} @sp 2 -@center by Bil Lewis, +@center by Bil Lewis, @center Dan LaLiberte, and @center the GNU Manual Group @@ -78,7 +78,7 @@ @sp 2 @center @titlefont{Volume 1} @sp 2 -@center by Bil Lewis, Dan LaLiberte, +@center by Bil Lewis, Dan LaLiberte, @center and the GNU Manual Group @page @@ -112,7 +112,7 @@ @sp 2 @center @titlefont{Volume 1} @sp 2 -@center by Bil Lewis, +@center by Bil Lewis, @center Dan LaLiberte, and @center the GNU Manual Group @@ -143,7 +143,7 @@ @sp 2 @center @titlefont{Volume 1} @sp 2 -@center by Bil Lewis, Dan LaLiberte, +@center by Bil Lewis, Dan LaLiberte, @center and the GNU Manual Group @page @@ -173,7 +173,7 @@ @sp 2 @center @titlefont{Volume 2} @sp 2 -@center by Bil Lewis, Dan LaLiberte, +@center by Bil Lewis, Dan LaLiberte, @center and the GNU Manual Group @page @@ -203,7 +203,7 @@ @sp 2 @center @titlefont{Volume 2} @sp 2 -@center by Bil Lewis, Dan LaLiberte, +@center by Bil Lewis, Dan LaLiberte, @center and the GNU Manual Group @@ -216,7 +216,7 @@ @center for Unix Users @center Edition 2.3, June 1994 @sp 4 -@center by Bil Lewis, Dan LaLiberte, +@center by Bil Lewis, Dan LaLiberte, @center and the GNU Manual Group @sp 4 @@ -225,7 +225,7 @@ @author FSF @author - + @page @c ================ Spine 2 ================ @@ -235,7 +235,7 @@ @center for Unix Users @center Edition 2.3, June 1994 @sp 4 -@center by Bil Lewis, Dan LaLiberte, +@center by Bil Lewis, Dan LaLiberte, @center and the GNU Manual Group diff --git a/lispref/elisp.texi b/lispref/elisp.texi index cd350c9bf18..7eab107f739 100644 --- a/lispref/elisp.texi +++ b/lispref/elisp.texi @@ -35,7 +35,7 @@ Published by the Free Software Foundation Boston, MA 02111-1307 USA Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1998, 1999,@* - 2000, 2002 Free Software Foundation, Inc. + 2000, 2002 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or @@ -207,8 +207,8 @@ Tips and Conventions Format of Descriptions -* A Sample Function Description:: -* A Sample Variable Description:: +* A Sample Function Description:: +* A Sample Variable Description:: Lisp Data Types @@ -317,7 +317,7 @@ Evaluation * Intro Eval:: Evaluation in the scheme of things. * Eval:: How to invoke the Lisp interpreter explicitly. * Forms:: How various sorts of objects are evaluated. -* Quoting:: Avoiding evaluation (to put constants in +* Quoting:: Avoiding evaluation (to put constants in the program). Kinds of Forms @@ -370,11 +370,11 @@ Variables Scoping Rules for Variable Bindings -* Scope:: Scope means where in the program a value +* Scope:: Scope means where in the program a value is visible. Comparison with other languages. * Extent:: Extent means how long in time a value exists. * Impl of Scope:: Two ways to implement dynamic scoping. -* Using Scoping:: How to use dynamic scoping carefully and +* Using Scoping:: How to use dynamic scoping carefully and avoid problems. Buffer-Local Variables @@ -392,11 +392,11 @@ Functions * Defining Functions:: Lisp expressions for defining functions. * Calling Functions:: How to use an existing function. * Mapping Functions:: Applying a function to each element of a list, etc. -* Anonymous Functions:: Lambda-expressions are functions with no names. +* Anonymous Functions:: Lambda-expressions are functions with no names. * Function Cells:: Accessing or setting the function definition of a symbol. * Related Topics:: Cross-references to specific Lisp primitives - that have a special bearing on how + that have a special bearing on how functions work. Lambda Expressions @@ -445,10 +445,10 @@ Debugging Lisp Programs * Debugger:: How the Emacs Lisp debugger is implemented. * Syntax Errors:: How to find syntax errors. -* Compilation Errors:: How to find errors that show up in +* Compilation Errors:: How to find errors that show up in byte compilation. * Edebug:: A source-level Emacs Lisp debugger. - + The Lisp Debugger * Error Debugging:: Entering the debugger when an error happens. @@ -467,10 +467,10 @@ Debugging Invalid Lisp Syntax Reading and Printing Lisp Objects * Streams Intro:: Overview of streams, reading and printing. -* Input Streams:: Various data types that can be used as +* Input Streams:: Various data types that can be used as input streams. * Input Functions:: Functions to read Lisp objects from text. -* Output Streams:: Various data types that can be used as +* Output Streams:: Various data types that can be used as output streams. * Output Functions:: Functions to print Lisp objects as text. @@ -542,7 +542,7 @@ Major and Minor Modes * Major Modes:: Defining major modes. * Minor Modes:: Defining minor modes. * Mode Line Format:: Customizing the text that appears in the mode line. -* Hooks:: How to use hooks; how to write code that +* Hooks:: How to use hooks; how to write code that provides hooks. Major Modes @@ -602,7 +602,7 @@ File Names * File Name Components:: The directory part of a file name, and the rest. * Directory Names:: A directory's name as a directory is different from its name as a file. -* Relative File Names:: Some file names are relative to a +* Relative File Names:: Some file names are relative to a current directory. * File Name Expansion:: Converting relative file names to absolute ones. * Unique File Names:: Generating names for temporary files. @@ -610,17 +610,17 @@ File Names Backups and Auto-Saving -* Backup Files:: How backup files are made; how their names +* Backup Files:: How backup files are made; how their names are chosen. * Auto-Saving:: How auto-save files are made; how their names are chosen. -* Reverting:: @code{revert-buffer}, and how to customize +* Reverting:: @code{revert-buffer}, and how to customize what it does. Backup Files * Making Backups:: How Emacs makes backup files, and when. -* Rename or Copy:: Two alternatives: renaming the old file +* Rename or Copy:: Two alternatives: renaming the old file or copying it. * Numbered Backups:: Keeping multiple backups for each source file. * Backup Names:: How backup file names are computed; customization. @@ -654,7 +654,7 @@ Windows and choosing a window for it. * Window Point:: Each window has its own location of point. * Window Start:: The display-start position controls which text - is on-screen in the window. + is on-screen in the window. * Vertical Scrolling:: Moving text up and down in the window. * Horizontal Scrolling:: Moving text sideways on the window. * Size of Window:: Accessing the size of a window. @@ -710,7 +710,7 @@ Markers * Predicates on Markers:: Testing whether an object is a marker. * Creating Markers:: Making empty markers or markers at certain places. * Information from Markers:: Finding the marker's buffer or character - position. + position. * Moving Markers:: Moving the marker to a new buffer or position. * The Mark:: How ``the mark'' is implemented with a marker. * The Region:: How to access ``the region''. @@ -739,7 +739,7 @@ Text * 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. diff --git a/lispref/errors.texi b/lispref/errors.texi index 51132c1b4bc..14797d61011 100644 --- a/lispref/errors.texi +++ b/lispref/errors.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1999 Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1999 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/errors @node Standard Errors, Standard Buffer-Local Variables, GNU Emacs Internals, Top @@ -87,7 +87,7 @@ error message is constructed from the data items alone when the error condition @code{file-error} is present.@* @xref{Files}. -@item file-locked +@item file-locked This is a subcategory of @code{file-error}.@* @xref{File Locks}. @@ -131,7 +131,7 @@ find invalid syntax or mismatched parentheses.@* @xref{Searching and Matching}. @item setting-constant -@code{"Attempt to set a constant symbol"}@* +@code{"Attempt to set a constant symbol"}@* The values of the symbols @code{nil} and @code{t}, and any symbols that start with @samp{:}, may not be changed.@* diff --git a/lispref/eval.texi b/lispref/eval.texi index 4c4e19b1a47..fa90ff07be1 100644 --- a/lispref/eval.texi +++ b/lispref/eval.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1998 Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1998 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/eval @node Evaluation, Control Structures, Symbols, Top @@ -30,7 +30,7 @@ function @code{eval}. @section Introduction to Evaluation The Lisp interpreter, or evaluator, is the program that computes -the value of an expression that is given to it. When a function +the value of an expression that is given to it. When a function written in Lisp is called, the evaluator computes the value of the function by evaluating the expressions in the function body. Thus, running any Lisp program really means running the Lisp interpreter. @@ -300,7 +300,7 @@ function, not a symbol. @smallexample @group ((lambda (arg) (erste arg)) - '(1 2 3)) + '(1 2 3)) @result{} 1 @end group @end smallexample diff --git a/lispref/files.texi b/lispref/files.texi index 8c3545a055b..cb28ac8607b 100644 --- a/lispref/files.texi +++ b/lispref/files.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/files @node Files, Backups and Auto-Saving, Documentation, Top @@ -92,7 +92,7 @@ temporary buffer. Visiting the file is not necessary and takes longer. @deffn Command find-file filename &optional wildcards This command selects a buffer visiting the file @var{filename}, -using an existing buffer if there is one, and otherwise creating a +using an existing buffer if there is one, and otherwise creating a new buffer and reading the file into it. It also returns that buffer. The body of the @code{find-file} function is very simple and looks @@ -548,7 +548,7 @@ offset from the start of the file and writes the data from there. If @var{mustbenew} is non-@code{nil}, then @code{write-region} asks for confirmation if @var{filename} names an existing file. -Starting in Emacs 21, if @var{mustbenew} is the symbol @code{excl}, +Starting in Emacs 21, if @var{mustbenew} is the symbol @code{excl}, then @code{write-region} does not ask for confirmation, but instead it signals an error @code{file-already-exists} if the file already exists. @@ -865,7 +865,7 @@ name of a text file, a directory, or even another symbolic link, or it may be a nonexistent file name. If the file @var{filename} is not a symbolic link (or there is no such file), -@code{file-symlink-p} returns @code{nil}. +@code{file-symlink-p} returns @code{nil}. @example @group @@ -1107,11 +1107,11 @@ For example, here are the file attributes for @file{files.texi}: @example @group (file-attributes "files.texi") - @result{} (nil 1 2235 75 - (8489 20284) - (8489 20284) + @result{} (nil 1 2235 75 + (8489 20284) + (8489 20284) (8489 20285) - 14906 "-rw-rw-rw-" + 14906 "-rw-rw-rw-" nil 129500 -32252) @end group @end example @@ -1530,7 +1530,7 @@ first character of the file name's last component. For example, @end defun @ignore -Andrew Innes says that this +Andrew Innes says that this @c @defvar directory-sep-char @c @tindex directory-sep-char @@ -1974,12 +1974,12 @@ default directory, and has five files whose names begin with @samp{f}: @example @group (file-name-all-completions "f" "") - @result{} ("foo" "file~" "file.c.~2~" + @result{} ("foo" "file~" "file.c.~2~" "file.c.~1~" "file.c") @end group @group -(file-name-all-completions "fo" "") +(file-name-all-completions "fo" "") @result{} ("foo") @end group @end example @@ -2126,7 +2126,7 @@ then the user will probably be happier if you do sort the names. @group (directory-files "~lewis") @result{} ("#foo#" "#foo.el#" "." ".." - "dired-mods.el" "files.texi" + "dired-mods.el" "files.texi" "files.texi.~1~") @end group @end example @@ -2388,7 +2388,7 @@ for an operation it does not recognize. Here's one way to do this: @dots{} ;; @r{Handle any operation we don't know about.} (t (let ((inhibit-file-name-handlers - (cons 'my-file-handler + (cons 'my-file-handler (and (eq inhibit-file-name-operation operation) inhibit-file-name-handlers))) (inhibit-file-name-operation operation)) diff --git a/lispref/frames.texi b/lispref/frames.texi index 9d9a0ce82c6..fd9e74bea36 100644 --- a/lispref/frames.texi +++ b/lispref/frames.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2002 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/frames @node Frames, Positions, Windows, Top @@ -70,7 +70,7 @@ The frame is displayed on an MS-DOS terminal. * Display Feature Testing:: Determining the features of a terminal. @end menu - @xref{Display}, for information about the related topic of + @xref{Display}, for information about the related topic of controlling Emacs redisplay. @node Creating Frames diff --git a/lispref/front-cover-1.texi b/lispref/front-cover-1.texi index 71ecd6a35da..56d0f2b1c2d 100644 --- a/lispref/front-cover-1.texi +++ b/lispref/front-cover-1.texi @@ -24,7 +24,7 @@ @sp 2 @center @titlefont{Volume 1} @sp 2 -@center by Bil Lewis, Dan LaLiberte, +@center by Bil Lewis, Dan LaLiberte, @center and the GNU Manual Group @page . @@ -45,7 +45,7 @@ @sp 2 @center @titlefont{Volume 2} @sp 2 -@center by Bil Lewis, Dan LaLiberte, +@center by Bil Lewis, Dan LaLiberte, @center and the GNU Manual Group @end titlepage diff --git a/lispref/functions.texi b/lispref/functions.texi index ece586f79e4..576ad51b006 100644 --- a/lispref/functions.texi +++ b/lispref/functions.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/functions @node Functions, Macros, Variables, Top @@ -18,7 +18,7 @@ define them. * Defining Functions:: Lisp expressions for defining functions. * Calling Functions:: How to use an existing function. * Mapping Functions:: Applying a function to each element of a list, etc. -* Anonymous Functions:: Lambda expressions are functions with no names. +* Anonymous Functions:: Lambda expressions are functions with no names. * Function Cells:: Accessing or setting the function definition of a symbol. * Inline Functions:: Defining functions that the compiler will open code. @@ -746,10 +746,10 @@ length of @var{sequence}. "Apply FUNCTION to successive cars of all ARGS. Return the list of results." ;; @r{If no list is exhausted,} - (if (not (memq 'nil args)) + (if (not (memq 'nil args)) ;; @r{apply function to @sc{car}s.} - (cons (apply function (mapcar 'car args)) - (apply 'mapcar* function + (cons (apply function (mapcar 'car args)) + (apply 'mapcar* function ;; @r{Recurse for rest of elements.} (mapcar 'cdr args))))) @end group @@ -779,7 +779,7 @@ The argument @var{function} must be a function that can take one argument and return a string. The argument @var{sequence} can be any kind of sequence except a char-table; that is, a list, a vector, a bool-vector, or a string. - + @smallexample @group (mapconcat 'symbol-name @@ -841,7 +841,7 @@ your program. For example, you might want to pass one as an argument to the function @code{mapcar}, which applies any given function to each element of a list. - Here we define a function @code{change-property} which + Here we define a function @code{change-property} which uses a function as its third argument: @example @@ -915,7 +915,7 @@ comment: @cindex @samp{#'} syntax The read syntax @code{#'} is a short-hand for using @code{function}. -For example, +For example, @example #'(lambda (x) (* x x)) diff --git a/lispref/gpl.texi b/lispref/gpl.texi index d348744468f..de21adbdd18 100644 --- a/lispref/gpl.texi +++ b/lispref/gpl.texi @@ -366,7 +366,7 @@ when it starts in an interactive mode: Gnomovision version 69, Copyright (C) @var{year} @var{name of author} Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome -to redistribute it under certain conditions; type `show c' +to redistribute it under certain conditions; type `show c' for details. @end smallexample @@ -384,7 +384,7 @@ necessary. Here is a sample; alter the names: @group Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' -(which makes passes at compilers) written +(which makes passes at compilers) written by James Hacker. @var{signature of Ty Coon}, 1 April 1989 diff --git a/lispref/hash.texi b/lispref/hash.texi index 4b12160c603..ca7d3ad8603 100644 --- a/lispref/hash.texi +++ b/lispref/hash.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1999 Free Software Foundation, Inc. +@c Copyright (C) 1999 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/hash @node Hash Tables, Symbols, Sequences Arrays Vectors, Top @@ -176,7 +176,7 @@ association in @var{table}. @end defun @tindex puthash -@defun puthash key value table +@defun puthash key value table This function enters an association for @var{key} in @var{table}, with value @var{value}. If @var{key} already has an association in @var{table}, @var{value} replaces the old associated value. @@ -270,7 +270,7 @@ compared case-insensitively. (defun case-fold-string-hash (a) (sxhash (upcase a))) -(define-hash-table-test 'case-fold 'case-fold-string= +(define-hash-table-test 'case-fold 'case-fold-string= 'case-fold-string-hash)) (make-hash-table :test 'case-fold) diff --git a/lispref/help.texi b/lispref/help.texi index eb9dc0a75d7..3f4f83b41c0 100644 --- a/lispref/help.texi +++ b/lispref/help.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/help @node Documentation, Files, Modes, Top @@ -164,7 +164,7 @@ All symbols that have PATTERN in their name are described in the `*Help*' buffer." (interactive "sDescribe symbols matching: ") (let ((describe-func - (function + (function (lambda (s) @end group @group @@ -172,30 +172,30 @@ in the `*Help*' buffer." (if (fboundp s) ; @r{It is a function.} (princ (format "%s\t%s\n%s\n\n" s - (if (commandp s) + (if (commandp s) (let ((keys (where-is-internal s))) (if keys (concat "Keys: " - (mapconcat 'key-description + (mapconcat 'key-description keys " ")) "Keys: none")) "Function") @end group @group - (or (documentation s) + (or (documentation s) "not documented")))) - + (if (boundp s) ; @r{It is a variable.} @end group @group (princ (format "%s\t%s\n%s\n\n" s - (if (user-variable-p s) + (if (user-variable-p s) "Option " "Variable") @end group @group - (or (documentation-property + (or (documentation-property s 'variable-documentation) "not documented"))))))) sym-list) @@ -203,7 +203,7 @@ in the `*Help*' buffer." @group ;; @r{Build a list of symbols that match pattern.} - (mapatoms (function + (mapatoms (function (lambda (sym) (if (string-match pattern (symbol-name sym)) (setq sym-list (cons sym sym-list)))))) @@ -225,7 +225,7 @@ but provides more information. (describe-symbols "goal") ---------- Buffer: *Help* ---------- -goal-column Option +goal-column Option *Semipermanent goal column for vertical motion, as set by @dots{} @end group @c Do not blithely break or fill these lines. @@ -306,11 +306,11 @@ can also call that function yourself. stands for a key sequence that will invoke @var{command}, or @samp{M-x @var{command}} if @var{command} has no key bindings. -@item \@{@var{mapvar}@} +@item \@{@var{mapvar}@} stands for a summary of the keymap which is the value of the variable @var{mapvar}. The summary is made using @code{describe-bindings}. -@item \<@var{mapvar}> +@item \<@var{mapvar}> stands for no text itself. It is used only for a side effect: it specifies @var{mapvar}'s value as the keymap for any following @samp{\[@var{command}]} sequences in this documentation string. @@ -335,13 +335,13 @@ user's own customized key bindings. @smallexample @group -(substitute-command-keys +(substitute-command-keys "To abort recursive edit, type: \\[abort-recursive-edit]") @result{} "To abort recursive edit, type: C-]" @end group @group -(substitute-command-keys +(substitute-command-keys "The keys that are defined for the minibuffer here are: \\@{minibuffer-local-must-match-map@}") @result{} "The keys that are defined for the minibuffer here are: @@ -605,7 +605,7 @@ Emacs versions, @code{exec-directory} was used for this. @c Emacs 19 feature @defmac make-help-screen fname help-line help-text help-map -This macro defines a help command named @var{fname} that acts like a +This macro defines a help command named @var{fname} that acts like a prefix key that shows a list of the subcommands it offers. When invoked, @var{fname} displays @var{help-text} in a window, then diff --git a/lispref/hooks.texi b/lispref/hooks.texi index ecdec6885da..4c4e6d14c01 100644 --- a/lispref/hooks.texi +++ b/lispref/hooks.texi @@ -1,13 +1,13 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1998 Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1998 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/hooks @node Standard Hooks, Index, Standard Keymaps, Top @appendix Standard Hooks The following is a list of hook variables that let you provide -functions to be called from within Emacs on suitable occasions. +functions to be called from within Emacs on suitable occasions. Most of these variables have names ending with @samp{-hook}. They are @dfn{normal hooks}, run by means of @code{run-hooks}. The value of such diff --git a/lispref/index.perm b/lispref/index.perm index aeccc6b4a7f..0b391e85379 100644 --- a/lispref/index.perm +++ b/lispref/index.perm @@ -23,7 +23,7 @@ All variables, functions, keys, programs, files, and concepts are -in this one index. +in this one index. All names and concepts are permuted, so they appear several times, one for each permutation of the parts of the name. For example, diff --git a/lispref/intro.texi b/lispref/intro.texi index 4a00377db4f..35e8151922d 100644 --- a/lispref/intro.texi +++ b/lispref/intro.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 2002 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/intro @@ -337,7 +337,7 @@ The description follows on succeeding lines, sometimes with examples. function, @code{foo}. * A Sample Variable Description:: A description of an imaginary variable, - @code{electric-future-map}. + @code{electric-future-map}. @end menu @node A Sample Function Description diff --git a/lispref/keymaps.texi b/lispref/keymaps.texi index be231798c43..e5adfb07b46 100644 --- a/lispref/keymaps.texi +++ b/lispref/keymaps.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1998, 1999, 2000 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/keymaps @node Keymaps, Modes, Command Loop, Top @@ -175,28 +175,28 @@ C-l}, @kbd{M-C-q}, and @kbd{M-C-x}. @example @group lisp-mode-map -@result{} +@result{} @end group @group -(keymap +(keymap ;; @key{TAB} - (9 . lisp-indent-line) + (9 . lisp-indent-line) @end group @group ;; @key{DEL} - (127 . backward-delete-char-untabify) + (127 . backward-delete-char-untabify) @end group @group - (3 keymap + (3 keymap ;; @kbd{C-c C-l} - (12 . run-lisp)) + (12 . run-lisp)) @end group @group - (27 keymap + (27 keymap ;; @r{@kbd{M-C-q}, treated as @kbd{@key{ESC} C-q}} - (17 . indent-sexp) + (17 . indent-sexp) ;; @r{@kbd{M-C-x}, treated as @kbd{@key{ESC} C-x}} - (24 . lisp-send-defun))) + (24 . lisp-send-defun))) @end group @end example @@ -280,7 +280,7 @@ definition is a keymap; the same symbol appears in the new copy. @end group @group ;; @r{(This implements meta characters.)} - (27 keymap + (27 keymap (83 . center-paragraph) (115 . center-line)) (9 . tab-to-tab-stop)) @@ -529,7 +529,7 @@ certain parts of the buffer; see @ref{Special Properties}. when the minor mode is enabled. The variable @code{overriding-local-map}, if non-@code{nil}, specifies -another local keymap that overrides the buffer's local map and all the +another local keymap that overrides the buffer's local map and all the minor mode keymaps. All the active keymaps are used together to determine what command to @@ -584,7 +584,7 @@ other. @example @group (current-global-map) -@result{} (keymap [set-mark-command beginning-of-line @dots{} +@result{} (keymap [set-mark-command beginning-of-line @dots{} delete-backward-char]) @end group @end example @@ -600,14 +600,14 @@ keymap. @example @group (current-local-map) -@result{} (keymap - (10 . eval-print-last-sexp) - (9 . lisp-indent-line) - (127 . backward-delete-char-untabify) +@result{} (keymap + (10 . eval-print-last-sexp) + (9 . lisp-indent-line) + (127 . backward-delete-char-untabify) @end group @group - (27 keymap - (24 . eval-defun) + (27 keymap + (24 . eval-defun) (17 . indent-sexp))) @end group @end example @@ -1004,7 +1004,7 @@ meta-prefix-char ; @r{The default value.} @end group @group (setq meta-prefix-char 24) - @result{} 24 + @result{} 24 @end group @group (key-binding "\M-b") @@ -1111,7 +1111,7 @@ map @end group @group map -@result{} (keymap +@result{} (keymap (24 keymap ; @kbd{C-x} (102 . forward-word)) ; @kbd{f} (6 . forward-char)) ; @kbd{C-f} @@ -1121,7 +1121,7 @@ map ;; @r{Bind @kbd{C-p} to the @code{ctl-x-map}.} (define-key map "\C-p" ctl-x-map) ;; @code{ctl-x-map} -@result{} [nil @dots{} find-file @dots{} backward-kill-sentence] +@result{} [nil @dots{} find-file @dots{} backward-kill-sentence] @end group @group @@ -1133,7 +1133,7 @@ map map @result{} (keymap ; @r{Note @code{foo} in @code{ctl-x-map}.} (16 keymap [nil @dots{} foo @dots{} backward-kill-sentence]) - (24 keymap + (24 keymap (102 . forward-word)) (6 . forward-char)) @end group @@ -1157,7 +1157,7 @@ standard bindings: @smallexample @group -(substitute-key-definition +(substitute-key-definition 'find-file 'find-file-read-only (current-global-map)) @end group @end smallexample @@ -1190,9 +1190,9 @@ Here is an example showing a keymap before and after substitution: @smallexample @group -(setq map '(keymap - (?1 . olddef-1) - (?2 . olddef-2) +(setq map '(keymap + (?1 . olddef-1) + (?2 . olddef-2) (?3 . olddef-1))) @result{} (keymap (49 . olddef-1) (50 . olddef-2) (51 . olddef-1)) @end group @@ -1220,8 +1220,8 @@ digits to run @code{digit-argument}, and @kbd{-} to run @code{negative-argument}. Otherwise it makes them undefined like the rest of the printing characters. -@cindex yank suppression -@cindex @code{quoted-insert} suppression +@cindex yank suppression +@cindex @code{quoted-insert} suppression The @code{suppress-keymap} function does not make it impossible to modify a buffer, as it does not suppress commands such as @code{yank} and @code{quoted-insert}. To prevent any modification of a buffer, make @@ -1423,7 +1423,7 @@ definition is the sparse keymap @code{(keymap (83 .@: center-paragraph) @smallexample @group (accessible-keymaps (current-local-map)) -@result{}(("" keymap +@result{}(("" keymap (27 keymap ; @r{Note this keymap for @key{ESC} is repeated below.} (83 . center-paragraph) (115 . center-line)) @@ -1431,8 +1431,8 @@ definition is the sparse keymap @code{(keymap (83 .@: center-paragraph) @end group @group - ("^[" keymap - (83 . center-paragraph) + ("^[" keymap + (83 . center-paragraph) (115 . foo))) @end group @end smallexample @@ -1447,7 +1447,7 @@ of a window. @smallexample @group (accessible-keymaps (current-global-map)) -@result{} (("" keymap [set-mark-command beginning-of-line @dots{} +@result{} (("" keymap [set-mark-command beginning-of-line @dots{} delete-backward-char]) @end group @group @@ -2240,7 +2240,7 @@ property list elements to add to the menu item specification. To define items in some local map, bind @code{`tool-bar-map} with @code{let} around calls of this function: @example -(defvar foo-tool-bar-map +(defvar foo-tool-bar-map (let ((tool-bar-map (make-sparse-keymap))) (tool-bar-add-item @dots{}) @dots{} diff --git a/lispref/lists.texi b/lispref/lists.texi index 1894fc3e15c..3235daa1d54 100644 --- a/lispref/lists.texi +++ b/lispref/lists.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/lists @node Lists, Sequences Arrays Vectors, Strings and Characters, Top @@ -498,7 +498,7 @@ This macro provides an alternative way to write It is new in Emacs 21. @example -(setq l '(a b)) +(setq l '(a b)) @result{} (a b) (push 'c l) @result{} (c a b) @@ -738,7 +738,7 @@ destructively. See @ref{Sets And Lists}. @cindex destructive list operations You can modify the @sc{car} and @sc{cdr} contents of a cons cell with the -primitives @code{setcar} and @code{setcdr}. We call these ``destructive'' +primitives @code{setcar} and @code{setcdr}. We call these ``destructive'' operations because they change existing list structure. @cindex CL note---@code{rplaca} vrs @code{setcar} diff --git a/lispref/loading.texi b/lispref/loading.texi index 0292088447c..1880f287df6 100644 --- a/lispref/loading.texi +++ b/lispref/loading.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/loading @node Loading, Byte Compilation, Customization, Top @@ -391,7 +391,7 @@ object, then it is defined as an autoload object like this: (autoload @var{filename} @var{docstring} @var{interactive} @var{type}) @end example -For example, +For example, @example @group @@ -580,7 +580,7 @@ file should call @code{provide} at the top level to add the feature to @code{features}; if it fails to do so, @code{require} signals an error. @cindex load error with require - For example, in @file{emacs/lisp/prolog.el}, + For example, in @file{emacs/lisp/prolog.el}, the definition for @code{run-prolog} includes the following code: @smallexample diff --git a/lispref/locals.texi b/lispref/locals.texi index d9565ae3e4b..6d998dabdf6 100644 --- a/lispref/locals.texi +++ b/lispref/locals.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1999 Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1999 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/locals @node Standard Buffer-Local Variables, Standard Keymaps, Standard Errors, Top diff --git a/lispref/macros.texi b/lispref/macros.texi index a62b1838bf5..3c91e5bb317 100644 --- a/lispref/macros.texi +++ b/lispref/macros.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998 Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/macros @node Macros, Customization, Functions, Top @@ -446,7 +446,7 @@ macro. Here is a correct expansion for the @code{for} macro: @end group @end smallexample -Here is a macro definition that creates this expansion: +Here is a macro definition that creates this expansion: @smallexample @group diff --git a/lispref/maps.texi b/lispref/maps.texi index 06ac5c47fc1..8a529e81d2f 100644 --- a/lispref/maps.texi +++ b/lispref/maps.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1999 Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1999 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/maps @node Standard Keymaps, Standard Hooks, Standard Buffer-Local Variables, Top diff --git a/lispref/markers.texi b/lispref/markers.texi index 508955e39df..dec9396a787 100644 --- a/lispref/markers.texi +++ b/lispref/markers.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/markers @node Markers, Text, Positions, Top @@ -595,7 +595,7 @@ marks of the current buffer, most recent first. @example @group mark-ring -@result{} (#<marker at 11050 in markers.texi> +@result{} (#<marker at 11050 in markers.texi> #<marker at 10832 in markers.texi> @dots{}) @end group diff --git a/lispref/minibuf.texi b/lispref/minibuf.texi index d5e57d79327..58ffd6d1a93 100644 --- a/lispref/minibuf.texi +++ b/lispref/minibuf.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2001 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/minibuf @node Minibuffers, Command Loop, Read and Print, Top @@ -374,7 +374,7 @@ text which is a valid form already: @group (edit-and-eval-command "Please edit: " '(forward-word 1)) -;; @r{After evaluation of the preceding expression,} +;; @r{After evaluation of the preceding expression,} ;; @r{the following appears in the minibuffer:} @end group @@ -582,7 +582,7 @@ is @code{t}. @smallexample @group -(try-completion +(try-completion "foo" '(("foobar1" 1) ("barfoo" 2) ("foobaz" 3) ("foobar2" 4))) @result{} "fooba" @@ -612,14 +612,14 @@ too short). Both of those begin with the string @samp{foobar}. @smallexample @group -(defun test (s) +(defun test (s) (> (length (car s)) 6)) @result{} test @end group @group -(try-completion +(try-completion "foo" - '(("foobar1" 1) ("barfoo" 2) ("foobaz" 3) ("foobar2" 4)) + '(("foobar1" 1) ("barfoo" 2) ("foobaz" 3) ("foobar2" 4)) 'test) @result{} "foobar" @end group @@ -642,13 +642,13 @@ example for @code{try-completion}: @smallexample @group -(defun test (s) +(defun test (s) (> (length (car s)) 6)) @result{} test @end group @group -(all-completions +(all-completions "foo" '(("foobar1" 1) ("barfoo" 2) ("foobaz" 3) ("foobar2" 4)) 'test) @@ -658,7 +658,7 @@ example for @code{try-completion}: @end defun @defvar completion-ignore-case -If the value of this variable is +If the value of this variable is non-@code{nil}, Emacs does not consider case significant in completion. @end defvar @@ -738,7 +738,7 @@ Here's an example of using @code{completing-read}: @end group @group -;; @r{After evaluation of the preceding expression,} +;; @r{After evaluation of the preceding expression,} ;; @r{the following appears in the minibuffer:} ---------- Buffer: Minibuffer ---------- @@ -923,7 +923,7 @@ only buffer name starting with the given input is @example (read-buffer "Buffer name? " "foo" t) @group -;; @r{After evaluation of the preceding expression,} +;; @r{After evaluation of the preceding expression,} ;; @r{the following prompt appears,} ;; @r{with an empty minibuffer:} @end group @@ -965,13 +965,13 @@ enters null input, the return value is @code{nil}. (read-command "Command name? ") @group -;; @r{After evaluation of the preceding expression,} +;; @r{After evaluation of the preceding expression,} ;; @r{the following prompt appears with an empty minibuffer:} @end group @group ----------- Buffer: Minibuffer ---------- -Command name? +---------- Buffer: Minibuffer ---------- +Command name? ---------- Buffer: Minibuffer ---------- @end group @end example @@ -990,7 +990,7 @@ complete in the set of extant Lisp symbols, and it uses the @group (read-command @var{prompt}) @equiv{} -(intern (completing-read @var{prompt} obarray +(intern (completing-read @var{prompt} obarray 'commandp t nil)) @end group @end example @@ -1010,8 +1010,8 @@ user enters null input, the return value is @code{nil}. @group (read-variable "Variable name? ") -;; @r{After evaluation of the preceding expression,} -;; @r{the following prompt appears,} +;; @r{After evaluation of the preceding expression,} +;; @r{the following prompt appears,} ;; @r{with an empty minibuffer:} @end group @@ -1080,13 +1080,13 @@ case, point goes at the beginning of @var{initial}. The default for @var{initial} does, try the command @kbd{C-x C-v}. @strong{Note:} we recommend using @var{default} rather than @var{initial} in most cases. -Here is an example: +Here is an example: @example @group (read-file-name "The file is ") -;; @r{After evaluation of the preceding expression,} +;; @r{After evaluation of the preceding expression,} ;; @r{the following appears in the minibuffer:} @end group @@ -1275,13 +1275,13 @@ invalid. At the next prompt the user types @kbd{y}. @group (y-or-n-p "Do you need a lift? ") -;; @r{After evaluation of the preceding expression,} +;; @r{After evaluation of the preceding expression,} ;; @r{the following prompt appears in the echo area:} @end group @group ---------- Echo area ---------- -Do you need a lift? (y or n) +Do you need a lift? (y or n) ---------- Echo area ---------- @end group @@ -1289,7 +1289,7 @@ Do you need a lift? (y or n) @group ---------- Echo area ---------- -Please answer y or n. Do you need a lift? (y or n) +Please answer y or n. Do you need a lift? (y or n) ---------- Echo area ---------- @end group @@ -1335,14 +1335,14 @@ Here is an example: @group (yes-or-no-p "Do you really want to remove everything? ") -;; @r{After evaluation of the preceding expression,} -;; @r{the following prompt appears,} +;; @r{After evaluation of the preceding expression,} +;; @r{the following prompt appears,} ;; @r{with an empty minibuffer:} @end group @group ---------- Buffer: minibuffer ---------- -Do you really want to remove everything? (yes or no) +Do you really want to remove everything? (yes or no) ---------- Buffer: minibuffer ---------- @end group @end smallexample diff --git a/lispref/modes.texi b/lispref/modes.texi index af38062706c..201e9ad3dc6 100644 --- a/lispref/modes.texi +++ b/lispref/modes.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/modes @node Modes, Documentation, Keymaps, Top @@ -99,7 +99,7 @@ Fundamental mode. Rmail mode is a complicated and specialized mode. * Example Major Modes:: Text mode and Lisp modes. * Auto Major Mode:: How Emacs chooses the major mode automatically. * Mode Help:: Finding out how to use a mode. -* Derived Modes:: Defining a new major mode based on another major +* Derived Modes:: Defining a new major mode based on another major mode. @end menu @@ -253,7 +253,7 @@ variable local to every buffer in which it is subsequently set, which would affect buffers that do not use this mode. It is undesirable for a mode to have such global effects. @xref{Buffer-Local Variables}. -With rare exceptions, the only reasonable way to use +With rare exceptions, the only reasonable way to use @code{make-variable-buffer-local} in a Lisp package is for a variable which is used only within that package. Using it on a variable used by other packages would interfere with them. @@ -324,7 +324,7 @@ the conventions listed above: @smallexample @group ;; @r{Create mode-specific tables.} -(defvar text-mode-syntax-table nil +(defvar text-mode-syntax-table nil "Syntax table used while in text mode.") @end group @@ -403,7 +403,7 @@ correspondingly more complicated. Here are excerpts from @smallexample @group ;; @r{Create mode-specific table variables.} -(defvar lisp-mode-syntax-table nil "") +(defvar lisp-mode-syntax-table nil "") (defvar emacs-lisp-mode-syntax-table nil "") (defvar lisp-mode-abbrev-table nil "") @end group @@ -419,7 +419,7 @@ correspondingly more complicated. Here are excerpts from ;; @r{Set syntax of chars up to 0 to class of chars that are} ;; @r{part of symbol names but not words.} ;; @r{(The number 0 is @code{48} in the @sc{ascii} character set.)} - (while (< i ?0) + (while (< i ?0) (modify-syntax-entry i "_ " emacs-lisp-mode-syntax-table) (setq i (1+ i))) @dots{} @@ -513,7 +513,7 @@ And here is the code to set up the keymap for Lisp mode: @end smallexample Finally, here is the complete major mode function definition for -Lisp mode. +Lisp mode. @smallexample @group @@ -601,7 +601,7 @@ the @samp{mode:} local variable near the end of a file; the How Major Modes are Chosen, emacs, The GNU Emacs Manual}. @end defun -@defopt default-major-mode +@defopt default-major-mode This variable holds the default major mode for new buffers. The standard value is @code{fundamental-mode}. @@ -649,7 +649,7 @@ For example, @end group @group ("\\.el\\'" . emacs-lisp-mode) - ("\\.c\\'" . c-mode) + ("\\.c\\'" . c-mode) ("\\.h\\'" . c-mode) @dots{}) @end group @@ -675,11 +675,11 @@ init file.) @smallexample @group (setq auto-mode-alist - (append + (append ;; @r{File name (within directory) starts with a dot.} - '(("/\\.[^/]*\\'" . fundamental-mode) + '(("/\\.[^/]*\\'" . fundamental-mode) ;; @r{File name has no dot.} - ("[^\\./]*\\'" . fundamental-mode) + ("[^\\./]*\\'" . fundamental-mode) ;; @r{File name ends in @samp{.C}.} ("\\.C\\'" . c++-mode)) auto-mode-alist)) @@ -742,7 +742,7 @@ This construct defines @var{variant} as a major mode command, using The new command @var{variant} is defined to call the function @var{parent}, then override certain aspects of that parent mode: -@itemize @bullet +@itemize @bullet @item The new mode has its own keymap, named @code{@var{variant}-map}. @code{define-derived-mode} initializes this map to inherit from @@ -751,25 +751,25 @@ The new mode has its own keymap, named @code{@var{variant}-map}. @item The new mode has its own syntax table, kept in the variable @code{@var{variant}-syntax-table}. -@code{define-derived-mode} initializes this variable by copying +@code{define-derived-mode} initializes this variable by copying @code{@var{parent}-syntax-table}, if it is not already set. @item The new mode has its own abbrev table, kept in the variable @code{@var{variant}-abbrev-table}. -@code{define-derived-mode} initializes this variable by copying +@code{define-derived-mode} initializes this variable by copying @code{@var{parent}-abbrev-table}, if it is not already set. @item The new mode has its own mode hook, @code{@var{variant}-hook}, which it runs in standard fashion as the very last thing that it does. -(The new mode also runs the mode hook of @var{parent} as part +(The new mode also runs the mode hook of @var{parent} as part of calling @var{parent}.) @end itemize In addition, you can specify how to override other aspects of @var{parent} with @var{body}. The command @var{variant} -evaluates the forms in @var{body} after setting up all its usual +evaluates the forms in @var{body} after setting up all its usual overrides, just before running @code{@var{variant}-hook}. The argument @var{docstring} specifies the documentation string for the @@ -1011,7 +1011,7 @@ specifying bindings in this form: @smallexample (define-minor-mode hungry-mode "Toggle Hungry mode. -With no argument, this command toggles the mode. +With no argument, this command toggles the mode. Non-null prefix argument turns on the mode. Null prefix argument turns off the mode. @@ -1025,7 +1025,7 @@ See the command \\[hungry-electric-delete]." ;; The minor mode bindings. '(("\C-\^?" . hungry-electric-delete) ("\C-\M-\^?" - . (lambda () + . (lambda () (interactive) (hungry-electric-delete t))))) @end smallexample @@ -1213,22 +1213,22 @@ directory. 'mode-line-mule-info 'mode-line-modified 'mode-line-frame-identification - "%b--" + "%b--" @end group @group ;; @r{Note that this is evaluated while making the list.} ;; @r{It makes a mode line construct which is just a string.} (getenv "HOST") @end group - ":" + ":" 'default-directory " " 'global-mode-string " %[(" '(:eval (mode-line-mode-name)) - 'mode-line-process - 'minor-mode-alist - "%n" + 'mode-line-process + 'minor-mode-alist + "%n" ")%]--" @group '(which-func-mode ("" which-func-format "--")) @@ -1325,9 +1325,9 @@ The default value of @code{minor-mode-alist} is: @group minor-mode-alist @result{} ((vc-mode vc-mode) - (abbrev-mode " Abbrev") - (overwrite-mode overwrite-mode) - (auto-fill-function " Fill") + (abbrev-mode " Abbrev") + (overwrite-mode overwrite-mode) + (auto-fill-function " Fill") (defining-kbd-macro " Def") (isearch-mode isearch-mode)) @end group @@ -1386,8 +1386,8 @@ The default value of @code{default-mode-line-format} is this list: ;; @r{properties to make it mouse-sensitive.} (:eval (mode-line-mode-name)) mode-line-process - minor-mode-alist - "%n" + minor-mode-alist + "%n" ")%]--" @end group @group @@ -2146,7 +2146,7 @@ Used (typically) for built-in function names. @item font-lock-function-name-face @vindex font-lock-function-name-face Used (typically) for the name of a function being defined or declared, -in a function definition or declaration. +in a function definition or declaration. @item font-lock-variable-name-face @vindex font-lock-variable-name-face diff --git a/lispref/nonascii.texi b/lispref/nonascii.texi index fbeedc191c8..de29dd9f3c9 100644 --- a/lispref/nonascii.texi +++ b/lispref/nonascii.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1998, 1999 Free Software Foundation, Inc. +@c Copyright (C) 1998, 1999 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/characters @node Non-ASCII Characters, Searching and Matching, Text, Top diff --git a/lispref/numbers.texi b/lispref/numbers.texi index 534550159c2..b8361d52820 100644 --- a/lispref/numbers.texi +++ b/lispref/numbers.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/numbers @node Numbers, Strings and Characters, Lisp Data Types, Top @@ -40,14 +40,14 @@ minimum range is @minus{}134217728 to 134217727 (28 bits; i.e., @ifnottex -2**27 @end ifnottex -@tex +@tex @math{-2^{27}} @end tex -to +to @ifnottex 2**27 - 1), @end ifnottex -@tex +@tex @math{2^{27}-1}), @end tex but some machines may provide a wider range. Many examples in this @@ -746,7 +746,7 @@ like this (with 8-bit binary numbers): (lsh 3 2) @result{} 12 ;; @r{Decimal 3 becomes decimal 12.} -00000011 @result{} 00001100 +00000011 @result{} 00001100 @end group @end example @@ -757,14 +757,14 @@ On the other hand, shifting one place to the right looks like this: (lsh 6 -1) @result{} 3 ;; @r{Decimal 6 becomes decimal 3.} -00000110 @result{} 00000011 +00000110 @result{} 00000011 @end group @group (lsh 5 -1) @result{} 2 ;; @r{Decimal 5 becomes decimal 2.} -00000101 @result{} 00000010 +00000101 @result{} 00000010 @end group @end example @@ -787,7 +787,7 @@ In binary, in the 28-bit implementation, the argument looks like this: @example @group ;; @r{Decimal 134,217,727} -0111 1111 1111 1111 1111 1111 1111 +0111 1111 1111 1111 1111 1111 1111 @end group @end example @@ -797,7 +797,7 @@ which becomes the following when left shifted: @example @group ;; @r{Decimal @minus{}2} -1111 1111 1111 1111 1111 1111 1110 +1111 1111 1111 1111 1111 1111 1110 @end group @end example @end defun @@ -818,10 +818,10 @@ looks like this: @example @group -(ash -6 -1) @result{} -3 +(ash -6 -1) @result{} -3 ;; @r{Decimal @minus{}6 becomes decimal @minus{}3.} 1111 1111 1111 1111 1111 1111 1010 - @result{} + @result{} 1111 1111 1111 1111 1111 1111 1101 @end group @end example @@ -834,7 +834,7 @@ In contrast, shifting the pattern of bits one place to the right with (lsh -6 -1) @result{} 134217725 ;; @r{Decimal @minus{}6 becomes decimal 134,217,725.} 1111 1111 1111 1111 1111 1111 1010 - @result{} + @result{} 0111 1111 1111 1111 1111 1111 1101 @end group @end example @@ -992,7 +992,7 @@ bit is one in the result if, and only if, the @var{n}th bit is zero in @var{integer}, and vice-versa. @example -(lognot 5) +(lognot 5) @result{} -6 ;; 5 = @r{0000 0000 0000 0000 0000 0000 0101} ;; @r{becomes} diff --git a/lispref/objects.texi b/lispref/objects.texi index 02c11e7b990..66c4f74ae2e 100644 --- a/lispref/objects.texi +++ b/lispref/objects.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/objects @node Lisp Data Types, Numbers, Introduction, Top @@ -248,7 +248,7 @@ with a question mark. The usual read syntax for alphanumeric characters is a question mark followed by the character; thus, @samp{?A} for the character @kbd{A}, @samp{?B} for the character @kbd{B}, and @samp{?a} for the -character @kbd{a}. +character @kbd{a}. For example: @@ -397,7 +397,7 @@ bit to indicate that the shift key was used in typing a control character. This distinction is possible only when you use X terminals or other special terminals; ordinary terminals do not report the distinction to the computer in any way. The Lisp syntax for -the shift bit is @samp{\S-}; thus, @samp{?\C-\S-o} or @samp{?\C-\S-O} +the shift bit is @samp{\S-}; thus, @samp{?\C-\S-o} or @samp{?\C-\S-O} represents the shifted-control-o character. @cindex hyper characters @@ -899,8 +899,8 @@ ignores an escaped newline while reading a string. An escaped space in documentation strings, but the newline is \ ignored if escaped." - @result{} "It is useful to include newlines -in documentation strings, + @result{} "It is useful to include newlines +in documentation strings, but the newline is ignored if escaped." @end example @@ -932,7 +932,7 @@ character to the string, but it does terminate the preceding hex escape. represent a unibyte non-@sc{ascii} character with its character code, which must be in the range from 128 (0200 octal) to 255 (0377 octal). This forces a unibyte string. - + @xref{Text Representations}, for more information about the two text representations. @@ -1071,7 +1071,7 @@ that it begins with @samp{#&} followed by the length. The string constant that follows actually specifies the contents of the bool-vector as a bitmap---each ``character'' in the string contains 8 bits, which specify the next 8 elements of the bool-vector (1 stands for @code{t}, -and 0 for @code{nil}). The least significant bits of the character +and 0 for @code{nil}). The least significant bits of the character correspond to the lowest indices in the bool-vector. If the length is not a multiple of 8, the printed representation shows extra elements, but these extras really make no difference. diff --git a/lispref/permute-index b/lispref/permute-index index b2dfb771f14..bbe2be75cba 100644 --- a/lispref/permute-index +++ b/lispref/permute-index @@ -36,7 +36,7 @@ set MANUAL=elisp # the base name of the manual echo "Extract raw index from texinfo fn index." # Let texindex combine duplicate entries, later. # But it wants to protect non-alphanumerics thus confusing ptx. -# Also change `\ ' to just a ` ', since texindex will fail. This is produced +# Also change `\ ' to just a ` ', since texindex will fail. This is produced # by `@findex two words' in an example environment (no doubt among others). # delete wrapper parens # change dots {} to dots{} @@ -114,7 +114,7 @@ echo "Sort with texindex." ${TEXINDEX} permuted.fn #mv permuted.fns ${MANUAL}.fns -# The resulting permuted.fns will be read when we run TeX +# The resulting permuted.fns will be read when we run TeX # on the manual the second time. Or you can use permuted.texinfo here. #${TEX} permuted.texinfo diff --git a/lispref/positions.texi b/lispref/positions.texi index 6b9d10e519d..ac5efda9bc9 100644 --- a/lispref/positions.texi +++ b/lispref/positions.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000, 2001 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/positions @node Positions, Markers, Frames, Top @@ -631,7 +631,7 @@ beginning of the first screen line. @xref{Minibuffer Misc}. @node List Motion @comment node-name, next, previous, up -@subsection Moving over Balanced Expressions +@subsection Moving over Balanced Expressions @cindex sexp motion @cindex Lisp expression motion @cindex list motion diff --git a/lispref/processes.texi b/lispref/processes.texi index 1ccc449f4e3..5bcd50a582e 100644 --- a/lispref/processes.texi +++ b/lispref/processes.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/processes @node Processes, Display, Abbrevs, Top @@ -108,7 +108,7 @@ must use @var{args} to provide those. specify overrides for it with @code{process-environment}. @xref{System Environment}. -@defvar exec-directory +@defvar exec-directory @pindex movemail The value of this variable is a string, the name of a directory that contains programs that come with GNU Emacs, programs intended for Emacs @@ -355,8 +355,8 @@ inputinput@point{} @smallexample @group -(call-process-region - start end +(call-process-region + start end shell-file-name ; @r{Name of program.} nil ; @r{Do not delete region.} buffer ; @r{Send output to @code{buffer}.} @@ -866,7 +866,7 @@ which is called the associated buffer of the process, or a function called the @dfn{filter function} can be called to act on the output. If the process has no buffer and no filter function, its output is discarded. - + When a subprocess terminates, Emacs reads any pending output, then stops reading output from that subprocess. Therefore, if the subprocess has children that are still live and still producing @@ -1205,7 +1205,7 @@ describing the type of event. The string describing the event looks like one of the following: @itemize @bullet -@item +@item @code{"finished\n"}. @item @@ -1301,7 +1301,7 @@ was not. @end defun @node Query Before Exit -@section Querying Before Exit +@section Querying Before Exit When Emacs exits, it terminates all its subprocesses by sending them the @code{SIGHUP} signal. Because some subprocesses are doing diff --git a/lispref/searching.texi b/lispref/searching.texi index 7f586f8777a..a172332e3a3 100644 --- a/lispref/searching.texi +++ b/lispref/searching.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/searching @node Searching and Matching, Syntax Tables, Non-ASCII Characters, Top @@ -325,7 +325,7 @@ multibyte character @var{c2}, the range is divided into two parts: one is @samp{@var{c}..?\377}, the other is @samp{@var{c1}..@var{c2}}, where @var{c1} is the first character of the charset to which @var{c2} belongs. - + You cannot always match all non-@sc{ascii} characters with the regular expression @code{"[\200-\377]"}. This works when searching a unibyte buffer or string (@pxref{Text Representations}), but not in a multibyte @@ -670,7 +670,7 @@ an @code{invalid-regexp} error is signaled. Here is a complicated regexp, used by Emacs to recognize the end of a sentence together with any whitespace that follows. It is the value of -the variable @code{sentence-end}. +the variable @code{sentence-end}. First, we show the regexp as a string in Lisp syntax to distinguish spaces from tab characters. The string constant begins and ends with a @@ -689,7 +689,7 @@ will see the following: @example @group sentence-end - @result{} "[.?!][]\"')@}]*\\($\\| $\\| \\| \\)[ + @result{} "[.?!][]\"')@}]*\\($\\| $\\| \\| \\)[ ]*" @end group @end example @@ -1325,7 +1325,7 @@ positions within the text: @group (string-match "\\(qu\\)\\(ick\\)" "The quick fox jumped quickly.") - ;0123456789 + ;0123456789 @result{} 4 @end group diff --git a/lispref/sequences.texi b/lispref/sequences.texi index 813d606c30b..8e7ab4176e2 100644 --- a/lispref/sequences.texi +++ b/lispref/sequences.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/sequences @node Sequences Arrays Vectors, Hash Tables, Lists, Top @@ -222,7 +222,7 @@ in the list. Emacs defines four types of array, all one-dimensional: @dfn{strings}, @dfn{vectors}, @dfn{bool-vectors} and @dfn{char-tables}. A vector is a general array; its elements can be any Lisp objects. A string is a -specialized array; its elements must be characters. Each type of array +specialized array; its elements must be characters. Each type of array has its own read syntax. @xref{String Type}, and @ref{Vector Type}. diff --git a/lispref/streams.texi b/lispref/streams.texi index 74f9e43e92c..bddc65a6423 100644 --- a/lispref/streams.texi +++ b/lispref/streams.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/streams @node Read and Print, Minibuffers, Debugging, Top @@ -489,7 +489,7 @@ in reverse order. @group last-output - @result{} (10 34 116 117 112 116 117 111 32 101 104 + @result{} (10 34 116 117 112 116 117 111 32 101 104 116 32 115 105 32 115 105 104 84 34 10) @end group @end example @@ -566,13 +566,13 @@ characters are used. @code{print} returns @var{object}. For example: (progn (print 'The\ cat\ in) (print "the hat") (print " came back")) - @print{} + @print{} @print{} The\ cat\ in - @print{} + @print{} @print{} "the hat" - @print{} + @print{} @print{} " came back" - @print{} + @print{} @result{} " came back" @end group @end example @@ -586,8 +586,8 @@ This function outputs the printed representation of @var{object} to @example @group -(progn (prin1 'The\ cat\ in) - (prin1 "the hat") +(progn (prin1 'The\ cat\ in) + (prin1 "the hat") (prin1 " came back")) @print{} The\ cat\ in"the hat"" came back" @result{} " came back" @@ -771,12 +771,12 @@ exceeding this limit is abbreviated with an ellipsis. A value of @code{nil} (which is the default) means no limit. @end defvar - These variables are used for detecting and reporting circular + These variables are used for detecting and reporting circular and shared structure---but they are only defined in Emacs 21. @tindex print-circle @defvar print-circle -If non-@code{nil}, this variable enables detection of circular +If non-@code{nil}, this variable enables detection of circular and shared structure in printing. @end defvar diff --git a/lispref/strings.texi b/lispref/strings.texi index f35f94b2bc4..0870e0b5369 100644 --- a/lispref/strings.texi +++ b/lispref/strings.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/strings @node Strings and Characters, Lists, Numbers, Top @@ -158,7 +158,7 @@ position up to which the substring is copied. The character whose index is 3 is actually the fourth character in the string. A negative number counts from the end of the string, so that @minus{}1 -signifies the index of the last character of the string. For example: +signifies the index of the last character of the string. For example: @example @group @@ -410,7 +410,7 @@ no characters is less than any other string. (string< "abc" "ab") @result{} nil (string< "" "") - @result{} nil + @result{} nil @end group @end example @end defun @@ -597,7 +597,7 @@ in how they use the result of formatting. @defun format string &rest objects This function returns a new string that is made by copying -@var{string} and then replacing any format specification +@var{string} and then replacing any format specification in the copy with encodings of the corresponding @var{objects}. The arguments @var{objects} are the computed values to be formatted. @@ -707,9 +707,9 @@ operation} error. (format "The buffer object prints as %s." (current-buffer)) @result{} "The buffer object prints as strings.texi." -(format "The octal value of %d is %o, +(format "The octal value of %d is %o, and the hex value is %x." 18 18 18) - @result{} "The octal value of 18 is 22, + @result{} "The octal value of 18 is 22, and the hex value is 12." @end group @end example @@ -745,32 +745,32 @@ only 3 letters, so 4 blank spaces are inserted for padding. In the second case, the string @code{"specification"} is 13 letters wide but is not truncated. In the third case, the padding is on the right. -@smallexample +@smallexample @group (format "The word `%7s' actually has %d letters in it." "foo" (length "foo")) - @result{} "The word ` foo' actually has 3 letters in it." + @result{} "The word ` foo' actually has 3 letters in it." @end group @group (format "The word `%7s' actually has %d letters in it." - "specification" (length "specification")) - @result{} "The word `specification' actually has 13 letters in it." + "specification" (length "specification")) + @result{} "The word `specification' actually has 13 letters in it." @end group @group (format "The word `%-7s' actually has %d letters in it." "foo" (length "foo")) - @result{} "The word `foo ' actually has 3 letters in it." + @result{} "The word `foo ' actually has 3 letters in it." @end group @end smallexample @node Case Conversion -@comment node-name, next, previous, up +@comment node-name, next, previous, up @section Case Conversion in Lisp -@cindex upper case -@cindex lower case -@cindex character case +@cindex upper case +@cindex lower case +@cindex character case @cindex case conversion in Lisp The character case functions change the case of single characters or diff --git a/lispref/symbols.texi b/lispref/symbols.texi index e9459de708c..ae4dffec89c 100644 --- a/lispref/symbols.texi +++ b/lispref/symbols.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/symbols @node Symbols, Evaluation, Hash Tables, Top diff --git a/lispref/syntax.texi b/lispref/syntax.texi index 0d7c1cd0364..07aca71e94e 100644 --- a/lispref/syntax.texi +++ b/lispref/syntax.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/syntax @node Syntax Tables, Abbrevs, Searching and Matching, Top @@ -664,36 +664,36 @@ The result is a list of nine elements describing the final state of the parse: @enumerate 0 -@item +@item The depth in parentheses, counting from 0. -@item +@item @cindex innermost containing parentheses The character position of the start of the innermost parenthetical grouping containing the stopping point; @code{nil} if none. -@item +@item @cindex previous complete subexpression The character position of the start of the last complete subexpression terminated; @code{nil} if none. -@item +@item @cindex inside string Non-@code{nil} if inside a string. More precisely, this is the character that will terminate the string, or @code{t} if a generic string delimiter character should terminate it. -@item +@item @cindex inside comment @code{t} if inside a comment (of either style), or the comment nesting level if inside a kind of comment that can be nested. -@item +@item @cindex quote character @code{t} if point is just after a quote character. -@item +@item The minimum parenthesis depth encountered during this scan. @item diff --git a/lispref/text.texi b/lispref/text.texi index 2544e4d2ce9..cd4140dd220 100644 --- a/lispref/text.texi +++ b/lispref/text.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000, 2001 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/text @node Text, Non-ASCII Characters, Markers, Top @@ -429,7 +429,7 @@ Do not try substituting your own definition of loop handles this function specially. @end deffn -@deffn Command newline &optional number-of-newlines +@deffn Command newline &optional number-of-newlines This command inserts newlines into the current buffer before point. If @var{number-of-newlines} is supplied, that many newline characters are inserted. @@ -614,7 +614,7 @@ You thought @end example @end deffn -@deffn Command delete-indentation &optional join-following-p +@deffn Command delete-indentation &optional join-following-p This function joins the line point is on to the previous line, deleting any whitespace at the join and in some cases replacing it with one space. If @var{join-following-p} is non-@code{nil}, @@ -945,7 +945,7 @@ selection from the newly killed text. @xref{Window System Selections}. The variable @code{kill-ring} holds the kill ring contents, in the form of a list of strings. The most recent kill is always at the front -of the list. +of the list. The @code{kill-ring-yank-pointer} variable points to a link in the kill ring list, whose @sc{car} is the text to yank next. We say it @@ -970,7 +970,7 @@ rotate the ring so that the newly killed text is at the front. Here is a diagram that shows the variable @code{kill-ring-yank-pointer} pointing to the second entry in the kill ring @code{("some text" "a -different piece of text" "yet older text")}. +different piece of text" "yet older text")}. @example @group @@ -980,11 +980,11 @@ kill-ring ---- kill-ring-yank-pointer | --- --- --- --- --- --- --> | | |------> | | |--> | | |--> nil --- --- --- --- --- --- - | | | - | | | - | | -->"yet older text" + | | | + | | | + | | -->"yet older text" | | - | --> "a different piece of text" + | --> "a different piece of text" | --> "some text" @end group @@ -1040,7 +1040,7 @@ to record where point was before the command. @item (@var{beg} . @var{end}) This kind of element indicates how to delete text that was inserted. -Upon insertion, the text occupied the range @var{beg}--@var{end} in the +Upon insertion, the text occupied the range @var{beg}--@var{end} in the buffer. @item (@var{text} . @var{position}) @@ -2123,7 +2123,7 @@ interactively. These commands, primarily for interactive use, act based on the indentation in the text. -@deffn Command back-to-indentation +@deffn Command back-to-indentation @comment !!SourceFile simple.el This command moves point to the first non-whitespace character in the current line (which is the line in which point is located). It returns @@ -2509,7 +2509,7 @@ properties are not identical to those of the character just after @var{pos}. If @var{limit} is non-@code{nil}, then the scan ends at position -@var{limit}. If there is no property change before that point, +@var{limit}. If there is no property change before that point, @code{next-property-change} returns @var{limit}. The value is @code{nil} if the properties remain unchanged all the way @@ -2540,7 +2540,7 @@ returns the position of the first character beyond @var{pos} whose @var{pos}. If @var{limit} is non-@code{nil}, then the scan ends at position -@var{limit}. If there is no property change before that point, +@var{limit}. If there is no property change before that point, @code{next-single-property-change} returns @var{limit}. The value is @code{nil} if the property remains unchanged all the way to @@ -3052,7 +3052,7 @@ uses may be possible. We invite users to write Lisp programs to store and retrieve text properties in files, using these hooks, and thus to experiment with -various data formats and find good ones. Eventually we hope users +various data formats and find good ones. Eventually we hope users will produce good, general extensions we can install in Emacs. We suggest not trying to handle arbitrary Lisp objects as text property diff --git a/lispref/tindex.pl b/lispref/tindex.pl index c138f5d66f1..459a2b72e84 100755 --- a/lispref/tindex.pl +++ b/lispref/tindex.pl @@ -52,7 +52,7 @@ my $help = 0; my $version = 0; my $old; -my $rc = GetOptions ('help' => \$help, 'version' => \$version, +my $rc = GetOptions ('help' => \$help, 'version' => \$version, 'old=s' => \$old); if ($version) { print "0.1\n"; @@ -86,14 +86,14 @@ foreach $file (@old_files) { close IN; } -# Process current files and remove those @tindex lines which we +# Process current files and remove those @tindex lines which we # know were already present in the files scanned above. print "Removing old \@tindex lines\n"; foreach $file (@new_files) { my $modified = 0; my $contents = ""; - + open (IN, "< $file") or fatal "Cannot open $file.orig for reading: $!"; while (<IN>) { if (/^\s*\@tindex\s+(\S+)/ && $tindex{$1}) { @@ -103,7 +103,7 @@ foreach $file (@new_files) { $contents = $contents . $_; } } - + close IN; if ($modified) { diff --git a/lispref/tips.texi b/lispref/tips.texi index 4eb0e3f7005..592a0015e75 100644 --- a/lispref/tips.texi +++ b/lispref/tips.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1995, 1998, 1999 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/tips @node Tips, GNU Emacs Internals, GPL, Top @@ -435,7 +435,7 @@ can be worth rearranging a data structure so that one of these primitive search functions can be used. @item -Certain built-in functions are handled specially in byte-compiled code, +Certain built-in functions are handled specially in byte-compiled code, avoiding the need for an ordinary function call. It is a good idea to use these functions rather than alternatives. To see whether a function is handled specially by the compiler, examine its @code{byte-compile} @@ -537,7 +537,7 @@ In Dired, visit the file or directory named on this line. @item Do not start or end a documentation string with whitespace. - + @item @strong{Do not} indent subsequent lines of a documentation string so that the text is lined up in the source code with the text of the first diff --git a/lispref/two-volume-cross-refs.txt b/lispref/two-volume-cross-refs.txt index b3fb7a665f4..f21028f1f32 100644 --- a/lispref/two-volume-cross-refs.txt +++ b/lispref/two-volume-cross-refs.txt @@ -28,7 +28,7 @@ and in Volume II: list motion .........117 All other references and the table of contents work the same way. I -find this *very* helpful. +find this *very* helpful. In brief: you run tex on a .texi file with @@ -126,16 +126,16 @@ Create volume specific .toc files with volume numbers in them. % cp elisp-toc-2vol.toc elisp1-toc.toc % cp elisp-toc-2vol.toc elisp2-toc.toc -Use keyboard macro to put I: in first half of elisp1-toc.toc and +Use keyboard macro to put I: in first half of elisp1-toc.toc and II: in first half of elisp2-toc.toc Copy the tocs to something you can remember more easily -% cp elisp2-toc.toc elisp1-toc-ready.toc -% cp elisp1-toc.toc elisp2-toc-ready.toc +% cp elisp2-toc.toc elisp1-toc-ready.toc +% cp elisp1-toc.toc elisp2-toc-ready.toc -Then, edit vol1.texi to input elisp1-toc-ready.toc -and vol2.texi to input elisp2-toc-ready.toc +Then, edit vol1.texi to input elisp1-toc-ready.toc +and vol2.texi to input elisp2-toc-ready.toc ### Now format the two volumes: @@ -217,7 +217,7 @@ Then insert marked file into other volume's .aux file." (defun volume-index-markup (arg) "Prepend `NUMBER:' to page number. Use Roman Numeral. -Apply only to unsorted index file, +Apply only to unsorted index file, Then insert marked file into other volume's unsorted index file. Then run texindex on that file and save." (interactive @@ -236,11 +236,11 @@ The steps: 1. Run TeX, texindex and TeX on file1. 2. Run TeX, texindex and TeX on file2. -3. Copy both .aux files into specially named files +3. Copy both .aux files into specially named files -4. In the case of the elisp ref manual, +4. In the case of the elisp ref manual, - copy the *unsorted* function index files into specially named files + copy the *unsorted* function index files into specially named files (no other index used in elisp ref manual) @@ -249,7 +249,7 @@ The steps: Run a function on the specially named .aux files to label each entry according to volume. Save these files. - i.e., convert + i.e., convert 'xrdef {Special-pg}{7} to 'xrdef {Special-pg}{7, vol.'tie1} 5a.Insert each specially named .aux file into the regular .aux file of diff --git a/lispref/two.el b/lispref/two.el index f8f00bde5b5..bad18d48485 100644 --- a/lispref/two.el +++ b/lispref/two.el @@ -14,7 +14,7 @@ Then insert marked file into other volume's .aux file." (defun volume-index-markup (arg) "Prepend `NUMBER:' to page number. Use Roman Numeral. -Apply only to unsorted index file, +Apply only to unsorted index file, Then insert marked file into other volume's unsorted index file. Then run texindex on that file and save." (interactive @@ -43,7 +43,7 @@ This is for the *Elisp Ref Manual*" (insert "\\unnumbchapentry {Volume 1}{}\n\\unnumbchapentry {}{}\n") (search-forward "\\unnumbchapentry {Index}") (forward-line 1) - (insert + (insert "\\unnumbchapentry {}{}\n\\unnumbchapentry {}{}\n\\unnumbchapentry {}{}\n\\unnumbchapentry {}{}\n\\unnumbchapentry {Volume 2}{}\n\\unnumbchapentry {}{}\n")) diff --git a/lispref/variables.texi b/lispref/variables.texi index 48003e0977a..9b83117f67b 100644 --- a/lispref/variables.texi +++ b/lispref/variables.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000 -@c Free Software Foundation, Inc. +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/variables @node Variables, Functions, Control Structures, Top @@ -207,7 +207,7 @@ Here is an example of this: @code{Z} is bound to the old value of @result{} 2 @end group @group -(let ((Y 1) +(let ((Y 1) (Z Y)) (list Y Z)) @result{} (1 2) @@ -767,7 +767,7 @@ The value of the @code{setq} form is the value of the last @var{form}. x ; @r{@code{x} now has a global value.} @result{} 3 @group -(let ((x 5)) +(let ((x 5)) (setq x 6) ; @r{The local binding of @code{x} is set.} x) @result{} 6 @@ -784,7 +784,7 @@ second @var{symbol} is set, and so on: @group (setq x 10 ; @r{Notice that @code{x} is set before} y (1+ x)) ; @r{the value of @code{y} is computed.} - @result{} 11 + @result{} 11 @end group @end example @end defspec @@ -1350,7 +1350,7 @@ then the variable appears directly in the resulting list. (mode-name . "Fundamental") @dots{} @group - ;; @r{Next, non-built-in buffer-local variables.} + ;; @r{Next, non-built-in buffer-local variables.} ;; @r{This one is buffer-local and void:} foobar ;; @r{This one is buffer-local and nonvoid:} diff --git a/lispref/vol1.texi b/lispref/vol1.texi index ddd4f776013..795d3974b2e 100644 --- a/lispref/vol1.texi +++ b/lispref/vol1.texi @@ -23,7 +23,7 @@ @c \overfullrule=0pt @c end tex -@c Start volume 1 chapter numbering on chapter 1; +@c Start volume 1 chapter numbering on chapter 1; @c this must be listed as chapno 0. @tex \global\chapno=0 @@ -87,18 +87,18 @@ @c ----- @c [163] [164] [165] [166]) (loading.texi Chapter 13 [167] [168] [169] @c Overfull \hbox (20.5428pt too wide) in paragraph at lines 131--131 -@c []@ninett +@c []@ninett @c setenv EMAC-SLOAD-PATH .:/user/bil/emacs:/usr/local/lib/emacs/lisp[] @c ----- @c (minibuf.texi Chapter 17 [206] [207] [208] [209] [210] [211] [212] [213] @c [214] [215] @c Overfull \hbox (2.09094pt too wide) in paragraph at lines 550--560 -@c @texttt map[] @textrm if @textsl require-match @textrm is -@c @texttt nil[]@textrm , or else with the keymap @texttt minibuffer- +@c @texttt map[] @textrm if @textsl require-match @textrm is +@c @texttt nil[]@textrm , or else with the keymap @texttt minibuffer- @c ----- @c (locals.texi Appendix @char 68 [533] [534] @c Underfull \hbox (badness 2512) in paragraph at lines 4--4 -@c []@chaprm Appendix DStandard Buffer-Local +@c []@chaprm Appendix DStandard Buffer-Local @c ------------------------------------------------------------------- @@ -186,11 +186,11 @@ instead of in the original English. @sp 2 @center @titlefont{Volume 1} @sp 3 -@center by Bil Lewis, Dan LaLiberte, +@center by Bil Lewis, Dan LaLiberte, @center and the GNU Manual Group @page @vskip 0pt plus 1filll -Copyright @copyright{} 1990, 1991, 1992, 1993, 1994, 1995 Free Software Foundation, Inc. +Copyright @copyright{} 1990, 1991, 1992, 1993, 1994, 1995 Free Software Foundation, Inc. @sp 2 Edition 2.4 @* @@ -325,8 +325,8 @@ Conventions Format of Descriptions -* A Sample Function Description:: -* A Sample Variable Description:: +* A Sample Function Description:: +* A Sample Variable Description:: Lisp Data Types @@ -435,7 +435,7 @@ Evaluation * Intro Eval:: Evaluation in the scheme of things. * Eval:: How to invoke the Lisp interpreter explicitly. * Forms:: How various sorts of objects are evaluated. -* Quoting:: Avoiding evaluation (to put constants in +* Quoting:: Avoiding evaluation (to put constants in the program). Kinds of Forms @@ -488,11 +488,11 @@ Variables Scoping Rules for Variable Bindings -* Scope:: Scope means where in the program a value +* Scope:: Scope means where in the program a value is visible. Comparison with other languages. * Extent:: Extent means how long in time a value exists. * Impl of Scope:: Two ways to implement dynamic scoping. -* Using Scoping:: How to use dynamic scoping carefully and +* Using Scoping:: How to use dynamic scoping carefully and avoid problems. Buffer-Local Variables @@ -510,11 +510,11 @@ Functions * Defining Functions:: Lisp expressions for defining functions. * Calling Functions:: How to use an existing function. * Mapping Functions:: Applying a function to each element of a list, etc. -* Anonymous Functions:: Lambda-expressions are functions with no names. +* Anonymous Functions:: Lambda-expressions are functions with no names. * Function Cells:: Accessing or setting the function definition of a symbol. * Related Topics:: Cross-references to specific Lisp primitives - that have a special bearing on how + that have a special bearing on how functions work. Lambda Expressions @@ -550,10 +550,10 @@ Debugging Lisp Programs * Debugger:: How the Emacs Lisp debugger is implemented. * Syntax Errors:: How to find syntax errors. -* Compilation Errors:: How to find errors that show up in +* Compilation Errors:: How to find errors that show up in byte compilation. * Edebug:: A source-level Emacs Lisp debugger. - + The Lisp Debugger * Error Debugging:: Entering the debugger when an error happens. @@ -572,10 +572,10 @@ Debugging Invalid Lisp Syntax Reading and Printing Lisp Objects * Streams Intro:: Overview of streams, reading and printing. -* Input Streams:: Various data types that can be used as +* Input Streams:: Various data types that can be used as input streams. * Input Functions:: Functions to read Lisp objects from text. -* Output Streams:: Various data types that can be used as +* Output Streams:: Various data types that can be used as output streams. * Output Functions:: Functions to print Lisp objects as text. @@ -647,7 +647,7 @@ Major and Minor Modes * Major Modes:: Defining major modes. * Minor Modes:: Defining minor modes. * Mode Line Format:: Customizing the text that appears in the mode line. -* Hooks:: How to use hooks; how to write code that +* Hooks:: How to use hooks; how to write code that provides hooks. Major Modes @@ -707,7 +707,7 @@ File Names * File Name Components:: The directory part of a file name, and the rest. * Directory Names:: A directory's name as a directory is different from its name as a file. -* Relative File Names:: Some file names are relative to a +* Relative File Names:: Some file names are relative to a current directory. * File Name Expansion:: Converting relative file names to absolute ones. * Unique File Names:: Generating names for temporary files. @@ -715,17 +715,17 @@ File Names Backups and Auto-Saving -* Backup Files:: How backup files are made; how their names +* Backup Files:: How backup files are made; how their names are chosen. * Auto-Saving:: How auto-save files are made; how their names are chosen. -* Reverting:: @code{revert-buffer}, and how to customize +* Reverting:: @code{revert-buffer}, and how to customize what it does. Backup Files * Making Backups:: How Emacs makes backup files, and when. -* Rename or Copy:: Two alternatives: renaming the old file +* Rename or Copy:: Two alternatives: renaming the old file or copying it. * Numbered Backups:: Keeping multiple backups for each source file. * Backup Names:: How backup file names are computed; customization. @@ -759,7 +759,7 @@ Windows and choosing a window for it. * Window Point:: Each window has its own location of point. * Window Start:: The display-start position controls which text - is on-screen in the window. + is on-screen in the window. * Vertical Scrolling:: Moving text up and down in the window. * Horizontal Scrolling:: Moving text sideways on the window. * Size of Window:: Accessing the size of a window. @@ -815,7 +815,7 @@ Markers * Predicates on Markers:: Testing whether an object is a marker. * Creating Markers:: Making empty markers or markers at certain places. * Information from Markers:: Finding the marker's buffer or character - position. + position. * Changing Markers:: Moving the marker to a new buffer or position. * The Mark:: How ``the mark'' is implemented with a marker. * The Region:: How to access ``the region''. @@ -841,7 +841,7 @@ Text * Substitution:: Replacing a given character wherever it appears. * Registers:: How registers are implemented. Accessing the text or position stored in a register. - + The Kill Ring * Kill Ring Concepts:: What text looks like in the kill ring. diff --git a/lispref/vol2.texi b/lispref/vol2.texi index 93e677ced58..349a886324f 100644 --- a/lispref/vol2.texi +++ b/lispref/vol2.texi @@ -23,7 +23,7 @@ @c \overfullrule=0pt @c end tex -@c Start volume 2 chapter numbering on chapter 21; +@c Start volume 2 chapter numbering on chapter 21; @c this must be listed as chapno 20. @tex \global\chapno=20 @@ -87,18 +87,18 @@ @c ----- @c [163] [164] [165] [166]) (loading.texi Chapter 13 [167] [168] [169] @c Overfull \hbox (20.5428pt too wide) in paragraph at lines 131--131 -@c []@ninett +@c []@ninett @c setenv EMAC-SLOAD-PATH .:/user/bil/emacs:/usr/local/lib/emacs/lisp[] @c ----- @c (minibuf.texi Chapter 17 [206] [207] [208] [209] [210] [211] [212] [213] @c [214] [215] @c Overfull \hbox (2.09094pt too wide) in paragraph at lines 550--560 -@c @texttt map[] @textrm if @textsl require-match @textrm is -@c @texttt nil[]@textrm , or else with the keymap @texttt minibuffer- +@c @texttt map[] @textrm if @textsl require-match @textrm is +@c @texttt nil[]@textrm , or else with the keymap @texttt minibuffer- @c ----- @c (locals.texi Appendix @char 68 [533] [534] @c Underfull \hbox (badness 2512) in paragraph at lines 4--4 -@c []@chaprm Appendix DStandard Buffer-Local +@c []@chaprm Appendix DStandard Buffer-Local @c ------------------------------------------------------------------- @@ -186,11 +186,11 @@ instead of in the original English. @sp 2 @center @titlefont{Volume 2} @sp 3 -@center by Bil Lewis, Dan LaLiberte, +@center by Bil Lewis, Dan LaLiberte, @center and the GNU Manual Group @page @vskip 0pt plus 1filll -Copyright @copyright{} 1990, 1991, 1992, 1993, 1994, 1995 Free Software Foundation, Inc. +Copyright @copyright{} 1990, 1991, 1992, 1993, 1994, 1995 Free Software Foundation, Inc. @sp 2 Edition 2.4 @* @@ -325,8 +325,8 @@ Conventions Format of Descriptions -* A Sample Function Description:: -* A Sample Variable Description:: +* A Sample Function Description:: +* A Sample Variable Description:: Lisp Data Types @@ -435,7 +435,7 @@ Evaluation * Intro Eval:: Evaluation in the scheme of things. * Eval:: How to invoke the Lisp interpreter explicitly. * Forms:: How various sorts of objects are evaluated. -* Quoting:: Avoiding evaluation (to put constants in +* Quoting:: Avoiding evaluation (to put constants in the program). Kinds of Forms @@ -488,11 +488,11 @@ Variables Scoping Rules for Variable Bindings -* Scope:: Scope means where in the program a value +* Scope:: Scope means where in the program a value is visible. Comparison with other languages. * Extent:: Extent means how long in time a value exists. * Impl of Scope:: Two ways to implement dynamic scoping. -* Using Scoping:: How to use dynamic scoping carefully and +* Using Scoping:: How to use dynamic scoping carefully and avoid problems. Buffer-Local Variables @@ -510,11 +510,11 @@ Functions * Defining Functions:: Lisp expressions for defining functions. * Calling Functions:: How to use an existing function. * Mapping Functions:: Applying a function to each element of a list, etc. -* Anonymous Functions:: Lambda-expressions are functions with no names. +* Anonymous Functions:: Lambda-expressions are functions with no names. * Function Cells:: Accessing or setting the function definition of a symbol. * Related Topics:: Cross-references to specific Lisp primitives - that have a special bearing on how + that have a special bearing on how functions work. Lambda Expressions @@ -550,10 +550,10 @@ Debugging Lisp Programs * Debugger:: How the Emacs Lisp debugger is implemented. * Syntax Errors:: How to find syntax errors. -* Compilation Errors:: How to find errors that show up in +* Compilation Errors:: How to find errors that show up in byte compilation. * Edebug:: A source-level Emacs Lisp debugger. - + The Lisp Debugger * Error Debugging:: Entering the debugger when an error happens. @@ -572,10 +572,10 @@ Debugging Invalid Lisp Syntax Reading and Printing Lisp Objects * Streams Intro:: Overview of streams, reading and printing. -* Input Streams:: Various data types that can be used as +* Input Streams:: Various data types that can be used as input streams. * Input Functions:: Functions to read Lisp objects from text. -* Output Streams:: Various data types that can be used as +* Output Streams:: Various data types that can be used as output streams. * Output Functions:: Functions to print Lisp objects as text. @@ -647,7 +647,7 @@ Major and Minor Modes * Major Modes:: Defining major modes. * Minor Modes:: Defining minor modes. * Mode Line Format:: Customizing the text that appears in the mode line. -* Hooks:: How to use hooks; how to write code that +* Hooks:: How to use hooks; how to write code that provides hooks. Major Modes @@ -707,7 +707,7 @@ File Names * File Name Components:: The directory part of a file name, and the rest. * Directory Names:: A directory's name as a directory is different from its name as a file. -* Relative File Names:: Some file names are relative to a +* Relative File Names:: Some file names are relative to a current directory. * File Name Expansion:: Converting relative file names to absolute ones. * Unique File Names:: Generating names for temporary files. @@ -715,17 +715,17 @@ File Names Backups and Auto-Saving -* Backup Files:: How backup files are made; how their names +* Backup Files:: How backup files are made; how their names are chosen. * Auto-Saving:: How auto-save files are made; how their names are chosen. -* Reverting:: @code{revert-buffer}, and how to customize +* Reverting:: @code{revert-buffer}, and how to customize what it does. Backup Files * Making Backups:: How Emacs makes backup files, and when. -* Rename or Copy:: Two alternatives: renaming the old file +* Rename or Copy:: Two alternatives: renaming the old file or copying it. * Numbered Backups:: Keeping multiple backups for each source file. * Backup Names:: How backup file names are computed; customization. @@ -759,7 +759,7 @@ Windows and choosing a window for it. * Window Point:: Each window has its own location of point. * Window Start:: The display-start position controls which text - is on-screen in the window. + is on-screen in the window. * Vertical Scrolling:: Moving text up and down in the window. * Horizontal Scrolling:: Moving text sideways on the window. * Size of Window:: Accessing the size of a window. @@ -815,7 +815,7 @@ Markers * Predicates on Markers:: Testing whether an object is a marker. * Creating Markers:: Making empty markers or markers at certain places. * Information from Markers:: Finding the marker's buffer or character - position. + position. * Changing Markers:: Moving the marker to a new buffer or position. * The Mark:: How ``the mark'' is implemented with a marker. * The Region:: How to access ``the region''. @@ -841,7 +841,7 @@ Text * Substitution:: Replacing a given character wherever it appears. * Registers:: How registers are implemented. Accessing the text or position stored in a register. - + The Kill Ring * Kill Ring Concepts:: What text looks like in the kill ring. diff --git a/lispref/windows.texi b/lispref/windows.texi index 4d7008607b9..1fc7a7e5022 100644 --- a/lispref/windows.texi +++ b/lispref/windows.texi @@ -1685,7 +1685,7 @@ If @var{window} is @code{nil}, the function uses the selected window. @tindex window-body-height @defun window-body-height &optional window -Like @code{window-height} but the value does not include the +Like @code{window-height} but the value does not include the mode line (if any) or the header line (if any). @end defun |