This file is indexed.

/usr/share/doc/ne/html/Basic-Preferences.html is in ne-doc 3.0.1-2build1.

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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>ne&rsquo;s manual: Basic Preferences</title>

<meta name="description" content="ne&rsquo;s manual: Basic Preferences">
<meta name="keywords" content="ne&rsquo;s manual: Basic Preferences">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="Command-Index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Basics.html#Basics" rel="up" title="Basics">
<link href="Basic-Macros.html#Basic-Macros" rel="next" title="Basic Macros">
<link href="Editing.html#Editing" rel="prev" title="Editing">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Basic-Preferences"></a>
<div class="header">
<p>
Next: <a href="Basic-Macros.html#Basic-Macros" accesskey="n" rel="next">Basic Macros</a>, Previous: <a href="Editing.html#Editing" accesskey="p" rel="prev">Editing</a>, Up: <a href="Basics.html#Basics" accesskey="u" rel="up">Basics</a> &nbsp; [<a href="Command-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Basic-Preferences-1"></a>
<h3 class="section">2.5 Basic Preferences</h3>
<a name="index-Preferences"></a>
<a name="index-Flags-1"></a>
<a name="index-Insert-mode"></a>
<a name="index-Automatic-preferences"></a>

<p><code>ne</code> has a number of <em>flags</em> that specify alternative
behaviors, the most prototypical example being the <em>insert</em> flag,
which specifies whether the text you type is inserted into the existing text
or replaces it. You can toggle this flag with the &lsquo;<samp>Insert</samp>&rsquo; menu
item of the &lsquo;<samp>Prefs</samp>&rsquo; menu, or with the <tt class="key">Insert</tt> key of your
keyboard. (<em>Toggle</em> means to change the value of a flag from true to
false, or from false to true; see <a href="Insert.html#Insert">Insert</a>.)
</p>
<p>Another important flag is the <em>free form</em> flag, which specifies
whether the cursor can be moved beyond the right end of each line of
text or only to existing text (a la <code>vi</code>). Programmers usually
prefer non free form editing; text writers seem to prefer free form. See
<a href="FreeForm.html#FreeForm">FreeForm</a> for some elaboration. The free form flag can be set with
the &lsquo;<samp>Free Form</samp>&rsquo; menu item of the &lsquo;<samp>Prefs</samp>&rsquo; menu.
</p>
<p>At this point, we suggest you explore by trial and error the other
flags of the &lsquo;<samp>Prefs</samp>&rsquo; menu, or try the <code>Flags</code> command (see <a href="Flags.html#Flags">Flags</a>),
which explains all the flags and the commands that operate on
them. We prefer spending a few words discussing <em>automatic
preferences</em> or <em>autoprefs</em>.
</p>
<p>Having many flags ensures a high degree of flexibility, but it can turn
editing into a nightmare if you have to turn on and off dozens of flags
for each different kind of file you edit. <code>ne</code>&rsquo;s solution is to
automatically set a document&rsquo;s flags when a file is loaded based on your
stated preferences for each <em>file type</em>. A file&rsquo;s type is determined
by the <em>extension</em> of its file name, that is, the last group of letters
after the last dot. For instance, the extension of <samp>ne.texinfo</samp> is
&lsquo;<samp>texinfo</samp>&rsquo;, the extension of <samp>source.c</samp> is &lsquo;<samp>c</samp>&rsquo;, and the
extension of <samp>my.txt</samp> is &lsquo;<samp>txt</samp>&rsquo;.
</p>
<p>Whenever you select the &lsquo;<samp>Save AutoPrefs</samp>&rsquo; menu item, <code>ne</code> saves
the flags of your current document to be used when
you load other files with the same extension as your current document.
These <em>autoprefs</em> are saved in a file in your <samp>~/.ne</samp>
directory. This file has the same name as the extension of the current
document with &lsquo;<samp>#ap</samp>&rsquo; appended to it. It contains all the commands
necessary to recreate your current document&rsquo;s flag settings. Whenever
you open a file with this file name extension, <code>ne</code> will
automagically recreate your preferred flag settings for that file type.
(There is a flag that inhibits the process; see <a href="AutoPrefs.html#AutoPrefs">AutoPrefs</a>.)
</p>
<p>Finally, when you select the &lsquo;<samp>Save Def Prefs</samp>&rsquo; menu item, a special
preferences file named <samp>.default#ap</samp> is saved. These preferences
are loaded whenever <code>ne</code> is run before loading any file. This is
how you set up the preferences you always want to be set.
</p>
<p>A small set of preferences are global to <code>ne</code> rather than specific
to particular document types. Thus they are saved in the <samp>.default#ap</samp>
file by the <code>SaveDefPrefs</code> command or the &lsquo;<samp>Save Def Prefs</samp>&rsquo; menu.
They are not saved by the <code>SaveAutoPrefs</code> command. These preferences are:
<code>FastGUI</code>, <code>RequestOrder</code>, <code>StatusBar</code> and <code>VerboseMacros</code>;
see <a href="FastGUI.html#FastGUI">FastGUI</a>, See <a href="RequestOrder.html#RequestOrder">RequestOrder</a>, See <a href="StatusBar.html#StatusBar">StatusBar</a>, and See <a href="VerboseMacros.html#VerboseMacros">VerboseMacros</a>.
</p>
<p>Similarly, the current syntax definition is specific to the current
document type, so it is saved only in autoprefs files by the
<code>SaveAutoPrefs</code> command or &lsquo;<samp>Save AutoPrefs</samp>&rsquo; menu; it is not
saved in the <samp>.default#ap</samp> file.
</p>
<p>Note also that a preferences file is just a macro (as described in the
following section). Thus, it can be edited manually if necessary.
</p>

<hr>
<div class="header">
<p>
Next: <a href="Basic-Macros.html#Basic-Macros" accesskey="n" rel="next">Basic Macros</a>, Previous: <a href="Editing.html#Editing" accesskey="p" rel="prev">Editing</a>, Up: <a href="Basics.html#Basics" accesskey="u" rel="up">Basics</a> &nbsp; [<a href="Command-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>