# HG changeset patch # User Karl Heuer # Date 929603420 0 # Node ID 78aaef52e28fe79be4c036edd12daa52bc8cc0d7 # Parent 0d593aa15c0f5cd725a44da9b544880efa921428 *** empty log message *** diff -r 0d593aa15c0f -r 78aaef52e28f lispref/calendar.texi --- a/lispref/calendar.texi Thu Jun 17 05:35:21 1999 +0000 +++ b/lispref/calendar.texi Thu Jun 17 07:10:20 1999 +0000 @@ -653,8 +653,8 @@ As with simple diary display, you can print a hard copy of the buffer with @code{print-diary-entries}. To print a hard copy of a day-by-day -diary for a week by positioning point on Sunday of that week, type -@kbd{7 d} and then do @kbd{M-x print-diary-entries}. As usual, the +diary for a week, position point on Sunday of that week, type +@kbd{7 d}, and then do @kbd{M-x print-diary-entries}. As usual, the inclusion of the holidays slows down the display slightly; you can speed things up by setting the variable @code{holidays-in-diary-buffer} to @code{nil}. diff -r 0d593aa15c0f -r 78aaef52e28f lispref/debugging.texi --- a/lispref/debugging.texi Thu Jun 17 05:35:21 1999 +0000 +++ b/lispref/debugging.texi Thu Jun 17 07:10:20 1999 +0000 @@ -164,7 +164,7 @@ When a program loops infinitely and fails to return, your first problem is to stop the loop. On most operating systems, you can do this -with @kbd{C-g}, which causes quit. +with @kbd{C-g}, which causes a @dfn{quit}. Ordinary quitting gives no information about why the program was looping. To get more information, you can set the variable diff -r 0d593aa15c0f -r 78aaef52e28f lispref/strings.texi --- a/lispref/strings.texi Thu Jun 17 05:35:21 1999 +0000 +++ b/lispref/strings.texi Thu Jun 17 07:10:20 1999 +0000 @@ -13,8 +13,8 @@ A string in Emacs Lisp is an array that contains an ordered sequence of characters. Strings are used as names of symbols, buffers, and -files, to send messages to users, to hold text being copied between -buffers, and for many other purposes. Because strings are so important, +files; to send messages to users; to hold text being copied between +buffers; and for many other purposes. Because strings are so important, Emacs Lisp has many functions expressly for manipulating them. Emacs Lisp programs use strings more often than individual characters. @@ -36,8 +36,7 @@ @node String Basics @section String and Character Basics - Strings in Emacs Lisp are arrays that contain an ordered sequence of -characters. Characters are represented in Emacs Lisp as integers; + Characters are represented in Emacs Lisp as integers; whether an integer is a character or not is determined only by how it is used. Thus, strings really contain integers. @@ -55,9 +54,9 @@ There are two text representations for non-@sc{ASCII} characters in Emacs strings (and in buffers): unibyte and multibyte (@pxref{Text Representations}). @sc{ASCII} characters always occupy one byte in a -string; in fact, there is no real difference between the two -representation for a string which is all @sc{ASCII}. For most Lisp -programming, you don't need to be concerned with these two +string; in fact, when a string is all @sc{ASCII}, there is no real +difference between the unibyte and multibyte representations. +For most Lisp programming, you don't need to be concerned with these two representations. Sometimes key sequences are represented as strings. When a string is @@ -88,7 +87,7 @@ copy them into buffers. @xref{Character Type}, and @ref{String Type}, for information about the syntax of characters and strings. @xref{Non-ASCII Characters}, for functions to convert between text -representations and encode and decode character codes. +representations and to encode and decode character codes. @node Predicates for Strings @section The Predicates for Strings @@ -275,8 +274,9 @@ Split @var{string} into substrings in between matches for the regular expression @var{separators}. Each match for @var{separators} defines a splitting point; the substrings between the splitting points are made -into a list, which is the value. If @var{separators} is @code{nil} (or -omitted), the default is @code{"[ \f\t\n\r\v]+"}. +into a list, which is the value returned by @code{split-string}. +If @var{separators} is @code{nil} (or omitted), +the default is @code{"[ \f\t\n\r\v]+"}. For example, @@ -326,7 +326,7 @@ Since it is impossible to change the length of an existing string, it is an error if @var{obj} doesn't fit within @var{string}'s actual length, -of if any new character requires a different number of bytes from the +or if any new character requires a different number of bytes from the character currently present at that point in @var{string}. @end defun @@ -351,7 +351,8 @@ @defun string= string1 string2 This function returns @code{t} if the characters of the two strings -match exactly; case is significant. +match exactly. +Case is always significant, regardless of @code{case-fold-search}. @example (string= "abc" "abc") @@ -520,7 +521,7 @@ @defun number-to-string number @cindex integer to string @cindex integer to decimal -This function returns a string consisting of the printed +This function returns a string consisting of the printed base-ten representation of @var{number}, which may be an integer or a floating point number. The value starts with a sign if the argument is negative. @@ -592,8 +593,8 @@ @cindex strings, formatting them @dfn{Formatting} means constructing a string by substitution of -computed values at various places in a constant string. This string -controls how the other values are printed as well as where they appear; +computed values at various places in a constant string. This constant string +controls how the other values are printed, as well as where they appear; it is called a @dfn{format string}. Formatting is often useful for computing messages to be displayed. In @@ -624,7 +625,7 @@ @end example If @var{string} contains more than one format specification, the -format specifications correspond with successive values from +format specifications correspond to successive values from @var{objects}. Thus, the first format specification in @var{string} uses the first such value, the second format specification uses the second such value, and so on. Any extra format specifications (those @@ -686,7 +687,7 @@ is shorter. @item %% -A single @samp{%} is placed in the string. This format specification is +Replace the specification with a single @samp{%}. This format specification is unusual in that it does not use a value. For example, @code{(format "%% %d" 30)} returns @code{"% 30"}. @end table @@ -855,10 +856,10 @@ @end defun @defun upcase-initials string -This function capitalizes the initials of the words in @var{string}. +This function capitalizes the initials of the words in @var{string}, without altering any letters other than the initials. It returns a new string whose contents are a copy of @var{string}, in which each word has -been converted to upper case. +had its initial letter converted to upper case. The definition of a word is any sequence of consecutive characters that are assigned to the word constituent syntax class in the current syntax diff -r 0d593aa15c0f -r 78aaef52e28f lispref/tips.texi --- a/lispref/tips.texi Thu Jun 17 05:35:21 1999 +0000 +++ b/lispref/tips.texi Thu Jun 17 07:10:20 1999 +0000 @@ -161,7 +161,7 @@ @item Anything which acts like a temporary mode or state which the user can -enter and leave should define @kbd{@key{ESC} @key{ESC}} of +enter and leave should define @kbd{@key{ESC} @key{ESC}} or @kbd{@key{ESC} @key{ESC} @key{ESC}} as a way to escape. For a state which accepts ordinary Emacs commands, or more generally any