diff options
| -rw-r--r-- | general.ent | 4 | ||||
| -rw-r--r-- | index.xml | 7 | ||||
| -rw-r--r-- | postlfs/postlfs.xml | 25 | ||||
| -rw-r--r-- | postlfs/shells/ash.xml | 93 | ||||
| -rw-r--r-- | postlfs/shells/shells.xml | 13 | ||||
| -rw-r--r-- | postlfs/shells/tcsh.xml | 98 | ||||
| -rw-r--r-- | postlfs/shells/zsh.xml | 87 |
7 files changed, 293 insertions, 34 deletions
diff --git a/general.ent b/general.ent index fcfee2d7bd..dbbc14afa4 100644 --- a/general.ent +++ b/general.ent @@ -42,7 +42,9 @@ <!ENTITY joe-version "3.0"> <!-- Chapter 7 --> - +<!ENTITY ash-version "0.4.0"> +<!ENTITY tcsh-version "6.13.00"> +<!ENTITY zsh-version "4.2.0"> <!-- Part III --> @@ -27,8 +27,8 @@ %book; <!-- %preface; -%introduction; --> -%postlfs; +%introduction; +%postlfs; --> %general; %connect; %basicnet; @@ -54,8 +54,7 @@ <!-- Parts --> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="introduction/introduction.xml"/> -<!-- &introduction; --> -&postlfs; +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postlfs/postlfs.xml"/> &general; &connect; &basicnet; diff --git a/postlfs/postlfs.xml b/postlfs/postlfs.xml index 92c1fac45e..ce8a3cacd2 100644 --- a/postlfs/postlfs.xml +++ b/postlfs/postlfs.xml @@ -1,19 +1,18 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE part 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; +]> + <part id="postlfs" xreflabel="Post LFS Configuration and Extra Software"> <?dbhtml filename="postlfs.html" dir="postlfs"?> <title>Post <acronym>LFS</acronym> Configuration and Extra Software</title> -<!-- &postlfs-config; --> -<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postlfs/config/config.xml"/> - -<!-- &postlfs-security; --> -<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postlfs/security/security.xml"/> - -<!-- &postlfs-filesystems; --> -<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postlfs/filesystems/filesystems.xml"/> - -<!-- &postlfs-editors; --> -<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postlfs/editors/editors.xml"/> - -&postlfs-shells; +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="config/config.xml"/> +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="security/security.xml"/> +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="filesystems/filesystems.xml"/> +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="editors/editors.xml"/> +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="shells/shells.xml"/> </part> diff --git a/postlfs/shells/ash.xml b/postlfs/shells/ash.xml index 7f588c87f1..39826d67a1 100644 --- a/postlfs/shells/ash.xml +++ b/postlfs/shells/ash.xml @@ -1,11 +1,96 @@ +<?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 ash-version "0.4.0"> +<!ENTITY ash-download-http " "> +<!ENTITY ash-download-ftp "ftp://distro.ibiblio.org/pub/Linux/distributions/slackware/slackware_source/ap/ash/ash-&ash-version;.tar.gz"> +<!ENTITY ash-size "118 KB"> +<!ENTITY ash-buildsize "2.7 MB"> +<!ENTITY ash-time "0.06 SBU"> + +]> + <sect1 id="ash" xreflabel="ASH-&ash-version;"> <?dbhtml filename="ash.html"?> <title>ASH-&ash-version;</title> -&ash-intro; -&ash-inst; -&ash-config; -&ash-desc; +<sect2> +<title>Introduction to <application>ASH</application></title> + +<para><command>ash</command> is a shell that is the most compliant with the +Bourne Shell (not to be confused with Bourne Again SHell i.e., <application>Bash</application> +installed in <acronym>LFS</acronym>) without any additional features. +Bourne Shell is available on most commercial +<acronym>UNIX</acronym> systems. Hence <command>ash</command> is useful for testing +scripts to be <command>sh</command>-compliant. It also has a small memory and space requirements +compared to the other <command>sh</command>-compliant shells.</para> + +<sect3><title>Package information</title> +<itemizedlist spacing='compact'> +<listitem><para>Download (HTTP): <ulink +url="&ash-download-http;"/></para></listitem> +<listitem><para>Download (FTP): <ulink +url="&ash-download-ftp;"/></para></listitem> +<listitem><para>Download size: &ash-size;</para></listitem> +<listitem><para>Estimated Disk space required: +&ash-buildsize;</para></listitem> +<listitem><para>Estimated build time: +&ash-time;</para></listitem></itemizedlist> +</sect3> + +<sect3><title>Additional downloads</title> +<itemizedlist spacing='compact'> +<listitem><para>Required patch: +<ulink url="&patch-root;/ash-&ash-version;-cumulative_fixes-1.patch"/></para></listitem> +</itemizedlist> +</sect3> + +</sect2> + +<sect2> +<title>Installation of <application>ASH</application></title> + +<para>Install <application>ASH</application> by running the following commands:</para> + +<screen><userinput><command>patch -Np1 -i ../ash-0.4.0-cumulative_fixes-1.patch && +make && +install -m 755 sh /bin/ash && +install -m 644 sh.1 /usr/share/man/man1/ash.1</command></userinput></screen> + +<para>If you would like to make <command>ash</command> the default sh shell, make a symlink.</para> + +<screen><userinput><command>ln -sf ash /bin/sh</command></userinput></screen> + +</sect2> + +<sect2> +<title>Configuring <application>ASH</application></title> + +<sect3><title>Config files</title> +<para><application>ASH</application> sources <filename>/etc/profile</filename> +and <filename>$HOME/.profile</filename></para> +</sect3> + +</sect2> + +<sect2> +<title>Contents</title> + +<para>The <application>ASH</application> package contains <command>ash</command>, +a <command>sh</command> compliant shell.</para> + +</sect2> + +<sect2><title>Description</title> + +<sect3><title>ash</title> +<para><command>ash</command> is a <command>sh</command>-compliant shell.</para> +</sect3> + +</sect2> </sect1> diff --git a/postlfs/shells/shells.xml b/postlfs/shells/shells.xml index aab0373e17..6c495e40b3 100644 --- a/postlfs/shells/shells.xml +++ b/postlfs/shells/shells.xml @@ -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-shells"> <?dbhtml filename="shells.html"?> <title>Shells</title> @@ -7,8 +14,8 @@ other user interfaces that are considered useful modern shells -- the Berkeley Unix C shell and the Korn shell. This chapter installs packages compatible with these additional shell types.</para> -&ash; -&tcsh; -&zsh; +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ash.xml"/> +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tcsh.xml"/> +<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="zsh.xml"/> </chapter> diff --git a/postlfs/shells/tcsh.xml b/postlfs/shells/tcsh.xml index 37e005c751..618fd7e982 100644 --- a/postlfs/shells/tcsh.xml +++ b/postlfs/shells/tcsh.xml @@ -1,12 +1,100 @@ +<?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 tcsh-download-http "http://gd.tuwien.ac.at/utils/shells/tcsh/tcsh-&tcsh-version;.tar.gz"> + <!ENTITY tcsh-download-ftp " "> + <!ENTITY tcsh-size "804 KB"> + <!ENTITY tcsh-buildsize "9.0 MB"> + <!ENTITY tcsh-time "0.16 SBU"> + +]> + <sect1 id="tcsh" xreflabel="Tcsh-&tcsh-version;"> <?dbhtml filename="tcsh.html"?> <title>Tcsh-&tcsh-version;</title> -&tcsh-intro; -&tcsh-inst; -&tcsh-exp; -&tcsh-config; -&tcsh-desc; +<sect2> +<title>Introduction to <application>Tcsh</application></title> + +<para>The <application>Tcsh</application> package contains "an enhanced but completely compatible +version of the Berkeley Unix C shell (csh)". This is useful as an +alternative shell for those who prefer C syntax to that of the bash +shell, and also because some programs require the C shell in order to +install.</para> + +<sect3><title>Package information</title> +<itemizedlist spacing='compact'> +<listitem><para>Download (HTTP): <ulink +url="&tcsh-download-http;"/></para></listitem> +<listitem><para>Download (FTP): <ulink +url="&tcsh-download-ftp;"/></para></listitem> +<listitem><para>Download size: &tcsh-size;</para></listitem> +<listitem><para>Estimated Disk space required: +&tcsh-buildsize;</para></listitem> +<listitem><para>Estimated build time: +&tcsh-time;</para></listitem></itemizedlist> +</sect3> + +</sect2> + +<sect2> +<title>Installation of <application>Tcsh</application></title> + +<para>Install <application>Tcsh</application> by running the following commands:</para> + +<screen><userinput><command>./configure --prefix=/usr && +make && +make install && +make install.man && +ln -sf /usr/bin/tcsh /bin/csh</command></userinput></screen> + +</sect2> + +<sect2> +<title>Command explanations</title> + +<para><command>ln -sf /usr/bin/tcsh /bin/csh</command>: The +<acronym>FHS</acronym> states that +if there is a <application>C</application> shell installed, there should be a symlink from +<filename>/bin/csh</filename> to it. This creates that symlink.</para> + +</sect2> + +<sect2> +<title>Configuring <application>Tcsh</application></title> + +<sect3><title>Config files</title> +<para>There are numerous configuration files for the C shell. Examples +of these are <filename>/etc/csh.cshrc</filename>, +<filename>/etc/csh.login</filename>, <filename>~/.tcshrc</filename>, +<filename>~/.cshrc</filename>, <filename>~/.history</filename>, +<filename>~/.login</filename>, <filename>~/.cshdirs</filename>, +<filename>/etc/csh.logout</filename>, <filename>~/.logout</filename> and +<filename>~/.logout</filename>. More information on these files can be +found in the <filename>tcsh(1)</filename> man page.</para> +</sect3> + +</sect2> + +<sect2> +<title>Contents</title> + +<para>The <application>Tcsh</application> package contains +<command>tcsh</command>.</para> + +</sect2> + +<sect2><title>Description</title> + +<sect3><title>tcsh</title> +<para><command>tcsh</command> is an enhanced but completely compatible version of the +Berkeley Unix C shell, csh. It is usable as both an interactive shell +and a script processor.</para></sect3> + +</sect2> </sect1> diff --git a/postlfs/shells/zsh.xml b/postlfs/shells/zsh.xml index c482b39f35..217bcbca39 100644 --- a/postlfs/shells/zsh.xml +++ b/postlfs/shells/zsh.xml @@ -1,11 +1,90 @@ +<?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 zsh-download-http "http://www.zsh.org/pub/zsh-&zsh-version;.tar.bz2"> + <!ENTITY zsh-download-ftp "ftp://ftp.zsh.org/zsh/zsh-&zsh-version;.tar.bz2"> + <!ENTITY zsh-size "1.9 MB"> + <!ENTITY zsh-buildsize "17 MB"> + <!ENTITY zsh-time "0.51 SBU"> +]> + <sect1 id="zsh" xreflabel="ZSH-&zsh-version;"> <?dbhtml filename="zsh.html"?> <title>ZSH-&zsh-version;</title> -&zsh-intro; -&zsh-inst; -&zsh-config; -&zsh-desc; +<sect2> +<title>Introduction to <application>ZSH</application></title> + +<para>The <application>ZSH</application> package contains a command +interpreter (shell) usable as an interactive login shell and as +a shell script command processor. Of the standard shells, +<application>ZSH</application> most +closely resembles <application>KSH</application> but includes many enhancements.</para> + +<sect3><title>Package information</title> +<itemizedlist spacing='compact'> +<listitem><para>Download (HTTP): <ulink +url="&zsh-download-http;"/></para></listitem> +<listitem><para>Download (FTP): <ulink +url="&zsh-download-ftp;"/></para></listitem> +<listitem><para>Download size: &zsh-size;</para></listitem> +<listitem><para>Estimated Disk space required: +&zsh-buildsize;</para></listitem> +<listitem><para>Estimated build time: +&zsh-time;</para></listitem></itemizedlist> +</sect3> + +<sect3><title><application>ZSH</application> dependencies</title> +<sect4><title>Optional</title> +<para><xref linkend="pcre"/></para></sect4> +</sect3> + +</sect2> + +<sect2> +<title>Installation of <application>ZSH</application></title> + +<para>Install <application>ZSH</application> by running the following commands:</para> + +<screen><userinput><command>./configure --prefix=/usr && +make && +make install</command></userinput></screen> + +</sect2> + +<sect2> +<title>Configuring <application>ZSH</application></title> + +<sect3><title>Config files</title> +<para>There are a whole host of configuration files for +<application>ZSH</application> including +<filename>/etc/zshenv</filename>, <filename>/etc/zprofile</filename>, +<filename>/etc/zshrc</filename>, <filename>/etc/zlogin</filename>, and +<filename>/etc/zlogout</filename>. You can find more information on +these in the <filename>zsh(1)</filename> and related +man pages.</para> +</sect3> + +</sect2> + +<sect2> +<title>Contents</title> + +<para>The <application>ZSH</application> package contains <command>zsh</command>.</para> + +</sect2> + +<sect2><title>Description</title> + +<sect3><title>zsh</title> +<para><command>zsh</command> is a shell which has command-line editing, built-in spelling +correction, programmable command completion, shell functions (with +autoloading), a history mechanism, and a host of other features.</para></sect3> + +</sect2> </sect1> |