r3163 - in trunk/BOOK: . general/prog introduction/welcome server/other

randy at linuxfromscratch.org randy at linuxfromscratch.org
Fri Dec 31 13:06:51 PST 2004


Author: randy
Date: 2004-12-31 14:06:50 -0700 (Fri, 31 Dec 2004)
New Revision: 3163

Added:
   trunk/BOOK/general/prog/pdl.xml
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/prog/nasm.xml
   trunk/BOOK/general/prog/perl-modules.xml
   trunk/BOOK/general/prog/prog.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/introduction/welcome/credits.xml
   trunk/BOOK/server/other/rsync.xml
Log:
Moved the PDL Perl bundle to its own BLFS page

Modified: trunk/BOOK/general/prog/nasm.xml
===================================================================
--- trunk/BOOK/general/prog/nasm.xml	2004-12-30 09:21:06 UTC (rev 3162)
+++ trunk/BOOK/general/prog/nasm.xml	2004-12-31 21:06:50 UTC (rev 3163)
@@ -9,7 +9,6 @@
 <!ENTITY NASM-size "536 KB">
 <!ENTITY NASM-buildsize "6.3 MB">
 <!ENTITY NASM-time "0.14 SBU">
-
 ]>
 
 <sect1 id="NASM" xreflabel="NASM-&NASM-version;">
@@ -21,50 +20,58 @@
 <title>NASM-&NASM-version;</title>
 
 <sect2>
-<title>Introduction to <application><acronym>NASM</acronym></application></title>
-                                                                               
-<para><application><acronym>NASM</acronym></application> (Netwide Assembler) is                                                                               
-an 80x86 assembler designed for portability and modularity. It includes a
+<title>Introduction to 
+<application><acronym>NASM</acronym></application></title>
+
+<para><application><acronym>NASM</acronym></application> (Netwide Assembler) 
+is an 80x86 assembler designed for portability and modularity. It includes a 
 disassembler as well.</para>
-                                                                               
+
 <sect3><title>Package information</title>
 <itemizedlist spacing='compact'>
-<listitem><para>Download (HTTP): <ulink url="&NASM-download-http;"/></para></listitem>
-<listitem><para>Download (FTP): <ulink url="&NASM-download-ftp;"/></para></listitem>
+<listitem><para>Download (HTTP): 
+<ulink url="&NASM-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): 
+<ulink url="&NASM-download-ftp;"/></para></listitem>
 <listitem><para>Download size: &NASM-size;</para></listitem>
-<listitem><para>Estimated Disk space required: &NASM-buildsize;</para></listitem>
-<listitem><para>Estimated build time: &NASM-time;</para></listitem></itemizedlist>
+<listitem><para>Estimated disk space required: 
+&NASM-buildsize;</para></listitem>
+<listitem><para>Estimated build time: 
+&NASM-time;</para></listitem></itemizedlist>
 </sect3>
-                                                                               
+
 </sect2>
 
 <sect2>
-<title>Installation of <application><acronym>NASM</acronym></application></title>
-                                                                               
-<para>Install <application><acronym>NASM</acronym></application> by running thefollowing commands:</para>
-                                                                               
+<title>Installation of 
+<application><acronym>NASM</acronym></application></title>
+
+<para>Install <application><acronym>NASM</acronym></application> by running 
+the following commands:</para>
+
 <screen><userinput><command>./configure --prefix=/usr &&
 make &&
 make install</command></userinput></screen>
-                                                                               
+
 </sect2>
 
 <sect2>
 <title>Contents</title>
-                                                                               
-<para>The <application><acronym>NASM</acronym></application> package contains <command>nasm
-</command> and <command>ndisasm</command> programs.</para>
-                                                                               
+
+<para>The <application><acronym>NASM</acronym></application> package contains 
+<command>nasm</command> and <command>ndisasm</command> programs.</para>
+
 </sect2>
-                                                                               
+
 <sect2><title>Description</title>
-                                                                               
+
 <sect3><title>nasm</title>
 <para><command>nasm</command> is a portable 80x86 assembler.</para></sect3>
-                                                                               
+
 <sect3><title>ndisasm</title>
-<para><command>ndisasm</command> is an 80x86 binary file disassembler.</para></sect3>
-                                                                               
+<para><command>ndisasm</command> is an 80x86 binary file 
+disassembler.</para></sect3>
+
 </sect2>
 
 </sect1>

