[Emacs-diffs] trunk r115899: More doc updates.

[Chong Yidong]

------------------------------------------------------------
revno: 115899
revision-id: address@hidden
parent: address@hidden
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Tue 2014-01-07 12:36:52 +0800
message:
  More doc updates.
  
  * doc/emacs/search.texi (Special Isearch): Document C-x 8 RET in isearch.
  (Word Search): Document incremental word search changes.
  (Isearch Yank): Document M-s C-e with a prefix argument.
  
  * doc/lispref/files.texi (Changing Files): Document copy-file changes.
  
  * lisp/isearch.el (isearch-yank-char, isearch-yank-word)
  (isearch-yank-line): Doc fix.
modified:
  doc/emacs/ChangeLog            changelog-20091113204419-o5vbwnq5f7feedwu-6227
  doc/emacs/search.texi          
search.texi-20091113204419-o5vbwnq5f7feedwu-6276
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/files.texi         files.texi-20091113204419-o5vbwnq5f7feedwu-6179
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1
  lisp/ChangeLog                 changelog-20091113204419-o5vbwnq5f7feedwu-1432
  lisp/isearch.el                isearch.el-20091113204419-o5vbwnq5f7feedwu-486

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2014-01-07 01:46:23 +0000
+++ b/doc/emacs/ChangeLog       2014-01-07 04:36:52 +0000
@@ -1,3 +1,9 @@
+2014-01-07  Chong Yidong  <address@hidden>
+
+       * search.texi (Special Isearch): Document C-x 8 RET in isearch.
+       (Word Search): Document incremental word search changes.
+       (Isearch Yank): Document M-s C-e with a prefix argument.
+
 2014-01-07  Glenn Morris  <address@hidden>
 
        * cal-xtra.texi (Calendar Customizing):

=== modified file 'doc/emacs/search.texi'
--- a/doc/emacs/search.texi     2014-01-01 07:43:34 +0000
+++ b/doc/emacs/search.texi     2014-01-07 04:36:52 +0000
@@ -229,12 +229,14 @@
 @samp{foo  bar}, @samp{foo   bar}, and so on (but not @samp{foobar}).
 More precisely, Emacs matches each sequence of space characters in the
 search string to a regular expression specified by the variable
address@hidden  For example, set it to
address@hidden"[[:space:]\n]+"} to make spaces match sequences of newlines as
-well as spaces.  To toggle lax space matching, type @kbd{M-s SPC}
address@hidden  For example, to make spaces match
+sequences of newlines as well as spaces, set it to
address@hidden"[[:space:]\n]+"}.
+
+  To toggle lax space matching, type @kbd{M-s SPC}
 (@code{isearch-toggle-lax-whitespace}).  To disable this feature
 entirely, change @code{search-whitespace-regexp} to @code{nil}; then
-each space in the search string matches exactly one space
+each space in the search string matches exactly one space.
 
   If the search string you entered contains only lower-case letters,
 the search is case-insensitive; as long as an upper-case letter exists
@@ -244,15 +246,29 @@
 
   To search for a newline character, type @kbd{C-j}.
 
-  To search for other control characters, such as @key{control-S},
-quote it by typing @kbd{C-q} first (@pxref{Inserting Text}).  To
-search for address@hidden characters, you can either use
address@hidden and enter its octal code, or use an input method
-(@pxref{Input Methods}).  If an input method is enabled in the current
-buffer when you start the search, you can use it in the search string
-also.  While typing the search string, you can toggle the input method
-with the command @kbd{C-\} (@code{isearch-toggle-input-method}).  You
-can also turn on a non-default input method with @kbd{C-^}
+  To search for address@hidden characters, use one of the
+following methods:
+
address@hidden @bullet
address@hidden
+Type @kbd{C-q}, followed by a non-graphic character or a sequence of
+octal digits.  This adds a character to the search string, similar to
+inserting into a buffer using @kbd{C-q} (@pxref{Inserting Text}).  For
+example, @kbd{C-q C-s} during incremental search adds the
address@hidden character to the search string.
+
address@hidden
+Type @kbd{C-x 8 @key{RET}}, followed by a Unicode name or code-point.
+This adds the specified character into the search string, similar to
+the usual @code{insert-char} command (@pxref{Inserting Text}).
+
address@hidden
+Use an input method (@pxref{Input Methods}).  If an input method is
+enabled in the current buffer when you start the search, you can use
+it in the search string also.  While typing the search string, you can
+toggle the input method with @kbd{C-\}
+(@code{isearch-toggle-input-method}).  You can also turn on a
+non-default input method with @kbd{C-^}
 (@code{isearch-toggle-specified-input-method}), which prompts for the
 name of the input method.  When an input method is active during
 incremental search, the search prompt includes the input method
