This file is indexed.

/usr/share/doc/ne/html/Hints-and-Tricks.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
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
<html lang="en">
<head>
<title>Hints and Tricks - 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="prev" href="Configuration.html#Configuration" title="Configuration">
<link rel="next" href="Motivations-and-Design.html#Motivations-and-Design" title="Motivations and Design">
<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="Hints-and-Tricks"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Motivations-and-Design.html#Motivations-and-Design">Motivations and Design</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Configuration.html#Configuration">Configuration</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
<hr>
</div>

<h2 class="chapter">6 Hints and Tricks</h2>

<p><a name="index-Escape-usage-227"></a><a name="index-Turbo-adjustment-228"></a><a name="index-Shortcuts-not-working-229"></a><a name="index-Meta-key-230"></a><a name="index-Changing-colors-231"></a>
     <dl>
<dt><em>Use &lt;f1&gt; or &lt;Escape&gt;-&lt;Escape&gt;, not &lt;Escape&gt;.</em><dd>Due to the limitations of the techniques used when communicating with a
terminal, it is not possible to &ldquo;decide&rdquo; that the user pressed the
&lt;Escape&gt; key for about a second after the actual key press
(see <a href="EscapeTime.html#EscapeTime">EscapeTime</a>). This means that you will experience annoying delays when
using menus. If you have no &lt;f1&gt; key, use &lt;Escape&gt;-&lt;Escape&gt;, or
redefine a keystroke assigning the command <code>Escape</code>, and you will be
able to use that keystroke instead of &lt;Escape&gt;. Unfortunately,
some GUI-based terminals (most notably, <code>gnome-terminal</code>) use &lt;f1&gt;
for their own purposes; in that case, you can assign the <code>Escape</code>
command to another key (see <a href="Configuration.html#Configuration">Configuration</a>).

     <br><dt><em>Check for the presence of a &lt;Meta&gt; key.</em><dd>If your system has a standard &lt;Meta&gt; or &lt;Alt&gt; key, there is a
good chance that you have several other shortcuts. If the built-in
&lt;Meta&gt; bindings do not work, you must discover which is the effect
of the &lt;Meta&gt; in your terminal emulator. Indeed, it is possible in
theory to configure about 150 shortcuts. See <a href="Configuration.html#Configuration">Configuration</a>. In any
case, prefixing a key with &lt;Escape&gt; has the same effect as holding
down &lt;Meta&gt;, so with the standard key bindings
you can, for instance, advance by word with <kbd>&lt;Escape&gt;</kbd> followed by <kbd>F</kbd>.

     <br><dt><em>Mac users should turn on &ldquo;Delete sends CTRL-H&rdquo; in the </em><samp><span class="command">Terminal</span></samp><em> settings.</em><dd>If you are a Mac user, you need to check the &ldquo;Delete sends CTRL-H&rdquo; option
in the &lsquo;<samp><span class="samp">Advanced</span></samp>&rsquo; tab of the <samp><span class="command">Terminal</span></samp> application settings.

     <br><dt><code>ne</code><em> does tilda expansion.</em><dd>When you have to specify a file name, you can always start with <samp><span class="file">~/</span></samp> in
order to specify your home directory, or <samp><span class="file">~</span><var>user</var><span class="file">/</span></samp> to
specify the home directory of another user.

     <br><dt><em>It is easy to correct bad colors.</em><dd>Sometimes, due to different opinions about the best default foreground and
background colors, some of the color choices in a syntax file might be
unreadable (for instance, &lsquo;<samp><span class="samp">dim white</span></samp>&rsquo; on a terminal with a white
background). Just copy the guilty syntax specification file to the
<samp><span class="file">~/.ne/syntax</span></samp> directory, and change the color names at the start of
the file.

     <br><dt><em>Use the &lsquo;</em><samp><span class="samp">tabs</span></samp><em>&rsquo; syntax to distinguish </em><span class="sc">tab</span><em>s from </em><span class="sc">space</span><em>s.</em><dd>When you're struggling to clean up a mix of <span class="sc">tab</span>s and <span class="sc">space</span>s,
temporarily switching to the &lsquo;<samp><span class="samp">tabs</span></samp>&rsquo; syntax may help. The command
<samp><span class="command">Syntax tabs</span></samp> makes <span class="sc">tab</span> characters show up in a different
background color from <span class="sc">space</span>s. Once you've gotten your white space
issues straightened out, you can switch back to the syntax appropriate
for your current file type.

     <br><dt><code>ne</code><em> does interactive filename completion.</em><dd>When you have to specify a file name as last element of a long input,
