diff options
| author | Karl Heuer | 1999-06-17 07:10:20 +0000 |
|---|---|---|
| committer | Karl Heuer | 1999-06-17 07:10:20 +0000 |
| commit | b6ae404e617391c33b7dc13583a80552bf58bf28 (patch) | |
| tree | 445c663dd8df3b82c01b3fb63d56f007d97e36f4 | |
| parent | 9ef73b91a0dd625ff753d1e57e3909cfbe9448af (diff) | |
| download | emacs-b6ae404e617391c33b7dc13583a80552bf58bf28.tar.gz emacs-b6ae404e617391c33b7dc13583a80552bf58bf28.zip | |
*** empty log message ***
| -rw-r--r-- | lispref/calendar.texi | 4 | ||||
| -rw-r--r-- | lispref/debugging.texi | 2 | ||||
| -rw-r--r-- | lispref/strings.texi | 39 | ||||
| -rw-r--r-- | lispref/tips.texi | 2 |
4 files changed, 24 insertions, 23 deletions
diff --git a/lispref/calendar.texi b/lispref/calendar.texi index 171f6a2263a..ad521822e88 100644 --- a/lispref/calendar.texi +++ b/lispref/calendar.texi | |||
| @@ -653,8 +653,8 @@ the entries by the dates they apply to. | |||
| 653 | 653 | ||
| 654 | As with simple diary display, you can print a hard copy of the buffer | 654 | As with simple diary display, you can print a hard copy of the buffer |
| 655 | with @code{print-diary-entries}. To print a hard copy of a day-by-day | 655 | with @code{print-diary-entries}. To print a hard copy of a day-by-day |
| 656 | diary for a week by positioning point on Sunday of that week, type | 656 | diary for a week, position point on Sunday of that week, type |
| 657 | @kbd{7 d} and then do @kbd{M-x print-diary-entries}. As usual, the | 657 | @kbd{7 d}, and then do @kbd{M-x print-diary-entries}. As usual, the |
| 658 | inclusion of the holidays slows down the display slightly; you can speed | 658 | inclusion of the holidays slows down the display slightly; you can speed |
| 659 | things up by setting the variable @code{holidays-in-diary-buffer} to | 659 | things up by setting the variable @code{holidays-in-diary-buffer} to |
| 660 | @code{nil}. | 660 | @code{nil}. |
diff --git a/lispref/debugging.texi b/lispref/debugging.texi index d4dd54ca590..4bc3d07d69b 100644 --- a/lispref/debugging.texi +++ b/lispref/debugging.texi | |||
| @@ -164,7 +164,7 @@ this: | |||
| 164 | 164 | ||
| 165 | When a program loops infinitely and fails to return, your first | 165 | When a program loops infinitely and fails to return, your first |
| 166 | problem is to stop the loop. On most operating systems, you can do this | 166 | problem is to stop the loop. On most operating systems, you can do this |
| 167 | with @kbd{C-g}, which causes quit. | 167 | with @kbd{C-g}, which causes a @dfn{quit}. |
| 168 | 168 | ||
| 169 | Ordinary quitting gives no information about why the program was | 169 | Ordinary quitting gives no information about why the program was |
| 170 | looping. To get more information, you can set the variable | 170 | looping. To get more information, you can set the variable |
diff --git a/lispref/strings.texi b/lispref/strings.texi index dc4aaabb18e..c443a1df61f 100644 --- a/lispref/strings.texi +++ b/lispref/strings.texi | |||
| @@ -13,8 +13,8 @@ | |||
| 13 | 13 | ||
| 14 | A string in Emacs Lisp is an array that contains an ordered sequence | 14 | A string in Emacs Lisp is an array that contains an ordered sequence |
| 15 | of characters. Strings are used as names of symbols, buffers, and | 15 | of characters. Strings are used as names of symbols, buffers, and |
| 16 | files, to send messages to users, to hold text being copied between | 16 | files; to send messages to users; to hold text being copied between |
| 17 | buffers, and for many other purposes. Because strings are so important, | 17 | buffers; and for many other purposes. Because strings are so important, |
| 18 | Emacs Lisp has many functions expressly for manipulating them. Emacs | 18 | Emacs Lisp has many functions expressly for manipulating them. Emacs |
| 19 | Lisp programs use strings more often than individual characters. | 19 | Lisp programs use strings more often than individual characters. |
| 20 | 20 | ||
| @@ -36,8 +36,7 @@ keyboard character events. | |||
| 36 | @node String Basics | 36 | @node String Basics |
| 37 | @section String and Character Basics | 37 | @section String and Character Basics |
| 38 | 38 | ||
| 39 | Strings in Emacs Lisp are arrays that contain an ordered sequence of | 39 | Characters are represented in Emacs Lisp as integers; |
| 40 | characters. Characters are represented in Emacs Lisp as integers; | ||
| 41 | whether an integer is a character or not is determined only by how it is | 40 | whether an integer is a character or not is determined only by how it is |
| 42 | used. Thus, strings really contain integers. | 41 | used. Thus, strings really contain integers. |
| 43 | 42 | ||
| @@ -55,9 +54,9 @@ and @code{aset} (@pxref{Array Functions}). | |||
| 55 | There are two text representations for non-@sc{ASCII} characters in | 54 | There are two text representations for non-@sc{ASCII} characters in |
| 56 | Emacs strings (and in buffers): unibyte and multibyte (@pxref{Text | 55 | Emacs strings (and in buffers): unibyte and multibyte (@pxref{Text |
| 57 | Representations}). @sc{ASCII} characters always occupy one byte in a | 56 | Representations}). @sc{ASCII} characters always occupy one byte in a |
| 58 | string; in fact, there is no real difference between the two | 57 | string; in fact, when a string is all @sc{ASCII}, there is no real |
| 59 | representation for a string which is all @sc{ASCII}. For most Lisp | 58 | difference between the unibyte and multibyte representations. |
| 60 | programming, you don't need to be concerned with these two | 59 | For most Lisp programming, you don't need to be concerned with these two |
| 61 | representations. | 60 | representations. |
| 62 | 61 | ||
| 63 | Sometimes key sequences are represented as strings. When a string is | 62 | Sometimes key sequences are represented as strings. When a string is |
| @@ -88,7 +87,7 @@ strings also copy the properties of the characters being copied. | |||
| 88 | copy them into buffers. @xref{Character Type}, and @ref{String Type}, | 87 | copy them into buffers. @xref{Character Type}, and @ref{String Type}, |
| 89 | for information about the syntax of characters and strings. | 88 | for information about the syntax of characters and strings. |
| 90 | @xref{Non-ASCII Characters}, for functions to convert between text | 89 | @xref{Non-ASCII Characters}, for functions to convert between text |
| 91 | representations and encode and decode character codes. | 90 | representations and to encode and decode character codes. |
| 92 | 91 | ||
| 93 | @node Predicates for Strings | 92 | @node Predicates for Strings |
| 94 | @section The Predicates for Strings | 93 | @section The Predicates for Strings |
| @@ -275,8 +274,9 @@ Lists}. | |||
| 275 | Split @var{string} into substrings in between matches for the regular | 274 | Split @var{string} into substrings in between matches for the regular |
| 276 | expression @var{separators}. Each match for @var{separators} defines a | 275 | expression @var{separators}. Each match for @var{separators} defines a |
| 277 | splitting point; the substrings between the splitting points are made | 276 | splitting point; the substrings between the splitting points are made |
| 278 | into a list, which is the value. If @var{separators} is @code{nil} (or | 277 | into a list, which is the value returned by @code{split-string}. |
| 279 | omitted), the default is @code{"[ \f\t\n\r\v]+"}. | 278 | If @var{separators} is @code{nil} (or omitted), |
| 279 | the default is @code{"[ \f\t\n\r\v]+"}. | ||
| 280 | 280 | ||
| 281 | For example, | 281 | For example, |
| 282 | 282 | ||
| @@ -326,7 +326,7 @@ may be either a character or a (smaller) string. | |||
| 326 | 326 | ||
| 327 | Since it is impossible to change the length of an existing string, it is | 327 | Since it is impossible to change the length of an existing string, it is |
| 328 | an error if @var{obj} doesn't fit within @var{string}'s actual length, | 328 | an error if @var{obj} doesn't fit within @var{string}'s actual length, |
| 329 | of if any new character requires a different number of bytes from the | 329 | or if any new character requires a different number of bytes from the |
| 330 | character currently present at that point in @var{string}. | 330 | character currently present at that point in @var{string}. |
| 331 | @end defun | 331 | @end defun |
| 332 | 332 | ||
| @@ -351,7 +351,8 @@ in case if @code{case-fold-search} is non-@code{nil}. | |||
| 351 | 351 | ||
| 352 | @defun string= string1 string2 | 352 | @defun string= string1 string2 |
| 353 | This function returns @code{t} if the characters of the two strings | 353 | This function returns @code{t} if the characters of the two strings |
| 354 | match exactly; case is significant. | 354 | match exactly. |
| 355 | Case is always significant, regardless of @code{case-fold-search}. | ||
| 355 | 356 | ||
| 356 | @example | 357 | @example |
| 357 | (string= "abc" "abc") | 358 | (string= "abc" "abc") |
| @@ -520,7 +521,7 @@ enough to retain. | |||
| 520 | @defun number-to-string number | 521 | @defun number-to-string number |
| 521 | @cindex integer to string | 522 | @cindex integer to string |
| 522 | @cindex integer to decimal | 523 | @cindex integer to decimal |
| 523 | This function returns a string consisting of the printed | 524 | This function returns a string consisting of the printed base-ten |
| 524 | representation of @var{number}, which may be an integer or a floating | 525 | representation of @var{number}, which may be an integer or a floating |
| 525 | point number. The value starts with a sign if the argument is | 526 | point number. The value starts with a sign if the argument is |
| 526 | negative. | 527 | negative. |
| @@ -592,8 +593,8 @@ Functions}. | |||
| 592 | @cindex strings, formatting them | 593 | @cindex strings, formatting them |
| 593 | 594 | ||
| 594 | @dfn{Formatting} means constructing a string by substitution of | 595 | @dfn{Formatting} means constructing a string by substitution of |
| 595 | computed values at various places in a constant string. This string | 596 | computed values at various places in a constant string. This constant string |
| 596 | controls how the other values are printed as well as where they appear; | 597 | controls how the other values are printed, as well as where they appear; |
| 597 | it is called a @dfn{format string}. | 598 | it is called a @dfn{format string}. |
| 598 | 599 | ||
| 599 | Formatting is often useful for computing messages to be displayed. In | 600 | Formatting is often useful for computing messages to be displayed. In |
| @@ -624,7 +625,7 @@ For example: | |||
| 624 | @end example | 625 | @end example |
| 625 | 626 | ||
| 626 | If @var{string} contains more than one format specification, the | 627 | If @var{string} contains more than one format specification, the |
| 627 | format specifications correspond with successive values from | 628 | format specifications correspond to successive values from |
| 628 | @var{objects}. Thus, the first format specification in @var{string} | 629 | @var{objects}. Thus, the first format specification in @var{string} |
| 629 | uses the first such value, the second format specification uses the | 630 | uses the first such value, the second format specification uses the |
| 630 | second such value, and so on. Any extra format specifications (those | 631 | second such value, and so on. Any extra format specifications (those |
| @@ -686,7 +687,7 @@ using either exponential notation or decimal-point notation, whichever | |||
| 686 | is shorter. | 687 | is shorter. |
| 687 | 688 | ||
| 688 | @item %% | 689 | @item %% |
| 689 | A single @samp{%} is placed in the string. This format specification is | 690 | Replace the specification with a single @samp{%}. This format specification is |
| 690 | unusual in that it does not use a value. For example, @code{(format "%% | 691 | unusual in that it does not use a value. For example, @code{(format "%% |
| 691 | %d" 30)} returns @code{"% 30"}. | 692 | %d" 30)} returns @code{"% 30"}. |
| 692 | @end table | 693 | @end table |
| @@ -855,10 +856,10 @@ has the same result as @code{upcase}. | |||
| 855 | @end defun | 856 | @end defun |
| 856 | 857 | ||
| 857 | @defun upcase-initials string | 858 | @defun upcase-initials string |
| 858 | This function capitalizes the initials of the words in @var{string}. | 859 | This function capitalizes the initials of the words in @var{string}, |
| 859 | without altering any letters other than the initials. It returns a new | 860 | without altering any letters other than the initials. It returns a new |
| 860 | string whose contents are a copy of @var{string}, in which each word has | 861 | string whose contents are a copy of @var{string}, in which each word has |
| 861 | been converted to upper case. | 862 | had its initial letter converted to upper case. |
| 862 | 863 | ||
| 863 | The definition of a word is any sequence of consecutive characters that | 864 | The definition of a word is any sequence of consecutive characters that |
| 864 | are assigned to the word constituent syntax class in the current syntax | 865 | are assigned to the word constituent syntax class in the current syntax |
diff --git a/lispref/tips.texi b/lispref/tips.texi index 2ab8b289960..5e7ac75302b 100644 --- a/lispref/tips.texi +++ b/lispref/tips.texi | |||
| @@ -161,7 +161,7 @@ that context. | |||
| 161 | 161 | ||
| 162 | @item | 162 | @item |
| 163 | Anything which acts like a temporary mode or state which the user can | 163 | Anything which acts like a temporary mode or state which the user can |
| 164 | enter and leave should define @kbd{@key{ESC} @key{ESC}} of | 164 | enter and leave should define @kbd{@key{ESC} @key{ESC}} or |
| 165 | @kbd{@key{ESC} @key{ESC} @key{ESC}} as a way to escape. | 165 | @kbd{@key{ESC} @key{ESC} @key{ESC}} as a way to escape. |
| 166 | 166 | ||
| 167 | For a state which accepts ordinary Emacs commands, or more generally any | 167 | For a state which accepts ordinary Emacs commands, or more generally any |