source: postlfs/editors/nano.xml@ 36d9b2b

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY nano-download-http "http://www.nano-editor.org/dist/v1.2/nano-&nano-version;.tar.gz">
  <!ENTITY nano-download-ftp  "ftp://ftp.uni-koeln.de/editor/nano-&nano-version;.tar.gz">
  <!ENTITY nano-md5sum        "2c513310ec5e8b63abaecaf48670ac7a">
  <!ENTITY nano-size          "897 KB">
  <!ENTITY nano-buildsize     "4.3 MB">
  <!ENTITY nano-time          "0.08 SBU">
]>

<sect1 id="nano">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="nano.html"?>
<title>nano-&nano-version;</title>
<indexterm zone="nano"><primary
sortas="a-nano">nano</primary></indexterm>

<sect2>
<title>Introduction to <application>nano</application></title>

<para>The <application>nano</application> package contains a small, simple 
text editor which aims to replace <application>Pico</application>, the default 
editor in the <application>Pine</application> package.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&nano-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&nano-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &nano-md5sum;</para></listitem>
<listitem><para>Download size: &nano-size;</para></listitem>
<listitem><para>Estimated disk space required:
&nano-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&nano-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title><application>nano</application> dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="slang"/></para>
</sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>nano</application></title>

<para>Install <application>nano</application> by running the following 
commands:</para>

<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc \
    --enable-color --enable-multibuffer --enable-nanorc &amp;&amp;
make</command></userinput></screen>

<para>Now, as the root user:</para>

<screen><userinput role='root'><command>make install &amp;&amp;
mkdir -p /usr/share/doc/nano/examples &amp;&amp;
cp nanorc.sample /usr/share/doc/nano/examples</command></userinput></screen>

</sect2>

<sect2>
<title>Configuring nano</title>

<sect3 id="nano-config"><title>Config files</title>
<para><filename>/etc/nanorc</filename>, <filename>~/.nanorc</filename></para>
<indexterm zone="nano nano-config">
<primary sortas="e-etc-nanorc">/etc/nanorc</primary>
</indexterm>
<indexterm zone="nano nano-config">
<primary sortas="e-AA.nanorc">~/.nanorc</primary>
</indexterm>

<para>Example Configuration</para>

<screen><userinput>set autoindent
set const
set fill 72
set historylog
set multibuffer
set nohelp
set regexp
set smooth
set suspend</userinput></screen>

<para>Another example is in the 
<filename class="directory">/usr/share/doc/nano/examples</filename> directory 
in the <filename>nanorc.sample</filename> file.  It includes color 
configurations and has some documentation included in the comments.</para>
</sect3>
</sect2>

<sect2>
<title>Contents</title>

<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>nano</seg>
<seg>/usr/share/doc/nano</seg>
</seglistitem>
</segmentedlist>

<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>

<varlistentry id="nano-prog">
<term><filename>nano</filename></term>
<listitem><para>is a small, simple text editor which aims to
replace <application>Pico</application>, the default editor in the
<application>Pine</application> package.</para>
<indexterm zone="nano nano-prog">
<primary sortas="b-nano">nano</primary></indexterm>
</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>