aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman1998-05-28 04:01:48 +0000
committerRichard M. Stallman1998-05-28 04:01:48 +0000
commit7dd3d99f7e49646d3d84161770881f37ba002ef1 (patch)
treef03d20afe324a290648da7b144f3e8c810446090
parent13da0554f62a88f309b1b79f688b1468420487a4 (diff)
downloademacs-7dd3d99f7e49646d3d84161770881f37ba002ef1.tar.gz
emacs-7dd3d99f7e49646d3d84161770881f37ba002ef1.zip
*** empty log message ***
-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.
956 (condition-case err 956 (condition-case err
957 ;; @r{Protected form.} 957 ;; @r{Protected form.}
958 (/ dividend divisor) 958 (/ dividend divisor)
959@end group
960@group
959 ;; @r{The handler.} 961 ;; @r{The handler.}
960 (arith-error ; @r{Condition.} 962 (arith-error ; @r{Condition.}
961 ;; @r{Display the usual message for this error.} 963 ;; @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
171@var{default}. @var{default} should be an expression to compute the 171@var{default}. @var{default} should be an expression to compute the
172value; be careful in writing it, because it can be evaluated on more 172value; be careful in writing it, because it can be evaluated on more
173than one occasion. 173than one occasion.
174@end defmac
174 175
175The following additional keywords are accepted: 176 @code{defcustom} accepts the following additional keywords:
176 177
177@table @code 178@table @code
178@item :type @var{type} 179@item :type @var{type}
@@ -248,7 +249,6 @@ already set or has been customized; otherwise, just use
248@code{set-default}. 249@code{set-default}.
249@end table 250@end table
250@end table 251@end table
251@end defmac
252 252
253 The @code{:require} option is useful for an option that turns on the 253 The @code{:require} option is useful for an option that turns on the
254operation of a certain feature. Assuming that the package is coded to 254operation 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.
553----------- Buffer: backtrace-output ------------ 553----------- Buffer: backtrace-output ------------
554 backtrace() 554 backtrace()
555 (list ...computing arguments...) 555 (list ...computing arguments...)
556@end group
556 (progn ...) 557 (progn ...)
557 eval((progn (1+ var) (list (quote testing) (backtrace)))) 558 eval((progn (1+ var) (list (quote testing) (backtrace))))
558 (setq ...) 559 (setq ...)
@@ -561,6 +562,7 @@ The arguments of special forms are elided.
561 (with-output-to-temp-buffer ...) 562 (with-output-to-temp-buffer ...)
562 eval-region(1973 2142 #<buffer *scratch*>) 563 eval-region(1973 2142 #<buffer *scratch*>)
563 byte-code("... for eval-print-last-sexp ...") 564 byte-code("... for eval-print-last-sexp ...")
565@group
564 eval-print-last-sexp(nil) 566 eval-print-last-sexp(nil)
565* call-interactively(eval-print-last-sexp) 567* call-interactively(eval-print-last-sexp)
566----------- Buffer: backtrace-output ------------ 568----------- 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
1302like the way successive kills in Emacs move down the kill ring. 1302like the way successive kills in Emacs move down the kill ring.
1303@end defun 1303@end defun
1304 1304
1305@need 1500
1305@node Font Names 1306@node Font Names
1306@section Looking up Font Names 1307@section Looking up Font Names
1307 1308
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.
768 @result{} 14 768 @result{} 14
769@end example 769@end example
770 770
771@need 1500
771More generally, 772More generally,
772 773
773@example 774@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
496``dotted list'' since its final @sc{cdr} is not @code{nil} as required 496``dotted list'' since its final @sc{cdr} is not @code{nil} as required
497in a true list. 497in a true list.
498 498
499Here is an example of using @code{append}: 499The @code{append} function also allows integers as arguments. It
500converts them to strings of digits, making up the decimal print
501representation of the integer, and then uses the strings instead of the
502original integers. @strong{Don't use this feature; we plan to eliminate
503it. If you already use this feature, change your programs now!} The
504proper way to convert an integer to a decimal number in this way is with
505@code{format} (@pxref{Formatting Strings}) or @code{number-to-string}
506(@pxref{String Conversion}).
507@end defun
508
509 Here is an example of using @code{append}:
500 510
501@example 511@example
502@group 512@group
@@ -518,7 +528,7 @@ more-trees
518@end group 528@end group
519@end example 529@end example
520 530
521You can see how @code{append} works by looking at a box diagram. The 531 You can see how @code{append} works by looking at a box diagram. The
522variable @code{trees} is set to the list @code{(pine oak)} and then the 532variable @code{trees} is set to the list @code{(pine oak)} and then the
523variable @code{more-trees} is set to the list @code{(maple birch pine 533variable @code{more-trees} is set to the list @code{(maple birch pine
524oak)}. However, the variable @code{trees} continues to refer to the 534oak)}. However, the variable @code{trees} continues to refer to the
@@ -537,9 +547,9 @@ more-trees trees
537@end group 547@end group
538@end smallexample 548@end smallexample
539 549
540An empty sequence contributes nothing to the value returned by 550 An empty sequence contributes nothing to the value returned by
541@code{append}. As a consequence of this, a final @code{nil} argument 551@code{append}. As a consequence of this, a final @code{nil} argument
542forces a copy of the previous argument. 552forces a copy of the previous argument:
543 553
544@example 554@example
545@group 555@group
@@ -564,7 +574,7 @@ wood
564This once was the usual way to copy a list, before the function 574This once was the usual way to copy a list, before the function
565@code{copy-sequence} was invented. @xref{Sequences Arrays Vectors}. 575@code{copy-sequence} was invented. @xref{Sequences Arrays Vectors}.
566 576
567Here we show the use of vectors and strings as arguments to @code{append}: 577 Here we show the use of vectors and strings as arguments to @code{append}:
568 578
569@example 579@example
570@group 580@group
@@ -573,7 +583,7 @@ Here we show the use of vectors and strings as arguments to @code{append}:
573@end group 583@end group
574@end example 584@end example
575 585
576With the help of @code{apply} (@pxref{Calling Functions}), we can append 586 With the help of @code{apply} (@pxref{Calling Functions}), we can append
577all the lists in a list of lists: 587all the lists in a list of lists:
578 588
579@example 589@example
@@ -583,7 +593,7 @@ all the lists in a list of lists:
583@end group 593@end group
584@end example 594@end example
585 595
586If no @var{sequences} are given, @code{nil} is returned: 596 If no @var{sequences} are given, @code{nil} is returned:
587 597
588@example 598@example
589@group 599@group
@@ -592,7 +602,7 @@ If no @var{sequences} are given, @code{nil} is returned:
592@end group 602@end group
593@end example 603@end example
594 604
595Here are some examples where the final argument is not a list: 605 Here are some examples where the final argument is not a list:
596 606
597@example 607@example
598(append '(x y) 'z) 608(append '(x y) 'z)
@@ -607,16 +617,6 @@ not a list, the sequence's elements do not become elements of the
607resulting list. Instead, the sequence becomes the final @sc{cdr}, like 617resulting list. Instead, the sequence becomes the final @sc{cdr}, like
608any other non-list final argument. 618any other non-list final argument.
609 619
610The @code{append} function also allows integers as arguments. It
611converts them to strings of digits, making up the decimal print
612representation of the integer, and then uses the strings instead of the
613original integers. @strong{Don't use this feature; we plan to eliminate
614it. If you already use this feature, change your programs now!} The
615proper way to convert an integer to a decimal number in this way is with
616@code{format} (@pxref{Formatting Strings}) or @code{number-to-string}
617(@pxref{String Conversion}).
618@end defun
619
620@defun reverse list 620@defun reverse list
621This function creates a new list whose elements are the elements of 621This function creates a new list whose elements are the elements of
622@var{list}, but in reverse order. The original argument @var{list} is 622@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
1916@table @code 1916@table @code
1917@item font-lock-comment-face 1917@item font-lock-comment-face
1918@vindex font-lock-comment-face 1918@vindex font-lock-comment-face
1919@kindex font-lock-comment-face @r{(face name)}
1920Used (typically) for comments. 1919Used (typically) for comments.
1921 1920
1922@item font-lock-string-face 1921@item font-lock-string-face
1923@vindex font-lock-string-face 1922@vindex font-lock-string-face
1924@kindex font-lock-string-face @r{(face name)}
1925Used (typically) for string constants. 1923Used (typically) for string constants.
1926 1924
1927@item font-lock-keyword-face 1925@item font-lock-keyword-face
1928@vindex font-lock-keyword-face 1926@vindex font-lock-keyword-face
1929@kindex font-lock-keyword-face @r{(face name)}
1930Used (typically) for keywords---names that have special syntactic 1927Used (typically) for keywords---names that have special syntactic
1931significance, like @code{for} and @code{if} in C. 1928significance, like @code{for} and @code{if} in C.
1932 1929
1933@item font-lock-builtin-face 1930@item font-lock-builtin-face
1934@vindex font-lock-builtin-face 1931@vindex font-lock-builtin-face
1935@kindex font-lock-builtin-face @r{(face name)}
1936Used (typically) for built-in function names. 1932Used (typically) for built-in function names.
1937 1933
1938@item font-lock-function-name-face 1934@item font-lock-function-name-face
1939@vindex font-lock-function-name-face 1935@vindex font-lock-function-name-face
1940@kindex font-lock-function-name-face @r{(face name)}
1941Used (typically) for the name of a function being defined or declared, 1936Used (typically) for the name of a function being defined or declared,
1942in a function definition or declaration. 1937in a function definition or declaration.
1943 1938
1944@item font-lock-variable-name-face 1939@item font-lock-variable-name-face
1945@vindex font-lock-variable-name-face 1940@vindex font-lock-variable-name-face
1946@kindex font-lock-variable-name-face @r{(face name)}
1947Used (typically) for the name of a variable being defined or declared, 1941Used (typically) for the name of a variable being defined or declared,
1948in a variable definition or declaration. 1942in a variable definition or declaration.
1949 1943
1950@item font-lock-type-face 1944@item font-lock-type-face
1951@vindex font-lock-type-face 1945@vindex font-lock-type-face
1952@kindex font-lock-type-face @r{(face name)}
1953Used (typically) for names of user-defined data types, 1946Used (typically) for names of user-defined data types,
1954where they are defined and where they are used. 1947where they are defined and where they are used.
1955 1948
1956@item font-lock-constant-face 1949@item font-lock-constant-face
1957@vindex font-lock-constant-face 1950@vindex font-lock-constant-face
1958@kindex font-lock-constant-face @r{(face name)}
1959Used (typically) for constant names. 1951Used (typically) for constant names.
1960 1952
1961@item font-lock-warning-face 1953@item font-lock-warning-face
1962@vindex font-lock-warning-face 1954@vindex font-lock-warning-face
1963@kindex font-lock-warning-face @r{(face name)}
1964Used (typically) for constructs that are peculiar, or that greatly 1955Used (typically) for constructs that are peculiar, or that greatly
1965change the meaning of other text. For example, this is used for 1956change the meaning of other text. For example, this is used for
1966@samp{;;;###autoload} cookies in Emacs Lisp, and for @code{#error} 1957@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.
1473 ((listp x) 1473 ((listp x)
1474 ;; If X is a list, add its elements to LIST. 1474 ;; If X is a list, add its elements to LIST.
1475 (setq list (append x list))) 1475 (setq list (append x list)))
1476@need 3000
1477 (t 1476 (t
1478 ;; We handle only symbols and lists. 1477 ;; We handle only symbols and lists.
1479 (error "Invalid argument %s in add-on" x)))) 1478 (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.
638@end example 638@end example
639@end defun 639@end defun
640 640
641@vindex system-name
642 The symbol @code{system-name} is a variable as well as a function. In 641 The symbol @code{system-name} is a variable as well as a function. In
643fact, the function returns whatever value the variable 642fact, the function returns whatever value the variable
644@code{system-name} currently holds. Thus, you can set the variable 643@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
752 752
753@example 753@example
754@group 754@group
755(save-excursion 755(save-excursion @var{forms})
756 @var{forms})
757@equiv{} 756@equiv{}
758(let ((old-buf (current-buffer)) 757(let ((old-buf (current-buffer))
759 (old-pnt (point-marker)) 758 (old-pnt (point-marker))
759@end group
760 (old-mark (copy-marker (mark-marker)))) 760 (old-mark (copy-marker (mark-marker))))
761 (unwind-protect 761 (unwind-protect
762 (progn @var{forms}) 762 (progn @var{forms})
763 (set-buffer old-buf) 763 (set-buffer old-buf)
764@group
764 (goto-char old-pnt) 765 (goto-char old-pnt)
765 (set-marker (mark-marker) old-mark))) 766 (set-marker (mark-marker) old-mark)))
766@end group 767@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
198the string @samp{fo}. Still trivial. To do something more powerful, you 198the string @samp{fo}. Still trivial. To do something more powerful, you
199need to use one of the special characters. Here is a list of them: 199need to use one of the special characters. Here is a list of them:
200 200
201@need 1200 201@need 800
202@table @asis 202@table @asis
203@item @samp{.}@: @r{(Period)} 203@item @samp{.}@: @r{(Period)}
204@cindex @samp{.} in regexp 204@cindex @samp{.} in regexp
@@ -312,7 +312,6 @@ mentioned as one of the characters not to match. This is in contrast to
312the handling of regexps in programs such as @code{grep}. 312the handling of regexps in programs such as @code{grep}.
313 313
314@item @samp{^} 314@item @samp{^}
315@cindex @samp{^} in regexp
316@cindex beginning of line in regexp 315@cindex beginning of line in regexp
317is a special character that matches the empty string, but only at the 316is a special character that matches the empty string, but only at the
318beginning of a line in the text being matched. Otherwise it fails to 317beginning of a line in the text being matched. Otherwise it fails to