This file is indexed.

/usr/share/doc/ne/html/Basic-Preferences.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
<html lang="en">
<head>
<title>Basic Preferences - 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="Basics.html#Basics" title="Basics">
<link rel="prev" href="Editing.html#Editing" title="Editing">
<link rel="next" href="Basic-Macros.html#Basic-Macros" title="Basic Macros">
<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="Basic-Preferences"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Basic-Macros.html#Basic-Macros">Basic Macros</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Editing.html#Editing">Editing</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Basics.html#Basics">Basics</a>
<hr>
</div>

<h3 class="section">2.5 Basic Preferences</h3>

<p><a name="index-Preferences-32"></a><a name="index-Flags-33"></a><a name="index-Insert-mode-34"></a><a name="index-Automatic-preferences-35"></a>
<code>ne</code> has a number of <dfn>flags</dfn> that specify alternative
behaviors, the most prototypical example being the <dfn>insert</dfn> flag,
which specifies whether the text you type is inserted into the existing text
or overwrites it. You can toggle this flag with the &lsquo;<samp><span class="samp">Insert</span></samp>&rsquo; menu
item of the &lsquo;<samp><span class="samp">Prefs</span></samp>&rsquo; menu, or with the &lt;Insert&gt; key of your
keyboard. (<dfn>Toggle</dfn> 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>Another important flag is the <dfn>free form</dfn> 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><span class="samp">Free Form</span></samp>&rsquo; menu item of the &lsquo;<samp><span class="samp">Prefs</span></samp>&rsquo; menu.

   <p>At this point, we suggest you explore by trial and error the other
flags of the &lsquo;<samp><span class="samp">Prefs</span></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 <dfn>automatic
preferences</dfn> or <dfn>autoprefs</dfn>.

   <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>'s solution is to
automatically set a document's flags when a file is loaded based on your
stated preferences for each <dfn>file type</dfn>. A file's type is determined
by the <dfn>extension</dfn> of its file name, that is, the last group of letters
after the last dot. For instance, the extension of <samp><span class="file">ne.texinfo</span></samp> is
&lsquo;<samp><span class="samp">texinfo</span></samp>&rsquo;, the extension of <samp><span class="file">source.c</span></samp> is &lsquo;<samp><span class="samp">c</span></samp>&rsquo;, and the
extension of <samp><span class="file">my.txt</span></samp> is &lsquo;<samp><span class="samp">txt</span></samp>&rsquo;.

   <p>Whenever you select the &lsquo;<samp><span class="samp">Save AutoPrefs</span></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 <dfn>autoprefs</dfn> are saved in a file in your <samp><span class="file">~/.ne</span></samp>
directory. This file has the same name as the extension of the current
document with &lsquo;<samp><span class="samp">#ap</span></samp>&rsquo; appended to it. It contains all the commands
necessary to recreate your current document'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>Finally, when you select the &lsquo;<samp><span class="samp">Save Def Prefs</span></samp>&rsquo; menu item, a special
preferences file named <samp><span class="file">.default#ap</span></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>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><span class="file">.default#ap</span></samp>
file by the <code>SaveDefPrefs</code> command or the &lsquo;<samp><span class="samp">Save Def Prefs</span></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>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><span class="samp">Save AutoPrefs</span></samp>&rsquo; menu; it is not
saved in the <samp><span class="file">.default#ap</span></samp> file.

   <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.

   </body></html>