Added: trunk/BOOK/general/prog/pdl.xml
===================================================================
--- trunk/BOOK/general/prog/pdl.xml	2004-12-30 09:21:06 UTC (rev 3162)
+++ trunk/BOOK/general/prog/pdl.xml	2004-12-31 21:06:50 UTC (rev 3163)
@@ -0,0 +1,469 @@
+<?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 pdl-download-http "http://prdownloads.sourceforge.net/pdl/PDL-&pdl-version;.tar.gz?download">
+<!ENTITY pdl-download-ftp  " ">
+<!ENTITY pdl-md5sum        "N/A">
+<!ENTITY pdl-size          "2.1 MB">
+<!ENTITY pdl-buildsize     "74 MB">
+<!ENTITY pdl-time          "2.56 SBU">
+]>
+
+<sect1 id="pdl" xreflabel="PDL">
+<sect1info>
+<othername>$LastChangedBy$</othername>
+<date>$Date$</date>
+</sect1info>
+<?dbhtml filename="pdl.html" ?>
+<title><application><acronym>PDL</acronym></application>-&pdl-version;</title>
+
+<sect2>
+<title>Introduction to 
+<application><acronym>PDL</acronym></application></title>
+
+<para><application><acronym>PDL</acronym></application> (Perl Data Language) 
+gives standard <application><acronym>Perl</acronym></application> the ability 
+to compactly store and quickly manipulate the large N-dimensional data arrays 
+common to scientific computing. 
+<application><acronym>PDL</acronym></application> turns 
+<application><acronym>Perl</acronym></application> into an array-oriented, 
+numerical language similar to such commerical packages as 
+<application>IDL</application> and <application>MatLab</application>. One can 
+write simple <application><acronym>Perl</acronym></application> expressions to 
+manipulate entire numerical arrays all at once.</para>
+
+<para><application><acronym>PDL</acronym></application> provides extensive 
+numerical and semi-numerical functionality with support for two- and 
+three-dimensional visualisation as well as a variety of I/O formats. The goal 
+is to allow <application><acronym>PDL</acronym></application> to interact with 
+a variety of external numerical packages, graphics and visualisation systems. 
+Easy interfacing to such systems is one of the core design features of 
+<application><acronym>PDL</acronym></application>.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP):
+<ulink url="&pdl-download-http;"/></para></listitem>
+<listitem><para>Download (FTP):
+<ulink url="&pdl-download-ftp;"/></para></listitem>
+<listitem><para>Download MD5 sum: &pdl-md5sum;</para></listitem>
+<listitem><para>Download size: &pdl-size;</para></listitem>
+<listitem><para>Estimated disk space required:
+&pdl-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&pdl-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3>
+<title><application><acronym>PDL</acronym></application> dependencies</title>
+
+<para><application><acronym>PDL</acronym></application> is a collection of 
+over 90 <application><acronym>Perl</acronym></application> modules. Some of 
+these modules require additional libraries and/or 
+<application><acronym>Perl</acronym></application> modules for full
+functionality. Listed below are the modules which require additional software 
+or configuration. If you don't need a particular module's functionality, you 
+don't need to install its dependencies. The dependency tree for each module 
+is listed downward, meaning you'll need to start at the bottom of a module's
+tree and work up. The dependencies are listed in the same order as they are 
+in the <filename>DEPENDENCIES</filename> file, found in the package source 
+tree.</para>
+
+<sect4>
+<title><application><acronym>PDL</acronym></application>::NiceSlice</title>
+<para>The <application><acronym>PDL</acronym></application>::NiceSlice 
+module is used to enhance <application><acronym>PDL</acronym></application>'s 
+slice syntax. <quote>Slicing</quote> is a term used in the process of creating 
+a cross-section, or slice, of a 
+<application><acronym>PDL</acronym></application> object (piddle).</para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/P/PM/PMQS/Filter-&Filter-version;.tar.gz">
+Filter-&Filter-version;</ulink></para>
+</listitem></itemizedlist>
+</sect4>
+
+<sect4>
+<title>Inline::Pdlpp</title>
+<para>The Inline::Pdlpp module allows you to define fast <acronym>PP</acronym> 
+code inline in your scripts.</para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/I/IN/INGY/Inline-&Inline-version;.tar.gz">
+Inline-&Inline-version;</ulink></para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/D/DC/DCONWAY/Parse-RecDescent-&Parse-RecDescent-version;.tar.gz">
+Parse-RecDescent-&Parse-RecDescent-version;</ulink></para>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</sect4>
+
+<sect4><title>perldl</title>
+<para><command>perldl</command> is a simple shell (written in 
+<application><acronym>Perl</acronym></application>) which allows interactive 
+use of <application><acronym>PDL</acronym></application>.</para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/H/HA/HAYASHI/Term-ReadLine-Gnu-&Term-ReadLine-Gnu-version;.tar.gz">
+Term-ReadLine-Gnu-&Term-ReadLine-Gnu-version;</ulink></para>
+</listitem></itemizedlist>
+</sect4>
+
+<sect4>
+<title><application><acronym>PDL</acronym></application>::Graphics::TriD</title>
+<para>The <application><acronym>PDL</acronym></application>::Graphics::TriD 
+module implements a generic <acronym>3D</acronym> plotting interface for 
+<application><acronym>PDL</acronym></application>. Points, lines and surfaces 
+(among other objects) are supported.</para>
+
+<itemizedlist spacing='compact'><listitem>
+<para>Open<acronym>GL</acronym> (<xref linkend="xfree86"/> or 
+<xref linkend="xorg"/>)</para>
+</listitem></itemizedlist>
+</sect4>
+
+<sect4>
+<title>
+<application><acronym>PDL</acronym></application>::Graphics::PGPLOT</title>
+<para>The <application><acronym>PDL</acronym></application>::Graphics::PGPLOT 
+module is a convenience interface to the <application>PGPLOT</application> 
+commands, implemented using the object oriented 
+<application>PGPLOT</application> plotting package in the 
+<application><acronym>PDL</acronym></application>::Graphics::PGPLOT::Window 
+module.</para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/K/KG/KGB/PGPLOT-&pgperl-version;.tar.gz">
+pgperl</ulink></para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/K/KG/KGB/ExtUtils-F77-&ExtUtils-F77-version;.tar.gz">
+ExtUtils-F77-&ExtUtils-F77-version;</ulink></para>
+
+<itemizedlist spacing='compact'><listitem>
+<para><xref linkend="gcc"/> (Fortran compiler)</para>
+</listitem></itemizedlist>
+</listitem>
+
+<listitem><para><ulink 
+url="http://www.astro.caltech.edu/~tjp/pgplot/">PGPLOT</ulink></para>
+
+<itemizedlist spacing='compact'><listitem>
+<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), 
+<xref linkend="lesstif"/>, 
+<xref linkend="tk"/> and 
+<xref linkend="gcc"/> (Fortran compiler)</para>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</sect4>
+
+<sect4>
+<title>
+<application><acronym>PDL</acronym></application>::Graphics::PLPLOT</title>
+<para>The <application><acronym>PDL</acronym></application>::Graphics::PLPLOT 
+module is a simple interface to the <application>PLplot</application> plotting 
+library.</para>
+
+<itemizedlist spacing='compact'><listitem>
+<para><ulink url="http://plplot.sourceforge.net/">PLplot</ulink></para>
+
+<itemizedlist spacing='compact'><listitem>
+<para><xref linkend="pkgconfig"/>, 
+X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), 
+<xref linkend="GTK"/>, 
+<xref linkend="freetype2"/>, 
+<ulink url="http://www.boutell.com/gd/">GD</ulink>, 
+<ulink url="http://www.svgalib.org/">SVGAlib</ulink>, 
+<xref linkend="gnome-libs"/>, 
+<xref linkend="j2sdk"/>, 
+<xref linkend="tk"/>, 
+<xref linkend="Python"/> (with the 
+<ulink url="http://www.pfdubois.com/numpy/">Numerical Extension</ulink>), 
+<xref linkend="gcc"/> (Fortran compiler), 
+<ulink url="http://www.swig.org/">SWIG</ulink>, 
+<ulink url="http://sourceforge.net/projects/incrtcl/">iTcl</ulink></para>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</sect4>
+
+<sect4>
+<title><application><acronym>PDL</acronym></application>::Graphics::IIS</title>
+<para>The <application><acronym>PDL</acronym></application>::Graphics::IIS 
+module provides an interface to any image display <quote>device</quote> which 
+supports the <quote>IIS protocol</quote>.</para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://tdc-www.harvard.edu/software/saoimage.html">SAOimage</ulink></para>
+
+<itemizedlist spacing='compact'><listitem>
+<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
+</listitem></itemizedlist>
+</listitem>
+
+<listitem><para><ulink 
+url="http://iraf.noao.edu/iraf/web/projects/x11iraf/x11iraf.html">
+X11 IRAF</ulink></para>
+
+<itemizedlist spacing='compact'><listitem>
+<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and 
+<xref linkend="tk"/></para>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</sect4>
+
+<sect4>
+<title>
+<application><acronym>PDL</acronym></application>::Graphics::Karma</title>
+<para>The <application><acronym>PDL</acronym></application>::Graphics::Karma 
+module is an interface to <application>Karma</application> visualisation 
+applications.</para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.atnf.csiro.au/computing/software/karma/">Karma</ulink></para>
+
+<itemizedlist spacing='compact'><listitem>
+<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+
+<para><emphasis>Note:</emphasis> You may need to modify the 
+<parameter>WHERE_KARMA => undef</parameter> line in the source tree 
+<filename>perldl.conf</filename> file to point to your installation 
+of <application>Karma</application></para>
+</sect4>
+
+<sect4>
+<title>
+<application><acronym>PDL</acronym></application>::<acronym>IO</acronym>::Pic
+</title>
+<para> The 
+<application><acronym>PDL</acronym></application>::<acronym>IO</acronym>::Pic 
+module implements I/O for a number of popular image formats by exploiting the 
+<command>xxxtopnm</command> and <command>pnmtoxxx</command> converters from 
+the <application>Netpbm</application> package and the <command>cjpeg</command> 
+and <command>djpeg</command> converters. It also  contains the routine wmpeg 
+to write <acronym>MPEG</acronym> movies from piddles representing image 
+stacks.</para>
+
+<itemizedlist spacing='compact'><listitem>
+<para><ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink>, 
+<xref linkend="libjpeg"/> and 
+<ulink url="ftp://mm-ftp.cs.berkeley.edu/pub/multimedia/mpeg/encode/">
+mpeg_encode</ulink></para>
+</listitem></itemizedlist>
+</sect4>
+
+<sect4>
+<title><application><acronym>PDL</acronym></application>::Slatec</title>
+<para> The <application><acronym>PDL</acronym></application>::Slatec module 
+serves the dual purpose of providing an interface to parts of the slatec 
+library and showing how to interface 
+<application><acronym>PDL</acronym></application> to an external library. 
+The module provides routines to manipulate matrices, calculate 
+<acronym>FFT</acronym>s, fit data using polynomials, and interpolate/integrate 
+data using piecewise cubic Hermite interpolation.</para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/K/KG/KGB/ExtUtils-F77-&ExtUtils-F77-version;.tar.gz">
+ExtUtils-F77-&ExtUtils-F77-version;</ulink></para>
+
+<itemizedlist spacing='compact'><listitem>
+<para><xref linkend="gcc"/> (Fortran compiler)</para>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</sect4>
+
+<sect4>
+<title>
+<application><acronym>PDL</acronym></application>::<application><acronym>GSL</acronym></application>
+</title>
+<para> The 
+<application><acronym>PDL</acronym></application>::<application><acronym>GSL</acronym></application> 
+module is an interface to the functions provided by the <acronym>Gnu</acronym> 
+Scientific Library.</para>
+
+<itemizedlist><listitem>
+<para><ulink url="http://www.gnu.org/software/gsl/">GSL</ulink></para>
+</listitem></itemizedlist>
+</sect4>
+
+<sect4>
+<title>
+<application><acronym>PDL</acronym></application>::<application><acronym>FFTW</acronym></application>
+</title>
+<para> The 
+<application><acronym>PDL</acronym></application>::<application><acronym>FFTW</acronym></application> 
+module is a means to interface 
+<application><acronym>PDL</acronym></application> with the 
+<application><acronym>FFTW</acronym></application> library. It's similar to 
+the standard <acronym>FFT</acronym> routine but it's usually faster and has 
+support for real transforms. It works well for the types of piddles for which 
+the library was compiled (otherwise it must do conversions).</para>
+
+<itemizedlist><listitem>
+<para><ulink url="http://www.fftw.org/">FFTW-2.x</ulink></para>
+</listitem></itemizedlist>
+</sect4>
+
+<sect4>
+<title>
+<application><acronym>PDL</acronym></application>::<acronym>IO</acronym>::Browser
+</title>
+<para> The
+<application><acronym>PDL</acronym></application>::<acronym>IO</acronym>::Browser 
+module is a <acronym>2D</acronym> cursor terminal data browser for 
+piddles.</para>
+
+<para>There is no additional software required to use the module. However, 
+the default is to not install the module because some platforms don't provide 
+a curses compatible library. To enable the module, issue the following 
+command:</para>
+
+<screen><userinput><command>sed -i -e "s/WITH_IO_BROWSER => 0/WITH_IO_BROWSER => 1/" \
+    perldl.conf</command></userinput></screen>
+</sect4>
+
+<sect4>
+<title>
+<application><acronym>PDL</acronym></application>::<acronym>IO</acronym>::<acronym>NDF</acronym>
+</title>
+<para>The 
+<application><acronym>PDL</acronym></application>::<acronym>IO</acronym>::<acronym>NDF</acronym> 
+module adds the ability to read and write Starlink N-dimensional data files 
+as N-dimensional piddles.</para>
+
+<itemizedlist><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/A/AA/AALLAN/Astro-FITS-Header-&Astro-FITS-Header-version;.tar.gz">
+Astro-FITS-Header-&Astro-FITS-Header-version;</ulink></para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/P/PR/PRATZLAFF/Astro-FITS-CFITSIO-&Astro-FITS-CFITSIO-version;.tar.gz">
+Astro-FITS-CFITSIO-&Astro-FITS-CFITSIO-version;</ulink></para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://heasarc.gsfc.nasa.gov/docs/software/fitsio/">CFITSIO</ulink></para>
+</listitem></itemizedlist>
+</listitem>
+
+<listitem><para><ulink 
+url="ftp://ftp.starlink.rl.ac.uk/pub/ussc/store/starperl/starperl.tar.Z">
+NDFPERL-&NDF-version;</ulink></para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="ftp://ftp.starlink.rl.ac.uk/pub/ussc/store/starperl/starperl.tar.Z">
+Starlink-Config-&Starlink-Config-version;</ulink></para>
+
+<itemizedlist spacing='compact'><listitem>
+<para><ulink url="http://star-www.rl.ac.uk/">Starlink IMG</ulink></para>
+
+<itemizedlist spacing='compact'><listitem>
+<para><ulink url="http://star-www.rl.ac.uk/">Starlink NDF</ulink></para>
+
+<itemizedlist spacing='compact'><listitem>
+<para><xref linkend="gcc"/> (Fortran compiler)</para>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</listitem>
+
+<listitem><para><ulink 
+url="ftp://ftp.starlink.rl.ac.uk/pub/ussc/store/starperl/starperl.tar.Z">
+GSDPERL-&GSD-version;</ulink></para>
+
+<itemizedlist><listitem><para><ulink 
+url="ftp://ftp.starlink.rl.ac.uk/pub/ussc/store/starperl/starperl.tar.Z">
+Starlink-Config-&Starlink-Config-version;</ulink></para>
+
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://star-www.rl.ac.uk/">Starlink GSD</ulink></para>
+
+<itemizedlist spacing='compact'><listitem>
+<para><xref linkend="gcc"/> (Fortran compiler)</para>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</listitem></itemizedlist>
+</sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application><acronym>PDL</acronym></application></title>
+
+<para>Install <application><acronym>PDL</acronym></application> by running 
+the following commands:</para>
+
+<screen><userinput><command>perl Makefile.PL &&
+make &&
+make test &&
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Configuring <application><acronym>PDL</acronym></application></title>
+
+<sect3><title>Config files</title>
+<para><filename>~/.perldlrc</filename> and 
+<filename>local.perldlrc</filename> in the current directory</para>
+</sect3>
+
+<sect3><title>Configuration information</title>
+<para>See <ulink 
+url="http://pdl.sourceforge.net/PDLdocs/perldl.html#the startup file ~/.perldlrc"/> 
+for information about configuring <command>perldl</command> to suit your 
+needs.</para>
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application><acronym>PDL</acronym></application> package contains 
+<command>pdl</command>, 
+<command>pdldoc</command>, 
+<command>perldl</command>, 
+<command>pptemplate</command> and over 90 
+<application><acronym>Perl</acronym></application> modules.</para>
+
+</sect2>
+
+<sect2>
+<title>Description</title>
+
+<sect3><title>pdl</title>
+<para><command>pdl</command> is a binary program called from 
+<application><acronym>PDL</acronym></application> scripts which is used to 
+interface <command>perldl</command>.</para>
+</sect3>
+
+<sect3><title>pdldoc</title>
+<para><command>pdldoc</command> is a shell interface to 
+<application><acronym>PDL</acronym></application> documentation.</para>
+</sect3>
+
+<sect3><title>perldl</title>
+<para><command>perldl</command> is a simple shell (written in 
+<application><acronym>Perl</acronym></application>) for interactive use of 
+<application><acronym>PDL</acronym></application>.</para>
+</sect3>
+
+<sect3><title>pptemplate</title>
+<para><command>pptemplate</command> is a script to generate 
+<filename>Makefile.PL</filename> and <acronym>PP</acronym> file 
+skeletons.</para>
+</sect3>
+
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/general/prog/pdl.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/general/prog/perl-modules.xml
===================================================================
--- trunk/BOOK/general/prog/perl-modules.xml	2004-12-30 09:21:06 UTC (rev 3162)
+++ trunk/BOOK/general/prog/perl-modules.xml	2004-12-31 21:06:50 UTC (rev 3163)
@@ -3,8 +3,6 @@
    "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