you can invoke the completer using &lt;Tab&gt;. If you hit it twice in a
row, you will enter the file requester, where you can navigate and
escape back to the command line, either with &lt;f1&gt;, which will let
you edit again your previous input, or with &lt;Tab&gt;, which will copy
your current selection over your previous file name. In other words, you
can freely alternate completion, editing and browsing.

     <br><dt><em>Disable the status line for slow connections.</em><dd><code>ne</code> tries to emit as few characters as possible when updating the
screen. However, for each key you type it is likely that the status
bar has to be updated. If your connection is very slow, you can
disable the status bar to get a quicker response (see <a href="StatusBar.html#StatusBar">StatusBar</a>).

     <br><dt><em>The &lt;Escape&gt; delay when activating menus can be avoided.</em><dd>If you press after &lt;Escape&gt; any key that does not produce the second
character of an escape sequence, <code>ne</code> will immediately recognize the
&lt;Escape&gt; key code as such. Since non-alphabetical keys have no effect while
browsing through the menus, if you're forced to use &lt;Escape&gt; as menu
activator you can press, for instance, &lsquo;<samp><span class="samp">,</span></samp>&rsquo; just after it to speed
up the menu activation (note that &lsquo;<samp><span class="samp">:</span></samp>&rsquo; would not work, because it would
activate the command line). Alternatively, you can just type &lt;Escape&gt;
twice in a row.

     <br><dt><em>Use turbo mode for lengthy operations.</em><dd>Turbo mode (see <a href="Turbo.html#Turbo">Turbo</a>) allows performing very complex operations
without updating the screen until the operations are complete. This can
be a major plus if you are editing very long files, or if your terminal
is slow. If the default value (0, which means twice the number of
visible rows) does not give you the best results, experiment other
values.

     <br><dt><em>Regular expressions are powerful, and slow.</em><dd>Regular expressions must be studied very carefully. If you spend a lot
of time doing editing, it is definitely reasonable to study even their
most esoteric features. Very complex editing actions can be performed by
a single find/replace using the <code>\</code><var>n</var> convention. But remember
always that regular expressions are much slower than a normal search: in
particular, if you use them on a UTF-8 text, <code>ne</code> has to transform
them into an equivalent (but more complex) expression that cannot match
partially a UTF-8 sequence, and this expansion makes the search even
slower.

     <br><dt><em>Use the correct movement commands in a macro.</em><dd>Many boring, repetitive editing actions can be performed in a breeze
by recording them the first time. Remember, however, that while recording
a complex macro you should always use a cursor movement that will apply
in a different context. For instance, if you are copying a word, you cannot
move with cursor keys, because that word at another application of the
macro could be of a different length. Rather, use the next/previous word
keys and the <code>MoveEOW</code> command, which guarantee a correct behaviour in
all situations.

     <br><dt><em>Some preferences can be preserved even with automatic preferences.</em><dd>When you save an autoprefs file, the file simply contains a macro that,
when executed, produces the current configuration. However, you could want,
for instance, to never change the insert/overwrite state. In this case, just
edit the autoprefs files with <code>ne</code> and delete the line containing the
command setting the insert flag. When the autoprefs are loaded later, the
insert flag will be left untouched. This trick is particularly useful with
the <code>StatusBar</code> and <code>FastGUI</code> commands.

     <br><dt><em>If some keystrokes do not work, check for system-specific features.</em><dd>Sometimes it can happen that a keystroke does not work&mdash;for instance,
<kbd>&lt;Control&gt;-O</kbd> does not open a file. This usually is due to the kernel
tracking that key for its purposes. For instance, along a <code>telnet</code>
connection with xon/xoff flow control, <kbd>&lt;Control&gt;-S</kbd> and
<kbd>&lt;Control&gt;-Q</kbd> would block and release the output
instead of saving and quitting.

     <p>In these cases, if you do not need the system
feature you should check how to disable it: for instance, some <span class="sc">bsd</span>-like
systems feature a delayed suspend signal that is not in the <span class="sc">posix</span>
standard, and thus cannot be disabled by <code>ne</code>. On <span class="sc">hp-ux</span>, the command
<code>stty dsusp ^-</code> would disable the signal, and would let the control
sequence previously assigned to it to run up to <code>ne</code>.

   </dl>

   </body></html>