diff options
| author | Nick Drozd | 2019-08-29 18:36:50 -0500 |
|---|---|---|
| committer | Eli Zaretskii | 2019-08-30 10:23:17 +0300 |
| commit | 462be72f41580a3137e8f4f1e48580ac6bcc371f (patch) | |
| tree | 0145110abf73940d90a53c8d97a26726845155c3 | |
| parent | 51cf9161ceaa613a95f714e56fb793dcf62d1da6 (diff) | |
| download | emacs-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.texi | 56 |
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 | |||
| 108 | things with buffers and files. All the features are described here | 108 | things with buffers and files. All the features are described here |
| 109 | in detail. | 109 | in detail. |
| 110 | 110 | ||
| 111 | The @dfn{Ido} package can let you switch between buffers and visit | 111 | The @dfn{Ido} package lets you switch between buffers and visit |
| 112 | files and directories with a minimum of keystrokes. It is a superset | 112 | files and directories with a minimum of keystrokes. It is a superset |
| 113 | of Iswitchb, the interactive buffer switching package by Stephen | 113 | of Iswitchb, the interactive buffer switching package by Stephen |
| 114 | Eglen. | 114 | Eglen. |
| @@ -211,7 +211,7 @@ do with various kinds of @emph{matching}: among buffers, files, and directories. | |||
| 211 | 211 | ||
| 212 | @noindent | 212 | @noindent |
| 213 | As you type in a substring, the list of buffers or files currently | 213 | As you type in a substring, the list of buffers or files currently |
| 214 | matching the substring are displayed as you type. The list is | 214 | matching the substring is displayed as you type. The list is |
| 215 | ordered so that the most recent buffers or files visited come at | 215 | ordered so that the most recent buffers or files visited come at |
| 216 | the start of the list. | 216 | the start of the list. |
| 217 | 217 | ||
| @@ -240,13 +240,13 @@ If you then press @kbd{2}: | |||
| 240 | Buffer: 2[3]@{123456 | 123@} | 240 | Buffer: 2[3]@{123456 | 123@} |
| 241 | @end example | 241 | @end example |
| 242 | 242 | ||
| 243 | The list in @{...@} are the matching buffers, most recent first | 243 | The items listed in @{...@} are the matching buffers, most recent |
| 244 | (buffers visible in the current frame are put at the end of the list | 244 | first (buffers visible in the current frame are put at the end of the |
| 245 | by default). At any time you can select the item at the head of the | 245 | list by default). At any time you can select the item at the head of |
| 246 | list by pressing @key{RET}. You can also put the first element at the | 246 | the list by pressing @key{RET}. You can also put the first element at |
| 247 | end of the list by pressing @kbd{C-s} or @kbd{<right>}, or bring the | 247 | the end of the list by pressing @kbd{C-s} or @key{RIGHT}, or bring |
| 248 | last element to the head of the list by pressing @kbd{C-r} or | 248 | the 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 |
| 252 | The item in [...] indicates what can be added to your input by | 252 | The item in [...] indicates what can be added to your input by |
| @@ -287,7 +287,7 @@ Buffer: 234a [No match] | |||
| 287 | There are no matching buffers. If you press @key{RET} or @key{TAB}, | 287 | There are no matching buffers. If you press @key{RET} or @key{TAB}, |
| 288 | you can be prompted to create a new buffer called @file{234a}. | 288 | you can be prompted to create a new buffer called @file{234a}. |
| 289 | 289 | ||
| 290 | Of course, where this function comes in really useful is when you can | 290 | Of course, where this function really comes in handy is when you can |
| 291 | specify the buffer using only a few keystrokes. In the above example, | 291 | specify the buffer using only a few keystrokes. In the above example, |
| 292 | the quickest way to get to the @file{123456} file would be just to | 292 | the quickest way to get to the @file{123456} file would be just to |
| 293 | type @kbd{4} and then @key{RET} (assuming there isn't any newer buffer | 293 | type @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 |
| 306 | scroll the list to the next or previous subdirectory. | 306 | scroll the list to the next or previous subdirectory. |
| 307 | 307 | ||
| 308 | To go down into a subdirectory, and continue the file selection on | 308 | To go down into a subdirectory and continue the file selection on |
| 309 | the files in that directory, simply move the directory to the head | 309 | the files in that directory, simply move the directory to the head |
| 310 | of the list and hit @key{RET}. | 310 | of 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 |
| 367 | The standard way of completion with *nix shells and Emacs is to insert | 367 | The standard way of completion with *nix shells and Emacs is to insert |
| 368 | a @dfn{prefix} and then hitting @key{TAB} (or another completion key). | 368 | a @dfn{prefix} and then hitting @key{TAB} (or another completion key). |
| 369 | Cause of this behavior has become second nature to a lot of Emacs | 369 | Because this behavior has become second nature to a lot of Emacs |
| 370 | users Ido offers in addition to the default substring matching method | 370 | users, 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 |
| 372 | the only difference to the description of the substring matching | 372 | the only difference to the description of the substring matching |
| 373 | above. | 373 | above. |
| 374 | 374 | ||
| @@ -425,7 +425,7 @@ matching. The value of this user option can be toggled within | |||
| 425 | ido-mode using @code{ido-toggle-regexp}. | 425 | ido-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 |
| 429 | enable regexp matching. | 429 | enable 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 | ||
| 441 | Coloring of the matching item was suggested by Carsten Dominik. | 441 | Coloring 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 | ||
| 447 | Normally, Ido does not include hidden buffers (whose name starts with | 447 | Normally, Ido does not include hidden buffers (whose names start with |
| 448 | a space) and hidden files and directories (whose name starts with | 448 | a 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 |
| 450 | substring you enter does not match any of the visible buffers or | 450 | substring you enter does not match any of the visible buffers or |
| 451 | files, Ido will automatically look for completions among the hidden | 451 | files, Ido will automatically look for completions among the hidden |
| 452 | buffers or files. | 452 | buffers or files. |
| 453 | 453 | ||
| 454 | @findex ido-toggle-ignore | 454 | @findex ido-toggle-ignore |
| 455 | You can toggle display of the hidden buffers and files with @kbd{C-a} | 455 | You 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 |
| 527 | Find File At Point, also known generally as ``ffap'', is an | 527 | Find File At Point, also known generally as ``ffap'', is an |
| 528 | intelligent system for opening files, and URLs. | 528 | intelligent system for opening files and URLs. |
| 529 | 529 | ||
| 530 | The following expression will make Ido guess the context: | 530 | The 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 |
| 554 | Ido is capable of ignoring buffers, directories, files and extensions | 554 | Ido is capable of ignoring buffers, directories, files and extensions |
| 555 | using regular expression. | 555 | using regular expressions. |
| 556 | 556 | ||
| 557 | @defopt ido-ignore-buffers | 557 | @defopt ido-ignore-buffers |
| 558 | This variable takes a list of regular expressions for buffers to | 558 | This variable takes a list of regular expressions for buffers to |
| @@ -590,7 +590,7 @@ Now you can customize @code{completion-ignored-extensions} as well. | |||
| 590 | Go ahead and add all the useless object files, backup files, shared | 590 | Go ahead and add all the useless object files, backup files, shared |
| 591 | library files and other computing flotsam you don't want Ido to show. | 591 | library 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 |
| 594 | if it would otherwise not show any other matches. So if you type out | 594 | if it would otherwise not show any other matches. So if you type out |
| 595 | the name of an ignored file, Ido will still let you open it just fine. | 595 | the name of an ignored file, Ido will still let you open it just fine. |
| 596 | 596 | ||
| @@ -718,7 +718,7 @@ packages. | |||
| 718 | After @kbd{C-x b} (@code{ido-switch-buffer}), the buffer at the head | 718 | After @kbd{C-x b} (@code{ido-switch-buffer}), the buffer at the head |
| 719 | of the list can be killed by pressing @kbd{C-k}. If the buffer needs | 719 | of the list can be killed by pressing @kbd{C-k}. If the buffer needs |
| 720 | saving, you will be queried before the buffer is killed. @kbd{C-S-b} | 720 | saving, you will be queried before the buffer is killed. @kbd{C-S-b} |
| 721 | buries the buffer at the head of the list. | 721 | buries the buffer at the end of the list. |
| 722 | 722 | ||
| 723 | Likewise, after @kbd{C-x C-f}, you can delete (i.e., physically | 723 | Likewise, after @kbd{C-x C-f}, you can delete (i.e., physically |
| 724 | remove) the file at the head of the list with @kbd{C-k}. You will | 724 | remove) 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 | ||
| 727 | If you enter @kbd{C-x b} to switch to a buffer visiting a given file, | 727 | If you enter @kbd{C-x b} to switch to a buffer visiting a given file, |
| 728 | and you find that the file you are after is not in any buffer, you can | 728 | and you find that the file you are after is not in any buffer, you can |
| 729 | press @kbd{C-f} to immediately drop into @code{ido-find-file}. And | 729 | press @kbd{C-f} to immediately drop into @code{ido-find-file}. You |
| 730 | you can switch back to buffer selection with @kbd{C-b}. | 730 | can 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 | |||
| 759 | behavior, set the variable @code{ido-max-window-height}. | 759 | behavior, set the variable @code{ido-max-window-height}. |
| 760 | 760 | ||
| 761 | Also, to improve the responsiveness of Ido, the maximum number of | 761 | Also, to improve the responsiveness of Ido, the maximum number of |
| 762 | matching items is limited to 12, but you can increase or removed this | 762 | matching items is limited to 12, but you can increase or remove this |
| 763 | limit via the @code{ido-max-prospects} user option. | 763 | limit 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 |
| 777 | to be drop in replacements for the normal buffer and file name reading | 777 | to be drop-in replacements for the normal buffer and file name reading |
| 778 | functions @code{read-buffer} and @code{read-file-name}. | 778 | functions @code{read-buffer} and @code{read-file-name}. |
| 779 | 779 | ||
| 780 | To use ido for all buffer and file selections in Emacs, customize the | 780 | To use ido for all buffer and file selections in Emacs, customize the |