-
-<!ENTITY LFS-Perl-version          "5.8.5">
 ]>
 
 <sect1 id="perl-modules" xreflabel="Perl modules">
@@ -13,7 +11,7 @@
 <date>$Date$</date>
 </sect1info>
 <?dbhtml filename="perl-modules.html" ?>
-<title>Perl modules</title>
+<title><application>Perl</application> modules</title>
 
 <sect2>
 <title>Introduction to <application>Perl</application> modules</title>
@@ -21,88 +19,81 @@
 <para>The <application>Perl</application> module packages add useful objects 
 to the <application>Perl</application> language.  Modules utilized by packages 
 throughout <acronym>BLFS</acronym> are listed here, along with their 
-dependencies.</para>
+dependencies. Most references to <application>Perl</application> modules are 
+in the form of Module, Module::SubName or Module::Sub::Name, however 
+occasionally you'll also see Module, Module-SubName or Module-Sub-Name. Most 
+references on this page are in the latter form, as these are the official 
+package names.</para>
 
-<sect3><title><application>Perl</application> Module Packages</title>
-<itemizedlist spacing='compact'>
-<listitem><para><ulink 
-url="http://search.cpan.org/CPAN/authors/id/C/CS/CSOE/PDL-&PDL-version;.tar.gz">PDL-&PDL-version;</ulink>
-</para>
+<sect3><title>The Module::Info module</title>
+<para>One module in particular is shown first, as this module's usefulness 
+warrants installation, even though it won't be required by many other modules. 
+The Module::Info module can tell you if a particular module is included in, 
+or has been installed into your <application>Perl</application> installation. 
+Additionally, the module can tell you what versions are installed and what 
+dependencies are required for them. You can even use Module::Info to gather 
+dependencies of uninstalled modules.</para>
 
 <itemizedlist spacing='compact'>
 <listitem><para><ulink 
