New XML Chapter 6

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2294 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Bruce Dubbs 2004-06-11 06:33:09 +00:00
parent a49bf08804
commit b5951ec94a
8 changed files with 459 additions and 21 deletions

View File

@ -19,6 +19,7 @@
<!ENTITY blfs-bootscripts-version "2004-05-22">
<!ENTITY blfs-bootscripts-download "&downloads-root;/blfs-bootscripts-&blfs-bootscripts-version;.tar.bz2">
<!-- Part II -->
<!-- Chapter 4 -->
<!ENTITY cracklib-version "2.7">
<!ENTITY Linux_PAM-version "0.77">
@ -34,7 +35,16 @@
<!ENTITY reiser-version "3.6.14">
<!ENTITY xfsprogs-version "2.6.13">
<!-- Chapter 6 -->
<!ENTITY vim-version "6.2">
<!ENTITY emacs-version "21.3">
<!ENTITY nano-version "1.2.3">
<!ENTITY joe-version "3.0">
<!-- Chapter 7 -->
<!-- Part III -->
<!ENTITY gnome-version "2.6">

View File

@ -1,3 +1,10 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter 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;
]>
<chapter id="postlfs-editors">
<?dbhtml filename="editors.html"?>
<title>Editors</title>
@ -8,10 +15,10 @@ also have the opportunity to show how some <acronym>LFS</acronym> installed
programs benefit from being recompiled after <acronym>GUI</acronym> libraries
have been installed.</para>
&postlfs-editors-vim;
&postlfs-editors-emacs;
&postlfs-editors-nano;
&postlfs-editors-joe;
&postlfs-editors-pico;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="vim.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="emacs.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="nano.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="joe.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pico.xml"/>
</chapter>

View File

@ -1,9 +1,150 @@
<?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 emacs-download-http "http://ftp.gnu.org/pub/gnu/emacs/emacs-&emacs-version;.tar.gz">
<!ENTITY emacs-download-ftp "ftp://ftp.gnu.org/pub/gnu/emacs/emacs-&emacs-version;.tar.gz">
<!ENTITY emacs-size "20 MB">
<!ENTITY emacs-buildsize "92.5 MB">
<!ENTITY emacs-time "4.20 SBU">
]>
<sect1 id="postlfs-editors-emacs" xreflabel="Emacs-&emacs-version;">
<?dbhtml filename="emacs.html"?>
<title>Emacs-&emacs-version;</title>
&emacs-intro;
&emacs-inst;
&emacs-desc;
<sect2>
<title>Introduction to <application>Emacs</application></title>
<para>The <application>Emacs</application> package contains the extensible, customizable,
self-documenting real-time display editor.</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&emacs-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&emacs-download-ftp;"/></para></listitem>
<listitem><para>Download size: &emacs-size;</para></listitem>
<listitem><para>Estimated Disk space required:
&emacs-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&emacs-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title><application>Emacs</application> dependencies</title>
<sect4><title>Optional</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), <xref linkend="libjpeg"/>, <xref
linkend="libpng"/>, <xref linkend="libtiff"/> and <xref
linkend="libungif"/></para></sect4>
</sect3>
</sect2>
<sect2>
<title>Installation of <application>Emacs</application></title>
<para>Install <application>Emacs</application> by running the following commands:</para>
<screen><userinput><command>./configure --prefix=/usr \
--libexecdir=/usr/sbin &amp;&amp;
make bootstrap &amp;&amp;
make install</command></userinput></screen>
</sect2>
<sect2>
<title>Contents</title>
<para>The <application>Emacs</application> package contains <command>emacs</command>,
<command>b2m</command>, <command>ctags</command>,
<command>ebrowse</command>, <command>emacsclient</command>,
<command>etags</command>, <command>grep-changelog</command>,
<command>rcs-checkin</command>, <command>cvt-mail</command>,
<command>digest-doc</command>, <command>emacsserver</command>,
<command>fakemail</command>, <command>hexl</command>,
<command>movemail</command>, <command>profile</command>,
<command>rcs2log</command>, <command>sorted-doc</command>,
<command>vcdiff</command> and <command>yow</command>.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>emacs</title>
<para>The editor proper.</para></sect3>
<sect3><title>b2m</title>
<para><command>b2m</command> is a program to convert mail files from RMAIL format to Unix
<quote>mbox</quote> format.</para></sect3>
<sect3><title>ctags</title>
<para><command>ctags</command> creates cross-reference tagfile database files for source
code.</para></sect3>
<sect3><title>ebrowse</title>
<para><command>ebrowse</command> permits browsing of C++ class hierarchies from
within emacs.</para></sect3>
<sect3><title>emacsclient</title>
<para><command>emacsclient</command> attaches an emacs session to an already running
emacsserver instance.</para></sect3>
<sect3><title>etags</title>
<para><command>etags</command> is another program to generate source code cross-reference
tagfiles.</para></sect3>
<sect3><title>grep-changelog</title>
<para><command>grep-changelog</command> prints entries in Change Logs matching
various criteria.</para></sect3>
<sect3><title>rcs-checkin</title>
<para><command>rcs-checkin</command> is a shell script used to check
files into <acronym>RCS</acronym>.</para></sect3>
<sect3><title>cvt-mail</title>
<para><command>cvt-mail</command> converts old style goslings emacs mail directories into
gnu-rmail format.</para></sect3>
<sect3><title>digest-doc</title>
<para><command>digest-doc</command> is a filter to create nroff output for man pages.</para></sect3>
<sect3><title>emacsserver</title>
<para><command>emacserver</command> allows other applications/shells to access an already
running emacs instance and share buffers with it.</para></sect3>
<sect3><title>fakemail</title>
<para><command>fakemail</command> is a sendmail-like interface to
<filename>/bin/mail</filename>.</para></sect3>
<sect3><title>hexl</title>
<para><command>hexl</command> converts files for editing with emacs hexl-mode binary file
editing mode.</para></sect3>
<sect3><title>movemail</title>
<para><command>movemail</command> provides access to
<acronym>POP</acronym>3 mailboxes.</para></sect3>
<sect3><title>profile</title>
<para><command>profile</command> generates periodic events for profiling of Emacs
Lisp code.</para></sect3>
<sect3><title>rcs2log</title>
<para><command>rcs2log</command> generates change log prefixes from
<acronym>RCS</acronym> files.</para></sect3>
<sect3><title>sorted-doc</title>
<para><command>sorted-doc</command> is a filter to generate texinfo files.</para></sect3>
<sect3><title>vcdiff</title>
<para><command>vcdiff</command> compares <acronym>SCCS</acronym> files.</para></sect3>
<sect3><title>yow</title>
<para><command>yow</command> prints a quotation from Zippy the Pinhead.</para></sect3>
</sect2>
</sect1>

