X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=info%2Flispref.info-29;h=9e728eb979ad4a4dc06bfb82d6096780d16f6fe4;hb=b5f26301ee1ad7dbc9ad1c22e5b8564b5161d9ad;hp=d9b742301f47069f0ccf5cf734ae625a66d7dbed;hpb=1d9bc86590766427e2431876a50d78206a99edd5;p=chise%2Fxemacs-chise.git diff --git a/info/lispref.info-29 b/info/lispref.info-29 index d9b7423..9e728eb 100644 --- a/info/lispref.info-29 +++ b/info/lispref.info-29 @@ -1,4 +1,4 @@ -This is ../info/lispref.info, produced by makeinfo version 4.0 from +This is ../info/lispref.info, produced by makeinfo version 4.0b from lispref/lispref.texi. INFO-DIR-SECTION XEmacs Editor @@ -50,85 +50,6 @@ may be included in a translation approved by the Free Software Foundation instead of in the original English.  -File: lispref.info, Node: List Motion, Next: Skipping Characters, Prev: Screen Lines, Up: Motion - -Moving over Balanced Expressions --------------------------------- - - Here are several functions concerned with balanced-parenthesis -expressions (also called "sexps" in connection with moving across them -in XEmacs). The syntax table controls how these functions interpret -various characters; see *Note Syntax Tables::. *Note Parsing -Expressions::, for lower-level primitives for scanning sexps or parts of -sexps. For user-level commands, see *Note Lists and Sexps: -(emacs)Lists and Sexps. - - - Command: forward-list &optional arg - This function moves forward across ARG balanced groups of - parentheses. (Other syntactic entities such as words or paired - string quotes are ignored.) ARG defaults to 1 if omitted. If ARG - is negative, move backward across that many groups of parentheses. - - - Command: backward-list &optional count - This function moves backward across COUNT balanced groups of - parentheses. (Other syntactic entities such as words or paired - string quotes are ignored.) COUNT defaults to 1 if omitted. If - COUNT is negative, move forward across that many groups of - parentheses. - - - Command: up-list &optional count - This function moves forward out of COUNT levels of parentheses. A - negative argument means move backward but still to a less deep - spot. - - - Command: down-list &optional count - This function moves forward into COUNT levels of parentheses. A - negative argument means move backward but still go deeper in - parentheses (-COUNT levels). - - - Command: forward-sexp &optional count - This function moves forward across COUNT balanced expressions. - Balanced expressions include both those delimited by parentheses - and other kinds, such as words and string constants. COUNT - defaults to 1 if omitted. If COUNT is negative, move backward - across that many balanced expressions. For example, - - ---------- Buffer: foo ---------- - (concat-!- "foo " (car x) y z) - ---------- Buffer: foo ---------- - - (forward-sexp 3) - => nil - - ---------- Buffer: foo ---------- - (concat "foo " (car x) y-!- z) - ---------- Buffer: foo ---------- - - - Command: backward-sexp &optional count - This function moves backward across COUNT balanced expressions. - COUNT defaults to 1 if omitted. If COUNT is negative, move - forward across that many balanced expressions. - - - Command: beginning-of-defun &optional count - This function moves back to the COUNTth beginning of a defun. If - COUNT is negative, this actually moves forward, but it still moves - to the beginning of a defun, not to the end of one. COUNT - defaults to 1 if omitted. - - - Command: end-of-defun &optional count - This function moves forward to the COUNTth end of a defun. If - COUNT is negative, this actually moves backward, but it still - moves to the end of a defun, not to the beginning of one. COUNT - defaults to 1 if omitted. - - - User Option: defun-prompt-regexp - If non-`nil', this variable holds a regular expression that - specifies what text can appear before the open-parenthesis that - starts a defun. That is to say, a defun begins on a line that - starts with a match for this regular expression, followed by a - character with open-parenthesis syntax. - - File: lispref.info, Node: Skipping Characters, Prev: List Motion, Up: Motion Skipping Characters @@ -1166,3 +1087,75 @@ operated on the current buffer.) The end of the buffer (or of its accessible portion) is always considered the end of a line. + +File: lispref.info, Node: Buffer Contents, Next: Comparing Text, Prev: Near Point, Up: Text + +Examining Buffer Contents +========================= + + This section describes two functions that allow a Lisp program to +convert any portion of the text in the buffer into a string. + + - Function: buffer-substring start end &optional buffer + - Function: buffer-string start end &optional buffer + These functions are equivalent and return a string containing a + copy of the text of the region defined by positions START and END + in the buffer. If the arguments are not positions in the + accessible portion of the buffer, `buffer-substring' signals an + `args-out-of-range' error. If optional argument BUFFER is `nil', + the current buffer is assumed. + + If the region delineated by START and END contains duplicable + extents, they will be remembered in the string. *Note Duplicable + Extents::. + + It is not necessary for START to be less than END; the arguments + can be given in either order. But most often the smaller argument + is written first. + + ---------- Buffer: foo ---------- + This is the contents of buffer foo + + ---------- Buffer: foo ---------- + + (buffer-substring 1 10) + => "This is t" + (buffer-substring (point-max) 10) + => "he contents of buffer foo + " + + +File: lispref.info, Node: Comparing Text, Next: Insertion, Prev: Buffer Contents, Up: Text + +Comparing Text +============== + + This function lets you compare portions of the text in a buffer, +without copying them into strings first. + + - Function: compare-buffer-substrings buffer1 start1 end1 buffer2 + start2 end2 + This function lets you compare two substrings of the same buffer + or two different buffers. The first three arguments specify one + substring, giving a buffer and two positions within the buffer. + The last three arguments specify the other substring in the same + way. You can use `nil' for BUFFER1, BUFFER2, or both to stand for + the current buffer. + + The value is negative if the first substring is less, positive if + the first is greater, and zero if they are equal. The absolute + value of the result is one plus the index of the first differing + characters within the substrings. + + This function ignores case when comparing characters if + `case-fold-search' is non-`nil'. It always ignores text + properties. + + Suppose the current buffer contains the text `foobarbar + haha!rara!'; then in this example the two substrings are `rbar ' + and `rara!'. The value is 2 because the first substring is greater + at the second character. + + (compare-buffer-substring nil 6 11 nil 16 21) + => 2 +