-url="http://www.cpan.org/authors/id/K/KG/KGB/ExtUtils-F77-&ExtUtils-F77-version;.tar.gz">ExtUtils-F77-&ExtUtils-F77-version;</ulink>
+url="http://www.cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">Module-Info-&Module-Info-version;</ulink>
 </para></listitem>
+</itemizedlist>
+</sect3>
 
-<listitem><para><ulink 
-url="http://www.cpan.org/authors/id/I/IN/INGY/Inline-&Inline-version;.tar.gz">Inline-&Inline-version;</ulink>
-</para>
+<sect3><title><application>Perl</application> Module Packages</title>
 
-<itemizedlist spacing='compact'>
-<listitem><para><ulink 
-url="http://search.cpan.org/CPAN/authors/id/D/DC/DCONWAY/Parse-RecDescent-&Parse-RecDescent-version;.tar.gz">Parse-RecDescent-&Parse-RecDescent-version;</ulink>
-</para></listitem>
-</itemizedlist></listitem>
+<itemizedlist><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/M/ML/MLEHMANN/Gtk-Perl-&Gtk-Perl-version;.tar.gz">
+Gtk-Perl-&Gtk-Perl-version;</ulink></para>
 
-<listitem><para><ulink 
-url="http://search.cpan.org/CPAN/authors/id/A/AA/AALLAN/Astro-FITS-Header-&Astro-FITS-Header-version;.tar.gz">Astro-FITS-Header-&Astro-FITS-Header-version;</ulink>
-</para></listitem>
-</itemizedlist></listitem>
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/J/JO/JOSEPHW/XML-Writer-&XML-Writer-version;.tar.gz">
+XML-Writer-&XML-Writer-version;</ulink></para>
+</listitem>
 
 <listitem><para><ulink 