View File

@ -1,10 +1,110 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter 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 joe-download-http "http://prdownloads.sourceforge.net/joe-editor/joe-&joe-version;.tar.gz">
<!ENTITY joe-download-ftp " ">
<!ENTITY joe-size "308 KB">
<!ENTITY joe-buildsize "4.8 MB">
<!ENTITY joe-time "0.11 SBU">
]>
<sect1 id="postlfs-editors-joe">
<?dbhtml filename="joe.html"?>
<title>JOE-&joe-version;</title>
&joe-intro;
&joe-inst;
&joe-config;
&joe-desc;
<sect2>
<title>Introduction to <application><acronym>JOE</acronym></application></title>
<para><application>JOE</application> (Joe's own editor) is a small text editor
capable of emulating WordStar, <application>Pico</application>,
and <application>Emacs</application>.</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&joe-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&joe-download-ftp;"/></para></listitem>
<listitem><para>Download size: &joe-size;</para></listitem>
<listitem><para>Estimated Disk space required:
&joe-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&joe-time;</para></listitem></itemizedlist>
</sect3>
</sect2>
<sect2>
<title>Installation of <application><acronym>JOE</acronym></application></title>
<para>Install <application><acronym>JOE</acronym></application> by running the following commands:</para>
<screen><userinput><command>./configure --sysconfdir=/etc --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
</sect2>
<sect2>
<title>Configuration files</title>
<para><application><acronym>JOE</acronym></application> can make use of several configuration files. Information
about these files may be found in the joe man page. These files
are <filename>/etc/jmacsrc</filename>, <filename>/etc/joerc</filename>,
<filename>/etc/jpicorc</filename>, <filename>/etc/jstarrc</filename>,
and <filename>/etc/rjoerc</filename>.
<application><acronym>JOE</acronym></application> can also make use of
<filename>~/.joerc</filename>, which may be copied from
<filename>/etc/joerc</filename> and customized for each user's
taste.</para>
</sect2>
<sect2>
<title>Contents</title>
<para>The <application><acronym>JOE</acronym></application> package contains <command>jmacs</command>,
<command>joe</command>, <command>jpico</command>,
<command>jstar</command>, <command>rjoe</command> and
<command>termidx</command>.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>jmacs</title>
<para><command>jmacs</command> is a symbolic link to
<command>joe</command> used to launch <application>Emacs</application>
emulation mode.</para></sect3>
<sect3><title>joe</title>
<para><command>joe</command> is a small text editor capable of emulating
WordStar, <application>Pico</application>, and
<application>Emacs</application>.</para></sect3>
<sect3><title>jpico</title>
<para><command>jpico</command> is a symbolic link to
<command>joe</command> used to launch <application>Pico</application>
emulation mode.</para></sect3>
<sect3><title>jstar</title>
<para><command>jstar</command> is a symbolic link to
<command>joe</command> used to launch WordStar
emulation mode.</para></sect3>
<sect3><title>rjoe</title>
<para><command>rjoe</command> is a symbolic link to
<command>joe</command> that restricts
<application><acronym>JOE</acronym></application> to editing
only files which are specified on the command-line.</para></sect3>
<sect3><title>termidx</title>
<para><command>termidx</command> is a program used by
<command>joe</command> to generate the termcap index
file.</para></sect3>
</sect2>
</sect1>

View File

@ -1,10 +1,103 @@
<?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-size "942 KB">
<!ENTITY nano-buildsize "4.6 MB">
<!ENTITY nano-time "0.08 SBU">
]>
<sect1 id="postlfs-editors-nano">
<?dbhtml filename="nano.html"?>
<title>nano-&nano-version;</title>
&nano-intro;
&nano-inst;
&nano-config;
&nano-desc;
<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 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 &amp;&amp;
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><title>Config files</title>
<para><filename>/etc/nanorc</filename>, <filename>~/.nanorc</filename></para>
<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>
<para>The <application>nano</application> package contains
<command>nano</command>.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>nano</title>
<para><command>nano</command> is a small, simple text editor which aims to replace
<application>Pico</application>, the default editor in the
<application>Pine</application> package.</para></sect3>
</sect2>
</sect1>

