source: postlfs/editors/nano.xml@ 8d9de85

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since 8d9de85 was 8d9de85, checked in by Thomas Trepl (Moody) <thomas@…>, 6 months ago

Upgrade nano-5.7

  • Property mode set to 100644
File size: 6.3 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!-- Note minor version in URL -->
8 <!ENTITY nano-download-http "https://www.nano-editor.org/dist/v5/nano-&nano-version;.tar.xz">
9 <!ENTITY nano-download-ftp " ">
10 <!ENTITY nano-md5sum "c2d6540a33248edc31a5830861b4b4ea">
11 <!ENTITY nano-size "1.4 MB">
12 <!ENTITY nano-buildsize "20 MB">
13 <!ENTITY nano-time "0.2 SBU">
14]>
15
16<sect1 id="nano" xreflabel="nano-&nano-version;">
17 <?dbhtml filename="nano.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Nano-&nano-version;</title>
24
25 <indexterm zone="nano">
26 <primary sortas="a-Nano">Nano</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Nano</title>
31
32 <para>
33 The <application>Nano</application> package contains a small,
34 simple text editor which aims to replace <application>Pico</application>,
35 the default editor in the <application>Pine</application> package.
36 </para>
37
38 &lfs101_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&nano-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&nano-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &nano-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &nano-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &nano-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &nano-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <para condition="html" role="usernotes">User Notes:
75 <ulink url="&blfs-wiki;/Nano"/>
76 </para>
77 </sect2>
78
79 <sect2 role="installation">
80 <title>Installation of Nano</title>
81
82 <para>
83 Install <application>Nano</application> by running the following
84 commands:
85 </para>
86
87<screen><userinput>./configure --prefix=/usr \
88 --sysconfdir=/etc \
89 --enable-utf8 \
90 --docdir=/usr/share/doc/nano-&nano-version; &amp;&amp;
91make</userinput></screen>
92
93 <para>
94 This package does not come with a test suite.
95 </para>
96
97 <para>
98 Now, as the <systemitem class="username">root</systemitem> user:
99 </para>
100
101<screen role="root"><userinput>make install &amp;&amp;
102install -v -m644 doc/{nano.html,sample.nanorc} /usr/share/doc/nano-&nano-version;</userinput></screen>
103
104 </sect2>
105
106 <sect2 role="commands">
107 <title>Command Explanations</title>
108
109 <para>
110 <parameter>--enable-utf8</parameter>: This switch enables unicode support
111 in <application>Nano</application>.
112 </para>
113
114 </sect2>
115
116 <sect2 role="configuration">
117 <title>Configuring nano</title>
118
119 <sect3 id="nano-config">
120 <title>Config Files</title>
121
122 <para>
123 <filename>/etc/nanorc</filename> and
124 <filename>~/.nanorc</filename>
125 </para>
126
127 <indexterm zone="nano nano-config">
128 <primary sortas="e-etc-nanorc">/etc/nanorc</primary>
129 </indexterm>
130
131 <indexterm zone="nano nano-config">
132 <primary sortas="e-AA.nanorc">~/.nanorc</primary>
133 </indexterm>
134
135 </sect3>
136
137 <sect3>
138 <title>Configuration Information</title>
139
140 <para>
141 Example configuration (create as a system-wide
142 <filename>/etc/nanorc</filename> or a personal
143 <filename>~/.nanorc</filename> file)
144 </para>
145
146<screen><literal>set autoindent
147set constantshow
148set fill 72
149set historylog
150set multibuffer
151set nohelp
152set positionlog
153set quickblank
154set regexp
155set suspend</literal></screen>
156
157 <para>
158 Check the <filename>sample.nanorc</filename> file in the installed
159 documentation directory. It includes color configurations and has
160 some documentation included in the comments.
161 </para>
162
163 <para>
164 Syntax highlighting is provided for several file types, in
165 <filename class="directory">/usr/share/nano/</filename> directory.
166 E.g., for shell scripts, you can insert
167 <option>include /usr/share/nano/sh.nanorc</option> in the personal or
168 global configuration file. If you wish highlighting for all supported
169 files, use <option>include /usr/share/nano/*.nanorc</option>. This
170 include does not descend into the <filename class="directory">extra</filename>
171 directory. Move required files one level up.
172 </para>
173
174 </sect3>
175
176 </sect2>
177
178 <sect2 role="content">
179 <title>Contents</title>
180
181 <segmentedlist>
182 <segtitle>Installed Programs</segtitle>
183 <segtitle>Installed Libraries</segtitle>
184 <segtitle>Installed Directories</segtitle>
185
186 <seglistitem>
187 <seg>
188 nano and rnano (symlink)
189 </seg>
190 <seg>
191 None
192 </seg>
193 <seg>
194 /usr/share/nano and
195 /usr/share/doc/nano-&nano-version;
196 </seg>
197 </seglistitem>
198 </segmentedlist>
199
200 <variablelist>
201 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
202 <?dbfo list-presentation="list"?>
203 <?dbhtml list-presentation="table"?>
204
205 <varlistentry id="nano-prog">
206 <term><command>nano</command></term>
207 <listitem>
208 <para>
209 is a small, simple text editor which aims to replace
210 <application>Pico</application>, the default editor in the
211 <application>Pine</application> package
212 </para>
213 <indexterm zone="nano nano-prog">
214 <primary sortas="b-nano">nano</primary>
215 </indexterm>
216 </listitem>
217 </varlistentry>
218
219 <varlistentry id="rnano-prog">
220 <term><command>rnano</command></term>
221 <listitem>
222 <para>
223 is a restricted mode for <command>nano</command>
224 </para>
225 <indexterm zone="nano rnano-prog">
226 <primary sortas="b-rnano">rnano</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 </variablelist>
232
233 </sect2>
234
235</sect1>
Note: See TracBrowser for help on using the repository browser.