-url="http://search.cpan.org/CPAN/authors/id/M/ML/MLEHMANN/Gtk-Perl-&Gtk-Perl-version;.tar.gz">Gtk-Perl-&Gtk-Perl-version;</ulink>
-</para>
+url="http://www.cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
+XML-Parser-&XML-Parser-version;</ulink></para>
 
-<itemizedlist spacing='compact'>
-<listitem><para><ulink 
-url="http://www.cpan.org/authors/id/J/JO/JOSEPHW/XML-Writer-&XML-Writer-version;.tar.gz">XML-Writer-&XML-Writer-version;</ulink>
-</para></listitem>
+<itemizedlist spacing='compact'><listitem>
+<para><xref linkend="expat"/></para>
+</listitem></itemizedlist>
+</listitem>
 
-<listitem><para><ulink 
-url="http://search.cpan.org/CPAN/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">XML-Parser-&XML-Parser-version;</ulink>
-</para>
-
-<itemizedlist spacing='compact'>
-<listitem><para><xref linkend="expat"/></para></listitem>
-</itemizedlist></listitem>
-
-<listitem><para><xref linkend="GTK"/></para>
+<listitem>
+<para><xref linkend="GTK"/></para>
+</listitem></itemizedlist>
 </listitem>
-</itemizedlist></listitem>
 
 <listitem><para><ulink 