View File

@ -1,3 +1,10 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter 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;
]>
<sect1 id="pico">
<?dbhtml filename="pico.html"?>
<title>Pico</title>

View File

@ -1,10 +1,88 @@
<?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 vim-download-http "http://ftp.at.vim.org/pub/vim/unix/vim-&vim-version;.tar.bz2">
<!ENTITY vim-download-ftp "ftp://ftp.vim.org/pub/vim/unix/vim-&vim-version;.tar.bz2">
<!ENTITY vim-size "3.2 MB">
<!ENTITY vim-buildsize "46 MB">
<!ENTITY vim-time "0.59 SBU">
]>
<sect1 id="postlfs-editors-vim" xreflabel="Vim-&vim-version;">
<?dbhtml filename="vim.html"?>
<title>Vim-&vim-version;</title>
&vim-intro;
&vim-inst;
&vim-exp;
&vim-desc;
<sect2>
<title>Installation of <application>Vim</application></title>
<note><para>If you recompile vim to link against <application>X</application>,
and your X libs are not on the root partition, you will no longer have
an editor for use in emergencies. You may choose to install an additional editor,
not link vim against X, or move the current <command>vim</command> executable to the
<filename>/bin</filename> directory under a different name such as <filename>vi</filename>.</para></note>
<para>Install <application>Vim</application> by running the following commands:</para>
<screen><userinput><command>echo '#define SYS_VIMRC_FILE "/etc/vimrc"' &gt;&gt; src/feature.h &amp;&amp;
echo '#define SYS_GVIMRC_FILE "/etc/gvimrc"' &gt;&gt; src/feature.h &amp;&amp;
./configure --prefix=/usr \
--with-features=huge &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
</sect2>
<sect2>
<title>Installation of <application>Vim</application></title>
<note><para>If you recompile vim to link against <application>X</application>,
and your X libs are not on the root partition, you will no longer have
an editor for use in emergencies. You may choose to install an additional editor,
not link vim against X, or move the current <command>vim</command> executable to the
<filename>/bin</filename> directory under a different name such as <filename>vi</filename>.</para></note>
<para>Install <application>Vim</application> by running the following commands:</para>
<screen><userinput><command>echo '#define SYS_VIMRC_FILE "/etc/vimrc"' &gt;&gt; src/feature.h &amp;&amp;
echo '#define SYS_GVIMRC_FILE "/etc/gvimrc"' &gt;&gt; src/feature.h &amp;&amp;
./configure --prefix=/usr \
--with-features=huge &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
</sect2>
<sect2>
<title>Command explanations</title>
<para><parameter>--with-features=huge</parameter>: This switch enables all the additional
features available in <application>Vim</application>.</para>
<para><parameter>--enable-gui=no</parameter>: If you prefer not to link vim against X, use
this switch.</para>
</sect2>
<sect2>
<title>Contents</title>
<para>The <application>Vim</application> package contains
<command>eview</command>, <command>evim</command>,
<command>ex</command>, <command>gview</command>,
<command>gvim</command>, <command>gvimdiff</command>,
<command>rgview</command>, <command>rgvim</command>,
<command>rview</command>, <command>rvim</command>,
<command>view</command>, <command>vim</command>,
<command>vimdiff</command>, <command>vimtutor</command> and
<command>xxd</command>. Except for <command>vimtutor</command> and
<command>xxd</command>, all the other commands are symlinks to
<command>vim</command> and start <command>vim</command> with different
options. <command>vimtutor</command> is a tool to learn the various
<command>vim</command> commands and <command>xxd</command> is a command used to create hex dumps.</para>
</sect2>
</sect1>

View File

@ -11,7 +11,9 @@
<!-- &postlfs-filesystems; -->
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postlfs/filesystems/filesystems.xml"/>
&postlfs-editors;
<!-- &postlfs-editors; -->
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postlfs/editors/editors.xml"/>
&postlfs-shells;
</part>