aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNick Drozd2019-08-29 18:36:50 -0500
committerEli Zaretskii2019-08-30 10:23:17 +0300
commit462be72f41580a3137e8f4f1e48580ac6bcc371f (patch)
tree0145110abf73940d90a53c8d97a26726845155c3
parent51cf9161ceaa613a95f714e56fb793dcf62d1da6 (diff)
downloademacs-462be72f41580a3137e8f4f1e48580ac6bcc371f.tar.gz
emacs-462be72f41580a3137e8f4f1e48580ac6bcc371f.zip
Minor copyedits in ido.texi
* doc/misc/ido.texi (Overview) (Interactive Substring Matching, Prefix Matching) (Regexp Matching, Hidden Buffers and Files) (Changing List Order, Find File At Point, Misc) (All Matching, Replacement): Fix wording, markup and punctuation. (Bug#37225)
-rw-r--r--doc/misc/ido.texi56
1 files changed, 28 insertions, 28 deletions
diff --git a/doc/misc/ido.texi b/doc/misc/ido.texi
index 29a204cf9e2..a787b743430 100644
--- a/doc/misc/ido.texi
+++ b/doc/misc/ido.texi
@@ -108,7 +108,7 @@ This document describes a set of features that can interactively do
108things with buffers and files. All the features are described here 108things with buffers and files. All the features are described here
109in detail. 109in detail.
110 110
111The @dfn{Ido} package can let you switch between buffers and visit 111The @dfn{Ido} package lets you switch between buffers and visit
112files and directories with a minimum of keystrokes. It is a superset 112files and directories with a minimum of keystrokes. It is a superset
113of Iswitchb, the interactive buffer switching package by Stephen 113of Iswitchb, the interactive buffer switching package by Stephen
114Eglen. 114Eglen.
@@ -211,7 +211,7 @@ do with various kinds of @emph{matching}: among buffers, files, and directories.
211 211
212@noindent 212@noindent
213As you type in a substring, the list of buffers or files currently 213As you type in a substring, the list of buffers or files currently
214matching the substring are displayed as you type. The list is 214matching the substring is displayed as you type. The list is
215ordered so that the most recent buffers or files visited come at 215ordered so that the most recent buffers or files visited come at
216the start of the list. 216the start of the list.
217 217
@@ -240,13 +240,13 @@ If you then press @kbd{2}:
240Buffer: 2[3]@{123456 | 123@} 240Buffer: 2[3]@{123456 | 123@}
241@end example 241@end example
242 242
243The list in @{...@} are the matching buffers, most recent first 243The items listed in @{...@} are the matching buffers, most recent
244(buffers visible in the current frame are put at the end of the list 244first (buffers visible in the current frame are put at the end of the
245by default). At any time you can select the item at the head of the 245list by default). At any time you can select the item at the head of
246list by pressing @key{RET}. You can also put the first element at the 246the list by pressing @key{RET}. You can also put the first element at
247end of the list by pressing @kbd{C-s} or @kbd{<right>}, or bring the 247the end of the list by pressing @kbd{C-s} or @key{RIGHT}, or bring
248last element to the head of the list by pressing @kbd{C-r} or 248the last element to the head of the list by pressing @kbd{C-r} or
249@kbd{<left>}. 249@key{LEFT}.
250 250
251@findex ido-complete 251@findex ido-complete
252The item in [...] indicates what can be added to your input by 252The item in [...] indicates what can be added to your input by
@@ -287,7 +287,7 @@ Buffer: 234a [No match]
287There are no matching buffers. If you press @key{RET} or @key{TAB}, 287There are no matching buffers. If you press @key{RET} or @key{TAB},
288you can be prompted to create a new buffer called @file{234a}. 288you can be prompted to create a new buffer called @file{234a}.
289 289
290Of course, where this function comes in really useful is when you can 290Of course, where this function really comes in handy is when you can
291specify the buffer using only a few keystrokes. In the above example, 291specify the buffer using only a few keystrokes. In the above example,
292the quickest way to get to the @file{123456} file would be just to 292the quickest way to get to the @file{123456} file would be just to
293type @kbd{4} and then @key{RET} (assuming there isn't any newer buffer 293type @kbd{4} and then @key{RET} (assuming there isn't any newer buffer
@@ -305,7 +305,7 @@ In addition to scrolling through the list using @kbd{<right>} and
305@kbd{<left>}, you can use @kbd{<up>} and @kbd{<down>} to quickly 305@kbd{<left>}, you can use @kbd{<up>} and @kbd{<down>} to quickly
306scroll the list to the next or previous subdirectory. 306scroll the list to the next or previous subdirectory.
307 307
308To go down into a subdirectory, and continue the file selection on 308To go down into a subdirectory and continue the file selection on
309the files in that directory, simply move the directory to the head 309the files in that directory, simply move the directory to the head
310of the list and hit @key{RET}. 310of the list and hit @key{RET}.
311 311
@@ -366,9 +366,9 @@ If for some reason you cannot specify the proper file using
366@noindent 366@noindent
367The standard way of completion with *nix shells and Emacs is to insert 367The standard way of completion with *nix shells and Emacs is to insert
368a @dfn{prefix} and then hitting @key{TAB} (or another completion key). 368a @dfn{prefix} and then hitting @key{TAB} (or another completion key).
369Cause of this behavior has become second nature to a lot of Emacs 369Because this behavior has become second nature to a lot of Emacs
370users Ido offers in addition to the default substring matching method 370users, Ido offers, in addition to the default substring matching method
371(look above) also the prefix matching method. The kind of matching is 371(see above), also the prefix matching method. The kind of matching is
372the only difference to the description of the substring matching 372the only difference to the description of the substring matching
373above. 373above.
374 374
@@ -425,7 +425,7 @@ matching. The value of this user option can be toggled within
425ido-mode using @code{ido-toggle-regexp}. 425ido-mode using @code{ido-toggle-regexp}.
426@end defopt 426@end defopt
427 427
428@strong{Please notice:} Ido-style completion is inhibited when you 428@strong{Please note:} Ido-style completion is inhibited when you
429enable regexp matching. 429enable regexp matching.
430 430
431@node Highlighting 431@node Highlighting
@@ -438,21 +438,21 @@ The highlighting of matching items is controlled via
438@code{ido-use-faces}. The faces used are @code{ido-first-match}, 438@code{ido-use-faces}. The faces used are @code{ido-first-match},
439@code{ido-only-match} and @code{ido-subdir}. 439@code{ido-only-match} and @code{ido-subdir}.
440 440
441Coloring of the matching item was suggested by Carsten Dominik. 441Coloring of the matching items was suggested by Carsten Dominik.
442 442
443@node Hidden Buffers and Files 443@node Hidden Buffers and Files
444@chapter Hidden Buffers and Files 444@chapter Hidden Buffers and Files
445@cindex hidden buffers and files 445@cindex hidden buffers and files
446 446
447Normally, Ido does not include hidden buffers (whose name starts with 447Normally, Ido does not include hidden buffers (whose names start with
448a space) and hidden files and directories (whose name starts with 448a space) and hidden files and directories (whose names start with
449@samp{.}) in the list of possible completions. However, if the 449@file{.}) in the list of possible completions. However, if the
450substring you enter does not match any of the visible buffers or 450substring you enter does not match any of the visible buffers or
451files, Ido will automatically look for completions among the hidden 451files, Ido will automatically look for completions among the hidden
452buffers or files. 452buffers or files.
453 453
454@findex ido-toggle-ignore 454@findex ido-toggle-ignore
455You can toggle display of the hidden buffers and files with @kbd{C-a} 455You can toggle the display of hidden buffers and files with @kbd{C-a}
456(@code{ido-toggle-ignore}). 456(@code{ido-toggle-ignore}).
457 457
458@c @deffn Command ido-toggle-ignore 458@c @deffn Command ido-toggle-ignore
@@ -525,7 +525,7 @@ deleting or rearranging elements.)
525 525
526@noindent 526@noindent
527Find File At Point, also known generally as ``ffap'', is an 527Find File At Point, also known generally as ``ffap'', is an
528intelligent system for opening files, and URLs. 528intelligent system for opening files and URLs.
529 529
530The following expression will make Ido guess the context: 530The following expression will make Ido guess the context:
531 531
@@ -552,7 +552,7 @@ a URL at point. If found, call @code{find-file-at-point} to visit it.
552 552
553@noindent 553@noindent
554Ido is capable of ignoring buffers, directories, files and extensions 554Ido is capable of ignoring buffers, directories, files and extensions
555using regular expression. 555using regular expressions.
556 556
557@defopt ido-ignore-buffers 557@defopt ido-ignore-buffers
558This variable takes a list of regular expressions for buffers to 558This variable takes a list of regular expressions for buffers to
@@ -590,7 +590,7 @@ Now you can customize @code{completion-ignored-extensions} as well.
590Go ahead and add all the useless object files, backup files, shared 590Go ahead and add all the useless object files, backup files, shared
591library files and other computing flotsam you don't want Ido to show. 591library files and other computing flotsam you don't want Ido to show.
592 592
593@strong{Please notice:} Ido will still complete the ignored elements 593@strong{Note:} Ido will still complete the ignored elements
594if it would otherwise not show any other matches. So if you type out 594if it would otherwise not show any other matches. So if you type out
595the name of an ignored file, Ido will still let you open it just fine. 595the name of an ignored file, Ido will still let you open it just fine.
596 596
@@ -718,7 +718,7 @@ packages.
718After @kbd{C-x b} (@code{ido-switch-buffer}), the buffer at the head 718After @kbd{C-x b} (@code{ido-switch-buffer}), the buffer at the head
719of the list can be killed by pressing @kbd{C-k}. If the buffer needs 719of the list can be killed by pressing @kbd{C-k}. If the buffer needs
720saving, you will be queried before the buffer is killed. @kbd{C-S-b} 720saving, you will be queried before the buffer is killed. @kbd{C-S-b}
721buries the buffer at the head of the list. 721buries the buffer at the end of the list.
722 722
723Likewise, after @kbd{C-x C-f}, you can delete (i.e., physically 723Likewise, after @kbd{C-x C-f}, you can delete (i.e., physically
724remove) the file at the head of the list with @kbd{C-k}. You will 724remove) the file at the head of the list with @kbd{C-k}. You will
@@ -726,8 +726,8 @@ always be asked for confirmation before deleting the file.
726 726
727If you enter @kbd{C-x b} to switch to a buffer visiting a given file, 727If you enter @kbd{C-x b} to switch to a buffer visiting a given file,
728and you find that the file you are after is not in any buffer, you can 728and you find that the file you are after is not in any buffer, you can
729press @kbd{C-f} to immediately drop into @code{ido-find-file}. And 729press @kbd{C-f} to immediately drop into @code{ido-find-file}. You
730you can switch back to buffer selection with @kbd{C-b}. 730can switch back to buffer selection with @kbd{C-b}.
731 731
732@c @deffn Command ido-magic-forward-char 732@c @deffn Command ido-magic-forward-char
733@c @deffn Command ido-magic-backward-char 733@c @deffn Command ido-magic-backward-char
@@ -759,7 +759,7 @@ want Ido to behave differently from the default minibuffer resizing
759behavior, set the variable @code{ido-max-window-height}. 759behavior, set the variable @code{ido-max-window-height}.
760 760
761Also, to improve the responsiveness of Ido, the maximum number of 761Also, to improve the responsiveness of Ido, the maximum number of
762matching items is limited to 12, but you can increase or removed this 762matching items is limited to 12, but you can increase or remove this
763limit via the @code{ido-max-prospects} user option. 763limit via the @code{ido-max-prospects} user option.
764 764
765@c @defopt ido-max-prospects 765@c @defopt ido-max-prospects
@@ -774,7 +774,7 @@ this separate buffer.
774 774
775@noindent 775@noindent
776@code{ido-read-buffer} and @code{ido-read-file-name} have been written 776@code{ido-read-buffer} and @code{ido-read-file-name} have been written
777to be drop in replacements for the normal buffer and file name reading 777to be drop-in replacements for the normal buffer and file name reading
778functions @code{read-buffer} and @code{read-file-name}. 778functions @code{read-buffer} and @code{read-file-name}.
779 779
780To use ido for all buffer and file selections in Emacs, customize the 780To use ido for all buffer and file selections in Emacs, customize the