aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKarl Heuer1999-06-17 07:10:20 +0000
committerKarl Heuer1999-06-17 07:10:20 +0000
commitb6ae404e617391c33b7dc13583a80552bf58bf28 (patch)
tree445c663dd8df3b82c01b3fb63d56f007d97e36f4
parent9ef73b91a0dd625ff753d1e57e3909cfbe9448af (diff)
downloademacs-b6ae404e617391c33b7dc13583a80552bf58bf28.tar.gz
emacs-b6ae404e617391c33b7dc13583a80552bf58bf28.zip
*** empty log message ***
-rw-r--r--lispref/calendar.texi4
-rw-r--r--lispref/debugging.texi2
-rw-r--r--lispref/strings.texi39
-rw-r--r--lispref/tips.texi2
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
655with @code{print-diary-entries}. To print a hard copy of a day-by-day 655with @code{print-diary-entries}. To print a hard copy of a day-by-day
656diary for a week by positioning point on Sunday of that week, type 656diary 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
658inclusion of the holidays slows down the display slightly; you can speed 658inclusion of the holidays slows down the display slightly; you can speed
659things up by setting the variable @code{holidays-in-diary-buffer} to 659things 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
166problem is to stop the loop. On most operating systems, you can do this 166problem is to stop the loop. On most operating systems, you can do this
167with @kbd{C-g}, which causes quit. 167with @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
170looping. To get more information, you can set the variable 170looping. 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
15of characters. Strings are used as names of symbols, buffers, and 15of characters. Strings are used as names of symbols, buffers, and
16files, to send messages to users, to hold text being copied between 16files; to send messages to users; to hold text being copied between
17buffers, and for many other purposes. Because strings are so important, 17buffers; and for many other purposes. Because strings are so important,
18Emacs Lisp has many functions expressly for manipulating them. Emacs 18Emacs Lisp has many functions expressly for manipulating them. Emacs
19Lisp programs use strings more often than individual characters. 19Lisp 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;
40characters. Characters are represented in Emacs Lisp as integers;
41whether an integer is a character or not is determined only by how it is 40whether an integer is a character or not is determined only by how it is
42used. Thus, strings really contain integers. 41used. 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
56Emacs strings (and in buffers): unibyte and multibyte (@pxref{Text 55Emacs strings (and in buffers): unibyte and multibyte (@pxref{Text
57Representations}). @sc{ASCII} characters always occupy one byte in a 56Representations}). @sc{ASCII} characters always occupy one byte in a
58string; in fact, there is no real difference between the two 57string; in fact, when a string is all @sc{ASCII}, there is no real
59representation for a string which is all @sc{ASCII}. For most Lisp 58difference between the unibyte and multibyte representations.
60programming, you don't need to be concerned with these two 59For most Lisp programming, you don't need to be concerned with these two
61representations. 60representations.
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.
88copy them into buffers. @xref{Character Type}, and @ref{String Type}, 87copy them into buffers. @xref{Character Type}, and @ref{String Type},
89for information about the syntax of characters and strings. 88for 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
91representations and encode and decode character codes. 90representations 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}.
275Split @var{string} into substrings in between matches for the regular 274Split @var{string} into substrings in between matches for the regular
276expression @var{separators}. Each match for @var{separators} defines a 275expression @var{separators}. Each match for @var{separators} defines a
277splitting point; the substrings between the splitting points are made 276splitting point; the substrings between the splitting points are made
278into a list, which is the value. If @var{separators} is @code{nil} (or 277into a list, which is the value returned by @code{split-string}.
279omitted), the default is @code{"[ \f\t\n\r\v]+"}. 278If @var{separators} is @code{nil} (or omitted),
279the default is @code{"[ \f\t\n\r\v]+"}.
280 280
281For example, 281For example,
282 282
@@ -326,7 +326,7 @@ may be either a character or a (smaller) string.
326 326
327Since it is impossible to change the length of an existing string, it is 327Since it is impossible to change the length of an existing string, it is
328an error if @var{obj} doesn't fit within @var{string}'s actual length, 328an error if @var{obj} doesn't fit within @var{string}'s actual length,
329of if any new character requires a different number of bytes from the 329or if any new character requires a different number of bytes from the
330character currently present at that point in @var{string}. 330character 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
353This function returns @code{t} if the characters of the two strings 353This function returns @code{t} if the characters of the two strings
354match exactly; case is significant. 354match exactly.
355Case 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
523This function returns a string consisting of the printed 524This function returns a string consisting of the printed base-ten
524representation of @var{number}, which may be an integer or a floating 525representation of @var{number}, which may be an integer or a floating
525point number. The value starts with a sign if the argument is 526point number. The value starts with a sign if the argument is
526negative. 527negative.
@@ -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
595computed values at various places in a constant string. This string 596computed values at various places in a constant string. This constant string
596controls how the other values are printed as well as where they appear; 597controls how the other values are printed, as well as where they appear;
597it is called a @dfn{format string}. 598it 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
627format specifications correspond with successive values from 628format 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}
629uses the first such value, the second format specification uses the 630uses the first such value, the second format specification uses the
630second such value, and so on. Any extra format specifications (those 631second such value, and so on. Any extra format specifications (those
@@ -686,7 +687,7 @@ using either exponential notation or decimal-point notation, whichever
686is shorter. 687is shorter.
687 688
688@item %% 689@item %%
689A single @samp{%} is placed in the string. This format specification is 690Replace the specification with a single @samp{%}. This format specification is
690unusual in that it does not use a value. For example, @code{(format "%% 691unusual 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
858This function capitalizes the initials of the words in @var{string}. 859This function capitalizes the initials of the words in @var{string},
859without altering any letters other than the initials. It returns a new 860without altering any letters other than the initials. It returns a new
860string whose contents are a copy of @var{string}, in which each word has 861string whose contents are a copy of @var{string}, in which each word has
861been converted to upper case. 862had its initial letter converted to upper case.
862 863
863The definition of a word is any sequence of consecutive characters that 864The definition of a word is any sequence of consecutive characters that
864are assigned to the word constituent syntax class in the current syntax 865are 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
163Anything which acts like a temporary mode or state which the user can 163Anything which acts like a temporary mode or state which the user can
164enter and leave should define @kbd{@key{ESC} @key{ESC}} of 164enter 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
167For a state which accepts ordinary Emacs commands, or more generally any 167For a state which accepts ordinary Emacs commands, or more generally any