-url="http://www.cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">SGMLSpm-&SGMLSpm-version;</ulink>
-</para></listitem>
+url="http://www.cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
+SGMLSpm-&SGMLSpm-version;</ulink></para>
+</listitem>
 
 <listitem><para><ulink 
-url="http://www.cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">Tk-&Perl-Tk-version;</ulink>
-</para>
+url="http://www.cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">
+Tk-&Perl-Tk-version;</ulink></para>
 
-<itemizedlist spacing='compact'>
-<listitem><para><xref linkend="tk"/> and 
-<xref linkend="libjpeg"/></para></listitem>
-</itemizedlist></listitem>
+<itemizedlist spacing='compact'><listitem>
+<para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
+</listitem></itemizedlist>
+</listitem>
 
 <listitem><para><ulink 
-url="http://www.cpan.org/authors/id/C/CR/CREIN/Net-DNS-&Net-DNS-version;.tar.gz">Net-DNS-&Net-DNS-version;</ulink>
-</para>
+url="http://www.cpan.org/authors/id/C/CR/CREIN/Net-DNS-&Net-DNS-version;.tar.gz">
+Net-DNS-&Net-DNS-version;</ulink></para>
 
-<itemizedlist spacing='compact'>
-<listitem><para><ulink 
-url="http://www.cpan.org/authors/id/G/GA/GAAS/Digest-MD5-&Digest-MD5-version;.tar.gz">Digest-MD5-&Digest-MD5-version;</ulink>
-</para></listitem>
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">
+Digest-HMAC-&Digest-HMAC-version;</ulink></para>
 
