/usr/share/doc/ne/html/The-Requester.html is in ne-doc 2.5-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 | <html lang="en">
<head>
<title>The Requester - ne's manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="ne's manual">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Reference.html#Reference" title="Reference">
<link rel="prev" href="The-Command-Line.html#The-Command-Line" title="The Command Line">
<link rel="next" href="Syntax-Highlighting.html#Syntax-Highlighting" title="Syntax Highlighting">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="The-Requester"></a>
<p>
Next: <a rel="next" accesskey="n" href="Syntax-Highlighting.html#Syntax-Highlighting">Syntax Highlighting</a>,
Previous: <a rel="previous" accesskey="p" href="The-Command-Line.html#The-Command-Line">The Command Line</a>,
Up: <a rel="up" accesskey="u" href="Reference.html#Reference">Reference</a>
<hr>
</div>
<h3 class="section">3.5 The Requester</h3>
<p><a name="index-Requester-67"></a><a name="index-File-requester-68"></a><a name="index-Interrupting-directory-scanning-69"></a><a name="index-Help-requester-70"></a>
In various situations, <code>ne</code> needs to ask you to choose one string
from several (where “several” can mean a lot).
For this kind of event, the <dfn>requester</dfn> is issued. The requester
displays the strings in as many columns as possible and lets you move
with the cursor from one string to another. The strings can fill many
screens, which are handled as consecutive pages. Most navigation keys
work exactly as in normal editing. This is true even of custom key
bindings. Thus, for instance, you can page up and down through the
list with <kbd><Control>-P</kbd> and <kbd><Control>-N</kbd> (in the standard keyboard
configuration).
<p>As with the input line (see <a href="The-Input-Line.html#The-Input-Line">The Input Line</a>), you can confirm your
input with <Return> or escape the requester with <f1> or the
<Escape> key (or whatever has been bound to the <code>Escape</code>
command). Moreover, if you are selecting a file name there is a third
possibility: by escaping with the <Tab> key, the file or directory
name that the cursor is currently on will be copied on the input
line. This allows you to choose an existing name and modify it.
<p>A special feature is bound to alphabetic characters: they move you to the next
entry starting with the letter you typed. The search is case insensitive, and
it continues on to the first string after having passed the last one.
<p>An example of a requester is the list of commands appearing when you use
the <code>Help</code> command. Another is the list of document words matching
a prefix given to the <code>AutoComplete</code> command. A third example is the file requester that
<code>ne</code> issues whenever a file operation is going to take place. In
this case, pressing <Return> while on a directory name will enter
the directory. Note also that, should the requester take too long to
appear, you can interrupt the directory scanning with
<kbd><Control>-\</kbd>. However, the listing will likely be incomplete.
<p>Note that there are two items that always appear in the file requester:
<samp><span class="file">./</span></samp> and <samp><span class="file">../</span></samp>. The first one represents the current directory
and can be used to force a reread of the directory. The second one represents the
parent directory and can be used to move up by one directory level.
<p>The requester presents the strings by default in “row major order,”
which means the second string is on the same row as the first but to
its right, at the top of the second column, and so on across each row
before filling in the next row down. If you prefer your lists displayed in
“column major order”—the first, second, and third strings are in
the same column and each column is filled before starting on the next
column to the right—then use the <code>RequestOrder</code> command to
switch that preference. The setting will be stored in your default
preferences the next time you save them. See <a href="Preferences-Commands.html#Preferences-Commands">Preferences Commands</a>.
</body></html>
|