diff options
| author | Richard M. Stallman | 1998-05-28 04:01:48 +0000 |
|---|---|---|
| committer | Richard M. Stallman | 1998-05-28 04:01:48 +0000 |
| commit | 7dd3d99f7e49646d3d84161770881f37ba002ef1 (patch) | |
| tree | f03d20afe324a290648da7b144f3e8c810446090 | |
| parent | 13da0554f62a88f309b1b79f688b1468420487a4 (diff) | |
| download | emacs-7dd3d99f7e49646d3d84161770881f37ba002ef1.tar.gz emacs-7dd3d99f7e49646d3d84161770881f37ba002ef1.zip | |
*** empty log message ***
| -rw-r--r-- | lispref/control.texi | 2 | ||||
| -rw-r--r-- | lispref/customize.texi | 4 | ||||
| -rw-r--r-- | lispref/debugging.texi | 2 | ||||
| -rw-r--r-- | lispref/frames.texi | 1 | ||||
| -rw-r--r-- | lispref/intro.texi | 1 | ||||
| -rw-r--r-- | lispref/lists.texi | 36 | ||||
| -rw-r--r-- | lispref/modes.texi | 9 | ||||
| -rw-r--r-- | lispref/objects.texi | 1 | ||||
| -rw-r--r-- | lispref/os.texi | 1 | ||||
| -rw-r--r-- | lispref/positions.texi | 5 | ||||
| -rw-r--r-- | lispref/searching.texi | 3 |
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 |
| 172 | value; be careful in writing it, because it can be evaluated on more | 172 | value; be careful in writing it, because it can be evaluated on more |
| 173 | than one occasion. | 173 | than one occasion. |
| 174 | @end defmac | ||
| 174 | 175 | ||
| 175 | The 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 |
| 254 | operation of a certain feature. Assuming that the package is coded to | 254 | 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. | |||
| 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 | |||
| 1302 | like the way successive kills in Emacs move down the kill ring. | 1302 | like 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 | ||
| 771 | More generally, | 772 | More 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 |
| 497 | in a true list. | 497 | in a true list. |
| 498 | 498 | ||
| 499 | Here is an example of using @code{append}: | 499 | The @code{append} function also allows integers as arguments. It |
| 500 | converts them to strings of digits, making up the decimal print | ||
| 501 | representation of the integer, and then uses the strings instead of the | ||
| 502 | original integers. @strong{Don't use this feature; we plan to eliminate | ||
| 503 | it. If you already use this feature, change your programs now!} The | ||
| 504 | proper 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 | ||
| 521 | You 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 |
| 522 | variable @code{trees} is set to the list @code{(pine oak)} and then the | 532 | variable @code{trees} is set to the list @code{(pine oak)} and then the |
| 523 | variable @code{more-trees} is set to the list @code{(maple birch pine | 533 | variable @code{more-trees} is set to the list @code{(maple birch pine |
| 524 | oak)}. However, the variable @code{trees} continues to refer to the | 534 | oak)}. 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 | ||
| 540 | An 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 |
| 542 | forces a copy of the previous argument. | 552 | forces a copy of the previous argument: |
| 543 | 553 | ||
| 544 | @example | 554 | @example |
| 545 | @group | 555 | @group |
| @@ -564,7 +574,7 @@ wood | |||
| 564 | This once was the usual way to copy a list, before the function | 574 | This 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 | ||
| 567 | Here 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 | ||
| 576 | With the help of @code{apply} (@pxref{Calling Functions}), we can append | 586 | With the help of @code{apply} (@pxref{Calling Functions}), we can append |
| 577 | all the lists in a list of lists: | 587 | all 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 | ||
| 586 | If 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 | ||
| 595 | Here 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 | |||
| 607 | resulting list. Instead, the sequence becomes the final @sc{cdr}, like | 617 | resulting list. Instead, the sequence becomes the final @sc{cdr}, like |
| 608 | any other non-list final argument. | 618 | any other non-list final argument. |
| 609 | 619 | ||
| 610 | The @code{append} function also allows integers as arguments. It | ||
| 611 | converts them to strings of digits, making up the decimal print | ||
| 612 | representation of the integer, and then uses the strings instead of the | ||
| 613 | original integers. @strong{Don't use this feature; we plan to eliminate | ||
| 614 | it. If you already use this feature, change your programs now!} The | ||
| 615 | proper 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 |
| 621 | This function creates a new list whose elements are the elements of | 621 | This 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)} | ||
| 1920 | Used (typically) for comments. | 1919 | Used (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)} | ||
| 1925 | Used (typically) for string constants. | 1923 | Used (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)} | ||
| 1930 | Used (typically) for keywords---names that have special syntactic | 1927 | Used (typically) for keywords---names that have special syntactic |
| 1931 | significance, like @code{for} and @code{if} in C. | 1928 | significance, 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)} | ||
| 1936 | Used (typically) for built-in function names. | 1932 | Used (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)} | ||
| 1941 | Used (typically) for the name of a function being defined or declared, | 1936 | Used (typically) for the name of a function being defined or declared, |
| 1942 | in a function definition or declaration. | 1937 | in 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)} | ||
| 1947 | Used (typically) for the name of a variable being defined or declared, | 1941 | Used (typically) for the name of a variable being defined or declared, |
| 1948 | in a variable definition or declaration. | 1942 | in 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)} | ||
| 1953 | Used (typically) for names of user-defined data types, | 1946 | Used (typically) for names of user-defined data types, |
| 1954 | where they are defined and where they are used. | 1947 | where 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)} | ||
| 1959 | Used (typically) for constant names. | 1951 | Used (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)} | ||
| 1964 | Used (typically) for constructs that are peculiar, or that greatly | 1955 | Used (typically) for constructs that are peculiar, or that greatly |
| 1965 | change the meaning of other text. For example, this is used for | 1956 | change 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 |
| 643 | fact, the function returns whatever value the variable | 642 | fact, 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 | |||
| 198 | the string @samp{fo}. Still trivial. To do something more powerful, you | 198 | the string @samp{fo}. Still trivial. To do something more powerful, you |
| 199 | need to use one of the special characters. Here is a list of them: | 199 | need 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 | |||
| 312 | the handling of regexps in programs such as @code{grep}. | 312 | the 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 |
| 317 | is a special character that matches the empty string, but only at the | 316 | is a special character that matches the empty string, but only at the |
| 318 | beginning of a line in the text being matched. Otherwise it fails to | 317 | beginning of a line in the text being matched. Otherwise it fails to |