-<listitem><para><ulink 
-url="http://www.cpan.org/authors/id/G/GA/GAAS/Digest-HMAC-&Digest-HMAC-version;.tar.gz">Digest-HMAC-&Digest-HMAC-version;</ulink>
-</para>
-
-<itemizedlist spacing='compact'>
-<listitem><para><ulink 
-url="http://www.cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">Digest-SHA1-&Digest-SHA1-version;</ulink>
-</para></listitem></itemizedlist>
+<itemizedlist spacing='compact'><listitem><para><ulink 
+url="http://www.cpan.org/authors/id/G/GA/GAAS/Digest-SHA1-&Digest-SHA1-version;.tar.gz">
+Digest-SHA1-&Digest-SHA1-version;</ulink></para>
 </listitem></itemizedlist>
 </listitem></itemizedlist>
-
+</listitem></itemizedlist>
 </sect3>
 
 </sect2>
@@ -121,16 +112,14 @@
 <para>The modules listed below require modifications to the instructions in 
 order to install successfully.</para>
                                                                                
-<sect3>
-<title>Gtk-Perl-&Gtk-Perl-version;:</title>
-                                                                               
+<sect3><title>Gtk-Perl-&Gtk-Perl-version;:</title>
 <screen><userinput><command>perl Makefile.PL --without-guessing &&
 make &&
 make test &&
-make install</command></userinput></screen></sect3>
+make install</command></userinput></screen>
+</sect3>
                                                                                
-<sect3>
-<title>SGMLSpm-&SGMLSpm-version;</title>
+<sect3><title>SGMLSpm-&SGMLSpm-version;</title>
                                                                                
 <para>If your system's <application>Perl</application> version is different 
 than &LFS-Perl-version;, you'll need to modify the <command>sed</command> 
@@ -151,18 +140,22 @@
 
 <sect2><title>(Alternate) Auto installation of <application>Perl</application>
 modules.</title>
-                                                                               
-<para>There is an alternate way of installing the modules using
-<application>Perl</application>'s built-in <command>install</command> command.
+
+<para>There is an alternate way of installing the modules using 
+<application>Perl</application>'s built-in <command>install</command> command. 
 The command automatically downloads the source from the <acronym>CPAN</acronym> 
-archive, extracts it, runs the commands mentioned above, and removes
-the build tree.</para>
+archive, extracts it, runs the commands mentioned above, and removes the build 
+tree. You may still need to install dependent library packages before running 
+the automated installation method.</para>
                                                                                
-<para>Start the perl shell with the commands:</para>
+<para>The first time you run this command, you'll be prompted to enter some 
+information regarding download locations and methods. This information is 
+retained in files located in <filename class='directory'>~/.cpan</filename>. 
+Start the perl shell with the following command:</para>
                                                                                
 <screen><userinput><command>perl -MCPAN -e shell</command></userinput></screen>                                                                               
 <para>Each module may now be installed from this shell with the command:</para>                                                                               
-<screen><userinput><command>install <moduleName></command></userinput></screen>
+<screen><userinput><command>install <replaceable>[ModuleName]</replaceable></command></userinput></screen>
                                                                                
 <para>For additional commands and help, type <command>help</command>.</para>
                                                                                

