[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] /srv/bzr/emacs/trunk r106030: * doc/emacs/mini.texi (Compl
From: |
Chong Yidong |
Subject: |
[Emacs-diffs] /srv/bzr/emacs/trunk r106030: * doc/emacs/mini.texi (Completion Options): Document completion-cycle-threshold. |
Date: |
Sat, 08 Oct 2011 15:17:34 -0400 |
User-agent: |
Bazaar (2.3.1) |
------------------------------------------------------------
revno: 106030
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Sat 2011-10-08 15:17:34 -0400
message:
* doc/emacs/mini.texi (Completion Options): Document
completion-cycle-threshold.
modified:
doc/emacs/ChangeLog
doc/emacs/mini.texi
etc/NEWS
=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog 2011-10-08 17:29:45 +0000
+++ b/doc/emacs/ChangeLog 2011-10-08 19:17:34 +0000
@@ -1,3 +1,7 @@
+2011-10-08 Chong Yidong <address@hidden>
+
+ * mini.texi (Completion Options): Add completion-cycle-threshold.
+
2011-10-08 Eli Zaretskii <address@hidden>
* mule.texi (Bidirectional Editing): Correct some inaccuracies.
=== modified file 'doc/emacs/mini.texi'
--- a/doc/emacs/mini.texi 2011-10-08 15:08:50 +0000
+++ b/doc/emacs/mini.texi 2011-10-08 19:17:34 +0000
@@ -462,24 +462,26 @@
address@hidden The default value is @code{nil} on systems that have
case-sensitive file-names, such as GNU/Linux; it is address@hidden on
systems that have case-insensitive file-names, such as Microsoft
-Windows. When completing buffer names, case is significant by
-default; to ignore case differences, change the variable
address@hidden to a address@hidden value.
+Windows. When completing buffer names, case differences are ignored
+if the variable @code{read-buffer-completion-ignore-case} is
address@hidden; the default is @code{nil}.
@vindex completion-ignored-extensions
@cindex ignored file names, in completion
When completing file names, Emacs usually omits certain alternatives
-that are considered unlikely to be chosen. The variable
address@hidden contains a list of strings; a
-file name ending in any of those strings is ignored as a completion
-alternative. The standard value of this variable has several elements
-including @code{".o"}, @code{".elc"}, and @code{"~"}. For example, if
-a directory contains @samp{foo.c} and @samp{foo.elc}, @samp{foo}
+that are considered unlikely to be chosen, as determined by the list
+variable @code{completion-ignored-extensions}. Each element in the
+list should be a string; any file name ending in such a string is
+ignored as a completion alternative. Any element ending in a slash
+(@file{/}) represents a subdirectory name. The standard value of
address@hidden has several elements including
address@hidden".o"}, @code{".elc"}, and @code{"~"}. For example, if a
+directory contains @samp{foo.c} and @samp{foo.elc}, @samp{foo}
completes to @samp{foo.c}. However, if @emph{all} possible
completions end in ``ignored'' strings, they are not ignored: in the
-previous example, @samp{foo.e} completes to @samp{foo.elc}.
-Displaying the completion list disregards
address@hidden; all completions are listed.
+previous example, @samp{foo.e} completes to @samp{foo.elc}. Emacs
+disregards @code{completion-ignored-extensions} when showing
+completion alternatives in the completion list.
@vindex completion-auto-help
If @code{completion-auto-help} is set to @code{nil}, the completion
@@ -490,11 +492,18 @@
echoes @samp{Next char not unique}; the second @key{TAB} does the
completion list buffer.
- If an element of @code{completion-ignored-extensions} ends in a
-slash (@file{/}), it's a subdirectory name; that directory and its
-contents are ignored. Elements of
address@hidden that do not end in a slash are
-ordinary file names.
address@hidden completion-cycle-threshold
+ If @code{completion-cycle-threshold} is address@hidden, completion
+commands can ``cycle'' through completion alternatives. Normally, if
+there is more than one completion alternative for the text in the
+minibuffer, a completion command completes up to the longest common
+substring. If you change @code{completion-cycle-threshold} to
address@hidden, the completion command instead completes to the first of
+those completion alternatives; each subsequent invocation of the
+completion command replaces that with the next completion alternative,
+in a cyclic manner. If you give @code{completion-cycle-threshold} a
+numeric value @var{n}, completion commands switch to this cycling
+behavior only when there are fewer than @var{n} alternatives.
@cindex Icomplete mode
@findex icomplete-mode
=== modified file 'etc/NEWS'
--- a/etc/NEWS 2011-10-08 16:37:46 +0000
+++ b/etc/NEWS 2011-10-08 19:17:34 +0000
@@ -103,7 +103,7 @@
---
*** Completion in a non-minibuffer now tries to detect the end of completion
and pops down the *Completions* buffer accordingly.
-
++++
*** Completion can cycle, depending on completion-cycle-threshold.
+++
*** New completion style `substring'.
@@ -112,13 +112,6 @@
*** Completion of buffers now uses substring completion by default.
-*** `completing-read' can be customized using the new variable
-`completing-read-function'.
-
-*** minibuffer-local-filename-must-match-map is not used any more.
-Instead, the bindings in minibuffer-local-filename-completion-map are combined
-with minibuffer-local-must-match-map.
-
** Mail changes
The default of `send-mail-function' is now `sendmail-query-once',
@@ -1133,6 +1126,13 @@
- `display-sort-function' to specify how to sort entries in *Completions*.
- `cycle-sort-function' to specify how to sort entries when cycling.
+*** minibuffer-local-filename-must-match-map is not used any more.
+Instead, the bindings in minibuffer-local-filename-completion-map are
+combined with minibuffer-local-must-match-map.
+
+*** New variable `completing-read-function' allows overriding the
+behavior of `completing-read'.
+
** `glyphless-char-display' can now distinguish between graphical and
text terminal display, via a char-table entry that is a cons cell.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] /srv/bzr/emacs/trunk r106030: * doc/emacs/mini.texi (Completion Options): Document completion-cycle-threshold.,
Chong Yidong <=