@@ -268,6 +284,7 @@
 where @var{im} is the mnemonic of the active input method.  Any input
 method you enable during incremental search remains enabled in the
 current buffer afterwards.
address@hidden itemize
 
 @kindex M-% @r{(Incremental search)}
   Typing @kbd{M-%} in incremental search invokes @code{query-replace}
@@ -315,7 +332,8 @@
 @findex isearch-yank-line
   Similarly, @kbd{M-s C-e} (@code{isearch-yank-line}) appends the rest
 of the current line to the search string.  If point is already at the
-end of a line, it appends the next line.
+end of a line, it appends the next line.  With a prefix argument
address@hidden, it appends the next @var{n} lines.
 
   If the search is currently case-insensitive, both @kbd{C-w} and
 @kbd{M-s C-e} convert the text they copy to lower case, so that the
@@ -481,12 +499,13 @@
 @code{word-search-backward} respectively.
 
   Incremental and nonincremental word searches differ slightly in the
-way they find a match.  In a nonincremental word search, the last word
-in the search string must exactly match a whole word.  In an
-incremental word search, the matching is more lax: the last word in
-the search string can match part of a word, so that the matching
-proceeds incrementally as you type.  This additional laxity does not
-apply to the lazy highlight, which always matches whole words.
+way they find a match.  In a nonincremental word search, each word in
+the search string must exactly match a whole word.  In an incremental
+word search, the matching is more lax: while you are typing the search
+string, its first and last words need not match whole words.  This is
+so that the matching can proceed incrementally as you type.  This
+additional laxity does not apply to the lazy highlight, which always
+matches whole words.
 
 @node Symbol Search
 @section Symbol Search

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2014-01-07 02:56:17 +0000
+++ b/doc/lispref/ChangeLog     2014-01-07 04:36:52 +0000
@@ -1,3 +1,7 @@
+2014-01-07  Chong Yidong  <address@hidden>
+
+       * files.texi (Changing Files): Document copy-file changes.
+
 2014-01-07  Glenn Morris  <address@hidden>
 
        * display.texi (Logging Messages): Copyedits re messages-buffer.

=== modified file 'doc/lispref/files.texi'
--- a/doc/lispref/files.texi    2014-01-05 23:36:13 +0000
+++ b/doc/lispref/files.texi    2014-01-07 04:36:52 +0000
@@ -1561,11 +1561,15 @@
 the correct permissions to do so.
 
 If the optional argument @var{preserve-permissions} is address@hidden,
-this function copies the file modes (or ``permissions''), as well as
-its Access Control List and SELinux context (if any).
address@hidden about Files}.  Otherwise, if the destination is
-created its file permission bits are those of the source, masked by
-the default file permissions.
+this function copies the file modes (or ``permissions'') of
address@hidden to @var{newname}, as well as the Access Control List and
+SELinux context (if any).  @xref{Information about Files}.
+
+Otherwise, the file modes of @var{newname} are left unchanged if it is
+an existing file, and set to those of @var{oldname}, masked by the
+default file permissions (see @code{set-default-file-modes} below), if
address@hidden is to be newly created.  The Access Control List or
+SELinux context are not copied over in either case.
 @end deffn
 
 @deffn Command make-symbolic-link filename newname  &optional ok-if-exists
@@ -1636,13 +1640,12 @@
 
 @defun set-default-file-modes mode
 @cindex umask