Modified: trunk/BOOK/general/prog/prog.xml
===================================================================
--- trunk/BOOK/general/prog/prog.xml	2004-12-30 09:21:06 UTC (rev 3162)
+++ trunk/BOOK/general/prog/prog.xml	2004-12-31 21:06:50 UTC (rev 3163)
@@ -18,6 +18,7 @@
 
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="python.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="perl-modules.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pdl.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="librep.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="j2sdk.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ruby.xml"/>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2004-12-30 09:21:06 UTC (rev 3162)
+++ trunk/BOOK/general.ent	2004-12-31 21:06:50 UTC (rev 3163)
@@ -1,8 +1,8 @@
-<!ENTITY day          "30">
+<!ENTITY day          "31">
 <!ENTITY month        "12">
 <!ENTITY year         "2004">
 <!ENTITY version      "svn-&year;&month;&day;">
-<!ENTITY releasedate  "December &day;th, &year;">
+<!ENTITY releasedate  "December &day;st, &year;">
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
 <!ENTITY blfs-version "cvs">                  <!-- cvs|[release #] -->
 <!ENTITY lfs-version  "stable">               <!-- stable|testing|unstable] -->
@@ -130,18 +130,18 @@
                                      
 <!-- Chapter 12 -->                  
 <!ENTITY Python-version               "2.3.4">
+<!ENTITY LFS-Perl-version             "5.8.5">
 <!ENTITY Module-Info-version          "0.26">
 <!ENTITY Gtk-Perl-version             "0.7009">
 <!ENTITY XML-Parser-version           "2.34">
 <!ENTITY XML-Writer-version           "0.510">
 <!ENTITY SGMLSpm-version              "1.03ii">
 <!ENTITY Perl-Tk-version              "804.027">
-<!ENTITY Digest-MD5-version           "2.33">
 <!ENTITY Net-DNS-version              "0.48">
 <!ENTITY Digest-HMAC-version          "1.01">
 <!ENTITY Digest-SHA1-version          "2.10">
 <!ENTITY LWP-version                  "5.803">
-<!ENTITY PDL-version                  "2.4.1">
+<!ENTITY pdl-version                  "2.4.2">
 <!ENTITY Filter-version               "1.30">
 <!ENTITY Term-ReadLine-Gnu-version    "1.15">
 <!ENTITY ExtUtils-F77-version         "1.14">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2004-12-30 09:21:06 UTC (rev 3162)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2004-12-31 21:06:50 UTC (rev 3163)
@@ -22,6 +22,9 @@
 
 <itemizedlist>
 
+<listitem><para>December 31st, 2004 [randy]: Moved PDL Perl bundle to its 
+own BLFS page.</para></listitem>
+
 <listitem><para>December 30th, 2004 [dj]: Simplified OOo instructions, 
 suggested by Anderson Lizardo.</para></listitem>
 

Modified: trunk/BOOK/introduction/welcome/credits.xml
===================================================================
--- trunk/BOOK/introduction/welcome/credits.xml	2004-12-30 09:21:06 UTC (rev 3162)
+++ trunk/BOOK/introduction/welcome/credits.xml	2004-12-31 21:06:50 UTC (rev 3163)
@@ -153,7 +153,7 @@
 <listitem><para>Apache Ant, Cyrus-SASL, DejaGnu, desktop-file-utils, 
 DocBook-utils, Ethereal, Evolution Data Server, Expect, GNOME Doc Utils, 
 Heimdal, HTML Tidy, JadeTeX, Java Access Bridge, libgail-gnome, libgnomecups, 
-MPlayer (extensive overhaul), Perl Modules (Net-DNS, SGMLSpm and Tk), 
+MPlayer (extensive overhaul), PDL, Perl Modules (Net-DNS, SGMLSpm and Tk), 
 pilot-link, SANE (original instructions by Alex Kloss), SLIB, Stunnel and 
 Sysstat: <emphasis>Randy McMurchy</emphasis></para></listitem>
 

Modified: trunk/BOOK/server/other/rsync.xml
===================================================================
--- trunk/BOOK/server/other/rsync.xml	2004-12-30 09:21:06 UTC (rev 3162)
+++ trunk/BOOK/server/other/rsync.xml	2004-12-31 21:06:50 UTC (rev 3163)
@@ -33,7 +33,7 @@
 <listitem><para>Download (FTP): 
 <ulink url="&rsync-download-ftp;"/></para></listitem>
 <listitem><para>Download size: &rsyncd-size;</para></listitem>
-<listitem><para>Estimated Disk space required: 
+<listitem><para>Estimated disk space required: 
 &rsync-buildsize;</para></listitem>
 <listitem><para>Estimated build time: 
 &rsyncd-time;</para></listitem></itemizedlist>




More information about the blfs-book mailing list