summaryrefslogtreecommitdiff
path: root/lispref
diff options
context:
space:
mode:
Diffstat (limited to 'lispref')
-rw-r--r--lispref/control.texi2
-rw-r--r--lispref/customize.texi4
-rw-r--r--lispref/debugging.texi2
-rw-r--r--lispref/frames.texi1
-rw-r--r--lispref/intro.texi1
-rw-r--r--lispref/lists.texi36
-rw-r--r--lispref/modes.texi9
-rw-r--r--lispref/objects.texi1
-rw-r--r--lispref/os.texi1
-rw-r--r--lispref/positions.texi5
-rw-r--r--lispref/searching.texi3
11 files changed, 30 insertions, 35 deletions
diff --git a/lispref/control.texi b/lispref/control.texi
index a824e79f6f2..17311fccf4b 100644
--- a/lispref/control.texi
+++ b/lispref/control.texi
@@ -956,6 +956,8 @@ message (but without a beep), then returns a very large number.
(condition-case err
;; @r{Protected form.}
(/ dividend divisor)
+@end group
+@group
;; @r{The handler.}
(arith-error ; @r{Condition.}
;; @r{Display the usual message for this error.}
diff --git a/lispref/customize.texi b/lispref/customize.texi
index f581fc42345..d0f56d1fb77 100644
--- a/lispref/customize.texi
+++ b/lispref/customize.texi
@@ -171,8 +171,9 @@ If @var{option} is void, @code{defcustom} initializes it to
@var{default}. @var{default} should be an expression to compute the
value; be careful in writing it, because it can be evaluated on more
than one occasion.
+@end defmac
-The following additional keywords are accepted:
+ @code{defcustom} accepts the following additional keywords:
@table @code
@item :type @var{type}
@@ -248,7 +249,6 @@ already set or has been customized; otherwise, just use
@code{set-default}.
@end table
@end table
-@end defmac
The @code{:require} option is useful for an option that turns on the
operation of a certain feature. Assuming that the package is coded to
diff --git a/lispref/debugging.texi b/lispref/debugging.texi
index 6f46c37c21f..d4dd54ca590 100644
--- a/lispref/debugging.texi
+++ b/lispref/debugging.texi
@@ -553,6 +553,7 @@ The arguments of special forms are elided.
----------- Buffer: backtrace-output ------------
backtrace()
(list ...computing arguments...)
+@end group
(progn ...)
eval((progn (1+ var) (list (quote testing) (backtrace))))
(setq ...)
@@ -561,6 +562,7 @@ The arguments of special forms are elided.
(with-output-to-temp-buffer ...)
eval-region(1973 2142 #<buffer *scratch*>)
byte-code("... for eval-print-last-sexp ...")
+@group
eval-print-last-sexp(nil)
* call-interactively(eval-print-last-sexp)
----------- Buffer: backtrace-output ------------
diff --git a/lispref/frames.texi b/lispref/frames.texi
index 20ce6e4fa62..3a02be0eee6 100644
--- a/lispref/frames.texi
+++ b/lispref/frames.texi
@@ -1302,6 +1302,7 @@ This function stores @var{string} into the first cut buffer (cut buffer
like the way successive kills in Emacs move down the kill ring.
@end defun
+@need 1500
@node Font Names
@section Looking up Font Names
diff --git a/lispref/intro.texi b/lispref/intro.texi
index 17a8d903d30..95490fc5fe9 100644
--- a/lispref/intro.texi
+++ b/lispref/intro.texi
@@ -768,6 +768,7 @@ is not supplied, then the number 19 is used by default.
@result{} 14
@end example
+@need 1500
More generally,
@example
diff --git a/lispref/lists.texi b/lispref/lists.texi
index 30b344bc411..2cb7ab92adf 100644
--- a/lispref/lists.texi
+++ b/lispref/lists.texi
@@ -496,7 +496,17 @@ result list. If the final element is not a list, the result is a
``dotted list'' since its final @sc{cdr} is not @code{nil} as required
in a true list.
-Here is an example of using @code{append}:
+The @code{append} function also allows integers as arguments. It
+converts them to strings of digits, making up the decimal print
+representation of the integer, and then uses the strings instead of the
+original integers. @strong{Don't use this feature; we plan to eliminate
+it. If you already use this feature, change your programs now!} The
+proper way to convert an integer to a decimal number in this way is with
+@code{format} (@pxref{Formatting Strings}) or @code{number-to-string}
+(@pxref{String Conversion}).
+@end defun
+
+ Here is an example of using @code{append}:
@example
@group
@@ -518,7 +528,7 @@ more-trees
@end group
@end example
-You can see how @code{append} works by looking at a box diagram. The
+ You can see how @code{append} works by looking at a box diagram. The
variable @code{trees} is set to the list @code{(pine oak)} and then the
variable @code{more-trees} is set to the list @code{(maple birch pine
oak)}. However, the variable @code{trees} continues to refer to the
@@ -537,9 +547,9 @@ more-trees trees
@end group
@end smallexample
-An empty sequence contributes nothing to the value returned by
+ An empty sequence contributes nothing to the value returned by
@code{append}. As a consequence of this, a final @code{nil} argument
-forces a copy of the previous argument.
+forces a copy of the previous argument:
@example
@group
@@ -564,7 +574,7 @@ wood
This once was the usual way to copy a list, before the function
@code{copy-sequence} was invented. @xref{Sequences Arrays Vectors}.
-Here we show the use of vectors and strings as arguments to @code{append}:
+ Here we show the use of vectors and strings as arguments to @code{append}:
@example
@group
@@ -573,7 +583,7 @@ Here we show the use of vectors and strings as arguments to @code{append}:
@end group
@end example
-With the help of @code{apply} (@pxref{Calling Functions}), we can append
+ With the help of @code{apply} (@pxref{Calling Functions}), we can append
all the lists in a list of lists:
@example
@@ -583,7 +593,7 @@ all the lists in a list of lists:
@end group
@end example
-If no @var{sequences} are given, @code{nil} is returned:
+ If no @var{sequences} are given, @code{nil} is returned:
@example
@group
@@ -592,7 +602,7 @@ If no @var{sequences} are given, @code{nil} is returned:
@end group
@end example
-Here are some examples where the final argument is not a list:
+ Here are some examples where the final argument is not a list:
@example
(append '(x y) 'z)
@@ -607,16 +617,6 @@ not a list, the sequence's elements do not become elements of the
resulting list. Instead, the sequence becomes the final @sc{cdr}, like
any other non-list final argument.
-The @code{append} function also allows integers as arguments. It
-converts them to strings of digits, making up the decimal print
-representation of the integer, and then uses the strings instead of the
-original integers. @strong{Don't use this feature; we plan to eliminate
-it. If you already use this feature, change your programs now!} The
-proper way to convert an integer to a decimal number in this way is with
-@code{format} (@pxref{Formatting Strings}) or @code{number-to-string}
-(@pxref{String Conversion}).
-@end defun
-
@defun reverse list
This function creates a new list whose elements are the elements of
@var{list}, but in reverse order. The original argument @var{list} is
diff --git a/lispref/modes.texi b/lispref/modes.texi
index 1ecbd177c0d..44b3cfa1876 100644
--- a/lispref/modes.texi
+++ b/lispref/modes.texi
@@ -1916,51 +1916,42 @@ Thus, the default value of @code{font-lock-comment-face} is
@table @code
@item font-lock-comment-face
@vindex font-lock-comment-face
-@kindex font-lock-comment-face @r{(face name)}
Used (typically) for comments.
@item font-lock-string-face
@vindex font-lock-string-face
-@kindex font-lock-string-face @r{(face name)}
Used (typically) for string constants.
@item font-lock-keyword-face
@vindex font-lock-keyword-face
-@kindex font-lock-keyword-face @r{(face name)}
Used (typically) for keywords---names that have special syntactic
significance, like @code{for} and @code{if} in C.
@item font-lock-builtin-face
@vindex font-lock-builtin-face
-@kindex font-lock-builtin-face @r{(face name)}
Used (typically) for built-in function names.
@item font-lock-function-name-face
@vindex font-lock-function-name-face
-@kindex font-lock-function-name-face @r{(face name)}
Used (typically) for the name of a function being defined or declared,
in a function definition or declaration.
@item font-lock-variable-name-face
@vindex font-lock-variable-name-face
-@kindex font-lock-variable-name-face @r{(face name)}
Used (typically) for the name of a variable being defined or declared,
in a variable definition or declaration.
@item font-lock-type-face
@vindex font-lock-type-face
-@kindex font-lock-type-face @r{(face name)}
Used (typically) for names of user-defined data types,
where they are defined and where they are used.
@item font-lock-constant-face
@vindex font-lock-constant-face
-@kindex font-lock-constant-face @r{(face name)}
Used (typically) for constant names.
@item font-lock-warning-face
@vindex font-lock-warning-face
-@kindex font-lock-warning-face @r{(face name)}
Used (typically) for constructs that are peculiar, or that greatly
change the meaning of other text. For example, this is used for
@samp{;;;###autoload} cookies in Emacs Lisp, and for @code{#error}
diff --git a/lispref/objects.texi b/lispref/objects.texi
index ccdc1756fe3..7e8f52e8578 100644
--- a/lispref/objects.texi
+++ b/lispref/objects.texi
@@ -1473,7 +1473,6 @@ a list and @code{symbolp} to check for a symbol.
((listp x)
;; If X is a list, add its elements to LIST.
(setq list (append x list)))
-@need 3000
(t
;; We handle only symbols and lists.
(error "Invalid argument %s in add-on" x))))
diff --git a/lispref/os.texi b/lispref/os.texi
index 0d900740933..d6cfe6fcc31 100644
--- a/lispref/os.texi
+++ b/lispref/os.texi
@@ -638,7 +638,6 @@ This function returns the name of the machine you are running on.
@end example
@end defun
-@vindex system-name
The symbol @code{system-name} is a variable as well as a function. In
fact, the function returns whatever value the variable
@code{system-name} currently holds. Thus, you can set the variable
diff --git a/lispref/positions.texi b/lispref/positions.texi
index 02bd42b6669..b8ddd6188f1 100644
--- a/lispref/positions.texi
+++ b/lispref/positions.texi
@@ -752,15 +752,16 @@ The value returned by @code{save-excursion} is the result of the last of
@example
@group
-(save-excursion
- @var{forms})
+(save-excursion @var{forms})
@equiv{}
(let ((old-buf (current-buffer))
(old-pnt (point-marker))
+@end group
(old-mark (copy-marker (mark-marker))))
(unwind-protect
(progn @var{forms})
(set-buffer old-buf)
+@group
(goto-char old-pnt)
(set-marker (mark-marker) old-mark)))
@end group
diff --git a/lispref/searching.texi b/lispref/searching.texi
index 265bc9aba5b..346357c857d 100644
--- a/lispref/searching.texi
+++ b/lispref/searching.texi
@@ -198,7 +198,7 @@ and @samp{o} to get the regular expression @samp{fo}, which matches only
the string @samp{fo}. Still trivial. To do something more powerful, you
need to use one of the special characters. Here is a list of them:
-@need 1200
+@need 800
@table @asis
@item @samp{.}@: @r{(Period)}
@cindex @samp{.} in regexp
@@ -312,7 +312,6 @@ mentioned as one of the characters not to match. This is in contrast to
the handling of regexps in programs such as @code{grep}.
@item @samp{^}
-@cindex @samp{^} in regexp
@cindex beginning of line in regexp
is a special character that matches the empty string, but only at the
beginning of a line in the text being matched. Otherwise it fails to