File: Basic-Preferences.html

package info (click to toggle)
ne 2.1-1
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 3,540 kB
  • ctags: 3,408
  • sloc: ansic: 24,666; perl: 500; makefile: 207; sh: 9
file content (101 lines) | stat: -rw-r--r-- 6,534 bytes parent folder | download | duplicates (3)
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
<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>