-This function sets the default file permissions for new files created
-by Emacs and its subprocesses.  Every file created with Emacs
-initially has these permissions, or a subset of them
-(@code{write-region} will not grant execute permissions even if the
-default file permissions allow execution).  On Unix and GNU/Linux, the
-default permissions are given by the bitwise complement of the
-``umask'' value.
+This function sets the default permissions for new files created by
+Emacs and its subprocesses.  Every file created with Emacs initially
+has these permissions, or a subset of them (@code{write-region} will
+not grant execute permissions even if the default file permissions
+allow execution).  On Unix and GNU/Linux, the default permissions are
+given by the bitwise complement of the ``umask'' value.
 
 The argument @var{mode} should be an integer which specifies the
 permissions, similar to @code{set-file-modes} above.  Only the lowest

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2014-01-07 01:50:44 +0000
+++ b/etc/NEWS  2014-01-07 04:36:52 +0000
@@ -702,6 +702,7 @@
 starts a symbol (identifier) incremental search forward with the
 symbol found near point added to the search string initially.
 
++++
 *** `C-x 8 RET' in Isearch mode reads a character by its Unicode name
 and adds it to the search string.
 
@@ -721,10 +722,12 @@
 *** By default, prefix arguments do not now terminate Isearch mode.
 Set `isearch-allow-prefix' to nil to restore old behavior.
 
++++
 *** More Isearch commands accept prefix arguments, namely
 `isearch-printing-char', `isearch-quote-char', `isearch-yank-word',
 `isearch-yank-line'.
 
++++
 *** Word search now matches whitespace at the beginning/end
 of the search string if it contains leading/trailing whitespace.
 In an incremental word search or when using a non-nil LAX argument
@@ -739,7 +742,7 @@
 *** New command `ses-rename-cell' allows assigning names to SES cells.
 
 ** Shell
-
+---
 *** `explicit-bash-args' now always defaults to use --noediting.
 During initialization, Emacs no longer expends a process to decide
 whether it is safe to use Bash's --noediting option.  These days
@@ -971,6 +974,7 @@
 `file-extended-attributes'.  The attributes can be applied to another
 file using `set-file-extended-attributes'.
 
++++
 ** By default `copy-file' no longer copies file permission bits to an
 existing destination; and it sets the file permission bits of a newly
 created destination to those of the source, masked by the default file
@@ -1146,6 +1150,7 @@
 argument GROUP which causes it check for file group too.  This can be
 used in place of the 9th element of `file-attributes'.
 
+---
 *** The function `set-visited-file-modtime' now accepts a 0 or -1
 argument, with the same interpretation as the returned value of
 `visited-file-modtime'.

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2014-01-06 23:34:05 +0000
+++ b/lisp/ChangeLog    2014-01-07 04:36:52 +0000
@@ -1,3 +1,8 @@
+2014-01-07  Chong Yidong  <address@hidden>
+
+       * isearch.el (isearch-yank-char, isearch-yank-word)
+       (isearch-yank-line): Doc fix.
+
 2014-01-06  Stefan Monnier  <address@hidden>
 
        * abbrev.el (define-abbrev): Beware new meaning of fboundp.

=== modified file 'lisp/isearch.el'
--- a/lisp/isearch.el   2014-01-01 07:43:34 +0000
+++ b/lisp/isearch.el   2014-01-07 04:36:52 +0000
@@ -1946,7 +1946,8 @@
     (forward-char arg)))
 
 (defun isearch-yank-char (&optional arg)
-  "Pull next character from buffer into search string."
+  "Pull next character from buffer into search string.
+If optional ARG is non-nil, pull in the next ARG characters."
   (interactive "p")
   (isearch-yank-internal (lambda () (forward-char arg) (point))))
 
@@ -1965,12 +1966,14 @@
        (forward-char 1)) (point))))
 
 (defun isearch-yank-word (&optional arg)
-  "Pull next word from buffer into search string."
+  "Pull next word from buffer into search string.
+If optional ARG is non-nil, pull in the next ARG words."
   (interactive "p")
   (isearch-yank-internal (lambda () (forward-word arg) (point))))
 
 (defun isearch-yank-line (&optional arg)
-  "Pull rest of line from buffer into search string."
+  "Pull rest of line from buffer into search string.
+If optional ARG is non-nil, yank the next ARG lines."
   (interactive "p")
   (isearch-yank-internal
    (lambda () (let ((inhibit-field-text-motion t))