[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] trunk r115899: More doc updates.
From: |
Chong Yidong |
Subject: |
[Emacs-diffs] trunk r115899: More doc updates. |
Date: |
Tue, 07 Jan 2014 04:42:32 +0000 |
User-agent: |
Bazaar (2.6b2) |
------------------------------------------------------------
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))
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] trunk r115899: More doc updates.,
Chong Yidong <=