Subversion Repositories svn LFS-FR

Compare Revisions

Ignore whitespace Rev 543 → Rev 544

/trunk/blfs/pst/pst.ent
File deleted
/trunk/blfs/pst/typesetting/tex/tex.ent
File deleted
/trunk/blfs/pst/typesetting/tex/tex-intro.xml
File deleted
/trunk/blfs/pst/typesetting/tex/tex-exp.xml
File deleted
/trunk/blfs/pst/typesetting/tex/tex-inst.xml
File deleted
/trunk/blfs/pst/typesetting/tex/tex-desc.xml
File deleted
/trunk/blfs/pst/typesetting/tex.xml
1,11 → 1,232
<?xml version="1.0" encoding="ISO-8859-1"?>
<sect1 id="pst-typesetting-tex">
<!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 tex-download-http "http://www.ibiblio.org/pub/packages/tex/teTeX/distrib/tetex-src-&tex-version;.tar.gz" >
<!-- <!ENTITY tex-download-ftp "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/2.0/distrib/tetex-src-&tex-version;.tar.gz"> -->
<!ENTITY tex-download-ftp "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/tetex-src-&tex-version;.tar.gz">
<!ENTITY tex-md5sum "a16f6bba227d55e79aeee46fbbd82d28">
<!ENTITY tex-size "11.7 MB">
<!ENTITY tex-buildsize "344 MB (415 MB with optional tarball)">
<!ENTITY tex-time "1.82 SBU">
 
<!-- <!ENTITY texmf-download "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/2.0/distrib/tetex-texmf-&tex-version;.tar.gz"> -->
<!ENTITY texmf-download "http://www.ibiblio.org/pub/packages/tex/teTeX/distrib/tetex-texmf-&tex-version;.tar.gz">
<!ENTITY texmf-md5sum "d3bdb96f9077e43b2115d3cc471743b3">
<!ENTITY texmf-size "52.4 MB">
 
<!-- <!ENTITY texmfsrc-download "ftp://tug.ctan.org/tex-archive/systems/unix/teTeX/2.0/distrib/tetex-texmfsrc-&tex-version;.tar.gz"> -->
<!ENTITY texmfsrc-download "http://www.ibiblio.org/pub/packages/tex/teTeX/distrib/tetex-texmfsrc-&tex-version;.tar.gz">
<!ENTITY texmfsrc-md5sum "40d4b2c5582eccbee4b6ec692c3cc253">
<!ENTITY texmfsrc-size "22.9 MB">
]>
 
<sect1 id="tex" xreflabel="TeX-&tex-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="tex.html"?>
<title>tex-&tex-version;</title>
<title>TeX-&tex-version;</title>
<indexterm zone="tex">
<primary sortas="a-TeX">TeX</primary></indexterm>
 
&tex-intro;
&tex-inst;
&tex-exp;
&tex-desc;
<sect2>
<title>Introduction to <application>TeX</application></title>
 
<para><application>TeX</application> is a typesetting package, able to create
documents in a variety of formats. The optional <filename>texmfsrc</filename>
<acronym>TAR</acronym> ball contains source code for packages that are
contained in the <filename>texmf</filename> <acronym>TAR</acronym> ball,
including the docstrip sources.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&tex-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&tex-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &tex-md5sum;</para></listitem>
<listitem><para>Download size: &tex-size;</para></listitem>
<listitem><para>Estimated disk space required:
&tex-buildsize;</para></listitem>
<listitem><para>Estimated build time: &tex-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3><title>Additional Downloads</title>
<sect4><title>Required macros and fonts</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (FTP):
<ulink url="&texmf-download;"/></para></listitem>
<listitem><para>Download MD5 sum: &texmf-md5sum;</para></listitem>
<listitem><para>Download size: &texmf-size;</para></listitem>
</itemizedlist>
</sect4>
 
<sect4><title>Optional <filename>texmf</filename> sources:</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (FTP):
<ulink url="&texmfsrc-download;"/></para></listitem>
<listitem><para>Download MD5 sum: &texmfsrc-md5sum;</para></listitem>
<listitem><para>Download size: &texmfsrc-size;</para></listitem>
</itemizedlist>
</sect4>
 
<sect4><title>Patches</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch: <ulink
url="&patch-root;/tetex-src-&tex-version;-flex-1.patch"/></para></listitem>
<listitem><para>Recommended Patch: <ulink
url="&patch-root;/tetex-src-&tex-version;-remove_readlink-1.patch"/></para>
</listitem>
</itemizedlist>
</sect4>
</sect3>
 
<sect3><title><application>TeX</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="ed"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="libpng"/>,
<xref linkend="x-installing"/>,
<xref linkend="openssl"/>,
<xref linkend="mysql"/>,
<xref linkend="perl-modules"/>: Tk-&Perl-Tk-version;, <ulink
url="http://gd.tuwien.ac.at/visual/ibiblio/libs/graphics/t1lib-5.0.2.tar.gz">
t1lib</ulink>
and <ulink url="http://www.w3.org/Library/">libwww</ulink></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>TeX</application></title>
 
<!--
<para><application>TeX</application> is installed from the source directory
(usually <filename class="directory">/usr/src</filename>) and untarring
instructions are included below instead of the usual assumption that you
have already untarred the package. The source directory should contain
the two required packages and the optional package, if desired.</para>
-->
 
<para>Before building <application>TeX</application>, the macros and fonts
package (<filename>texmf</filename> tarball) must be installed. Install the
macros and fonts using the following commands as the root user:</para>
 
<screen><userinput role='root'><command>install -v -d -m755 /usr/share/texmf &amp;&amp;
gzip -dc ../tetex-texmf-&tex-version;.tar.gz \
| (umask 0; cd /usr/share/texmf; tar -xf -)</command></userinput></screen>
 
<para>If the optional <filename>texmf</filename> source code
<acronym>TAR</acronym> ball was downloaded, untar it now as the root
user:</para>
 
<screen><userinput role='root'><command>gzip -dc ../tetex-texmfsrc-&tex-version;.tar.gz \
| (umask 0; cd /usr/share/texmf; tar -xf -)</command></userinput></screen>
 
<para>Install <application>TeX</application> by running the following
commands:</para>
 
<screen><userinput><command>patch -Np1 -i ../tetex-src-&tex-version;-flex-1.patch &amp;&amp;
patch -Np1 -i ../tetex-src-&tex-version;-remove_readlink-1.patch &amp;&amp;
./configure --with-x=no --prefix=/usr \
--without-texinfo --with-system-ncurses --with-system-zlib \
--exec-prefix=/usr --bindir=/usr/bin &amp;&amp;
make all</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install &amp;&amp;
texconfig dvips paper letter &amp;&amp;
texconfig font rw</command></userinput></screen>
 
<note><para>The paper size may be changed to a4, as is used in most
countries.</para></note>
 
</sect2>
 
<sect2>
<title>Installation command explanations</title>
 
<para><option>--with-x=no</option>: This switch will avoid any
<application>X</application> Window dependencies.
<application>TeX</application> can be compiled with
<application>X</application> Window support, notably for
<command>xdvi</command>. If this is desired, remove this
configure option.</para>
 
<para><parameter>--exec-prefix=/usr --bindir=/usr/bin</parameter>: These
switches ensure that <application>TeX</application> binaries are installed in
<filename class="directory">/usr/bin</filename>.</para>
 
<para><parameter>--without-texinfo</parameter>: A default
<acronym>LFS</acronym> installation already has the
<application>Texinfo</application> package installed; this switch will avoid
overwriting it with the included <application>Texinfo</application>
package.</para>
 
<para><parameter>--with-system-ncurses</parameter>: This switch specifies
using the already installed <filename class="libraryfile">libncurses</filename>
library.</para>
 
<para><parameter>--with-system-zlib</parameter>: <acronym>LFS</acronym> systems
starting with version 4.0 have <application>Zlib</application> installed as
part of the base operating system; this switch avoids building it here.</para>
 
<para><command>texconfig dvips paper letter</command>: This command sets the
default paper size for <application>TeX</application>.</para>
 
<para><command>texconfig font rw</command>: This command specifies writable
fonts.</para>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>101 separate binaries and scripts along with 37 symlinks to these
programs.</seg>
<seg>libkpathsea.a</seg>
<seg>/usr/share/texmf</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="tex-programs">
<term><command>TeX programs</command></term>
<listitem><para>included in the <application>TeX</application> package are too
numerous to individually list. Please refer to
<ulink url="file:///usr/share/texmf/doc/index.html"/> for details, as well as
a tour of the expansive <application>TeX</application> documentation.</para>
<indexterm zone="tex tex-programs">
<primary sortas="b-TeX-programs">TeX programs</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="libkpathsea">
<term><filename class='libraryfile'>libkpathsea.a</filename></term>
<listitem><para>contains functions used by <application>TeX</application>
for searching and cataloging path names.</para>
<indexterm zone="tex libkpathsea">
<primary sortas="c-libkpathsea">libkpathsea.a</primary></indexterm>
</listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/typesetting/jadetex.xml
0,0 → 1,219
<?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 jadetex-download-http "http://prdownloads.sourceforge.net/jadetex/jadetex-&jadetex-version;.tar.gz">
<!ENTITY jadetex-download-ftp " ">
<!ENTITY jadetex-md5sum "634dfc172fbf66a6976e2c2c60e2d198">
<!ENTITY jadetex-size "103 KB">
<!ENTITY jadetex-buildsize "9.6 MB">
<!ENTITY jadetex-time "0.11 SBU">
]>
 
<sect1 id="jadetex" xreflabel="JadeTeX-&jadetex-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="jadetex.html"?>
<title>JadeTeX-&jadetex-version;</title>
<indexterm zone="jadetex">
<primary sortas="a-JadeTeX">JadeTeX</primary></indexterm>
 
<sect2>
<title>Introduction to <application>JadeTeX</application></title>
 
<para>The <application>JadeTeX</application> package is a companion package to
the <application>OpenJade</application> <acronym>DSSSL</acronym> processor.
<application>JadeTeX</application> transforms high level LaTeX macros into
<acronym>DVI</acronym>/PostScript and Portable Document Format
(<acronym>PDF</acronym>) forms.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&jadetex-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&jadetex-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &jadetex-md5sum;</para></listitem>
<listitem><para>Download size: &jadetex-size;</para></listitem>
<listitem><para>Estimated disk space required:
&jadetex-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&jadetex-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>JadeTeX</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="tex"/> and
<xref linkend="openjade"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>JadeTeX</application></title>
 
<para>First, as the root user, make some required modifications to files
already installed on the system:</para>
 
<screen><userinput role='root'><command>sed -i.orig -e "s/original texmf.cnf/modified texmf.cnf/" \
/usr/share/texmf/web2c/texmf.cnf</command></userinput></screen>
 
<para>You'll need to make two modifications to
<filename>/usr/share/texmf/web2c/texmf.cnf</filename>. First, add the
following line under the section titled <quote>ConTeXt is a memory
hog...</quote>:</para>
 
<screen><userinput role='root'>pool_size.context = 750000</userinput></screen>
 
<para>Next, add <command>latex</command>, <command>jadetex</command> and
<command>pdfjadetex</command> settings using the following command:</para>
 
<screen><userinput role='root'><command>cat &gt;&gt; /usr/share/texmf/web2c/texmf.cnf &lt;&lt; "EOF"</command>
 
% The following 3 sections added for JadeTeX
 
% latex settings
main_memory.latex = 1100000
param_size.latex = 1500
stack_size.latex = 1500
hash_extra.latex = 15000
string_vacancies.latex = 45000
pool_free.latex = 47500
nest_size.latex = 500
save_size.latex = 5000
pool_size.latex = 500000
max_strings.latex = 55000
font_mem_size.latex= 400000
 
% jadetex settings
main_memory.jadetex = 1500000
param_size.jadetex = 1500
stack_size.jadetex = 1500
hash_extra.jadetex = 50000
string_vacancies.jadetex = 45000
pool_free.jadetex = 47500
nest_size.jadetex = 500
save_size.jadetex = 5000
pool_size.jadetex = 500000
max_strings.jadetex = 55000
 
% pdfjadetex settings
main_memory.pdfjadetex = 2500000
param_size.pdfjadetex = 1500
stack_size.pdfjadetex = 1500
hash_extra.pdfjadetex = 50000
string_vacancies.pdfjadetex = 45000
pool_free.pdfjadetex = 47500
nest_size.pdfjadetex = 500
save_size.pdfjadetex = 5000
pool_size.pdfjadetex = 500000
max_strings.pdfjadetex = 55000
<command>EOF</command></userinput></screen>
 
<para>Build a new <filename>latex.fmt</filename> file using the following
commands:</para>
 
<screen><userinput><command>cp -v -R /usr/share/texmf/tex/latex/config . &amp;&amp;
cd config &amp;&amp;
tex -ini -progname=latex latex.ini &amp;&amp;
cd ..</command></userinput></screen>
 
<para>Now, as the root user, install the <filename>latex.fmt</filename> file,
then build and install <application>JadeTex</application> using the following
commands:</para>
 
<screen><userinput role='root'><command>mv /usr/share/texmf/web2c/latex.fmt \
/usr/share/texmf/web2c/latex.fmt.orig &amp;&amp;
install -v -m644 config/latex.fmt /usr/share/texmf/web2c &amp;&amp;
make install &amp;&amp;
ln -v -sf tex /usr/bin/jadetex &amp;&amp;
ln -v -sf pdftex /usr/bin/pdfjadetex &amp;&amp;
mktexlsr</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sed -i -e "s/original texmf.cnf/modified texmf.cnf/"</command>:
This changes <filename>/usr/share/texmf/web2c/texmf.cnf</filename> so that if
<application>TeX</application> is upgraded, this file won't get
overwritten.</para>
 
<para><command>ln -v -sf tex ...; ln -v -sf pdftex ...; mktexlsr</command>: The
<application>JadeTeX</application> programs are actually just symlinks to the
<application>TeX</application> programs. <command>mktexlsr</command> updates
<application>TeX</application>'s <filename>ls-R</filename> database used by
the <filename class='libraryfile'>libkpathsea</filename> library so that
<application>TeX</application> knows to use the
<application>JadeTeX</application> <filename>.fmt</filename> files when
<command>jadetex</command> or <command>pdfjadetex</command> is called.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>JadeTeX</application></title>
 
<sect3><title>Config files</title>
<para><filename>jadetex.dtx</filename> in the
<application>JadeTeX</application> source tree.</para>
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para>If you need to modify the default <application>JadeTeX</application>
macro settings, see the
<ulink url="http://jadetex.sourceforge.net/#index-div-d18e397">
<application>JadeTeX</application> <acronym>FAQ</acronym></ulink>.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>jadetex and pdfjadetex</seg>
<seg>None</seg>
<seg>/usr/share/texmf/tex/jadetex</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="jadetex-prog">
<term><command>jadetex</command></term>
<listitem><para>transforms LaTeX macros created by
<application>OpenJade</application> into <acronym>DVI</acronym>/PostScript
forms.</para>
<indexterm zone="jadetex jadetex-prog">
<primary sortas="b-jadetex">jadetex</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="pdfjadetex">
<term><command>pdfjadetex</command></term>
<listitem><para>transforms LaTeX macros created by
<application>OpenJade</application> into Portable Document Format
(<acronym>PDF</acronym>) forms.</para>
<indexterm zone="jadetex pdfjadetex">
<primary sortas="b-pdfjadetex">pdfjadetex</primary></indexterm>
</listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
 
/trunk/blfs/pst/typesetting/typesetting.xml
1,11 → 1,17
<?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="pst-typesetting">
<?dbhtml filename="typesetting.html"?>
<title>Composition de texte</title>
<title>Typesetting</title>
 
<para>Ce chapitre inclut des applications qui créent une sortie équivalent à de
la composition de texte.</para>
<para>This chapter includes applications that create output equivalent to
typesetting.</para>
 
&tex;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tex.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="jadetex.xml"/>
 
</chapter>
/trunk/blfs/pst/scanning/gocr/gocr.ent
File deleted
/trunk/blfs/pst/scanning/gocr/gocr-intro.xml
File deleted
/trunk/blfs/pst/scanning/gocr/gocr-inst.xml
File deleted
/trunk/blfs/pst/scanning/gocr/gocr-desc.xml
File deleted
/trunk/blfs/pst/scanning/sane/sane.ent
File deleted
/trunk/blfs/pst/scanning/sane/sane-intro.xml
File deleted
/trunk/blfs/pst/scanning/sane/sane-exp.xml
File deleted
/trunk/blfs/pst/scanning/sane/sane-inst.xml
File deleted
/trunk/blfs/pst/scanning/sane/sane-desc.xml
File deleted
/trunk/blfs/pst/scanning/gocr.xml
File deleted
/trunk/blfs/pst/scanning/xsane/xsane.ent
File deleted
/trunk/blfs/pst/scanning/xsane/xsane-intro.xml
File deleted
/trunk/blfs/pst/scanning/xsane/xsane-inst.xml
File deleted
/trunk/blfs/pst/scanning/xsane/xsane-desc.xml
File deleted
/trunk/blfs/pst/scanning/scanning.xml
1,14 → 1,18
<?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="pst-scanning">
<?dbhtml filename="scanning.html"?>
<title>Numérisation</title>
<title>Scanning</title>
 
<para>Ce chapitre contient des applications de numérisation qui vous permettent
de convertir des documents imprimés en documents formattés lisibles par d'autres
<para>This chapter contains scanning applications which allow you to
convert printed documents into formatted documents readable by other
applications.</para>
 
&sane;
&xsane;
<!-- &gocr; -->
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sane.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xsane.xml"/>
 
</chapter>
/trunk/blfs/pst/scanning/sane.xml
1,11 → 1,348
<?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 sane-be-download-http "http://gd.tuwien.ac.at/api/sane/sane-backends-&sane-version;/sane-backends-&sane-version;.tar.gz">
<!ENTITY sane-be-download-ftp "ftp://ftp.sane-project.org/pub/sane/sane-backends-&sane-version;/sane-backends-&sane-version;.tar.gz">
<!ENTITY sane-be-md5sum "3b804f35cdfbc5ad2d201ffe078bbac9">
<!ENTITY sane-be-size "3.2 MB">
<!ENTITY sane-be-buildsize "50 MB">
<!ENTITY sane-be-time "1.26 SBU">
 
<!ENTITY sane-fe-version "1.0.13">
<!ENTITY sane-fe-download-http "http://gd.tuwien.ac.at/api/sane/sane-frontends-&sane-fe-version;/sane-frontends-&sane-fe-version;.tar.gz">
<!ENTITY sane-fe-download-ftp "ftp://ftp.sane-project.org/pub/sane/sane-frontends-&sane-fe-version;/sane-frontends-&sane-fe-version;.tar.gz">
<!ENTITY sane-fe-md5sum "2930626e627df49b45192a722cedc8a6">
<!ENTITY sane-fe-size "210 KB">
<!ENTITY sane-fe-buildsize "2.6 MB">
<!ENTITY sane-fe-time "0.09 SBU">
]>
 
<sect1 id="sane" xreflabel="SANE-&sane-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="sane.html"?>
<title>SANE-&sane-version;</title>
<indexterm zone="sane">
<primary sortas="a-SANE">SANE</primary></indexterm>
 
&sane-intro;
&sane-inst;
&sane-exp;
&sane-desc;
<sect2>
<title>Introduction to
<application><acronym>SANE</acronym></application></title>
 
<para><application><acronym>SANE</acronym></application> is short for Scanner
Access Now Easy. Scanner access, however, is far from easy, since every vendor
has their own protocols. The only known protocol that should bring some unity
into this chaos is the TWAIN interface, but this is too imprecise to allow a
stable scanning framework. Therefore, <acronym>SANE</acronym> comes with its
own protocol, and the vendor drivers can't be used.</para>
 
<para><acronym>SANE</acronym> is split into back ends and front ends. The back
ends are drivers for the supported scanners and cameras. The front ends are
user interfaces to access the backends.</para>
 
<sect3><title>Back ends package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&sane-be-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&sane-be-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &sane-be-md5sum;</para></listitem>
<listitem><para>Download size: &sane-be-size;</para></listitem>
<listitem><para>Estimated disk space required:
&sane-be-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&sane-be-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Front ends package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&sane-fe-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&sane-fe-download-ftp;"/></para></listitem>
<listitem><para>Downlaod MD5 sum: &sane-fe-md5sum;</para></listitem>
<listitem><para>Download size: &sane-fe-size;</para></listitem>
<listitem><para>Estimated disk space required:
&sane-fe-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&sane-fe-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application><acronym>SANE</acronym></application>
dependencies</title>
<sect4><title>Optional (back ends)</title>
<para><xref linkend="libjpeg"/>,
<xref linkend="libusb"/>,
<ulink url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink>,
<ulink url="http://www.gphoto.org/">gPhoto2</ulink>
(requires <ulink url="http://www.gphoto.org/">libgphoto2</ulink>) and
<xref linkend="tex"/></para>
</sect4>
 
<sect4><title>Optional (front ends)</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="gtk2"/> and
<xref linkend="gimp"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of
<application><acronym>SANE</acronym></application></title>
 
<sect3 id="sane-kernel"><title>Preparing your system for scanner access</title>
<indexterm zone="sane sane-kernel">
<primary sortas="d-Scanning-devices">Scanning devices</primary></indexterm>
 
<para>To access your scanner, you will probably need the related kernel
drivers or additional support packages (<xref linkend="libusb"/>).
A <acronym>SCSI</acronym> scanner will need <acronym>SCSI</acronym>
drivers, a parallel port scanner needs parallel port support (you should use
enhanced <acronym>EPP</acronym> modes) and a <acronym>USB</acronym> scanner
will need the <application>libusb</application> package and a
<acronym>SCSI</acronym> system for emulation. Be sure that you have got the
necessary drivers configured to access the devices.</para>
</sect3>
 
<sect3><title>Installation of
<application><acronym>SANE</acronym></application> back ends</title>
 
<para>Install <application><acronym>SANE</acronym></application>-backends by
running the following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
</sect3>
 
<sect3><title>Installation of
<application><acronym>SANE</acronym></application> front ends</title>
 
<para>The <application><acronym>SANE</acronym></application>-frontends package
includes the graphical frontends <command>xscanimage</command> and
<command>xcam</command>, and a command-line frontend
<command>scanadf</command>. You don't need this package if you intend to use
one of the more advanced graphical frontends like <xref linkend="xsane"/>. For
a list of frontend packages, see
<ulink url="http://www.sane-project.org/sane-frontends.html"/>.</para>
 
<para>To install <application><acronym>SANE</acronym></application>-frontends,
use the following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
<para>If <application>GIMP</application> was linked into the build and you
wish <application>GIMP</application> to use <command>xscanimage</command> as
a scanning plugin, issue the following command as the root user:</para>
 
<screen><userinput role='root'><command>ln -s /usr/bin/xscanimage /usr/lib/gimp/2.0/plug-ins</command></userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
configuration files in <filename class="directory">/etc/sane.d</filename>
instead of <filename class="directory">/usr/etc/sane.d</filename>.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application><acronym>SANE</acronym></application></title>
 
<sect3 id="sane-config"><title>Config files</title>
<para><filename>/etc/sane.d/*.conf</filename></para>
<indexterm zone="sane sane-config">
<primary sortas="e-etc-sane.d-conf">/etc/sane.d/*.conf</primary></indexterm>
</sect3>
 
<sect3><title>Configuration information</title>
<sect4><title>Backend configuration</title>
<para>The backend configuration files are located in
<filename class='directory'>/etc/sane.d</filename>. Information for configuring
the various backends can be found by using the man(5) page for the desired
backend. Run <command>man sane-<replaceable>[backend]</replaceable></command>,
substituting the desired backend.</para>
</sect4>
 
<sect4><title>General information</title>
<para>For general information about configuring and using
<application><acronym>SANE</acronym></application>, see
<command>man sane</command>. Linux-2.6.x brings some special issues into the
picture. See <ulink url="http://www.sane-project.org/README.linux"/> for
information about using <application><acronym>SANE</acronym></application>
with the Linux-2.6.x kernel. For information about <acronym>USB</acronym>
scanning devices, run <command>man sane-usb</command>. For information about
<acronym>SCSI</acronym> devices, run <command>man sane-scsi</command>.</para>
</sect4>
 
<sect4><title>Configuration and setup of the <command>saned</command>
daemon</title>
<para>The <command>saned</command> daemon is not meant to be used for
untrusted clients. You should provide <xref linkend="tcpwrappers"/> and/or
<xref linkend="fw-firewall"/> protection to insure only trusted clients access
the daemon. Due to the complex security requirements to insure only trusted
clients access the daemon, <acronym>BLFS</acronym> does not provide
instructions to configure the <command>saned</command> daemon. If you desire
to make the daemon available, ensure you provide adequate security, configure
your <filename>[x]inetd.conf</filename> file and send a
<userinput>SIGHUP</userinput> to the [x]inetd daemon. Some good information for
setting up and securing the <command>saned</command> daemon can be found at
<ulink url="http://penguin-breeder.org/sane/saned/"/>.</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<bridgehead renderas="sect4">Back Ends:</bridgehead>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
 
<seglistitem>
<seg>gamma4scanimage, sane-config, saned, sane-find-scanner and scanimage</seg>
<seg>libsane.so and numerous scanner backend modules</seg>
<seg>/etc/sane.d, /usr/include/sane, /usr/lib/sane, /usr/share/sane and
/usr/share/doc/sane-&sane-version;</seg>
</seglistitem>
</segmentedlist>
 
<bridgehead renderas="sect4">Front Ends:</bridgehead>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
 
<seglistitem>
<seg>scanadf, xcam and xscanimage</seg>
<seg><application>GIMP</application> plugin imbedded in
<command>xscanimage</command></seg>
<seg>/usr/share/sane</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="gamma4scanimage">
<term><command>gamma4scanimage</command></term>
<listitem><para>creates a gamma table in the format expected by
<command>scanimage</command>.</para>
<indexterm zone="sane gamma4scanimage">
<primary sortas="b-gamma4scanimage">gamma4scanimage</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="sane-config-prog">
<term><command>sane-config</command></term>
<listitem><para>is a tool used to determine the compiler and linker flags that
should be used to compile and link
<application><acronym>SANE</acronym></application>.</para>
<indexterm zone="sane sane-config-prog">
<primary sortas="b-sane-config">sane-config</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="saned">
<term><command>saned</command></term>
<listitem><para>is the <application><acronym>SANE</acronym></application>
daemon that allows remote clients to access image acquisition devices
available on the local host.</para>
<indexterm zone="sane saned">
<primary sortas="b-saned">saned</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="sane-find-scanner">
<term><command>sane-find-scanner</command></term>
<listitem><para>is a command-line tool to find <acronym>SCSI</acronym> and
<acronym>USB</acronym> scanners and determine their device files. Its primary
aim is to make sure that scanners can be detected by
<application><acronym>SANE</acronym></application> backends.</para>
<indexterm zone="sane sane-find-scanner">
<primary sortas="b-sane-find-scanner">sane-find-scanner</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="scanadf">
<term><command>scanadf</command></term>
<listitem><para>is a command-line interface to control image acquisition
devices which are equipped with an automatic document feeder
(<acronym>ADF</acronym>).</para>
<indexterm zone="sane scanadf">
<primary sortas="b-scanadf">scanadf</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="scanimage">
<term><command>scanimage</command></term>
<listitem><para>is a command line interface for scanning from image
acquisition devices such as flatbed scanners or cameras. It is also used to
list the available backend devices.</para>
<indexterm zone="sane scanimage">
<primary sortas="b-scanimage">scanimage</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="xcam">
<term><command>xcam</command></term>
<listitem><para>is a graphical camera front end for
<application><acronym>SANE</acronym></application>.</para>
<indexterm zone="sane xcam">
<primary sortas="b-xcam">xcam</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="xscanimage">
<term><command>xscanimage</command></term>
<listitem><para>is a graphical user interface for scanning.</para>
<indexterm zone="sane xscanimage">
<primary sortas="b-xscanimage">xscanimage</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="libsane">
<term><filename class='libraryfile'>libsane.so</filename></term>
<listitem><para>is the application programming interface that is used to
communicate between frontends and backends.</para>
<indexterm zone="sane libsane">
<primary sortas="c-libsane">libsane.so</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="libsane-module">
<term><filename class='libraryfile'>libsane-*.so</filename></term>
<listitem><para>modules are backend scanning library plugins used to interface
with scanning devices. See
<ulink url="http://www.sane-project.org/sane-supported-devices.html"/>
for a list of supported backends.</para>
<indexterm zone="sane libsane-module">
<primary sortas="c-libsane-module">libsane-*.so</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/scanning/xsane.xml
1,10 → 1,128
<?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 xsane-download-http "http://gd.tuwien.ac.at/hci/sane/xsane/xsane-&xsane-version;.tar.gz">
<!ENTITY xsane-download-ftp "ftp://ftp.sane-project.org/pub/sane/xsane/xsane-&xsane-version;.tar.gz">
<!ENTITY xsane-md5sum "3d1f889d88c3462594febd53be58c561">
<!ENTITY xsane-size "3.1 MB">
<!ENTITY xsane-buildsize "21.3 MB">
<!ENTITY xsane-time "0.22 SBU">
]>
 
<sect1 id="xsane" xreflabel="XSane-&xsane-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="xsane.html"?>
<title>XSane-&xsane-version;</title>
<indexterm zone="xsane">
<primary sortas="a-XSane">XSane</primary></indexterm>
 
&xsane-intro;
&xsane-inst;
&xsane-desc;
<sect2>
<title>Introduction to <application>XSane</application></title>
 
<para><application>XSane</application> is another front end for
<xref linkend="sane"/>. It has additional features to improve the image
quality and ease of use compared to <command>xscanimage</command>.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&xsane-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&xsane-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &xsane-md5sum;</para></listitem>
<listitem><para>Download size: &xsane-size;</para></listitem>
<listitem><para>Estimated disk space required:
&xsane-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&xsane-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>XSane</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="gtk2"/> or <xref linkend="GTK"/> and
<xref linkend="sane"/> (back ends)</para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="libtiff"/>,
<xref linkend="libjpeg"/> and
<xref linkend="gimp"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>XSane</application></title>
 
<para>Install <application>XSane</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
<para>If <application><acronym>GIMP</acronym></application> is installed,
issue the following command as the root user:</para>
 
<screen><userinput role='root'><command>ln -s /usr/bin/xsane /usr/lib/gimp/2.0/plug-ins/</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>ln -s /usr/bin/xsane /usr/lib/gimp/2.0/plug-ins/</command>:
This creates a link in the system-wide
<application><acronym>GIMP</acronym></application>
<filename class='directory'>plug-ins</filename> directory so that users can
access <application>XSane</application> directly from
<application><acronym>GIMP</acronym></application>.
<application><acronym>GIMP</acronym></application> must be available before
building <application>XSane</application> for this to work. Alternatively,
create the link in <filename class='directory'>~/.gimp-2.0/plug-ins/</filename>
to provide individual user access. <command>man xsane</command> for
additional information.</para>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
 
<seglistitem>
<seg>xsane</seg>
<seg>None</seg>
<seg>/usr/share/sane/xsane</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="xsane-prog">
<term><command>xsane</command></term>
<listitem><para>is a graphical user-interface to control an image acquisition
device such as a flatbed scanner.</para>
<indexterm zone="xsane xsane-prog">
<primary sortas="b-xsane">xsane</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/xml/docbook-xsl/docbook-xsl-config.xml
File deleted
/trunk/blfs/pst/xml/docbook-xsl/docbook-xsl.ent
File deleted
/trunk/blfs/pst/xml/docbook-xsl/docbook-xsl-intro.xml
File deleted
/trunk/blfs/pst/xml/docbook-xsl/docbook-xsl-inst.xml
File deleted
/trunk/blfs/pst/xml/docbook-xsl/docbook-xsl-desc.xml
File deleted
/trunk/blfs/pst/xml/docbook/docbook-desc.xml
File deleted
/trunk/blfs/pst/xml/docbook/docbook-config.xml
File deleted
/trunk/blfs/pst/xml/docbook/docbook.ent
File deleted
/trunk/blfs/pst/xml/docbook/docbook-intro.xml
File deleted
/trunk/blfs/pst/xml/docbook/docbook-inst.xml
File deleted
/trunk/blfs/pst/xml/docbook.xml
1,12 → 1,202
<?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 DocBook-download-http "http://www.docbook.org/xml/4.3/docbook-xml-&DocBook-version;.zip">
<!ENTITY DocBook-download-ftp "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/docbook-xml-&DocBook-version;.zip">
<!ENTITY DocBook-md5sum "ab200202b9e136a144db1e0864c45074">
<!ENTITY DocBook-size "83 KB">
<!ENTITY DocBook-buildsize "482 KB">
<!ENTITY DocBook-time "0.01 SBU">
]>
 
<sect1 id="DocBook" xreflabel="DocBook XML DTD-&DocBook-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="DocBook.html"?>
<title>DocBook XML DTD-&DocBook-version;</title>
 
&DocBook-intro;
&DocBook-inst;
&DocBook-config;
&DocBook-desc;
<sect2>
<title>Introduction to <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application></title>
 
<para>The <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application>-&DocBook-version; package contains
document type definitions for verification of <acronym>XML</acronym> data
files against the DocBook rule set. These are useful for structuring books
and software documentation to a standard allowing you to utilize
transformations already written for that standard.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&DocBook-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&DocBook-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &DocBook-md5sum;</para></listitem>
<listitem><para>Download size: &DocBook-size;</para></listitem>
<listitem><para>Estimated disk space required:
&DocBook-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&DocBook-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application> &DocBook-version; dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="libxml2"/> and <xref linkend="unzip"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application></title>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../use-unzip.xml"/>
 
<para>Install <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application> by running the following commands:</para>
 
<screen><userinput><command>install -d /usr/share/xml/docbook/xml-dtd-&DocBook-version; &amp;&amp;
chown -R root:root . &amp;&amp;
cp -af docbook.cat *.dtd ent/ *.mod \
/usr/share/xml/docbook/xml-dtd-&DocBook-version; &amp;&amp;
if [ ! -e /etc/xml/catalog ]; then mkdir -p /etc/xml; xmlcatalog \
--noout --create /etc/xml/catalog; fi &amp;&amp;
if [ ! -e /etc/xml/docbook ]; then xmlcatalog --noout --create \
/etc/xml/docbook; fi &amp;&amp;
xmlcatalog --noout --add "public" \
"-//OASIS//ELEMENTS DocBook XML Information Pool V&DocBook-version;//EN" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbpoolx.mod" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public" \
"-//OASIS//DTD DocBook XML V&DocBook-version;//EN" \
"http://www.oasis-open.org/docbook/xml/&DocBook-version;/docbookx.dtd" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public" \
"-//OASIS//ENTITIES DocBook XML Character Entities V&DocBook-version;//EN" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbcentx.mod" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public" \
"-//OASIS//ENTITIES DocBook XML Notations V&DocBook-version;//EN" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbnotnx.mod" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public" \
"-//OASIS//ENTITIES DocBook XML Additional General Entities V&DocBook-version;//EN" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbgenent.mod" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public" \
"-//OASIS//ELEMENTS DocBook XML Document Hierarchy V&DocBook-version;//EN" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbhierx.mod" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public" \
"-//OASIS//DTD XML Exchange Table Model 19990315//EN" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/soextblx.dtd" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "public" \
"-//OASIS//DTD DocBook XML CALS Table Model V&DocBook-version;//EN" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/calstblx.dtd" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "rewriteSystem" \
"http://www.oasis-open.org/docbook/xml/&DocBook-version;" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "rewriteURI" \
"http://www.oasis-open.org/docbook/xml/&DocBook-version;" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "delegatePublic" \
"-//OASIS//ENTITIES DocBook XML" \
"file:///etc/xml/docbook" /etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "delegatePublic" \
"-//OASIS//DTD DocBook XML" \
"file:///etc/xml/docbook" /etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "delegateSystem" \
"http://www.oasis-open.org/docbook/" \
"file:///etc/xml/docbook" /etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "delegateURI" \
"http://www.oasis-open.org/docbook/" \
"file:///etc/xml/docbook" /etc/xml/catalog</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Configuring <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application></title>
 
<sect3 id="docbook-config"><title>Config files</title>
<para><filename>/etc/xml/catalog</filename>,
<filename>/etc/xml/docbook</filename></para>
<indexterm zone="DocBook docbook-config"><primary
sortas="e-etc-xml-docbook">/etc/xml/docbook</primary></indexterm>
<indexterm zone="DocBook docbook-config"><primary
sortas="e-etc-xml-catalog">/etc/xml/catalog</primary></indexterm>
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para>The above installation script creates the files and updates the catalog.
In order to install <application>ScrollKeeper</application> or to utilize
<application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application> V&DocBook-version; when any version 4 is
requested in the System Identifier, make the following entry:</para>
<screen><userinput><command>xmlcatalog --noout --add "public" \
"-//OASIS//DTD DocBook XML V4.1.2//EN" \
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "delegateSystem" \
"http://www.oasis-open.org/docbook/xml/4.1.2/" \
"file:///etc/xml/docbook" /etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "delegateURI" \
"http://www.oasis-open.org/docbook/xml/4.1.2/" \
"file:///etc/xml/docbook" /etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "rewriteSystem" \
"http://www.oasis-open.org/docbook/xml/4.1.2" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "rewriteURI" \
"http://www.oasis-open.org/docbook/xml/4.1.2" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;" \
/etc/xml/docbook &amp;&amp;
xmlcatalog --noout --add "rewriteURI" \
"http://www.oasis-open.org/docbook/xml/4.2" \
"file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;" \
/etc/xml/docbook</command></userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>DocBook <acronym>XML</acronym>
<acronym>DTD</acronym></application> package contains <filename>DTD</filename>
files, <filename>MOD</filename> files and <filename>ENT</filename> files.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>DTD files</title>
<para><filename>DTD</filename> files contain a document type definition which
defines the element types and the attribute lists that can be used in the
corresponding <filename>XML</filename> files.</para></sect3>
 
<sect3><title>MOD files</title>
<para><filename>MOD</filename> files contain components of the document type
definition that are sourced into the <filename>DTD</filename> files.</para>
</sect3>
 
<sect3><title>ENT files</title>
<para><filename>ENT</filename> files contain lists of named character entities
allowed in <acronym>HTML</acronym>.</para></sect3>
 
</sect2>
 
</sect1>
 
/trunk/blfs/pst/xml/xml.xml
1,13 → 1,18
<?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="pst-xml">
<?dbhtml filename="xml.html"?>
<title>Langage de balises extensible (<acronym>XML</acronym>, acronyme de <foreignphrase>Extensible Markup Language</foreignphrase>)</title>
<title>Extensible Markup Language (<acronym>XML</acronym>)</title>
 
<para>Ce chapitre contient la définition du type de document DocBook
<acronym>XML</acronym> (<acronym>DTD</acronym>) et les feuilles de style DocBook
utilisées pour valider, transformer, formatter et publier des documents DocBook.</para>
<para>This chapter contains the DocBook <acronym>XML</acronym> document
type definition (<acronym>DTD</acronym>) and DocBook Stylesheets
which are used to validate, transform, format and publish DocBook documents.</para>
 
&DocBook;
&docbook-xsl;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="docbook.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="docbook-xsl.xml"/>
 
</chapter>
/trunk/blfs/pst/xml/docbook-xsl.xml
1,12 → 1,197
<?xml version="1.0" encoding="ISO-8859-1"?>
<sect1 id="docbook-xsl" xreflabel="DocBook XSL Stylesheets-&docbook-xsl-version;">
<!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 docbook-xsl-download-http "http://prdownloads.sourceforge.net/docbook/docbook-xsl-&docbook-xsl-version;.tar.bz2">
<!ENTITY docbook-xsl-download-ftp " ">
<!ENTITY docbook-xsl-md5sum "deb1864e3e190465dcc26145d2667a84">
<!ENTITY docbook-xsl-size "975 KB">
<!ENTITY docbook-xsl-buildsize "25 MB">
<!ENTITY docbook-xsl-time "0.01 SBU">
]>
 
<sect1 id="docbook-xsl"
xreflabel="DocBook XSL Stylesheets-&docbook-xsl-version;">
 
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
 
<?dbhtml filename="docbook-xsl.html"?>
<title>DocBook XSL Stylesheets-&docbook-xsl-version;</title>
 
&docbook-xsl-intro;
&docbook-xsl-inst;
&docbook-xsl-config;
&docbook-xsl-desc;
<sect2>
<title>Introduction to <application>DocBook <acronym>XSL</acronym>
Stylesheets</application></title>
 
<para>The <application>DocBook <acronym>XSL</acronym> Stylesheets</application>
package contains <acronym>XSL</acronym> stylesheets. These are useful for
performing transformations on <acronym>XML</acronym> DocBook files.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&docbook-xsl-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&docbook-xsl-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &docbook-xsl-md5sum;</para></listitem>
<listitem><para>Download size: &docbook-xsl-size;</para></listitem>
<listitem><para>Estimated disk space required: &docbook-xsl-buildsize;</para></listitem>
<listitem><para>Estimated build time: &docbook-xsl-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title><application>DocBook <acronym>XSL</acronym> Stylesheets</application> dependencies</title>
 
<sect4>
<title>Required</title>
<para><xref linkend="libxslt"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>DocBook <acronym>XSL</acronym> Stylesheets</application></title>
 
<para>Install <application>DocBook <acronym>XSL</acronym>
Stylesheets</application> by running the following commands:</para>
 
<screen><userinput><command>install -d /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; &amp;&amp;
chown -R root:root . &amp;&amp;
cp -af INSTALL VERSION common eclipse extensions fo html htmlhelp \
images javahelp lib manpages params profiling template xhtml \
/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; &amp;&amp;
install -d /usr/share/doc/xml &amp;&amp;
cp -af doc/* /usr/share/doc/xml &amp;&amp;
cd /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; &amp;&amp;
sh INSTALL &amp;&amp;
if [ ! -f /etc/xml/catalog ]; then mkdir -p /etc/xml; xmlcatalog \
--noout --create /etc/xml/catalog; fi &amp;&amp;
if [ ! -e /etc/xml/docbook ]; then xmlcatalog --noout --create \
/etc/xml/docbook; fi &amp;&amp;
xmlcatalog --noout --add "rewriteSystem" \
"http://docbook.sourceforge.net/release/xsl/&docbook-xsl-version;" \
"/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" /etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "rewriteURI" \
"http://docbook.sourceforge.net/release/xsl/&docbook-xsl-version;" \
"/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" /etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "delegateSystem" \
"http://docbook.sourceforge.net/release/xsl/" \
"file:///etc/xml/docbook" /etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "delegateURI" \
"http://docbook.sourceforge.net/release/xsl/" \
"file:///etc/xml/docbook" /etc/xml/catalog</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sh INSTALL</command>: This command creates a local
catalog for the <acronym>XSL</acronym> files.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>DocBook <acronym>XSL</acronym> Stylesheets</application></title>
 
<sect3 id="docbook-xsl-config">
<title>Config files</title>
 
<para><filename>/etc/xml/catalog</filename></para>
 
<indexterm zone="docbook-xsl docbook-xsl-config">
<primary sortas="e-etc-xml-catalog">/etc/xml/catalog</primary>
</indexterm>
 
</sect3>
 
<sect3>
<title>Configuration Information</title>
 
<para>The system profile needs to be updated to utilize the new
installed catalog. This can be done with the following command:</para>
 
<screen><userinput><command>cat &gt; /etc/profile.d/xsl.sh &lt;&lt; "EOF"</command>
# Set up Environment Variable for XSL Processing
export XML_CATALOG_FILES="/usr/share/xml/docbook/\
xsl-stylesheets-&docbook-xsl-version;/catalog.xml /etc/xml/catalog"
<command>EOF</command></userinput></screen>
 
<para>The above installation script creates the files and updates the
catalog. Some project stylesheets reference specific versions of
<acronym>XSL</acronym> stylesheets, like <acronym>BLFS</acronym>, which
needs the following additional commands. These commands can also serve
as an example for using a single <acronym>XSL</acronym> version to support
any hard coded versions, as needed.</para>
 
<screen><userinput><command>xmlcatalog --noout --add "rewriteSystem" \
"http://docbook.sourceforge.net/release/xsl/1.65.1" \
"/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
/etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "rewriteURI" \
"http://docbook.sourceforge.net/release/xsl/1.65.1" \
"/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
/etc/xml/catalog</command></userinput></screen>
 
<para>Alternatively, other versions can be installed in their own
versioned directories and catalog entries made in the following
form:</para>
 
<screen><userinput><command>xmlcatalog --noout --add "rewriteSystem" \
"http://docbook.sourceforge.net/release/xsl/<replaceable>[version]</replaceable>" \
"/usr/share/xml/docbook/xsl-stylesheets-<replaceable>[version]</replaceable>" \
/etc/xml/catalog &amp;&amp;
xmlcatalog --noout --add "rewriteURI" \
"http://docbook.sourceforge.net/release/xsl/<replaceable>[version]</replaceable>" \
"/usr/share/xml/docbook/xsl-stylesheets-<replaceable>[version]</replaceable>" \
/etc/xml/catalog</command></userinput></screen>
 
<note><para>To use XSL Stylesheets for GTK-Doc, and possibly other packages, a
"current" version is needed instead of a specific version number. In this
case, use the following instructions:</para>
 
<literallayout><userinput><command>xmlcatalog --noout --add "rewriteSystem" \
"http://docbook.sourceforge.net/release/xsl/current" \
"/usr/share/xml/docbook/xsl-stylesheets-1.67.2" \
/etc/xml/catalog &amp;&amp;
 
xmlcatalog --noout --add "rewriteURI" \
"http://docbook.sourceforge.net/release/xsl/current" \
"/usr/share/xml/docbook/xsl-stylesheets-1.67.2" \
/etc/xml/catalog</command></userinput></literallayout>
 
<para>This is a workaround that may or may not work for other packages that may
need a "current" catalog version.</para>
</note>
 
<!-- The following is very specific to LFS 6.0, the first sentence for
make and the remainder for 'make pdf', If it stays, it needs to be removed
after BLFS 6.0-->
 
<para>For <acronym>LFS</acronym> 6.0, version 1.65.1 of this package should be
installed. In addition, you need to make a symbolic link as described in the
<filename>INSTALL</filename> file of <acronym>LFS</acronym> 6.0.</para>
<screen><userinput><command>cd /usr/share/xml/docbook/ &amp;&amp;
ln -s xsl-stylesheets-1.65.1 xsl-stylesheets-current</command></userinput></screen>
 
</sect3>
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Files</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem><seg><acronym>XSL</acronym>
style sheets for <acronym>HTML</acronym> and <acronym>FO</acronym></seg>
<seg>/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; and
/usr/share/doc/xml</seg>
</seglistitem>
</segmentedlist>
 
</sect2>
</sect1>
 
/trunk/blfs/pst/ps/psutils/psutils-inst.xml
File deleted
/trunk/blfs/pst/ps/psutils/psutils-desc.xml
File deleted
/trunk/blfs/pst/ps/psutils/psutils.ent
File deleted
/trunk/blfs/pst/ps/psutils/psutils-intro.xml
File deleted
/trunk/blfs/pst/ps/psutils/psutils-exp.xml
File deleted
/trunk/blfs/pst/ps/enscript/enscript-intro.xml
File deleted
/trunk/blfs/pst/ps/enscript/enscript-exp.xml
File deleted
/trunk/blfs/pst/ps/enscript/enscript-inst.xml
File deleted
/trunk/blfs/pst/ps/enscript/enscript-desc.xml
File deleted
/trunk/blfs/pst/ps/enscript/enscript.ent
File deleted
/trunk/blfs/pst/ps/a2ps/a2ps-inst.xml
File deleted
/trunk/blfs/pst/ps/a2ps/a2ps-desc.xml
File deleted
/trunk/blfs/pst/ps/a2ps/a2ps-config.xml
File deleted
/trunk/blfs/pst/ps/a2ps/a2ps.ent
File deleted
/trunk/blfs/pst/ps/a2ps/a2ps-intro.xml
File deleted
/trunk/blfs/pst/ps/a2ps/a2ps-exp.xml
File deleted
/trunk/blfs/pst/ps/xpdf/xpdf-config.xml
File deleted
/trunk/blfs/pst/ps/xpdf/xpdf.ent
File deleted
/trunk/blfs/pst/ps/xpdf/xpdf-intro.xml
File deleted
/trunk/blfs/pst/ps/xpdf/xpdf-exp.xml
File deleted
/trunk/blfs/pst/ps/xpdf/xpdf-inst.xml
File deleted
/trunk/blfs/pst/ps/xpdf/xpdf-desc.xml
File deleted
/trunk/blfs/pst/ps/gsview/gsview-config.xml
File deleted
/trunk/blfs/pst/ps/gsview/gsview.ent
File deleted
/trunk/blfs/pst/ps/gsview/gsview-intro.xml
File deleted
/trunk/blfs/pst/ps/gsview/gsview-exp.xml
File deleted
/trunk/blfs/pst/ps/gsview/gsview-inst.xml
File deleted
/trunk/blfs/pst/ps/gsview/gsview-desc.xml
File deleted
/trunk/blfs/pst/ps/other.xml
1,10 → 1,18
<?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;
]>
 
<sect1 id="pst-postscript-other">
<sect1info>
<othername>$LastChangedBy: larry $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="otherps.html"?>
<title>Autres programmes PostScript</title>
<title>Other PostScript programs</title>
 
<para>KGhostview est un visualisateur de fichiers PostScript/<acronym>PDF</acronym>
basé sur <application>Qt</application> disponible dans <xref linkend="kdegraphics"/>.</para>
<para><command>kghostview</command> is a <application>Qt</application> based
PostScript/<acronym>PDF</acronym> viewer from <xref linkend="kdegraphics"/>.</para>
 
 
</sect1>
/trunk/blfs/pst/ps/xpdf.xml
1,12 → 1,193
<?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 xpdf-download-http "http://gd.tuwien.ac.at/publishing/xpdf/xpdf-3.00.tar.gz">
<!ENTITY xpdf-download-ftp "ftp://ftp.foolabs.com/pub/xpdf/xpdf-3.00.tar.gz">
<!ENTITY xpdf-md5sum "95294cef3031dd68e65f331e8750b2c2">
<!ENTITY xpdf-size "534 KB">
<!ENTITY xpdf-buildsize "32 MB">
<!ENTITY xpdf-time "0.36 SBU">
]>
 
<sect1 id="xpdf" xreflabel="Xpdf-&xpdf-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="xpdf.html"?>
<title>Xpdf-&xpdf-version;</title>
<title><application>Xpdf</application>-&xpdf-version;</title>
 
&xpdf-intro;
&xpdf-inst;
&xpdf-exp;
&xpdf-config;
&xpdf-desc;
<sect2>
<title>Introduction to <application>Xpdf</application></title>
 
<para><application>Xpdf</application> is a viewer for Adobe's free Portable
Document Format (<acronym>PDF</acronym>) which is both fast and small and
comes with some useful command-line utilities.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&xpdf-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&xpdf-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &xpdf-md5sum;</para></listitem>
<listitem><para>Download size: &xpdf-size;</para></listitem>
<listitem><para>Estimated disk space required:
&xpdf-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&xpdf-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required patch: <ulink
url="ftp://ftp.foolabs.com/pub/xpdf/xpdf-3.00pl1.patch"/></para>
</listitem>
<listitem><para>Required patch: <ulink
url="ftp://ftp.foolabs.com/pub/xpdf/xpdf-3.00pl2.patch"/></para>
</listitem>
<listitem><para>Required patch: <ulink
url="ftp://ftp.foolabs.com/pub/xpdf/xpdf-&xpdf-version;.patch"/></para>
</listitem>
<listitem><para>Required patch: <ulink
url="&patch-root;/xpdf-&xpdf-version;-freetype_2.1.7_hack-2.patch"/></para>
</listitem>
</itemizedlist></sect3>
 
<sect3><title><application>Xpdf</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="lesstif"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="gs"/> or <xref linkend="espgs"/> (just the fonts),
<ulink
url="http://gd.tuwien.ac.at/visual/ibiblio/libs/graphics/t1lib-5.0.2.tar.gz">
t1lib</ulink>
and <ulink
url="http://packages.debian.org/unstable/source/libpaper">libpaper</ulink>
</para></sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Xpdf</application></title>
 
<para>Install <application>Xpdf</application> by running the following
commands:</para>
 
<screen><userinput><command>patch -d xpdf -Np0 -i ../../xpdf-3.00pl1.patch &amp;&amp;
patch -d xpdf -Np0 -i ../../xpdf-3.00pl2.patch &amp;&amp;
patch -d xpdf -Np0 -i ../../xpdf-&xpdf-version;.patch &amp;&amp;
patch -Np1 -i ../xpdf-&xpdf-version;-freetype_2.1.7_hack-2.patch &amp;&amp;
./configure --prefix=/usr --sysconfdir=/etc \
--with-freetype2-includes=/usr/include/freetype2 &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Installation command explanations</title>
 
<para><option>--enable-a4-paper</option>: This switch must be
added to set <acronym>DIN</acronym> A4 as the standard paper format.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>Xpdf</application></title>
 
<sect3><title>Config files</title>
<para><filename>/etc/xpdfrc</filename>,
<filename>~/.xpdfrc</filename></para></sect3>
 
<sect3><title>Configuration Information</title>
 
<para>In the <filename class='directory'>/etc</filename> directory you will
find a sample <filename>xpdfrc</filename> that can be either copied to
<filename>~/.xpdfrc</filename> or taken as an example to write your own
configuration file.</para>
 
<screen><userinput># Example .xpdfrc
displayFontT1 Times-Roman /usr/share/ghostscript/fonts/n021003l.pfb
displayFontT1 Times-Italic /usr/share/ghostscript/fonts/n021023l.pfb
displayFontT1 Times-Bold /usr/share/ghostscript/fonts/n021004l.pfb
displayFontT1 Times-BoldItalic /usr/share/ghostscript/fonts/n021024l.pfb
displayFontT1 Helvetica /usr/share/ghostscript/fonts/n019003l.pfb
displayFontT1 Helvetica-Oblique /usr/share/ghostscript/fonts/n019023l.pfb
displayFontT1 Helvetica-Bold /usr/share/ghostscript/fonts/n019004l.pfb
displayFontT1 Helvetica-BoldOblique /usr/share/ghostscript/fonts/n019024l.pfb
displayFontT1 Courier /usr/share/ghostscript/fonts/n022003l.pfb
displayFontT1 Courier-Oblique /usr/share/ghostscript/fonts/n022023l.pfb
displayFontT1 Courier-Bold /usr/share/ghostscript/fonts/n022004l.pfb
displayFontT1 Courier-BoldOblique /usr/share/ghostscript/fonts/n022024l.pfb
displayFontT1 Symbol /usr/share/ghostscript/fonts/s050000l.pfb
displayFontT1 ZapfDingbats /usr/share/ghostscript/fonts/d050000l.pfb
 
fontDir /usr/X11R6/lib/X11/fonts/TTF
 
psFile "|lpr"
psPaperSize letter
#psPaperSize A4
textEOL unix
 
enableT1lib yes
enableFreeType yes
antialias yes
 
urlCommand "links -g %s"</userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>Xpdf</application> package contains
<command>xpdf</command>, <command>pdftops</command>,
<command>pdftotext</command>, <command>pdftoppm</command>,
<command>pdffonts</command>, <command>pdfimages</command> and
<command>pdfinfo</command>.</para>
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>xpdf</title>
<para><command>xpdf</command> displays files in <acronym>PDF</acronym>
format.</para></sect3>
 
<sect3><title>pdftops</title>
<para><command>pdftops</command> converts <acronym>PDF</acronym> files to
<acronym>PS</acronym> format.</para></sect3>
 
<sect3><title>pdftotext</title>
<para><command>pdftotext</command> parses <acronym>ASCII</acronym> text from
<acronym>PDF</acronym> files.</para></sect3>
 
<sect3><title>pdftoppm</title>
<para><command>pdftoppm</command> converts <acronym>PDF</acronym> files to
<acronym>PBM</acronym>, <acronym>PGM</acronym>, <acronym>PPM</acronym>
formats.</para></sect3>
 
<sect3><title>pdffonts</title>
<para><command>pdffonts</command> lists the fonts used in a
<acronym>PDF</acronym> file along with various information for each
font.</para></sect3>
 
<sect3><title>pdfimages</title>
<para><command>pdfimages</command> saves images from a
<acronym>PDF</acronym> file as <acronym>PPM</acronym>,
<acronym>PBM</acronym>, or <acronym>JPEG</acronym> files.</para></sect3>
 
<sect3><title>pdfinfo</title>
<para><command>pdfinfo</command> prints the contents of the 'Info'
dictionary (plus some other useful information) from a
<acronym>PDF</acronym> file.</para></sect3>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/ps/ps.xml
1,18 → 1,23
<?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="pst-ps">
<?dbhtml filename="ps.html"?>
<title>PostScript</title>
 
<para>Ce chapitre inclut des applications qui créent, manipulent ou visualisent
des fichiers PostScript et visualisent les fichiers au format <acronym>PDF</acronym>
(acronyme de <foreignphrase>Portable Document Format</foreignphrase>).
</para>
<para>This chapter includes applications that create, manipulate or view
PostScript files and create or view Portable Document Format
<acronym>PDF</acronym> files.</para>
 
&a2ps;
&enscript;
&psutils;
&gsview;
&xpdf;
&pst-postscript-other;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="a2ps.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="enscript.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="psutils.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gsview.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xpdf.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fop.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="other.xml"/>
 
</chapter>
/trunk/blfs/pst/ps/psutils.xml
1,11 → 1,125
<?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 psutils-download-http "http://gd.tuwien.ac.at/publishing/tex/tex-utils/psutils/psutils-&psutils-version;.tar.gz">
<!ENTITY psutils-download-ftp " ">
<!ENTITY psutils-md5sum "b161522f3bd1507655326afa7db4a0ad">
<!ENTITY psutils-size "68 KB">
<!ENTITY psutils-buildsize "740 KB">
<!ENTITY psutils-time "0.01 SBU">
]>
 
<sect1 id="psutils" xreflabel="PSUtils-&psutils-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="psutils.html"?>
<title>PSUtils-&psutils-version;</title>
 
&psutils-intro;
&psutils-inst;
&psutils-exp;
&psutils-desc;
<sect2>
<title>Introduction to <application>PSUtils</application></title>
 
<para><application>PSUtils</application> is a set of utilities to manipulate
PostScript files.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&psutils-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&psutils-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &psutils-md5sum;</para></listitem>
<listitem><para>Download size: &psutils-size;</para></listitem>
<listitem><para>Estimated disk space required:
&psutils-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&psutils-time;</para></listitem></itemizedlist>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>PSUtils</application></title>
 
<para>Install <application>PSUtils</application> by running the following
commands:</para>
 
<screen><userinput><command>cat Makefile.unix | sed -e 's|/usr/local|/usr|g' &gt; Makefile &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>cat Makefile.unix | sed -e ... &gt; Makefile</command>: This
command creates a <filename>Makefile</filename> that installs the program to
the <filename class="directory">/usr</filename> prefix instead of the
<filename class="directory">/usr/local</filename> prefix.</para>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>PSUtils</application> package contains
<command>psbook</command>, <command>psselect</command>,
<command>pstops</command>, <command>psnup</command>,
<command>psresize</command>, <command>epsffit</command>,
<command>getafm</command>, <command>showchar</command>,
<command>fixdlsrps</command>, <command>fixfmps</command>,
<command>fixmacps</command>, <command>fixpsditps</command>,
<command>fixpspps</command>, <command>fixscribeps</command>,
<command>fixtpps</command>, <command>fixwfwps</command>,
<command>fixwpps</command>, <command>fixwwps</command>,
<command>extractres</command>, <command>includeres</command> and
<command>psmerge</command>.</para>
 
<para>Sometimes <command>psnup</command> and other utilities from this
package produce PostScript files that don't conform to Adobe's
<acronym>DSC</acronym> standard.
<application><acronym>CUPS</acronym></application> may print them
incorrectly. On the other hand,
<application><acronym>CUPS</acronym></application> has builtin
replacements for most commands from this package. For example, to print
a document 2-up, you can issue this command:</para>
 
<screen><userinput><command>lp -o number-up=2 <replaceable>[filename]</replaceable></command></userinput></screen>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>psbook</title>
<para><command>psbook</command> rearranges pages into signatures.</para></sect3>
 
<sect3><title>psselect</title>
<para><command>psselect</command> selects pages and page ranges.</para>
</sect3>
 
<sect3><title>pstops</title>
<para><command>pstops</command> performs general page rearrangements
and selection.</para></sect3>
 
<sect3><title>psnup</title>
<para><command>psnup</command> puts multiple pages per physical sheet
of paper.</para></sect3>
 
<sect3><title>psresize</title>
<para><command>psresize</command> alters the document paper size.</para></sect3>
 
<sect3><title>epsffit</title>
<para><command>epsffit</command> fits an <acronym>EPSF</acronym> file to a
given bounding box.</para></sect3>
 
<sect3><title>scripts</title>
<para>The remaining commands are scripts that perform specific functions
described in their respective man pages.</para></sect3>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/ps/gsview.xml
1,12 → 1,131
<?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 gsview-download-http "http://gd.tuwien.ac.at/publishing/ghostscript/ghostgum/gsview-&gsview-version;.tar.gz">
<!ENTITY gsview-download-ftp "ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/gsview-&gsview-version;.tar.gz">
<!ENTITY gsview-md5sum "35cb5e421faca49eb70c426354e41ba8">
<!ENTITY gsview-size "895 KB">
<!ENTITY gsview-buildsize "19 MB">
<!ENTITY gsview-time "0.19 SBU">
]>
 
<sect1 id="gsview" xreflabel="GSview-&gsview-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="gsview.html"?>
<title>GSview-&gsview-version;</title>
 
&gsview-intro;
&gsview-inst;
&gsview-exp;
&gsview-config;
&gsview-desc;
<sect2>
<title>Introduction to <application>GSview</application></title>
 
<para><application>GSview</application> is a viewer for PostScript and
<acronym>PDF</acronym> using <application>X</application>.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&gsview-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&gsview-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &gsview-md5sum;</para></listitem>
<listitem><para>Download size: &gsview-size;</para></listitem>
<listitem><para>Estimated disk space required:
&gsview-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&gsview-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch: <ulink
url="&patch-root;/gsview-&gsview-version;-pstotext-1.patch"/></para></listitem>
<listitem><para>Required Patch: <ulink
url="&patch-root;/gsview-&gsview-version;-lang-1.patch"/></para></listitem>
</itemizedlist>
</sect3>
 
<sect3><title><application>GSview</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="GTK"/> and
<xref linkend="gs"/> or <xref linkend="espgs"/>
(with libgs.so installed)</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>GSview</application></title>
 
<para><application>GSview</application> uses <command>netscape</command> to
browse through the online help. <acronym>BLFS</acronym>
does not install <application>Netscape</application>, but has other
browsers from which to choose. You can create a symlink from your preferred
browser to <command>/usr/bin/netscape</command>, or simply edit
<filename>srcunx/gvxreg.c</filename> using the following <command>sed</command>
script with your browser's executable file name
substituted for <replaceable>[browser]</replaceable>:</para>
 
<screen><userinput><command>sed -i s/netscape/<replaceable>[browser]</replaceable>/ srcunx/gvxreg.c</command></userinput></screen>
 
<para>Install <application>GSview</application> by running the following
commands:</para>
 
<screen><userinput><command>sed 's|GSVIEW_ROOT=/usr/local|GSVIEW_ROOT=/usr|' \
srcunx/unx.mak &gt; Makefile &amp;&amp;
patch -Np1 -i ../gsview-&gsview-version;-pstotext-1.patch &amp;&amp;
patch -Np1 -i ../gsview-&gsview-version;-lang-1.patch &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sed 's|GSVIEW_ROOT=/usr/local|GSVIEW_ROOT=/usr|'</command>: This
command changes the default installation directory to
<filename class="directory">/usr</filename>.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>GSview</application></title>
 
<sect3><title>Config files</title>
<para><filename>/etc/gsview/*</filename></para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>GSview</application> package contains
<command>epstool</command>, <command>gsview</command> and
<command>gsview-help</command>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>epstool</title>
<para><command>epstool</command> is a tool for extracting preview
bitmaps in <acronym>EPS</acronym> files.</para></sect3>
 
<sect3><title>gsview</title>
<para><command>gsview</command> is a viewer for PostScript
(<acronym>PS</acronym>) and
<acronym>PDF</acronym> files.</para></sect3>
 
<sect3><title>gsview-help</title>
<para><command>gsview-help</command> is a script for displaying help
files in your chosen browser.</para></sect3>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/ps/fop.xml
0,0 → 1,331
<?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 fop-download-http "http://www.apache.org/dist/xml/fop/fop-&fop-version;-src.tar.gz">
<!ENTITY fop-download-ftp "ftp://apache.mirrors.pair.com/xml/fop/source/fop-&fop-version;-src.tar.gz">
<!ENTITY fop-md5sum "1a31eb1357e5d4b8d32d4cb3edae2da2">
<!ENTITY fop-size "7.8 MB">
<!ENTITY fop-buildsize "45.3 MB">
<!ENTITY fop-time "0.25 SBU">
 
<!ENTITY jai-download "http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&amp;PartDetailId=jai-1_1_2_01-oth-JPR&amp;SiteId=JSC&amp;TransactionId=noreg">
<!ENTITY jai-md5sum "f2be3619a8d002eff3874355e96327eb">
<!ENTITY jai-size "2.6 MB">
]>
 
<sect1 id="fop" xreflabel="FOP-&fop-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="fop.html"?>
<title><application><acronym>FOP</acronym></application>-&fop-version;</title>
<indexterm zone="fop">
<primary sortas="a-FOP">FOP</primary></indexterm>
 
<sect2>
<title>Introduction to <application><acronym>FOP</acronym></application></title>
 
<para>The <application><acronym>FOP</acronym></application> (Formatting
Objects Processor) package contains a print formatter driven by
<acronym>XSL</acronym> formatting objects
(<acronym>XSL</acronym>-<acronym>FO</acronym>). It is a
<application>Java</application> application that reads a formatting object
tree and renders the resulting pages to a specified output. Output formats
currently supported include <acronym>PDF</acronym>, <acronym>PCL</acronym>,
PostScript, <acronym>SVG</acronym>, <acronym>XML</acronym> (area tree
representation), print, <acronym>AWT</acronym>, <acronym>MIF</acronym> and
<acronym>ASCII</acronym> text. The primary output target is
<acronym>PDF</acronym>.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing="compact">
<listitem><para>Download (HTTP):
<ulink url="&fop-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&fop-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum:
&fop-md5sum;</para></listitem>
<listitem><para>Download size:
&fop-size;</para></listitem>
<listitem><para>Estimated disk space required:
&fop-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&fop-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Additional downloads</title>
<itemizedlist spacing="compact">
<listitem><para><application>Java</application> Advanced Imaging
(<acronym>JAI</acronym>) <acronym>API</acronym> components:
<ulink url="&jai-download;">
http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&amp;</ulink>
<ulink url="&jai-download;">
PartDetailId=jai-1_1_2_01-oth-JPR&amp;SiteId=JSC&amp;TransactionId=noreg</ulink>
</para></listitem>
<listitem><para>Download MD5 sum: &jai-md5sum;</para></listitem>
<listitem><para>Download size: &jai-size;</para></listitem>
</itemizedlist>
 
<para>Choose the <quote><application>Linux</application>
<application><acronym>JDK</acronym></application> Install</quote> file after
accepting the license agreement.</para>
</sect3>
 
<sect3><title><application>FOP</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="j2sdk"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="libxslt"/>,
<ulink url="http://java.sun.com/products/jimi/">JIMI SDK</ulink>,
<ulink url="http://xml.apache.org/batik/">Batik</ulink> and
<ulink url="http://forrest.apache.org/">Forrest</ulink> (only used to rebuild
the documentation)</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>FOP</application></title>
 
<note><para>Ensure <envar>$JAVA_HOME</envar> is set correctly before beginning
the build. Additionally, the build will fail if your version of the
<acronym>JDK</acronym> is higher than 1.4.2_x.</para></note>
 
<para>Some versions of tar will display a message similar to
<quote><computeroutput>tar: A lone zero block at 33476</computeroutput></quote>
when unpacking the source tarball. You may safely ignore this message.</para>
 
<sect3><title>Installing <acronym>JAI</acronym></title>
<para>Install the <acronym>JAI</acronym> components by running the following
commands as the root user while in the root of the
<application><acronym>FOP</acronym></application> source tree:</para>
 
<screen><userinput role='root'><command>chmod 755 ../jai-1_1_2_01-lib-linux-i586-jdk.bin &amp;&amp;
FOP_BUILD_DIR=$(pwd) &amp;&amp;
cd $JAVA_HOME &amp;&amp;
yes | $FOP_BUILD_DIR/../jai-1_1_2_01-lib-linux-i586-jdk.bin &amp;&amp;
cd $FOP_BUILD_DIR</command></userinput></screen>
</sect3>
 
<sect3><title>Installing <application><acronym>FOP</acronym></application>
required components</title>
<para>Install <application><acronym>FOP</acronym></application> by running the
following commands:</para>
 
<screen><userinput><command>./build.sh &amp;&amp;
sed -i -e "s/build/lib/" fop.sh</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>install -v -d -m755 \
/opt/fop-&fop-version;/{bin,lib,docs/{general,lib,site}} &amp;&amp;
install -v -m755 fop.sh /opt/fop-&fop-version;/bin &amp;&amp;
install -v -m644 build/fop.jar lib/avalon-framework-cvs-20020806.jar \
/opt/fop-&fop-version;/lib &amp;&amp;
install -v -m644 docs/* /opt/fop-&fop-version;/docs &amp;&amp;
install -v -m644 CHANGES LICENSE README ReleaseNotes.html STATUS \
/opt/fop-&fop-version;/docs/general &amp;&amp;
install -v -m644 lib/{avalon.LICENSE.txt,readme} \
/opt/fop-&fop-version;/docs/lib &amp;&amp;
cp -v -R build/site/* /opt/fop-&fop-version;/docs/site &amp;&amp;
ln -svf fop-&fop-version; /opt/fop</command></userinput></screen>
</sect3>
 
<sect3><title>Installing the <application>Batik</application>
<acronym>JAR</acronym></title>
<para>You'll need to install one additional <application>Java</application>
class library to process <acronym>SVG</acronym> objects. This library is part
of the <ulink url="http://xml.apache.org/batik/">Batik</ulink> package, but is
also included with the <application><acronym>FOP</acronym></application>
package. If you have <application>Batik</application> installed, ensure the
<filename>batik.jar</filename> library is included in your
<envar>$CLASSPATH</envar> environment variable. Alternatively, create a
symbolic link from <filename>/opt/fop-&fop-version;/lib/batik.jar</filename>
pointing to the full path of the installed <filename>batik.jar</filename>
file so that the <command>fop.sh</command> script will automatically pick it
up.</para>
 
<para>If you don't have the <application>Batik</application> package installed,
run the following commands as the root user:</para>
 
<screen><userinput role='root'><command>install -v -m644 lib/batik.jar /opt/fop-&fop-version;/lib &amp;&amp;
install -v -m644 lib/batik.LICENSE.txt \
/opt/fop-&fop-version;/docs/lib</command></userinput></screen>
</sect3>
 
<sect3><title>Installing the <application>Xalan-Java</application>
components</title>
<para>The components of <application><acronym>FOP</acronym></application>
required to process <acronym>FO</acronym> files created by an
<acronym>XSL</acronym> transformation engine (also known as an
<acronym>XSLT</acronym> processor) is now complete. An
<acronym>XSL</acronym> transformation engine (<command>xsltproc</command>)
is included with the <xref linkend="libxslt"/> package in
<acronym>BLFS</acronym>. The <application><acronym>FOP</acronym></application>
package includes components of
<ulink url="http://xml.apache.org/xalan-j/">Xalan-Java</ulink> to accomplish
<acronym>XSL</acronym> transformations. If you have the
<application>Xalan-Java</application> package installed, skip to the next
section.</para>
 
<para>If you wish to install the <application>Xalan-Java</application>
components provided by the <application><acronym>FOP</acronym></application>
package, run the following commands as the root user:</para>
 
<screen><userinput role='root'><command>sed -i -e "s/build/lib/" xalan.sh &amp;&amp;
install -v -m755 xalan.sh /opt/fop-&fop-version;/bin &amp;&amp;
install -v -m644 lib/xml-apis.jar \
lib/xercesImpl-2.2.1.jar \
lib/xalan-2.4.1.jar \
/opt/fop-&fop-version;/lib &amp;&amp;
install -v -m644 lib/{xml-apis,xerces,xalan}.LICENSE.txt \
lib/xml-apis.README.txt \
/opt/fop-&fop-version;/docs/lib</command></userinput></screen>
</sect3>
 
<sect3><title>Installing the
<application>Jimi <acronym>SDK</acronym></application>
<acronym>JAR</acronym></title>
<para>If you installed the Java Image I/O class library
(<application>Jimi <acronym>SDK</acronym></application>) into the
<application><acronym>FOP</acronym></application> source tree
<filename class='directory'>lib</filename> directory before building
<application><acronym>FOP</acronym></application> (this will enable Jimi
support), ensure you also install this <acronym>JAR</acronym> file into
<filename class='directory'>/opt/fop-&fop-version;/lib</filename>.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>yes | $FOP_BUILD_DIR/../jai-...-jdk.bin</command>: This command
installs the <application><acronym>JAI</acronym></application> components
into the <application><acronym>JDK</acronym></application> file structure. The
<command>yes</command> command is piped through so that you don't have to
scroll through four pages of the license agreement and automatically responds
<quote>yes</quote> to the agreement. <envar>$FOP_BUILD_DIR</envar> is used as
a reference point to the source executable and as a method to return back to
the <application><acronym>FOP</acronym></application> source tree.</para>
 
<para><command>sed -i -e "s/build/lib/" ...</command>: These commands modify
the installed shell scripts so that the location of the installed
<filename>fop.jar</filename> file is correctly identified.</para>
 
<para><command>install -v ...; cp -v ...</command>: There is no installation
script provided by the <application><acronym>FOP</acronym></application>
package. These commands install the package.</para>
 
<para><command>ln -svf fop-&fop-version; /opt/fop</command>: This creates a
convenience symlink so that <envar>$FOP_HOME</envar> doesn't have to be
changed each time there's a package version change.</para>
</sect2>
 
<sect2>
<title>Configuring <application>FOP</application></title>
 
<sect3 id="fop-config"><title>Config files</title>
<para><filename>~/.foprc</filename></para>
<indexterm zone="fop fop-config">
<primary sortas="e-AA.foprc">~/.foprc</primary></indexterm>
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para>Using <application><acronym>FOP</acronym></application> to process some
large <acronym>FO</acronym>'s (including the <acronym>FO</acronym> derived from
the <acronym>BLFS</acronym> <acronym>XML</acronym> sources), can lead to memory
errors. Unless you add a parameter to the <command>java</command> command used
in the <command>fop.sh</command> script you may receive messages similar to the
one shown below:</para>
 
<para><computeroutput>Exception in thread "main" java.lang.OutOfMemoryError:
Java heap space</computeroutput></para>
 
<para>To avoid errors like this, you need to pass an extra parameter to the
<command>java</command> command used in the <command>fop.sh</command> script.
This can be accomplished by creating a <filename>~/.foprc</filename> (which
is sourced by the <command>fop.sh</command> script) and adding the parameter
to the <envar>FOP_OPTS</envar> environment variable.</para>
 
<para>The <command>fop.sh</command> script looks for a <envar>FOP_HOME</envar>
environment variable to locate the
<application><acronym>FOP</acronym></application> class libraries. You can
create this variable using the <filename>~/.foprc</filename> file as
well. Create a <filename>~/.foprc</filename> file using the following
commands:</para>
 
<screen><userinput><command>cat &gt; ~/.foprc &lt;&lt; "EOF"</command>
FOP_OPTS="-Xmx<replaceable>[RAM_Installed]</replaceable>m"
FOP_HOME="/opt/fop"
 
<command>EOF</command></userinput></screen>
 
<para>Replace <replaceable>[RAM_Installed]</replaceable> with a number
representing the amount of RAM installed in your computer. An example would
be <userinput>FOP_OPTS="-Xmx768m"</userinput>. For more information about
memory issues running <application><acronym>FOP</acronym></application>, see
<ulink url="http://xml.apache.org/fop/running.html#memory"/>.</para>
 
<para>To include the <command>fop.sh</command> script in your path, update
your personal or system-wide profile with the following:</para>
 
<screen><userinput>PATH=$PATH:/opt/fop/bin</userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>fop.sh and xalan.sh</seg>
<seg>avalon-framework-cvs-20020806.jar, batik.jar, fop.jar, xalan-2.4.1.jar,
xercesImpl-2.2.1.jar and xml-apis.jar. <acronym>JAI</acronym> components
include libmlib_jai.so, jai_codec.jar, jai_core.jar and
mlibwrapper_jai.jar</seg>
<seg>/opt/fop-&fop-version;</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="fop.sh">
<term><command>fop.sh</command></term>
<listitem><para>is a wrapper script to the <command>java</command> command
which sets up the <application><acronym>FOP</acronym></application>
environment and passes the required parameters.</para>
<indexterm zone="fop fop.sh">
<primary sortas="b-fop.sh">fop.sh</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="fop.jar">
<term><filename class='libraryfile'>fop.jar</filename></term>
<listitem><para>contains all the
<application><acronym>FOP</acronym></application>
<application>Java</application> classes.</para>
<indexterm zone="fop fop.jar">
<primary sortas="c-fop.jar">fop.jar</primary></indexterm>
</listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
 
/trunk/blfs/pst/ps/a2ps.xml
1,12 → 1,198
<?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 a2ps-download-http "http://ftp.gnu.org/gnu/a2ps/a2ps-&a2ps-version;.tar.gz">
<!ENTITY a2ps-download-ftp "ftp://ftp.gnu.org/gnu/a2ps/a2ps-&a2ps-version;.tar.gz">
<!ENTITY a2ps-md5sum "0c8e0c31b08c14f7a7198ce967eb3281">
<!ENTITY a2ps-size "1.9 MB">
<!ENTITY a2ps-buildsize "19.2 MB">
<!ENTITY a2ps-time "0.26 SBU">
]>
 
<sect1 id="a2ps" xreflabel="a2ps-&a2ps-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="a2ps.html"?>
<title>a2ps-&a2ps-version;</title>
 
&a2ps-intro;
&a2ps-inst;
&a2ps-exp;
&a2ps-config;
&a2ps-desc;
<sect2>
<title>Introduction to <application>a2ps</application></title>
 
<para><application>a2ps</application> is a filter utilitized mainly in the
background and primarily by printing scripts to convert almost
every input format into PostScript output. The application's name expands
appropriately to "all to PostScript".</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&a2ps-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&a2ps-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &a2ps-md5sum;</para></listitem>
<listitem><para>Download size: &a2ps-size;</para></listitem>
<listitem><para>Estimated disk space required:
&a2ps-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&a2ps-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>International fonts: <ulink
url="ftp://ftp.enst.fr/pub/unix/a2ps/i18n-fonts-0.1.tar.gz"/></para></listitem>
</itemizedlist>
</sect3>
 
<sect3><title><application>a2ps</application> dependencies</title>
<sect4><title>Optional</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="psutils"/>,
<xref linkend="tex"/>,
<xref linkend="gs"/> or <xref linkend="espgs"/>,
<ulink
url="http://packages.debian.org/unstable/source/libpaper">libpaper</ulink>,
<ulink url="http://www.adobe.com/products/acrobat/readstep2.html">Adobe
Reader</ulink> and
<ulink
url="http://www.gnu.org/software/ghostview/ghostview.html">Ghostview</ulink>
</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>a2ps</application></title>
 
<para>Install <application>a2ps</application> by running the following
commands:</para>
 
<screen><userinput><command>sed -i -e "s|emacs||" contrib/Makefile.in &amp;&amp;
sed -i -e "s|/usr/local/share|/usr/share|" configure &amp;&amp;
sed -i -e "s|char \*malloc ();|/* &amp; */|" \
lib/path-concat.c &amp;&amp;
./configure --prefix=/usr \
--sysconfdir=/etc/a2ps --localstatedir=/var \
--enable-shared --with-medium=letter &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sed -i -e "s|emacs||" contrib/Makefile.in</command>:
This command eliminates the compiling and installing of the
<application>Emacs</application> script files. If you have substituted
<application>Emacs</application> for <application>Vi</application> as your
primary editor, skip this step.</para>
 
<para><command>sed -i -e "s|/usr/local/share|/usr/share|" configure</command>:
This command modifies the configure script to search for
<application>Ghostscript</application> fonts at the location where they were
installed by the <acronym>BLFS</acronym> instructions.</para>
 
<para><command>sed -i -e "s|char \*malloc ();|/* &amp; */|"
lib/path-concat.c</command>: This command fixes a build problem with
<application><acronym>GCC</acronym></application>-3.4.x</para>
 
<para><parameter>--sysconfdir=/etc/a2ps</parameter>: Configuration data
is installed in <filename class="directory">/etc/a2ps</filename> instead of
<filename class="directory">/usr/etc</filename>.</para>
 
<para><parameter>--enable-shared</parameter>: This switch enables building
the dynamic <filename class='libraryfile'>liba2ps</filename> library.</para>
 
<para><parameter>--with-medium=letter</parameter>: This switch changes
the default paper format of A4 to letter. Installations that utilize A4
would eliminate this switch.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>a2ps</application></title>
 
<sect3><title>Config files</title>
 
<para><filename>/etc/a2ps/a2ps.cfg</filename>,
<filename>/etc/a2ps/a2ps-site.cfg</filename></para>
 
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para>Information about configuring <application>a2ps</application> can be
found in the comments contained in the above files, and also by
running <command>info a2ps</command>.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>a2ps</application> package
contains <command>a2ps</command>, <command>card</command>,
<command>composeglyphs</command>, <command>fixnt</command>,
<command>fixps</command>, <command>ogonkify</command>,
<command>pdiff</command>, <command>psmandup</command>,
<command>psset</command>, <command>texi2dvi4a2ps</command>,
<filename class='libraryfile'>liba2ps</filename> libraries
and filter data.</para>
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>a2ps</title>
<para><command>a2ps</command> is a filter, utilized primarily by
printing scripts, that converts standard input or supported files
to PostScript.</para></sect3>
 
<sect3><title>card</title>
<para><command>card</command> prints a reference card of a given program's
options.</para></sect3>
 
<sect3><title>composeglyphs</title>
<para><command>composeglyphs</command> creates a composite font
program.</para></sect3>
 
<sect3><title>fixnt</title>
<para><command>fixnt</command> is supposed to fix the problems in
the PostScript files generated by the Microsoft PostScript driver under
Windows NT (3.5 and 4.0).</para></sect3>
 
<sect3><title>fixps</title>
<para><command>fixps</command> tries to fix common PostScript problems that
break postprocessing.</para></sect3>
 
<sect3><title>ogonkify</title>
<para><command>ogonkify</command> provides international support for
Postscript by performing various munging of PostScript files
related to printing in different languages.</para></sect3>
 
<sect3><title>pdiff</title>
<para><command>pdiff</command> produces a pretty comparison between
files.</para></sect3>
 
<sect3><title>psmandup</title>
<para><command>psmandup</command> tries to produce a version of a given
PostScript file to print in manual duplex.</para></sect3>
 
<sect3><title>psset</title>
<para><command>psset</command> produces a version of a given PostScript file
with a protected call to the PostScript operator 'setpagedevice'. Typical use
is making a file print duplex, or on the manual tray, etc.</para></sect3>
 
<sect3><title>texi2dvi4a2ps</title>
<para><command>texi2dvi4a2ps</command> compiles Texinfo and LaTeX files to
<acronym>DVI</acronym> or <acronym>PDF</acronym></para></sect3>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/ps/enscript.xml
1,11 → 1,124
<?xml version="1.0" encoding="ISO-8859-1"?>
<sect1 id="enscript" xreflabel="enscript-&enscript-version;">
<!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 enscript-download-http "http://www.iki.fi/mtr/genscript/enscript-&enscript-version;.tar.gz">
<!ENTITY enscript-download-ftp " ">
<!ENTITY enscript-md5sum "b5174b59e4a050fb462af5dbf28ebba3">
<!ENTITY enscript-size "1.0 MB">
<!ENTITY enscript-buildsize "10.2 MB">
<!ENTITY enscript-time "0.13 SBU">
]>
 
<sect1 id="enscript" xreflabel="Enscript-&enscript-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="enscript.html"?>
<title>enscript-&enscript-version;</title>
<title>Enscript-&enscript-version;</title>
 
&enscript-intro;
&enscript-inst;
&enscript-exp;
&enscript-desc;
<sect2>
<title>Introduction to <application>Enscript</application></title>
 
<para><application>Enscript</application> converts <acronym>ASCII</acronym>
text files to PostScript, <acronym>HTML</acronym>, <acronym>RTF</acronym>,
<acronym>ANSI</acronym> and overstrikes.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&enscript-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&enscript-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &enscript-md5sum;</para></listitem>
<listitem><para>Download size: &enscript-size;</para></listitem>
<listitem><para>Estimated disk space required:
&enscript-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&enscript-time;</para></listitem></itemizedlist>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of Enscript</title>
 
<para>Install <application>Enscript</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc/enscript \
--localstatedir=/var --with-media=Letter &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><parameter>--sysconfdir=/etc/enscript</parameter>: This switch puts
configuration data in <filename class="directory">/etc/enscript</filename>
instead of <filename class="directory">/usr/etc</filename>.</para>
 
<para><parameter>--localstatedir=/var</parameter>: This switch sets the
directory for runtime data to <filename class="directory">/var</filename>
instead of <filename class="directory">/usr/var</filename>.</para>
 
<para><parameter>--with-media=Letter</parameter>: This switch sets the
medium format to letter.</para>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>Enscript</application> package contains
<command>diffpp</command>,
<command>enscript</command>,
<command>mkafmmap</command>,
<command>over</command>,
<command>sliceprint</command>,
<command>states</command> and filter data.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>diffpp</title>
<para><command>diffpp</command> converts <command>diff</command> output files
to a format suitable to be printed with <command>enscript</command>.</para>
</sect3>
 
<sect3><title>enscript</title>
<para><command>enscript</command> is a filter, used primarily by printing
scripts, that converts <acronym>ASCII</acronym> text files to PostScript,
<acronym>HTML</acronym>, <acronym>RTF</acronym>, <acronym>ANSI</acronym> and
overstrikes.</para>
</sect3>
 
<sect3><title>mkafmmap</title>
<para><command>mkafmmap</command> creates a font map from a given file.</para>
</sect3>
 
<sect3><title>over</title>
<para><command>over</command> is a script which calls
<command>enscript</command> and passes the correct parameters to create
overstriked fonts.</para>
</sect3>
 
<sect3><title>sliceprint</title>
<para><command>sliceprint</command> slices documents with long lines.</para>
</sect3>
 
<sect3><title>states</title>
<para><command>states</command> is an <command>awk</command>-like text
processing tool with some state machine extensions. It is designed for program
source code highlighting and for similar tasks where state information helps
input processing.</para>
</sect3>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/sgml/sgml-dtd/sgml-dtd-config.xml
File deleted
/trunk/blfs/pst/sgml/sgml-dtd/sgml-dtd.ent
File deleted
/trunk/blfs/pst/sgml/sgml-dtd/sgml-dtd-intro.xml
File deleted
/trunk/blfs/pst/sgml/sgml-dtd/sgml-dtd-exp.xml
File deleted
/trunk/blfs/pst/sgml/sgml-dtd/sgml-dtd-inst.xml
File deleted
/trunk/blfs/pst/sgml/sgml-dtd/sgml-dtd-desc.xml
File deleted
/trunk/blfs/pst/sgml/sgml-dtd-3/sgml-dtd-3-config.xml
File deleted
/trunk/blfs/pst/sgml/sgml-dtd-3/sgml-dtd-3.ent
File deleted
/trunk/blfs/pst/sgml/sgml-dtd-3/sgml-dtd-3-intro.xml
File deleted
/trunk/blfs/pst/sgml/sgml-dtd-3/sgml-dtd-3-exp.xml
File deleted
/trunk/blfs/pst/sgml/sgml-dtd-3/sgml-dtd-3-inst.xml
File deleted
/trunk/blfs/pst/sgml/sgml-dtd-3/sgml-dtd-3-desc.xml
File deleted
/trunk/blfs/pst/sgml/docbook-dsssl/docbook-dsssl-intro.xml
File deleted
/trunk/blfs/pst/sgml/docbook-dsssl/docbook-dsssl-exp.xml
File deleted
/trunk/blfs/pst/sgml/docbook-dsssl/docbook-dsssl-inst.xml
File deleted
/trunk/blfs/pst/sgml/docbook-dsssl/docbook-dsssl-desc.xml
File deleted
/trunk/blfs/pst/sgml/docbook-dsssl/docbook-dsssl-config.xml
File deleted
/trunk/blfs/pst/sgml/docbook-dsssl/docbook-dsssl.ent
File deleted
/trunk/blfs/pst/sgml/opensp/opensp.ent
File deleted
/trunk/blfs/pst/sgml/opensp/opensp-intro.xml
File deleted
/trunk/blfs/pst/sgml/opensp/opensp-exp.xml
File deleted
/trunk/blfs/pst/sgml/opensp/opensp-inst.xml
File deleted
/trunk/blfs/pst/sgml/opensp/opensp-desc.xml
File deleted
/trunk/blfs/pst/sgml/sgml-common/sgml-common.ent
File deleted
/trunk/blfs/pst/sgml/sgml-common/sgml-common-intro.xml
File deleted
/trunk/blfs/pst/sgml/sgml-common/sgml-common-inst.xml
File deleted
/trunk/blfs/pst/sgml/sgml-common/sgml-common-desc.xml
File deleted
/trunk/blfs/pst/sgml/sgml-common/sgml-common-config.xml
File deleted
/trunk/blfs/pst/sgml/openjade/openjade.ent
File deleted
/trunk/blfs/pst/sgml/openjade/openjade-intro.xml
File deleted
/trunk/blfs/pst/sgml/openjade/openjade-exp.xml
File deleted
/trunk/blfs/pst/sgml/openjade/openjade-inst.xml
File deleted
/trunk/blfs/pst/sgml/openjade/openjade-desc.xml
File deleted
/trunk/blfs/pst/sgml/openjade/openjade-config.xml
File deleted
/trunk/blfs/pst/sgml/sgml.xml
1,18 → 1,24
<?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="pst-sgml">
<?dbhtml filename="sgml.html"?>
<title>Langage de balises standards généralisées (<acronym>SGML</acronym>, acronyme de <foreignphrase>Standard Generalized Markup Language</foreignphrase>)</title>
<title>Standard Generalized Markup Language (<acronym>SGML</acronym>)</title>
 
<para>Ce chapitre contient les définitions de type de document DocBook
<acronym>SGML</acronym> (<acronym>DTD</acronym>s), les feuilles de style DocBook
<acronym>DSSSL</acronym> et les outils DocBook pour valider, transformer,
formatter et publier des documents DocBook.</para>
<para>This chapter contains DocBook <acronym>SGML</acronym> document
type definitions (<acronym>DTD</acronym>s), DocBook
<acronym>DSSSL</acronym> Stylesheets and DocBook tools to validate,
transform, format and publish DocBook documents.</para>
 
&sgml-common;
&sgml-dtd-3;
&sgml-dtd;
&opensp;
&openjade;
&docbook-dsssl;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sgml-common.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sgml-dtd-3.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sgml-dtd.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="opensp.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="openjade.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="docbook-dsssl.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="docbook-utils.xml"/>
 
</chapter>
/trunk/blfs/pst/sgml/opensp.xml
1,12 → 1,166
<?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 opensp-download-http "http://download.sourceforge.net/openjade/OpenSP-&opensp-version;.tar.gz">
<!ENTITY opensp-download-ftp "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/OpenSP-&opensp-version;.tar.gz">
<!ENTITY opensp-md5sum "f46fe0a04b76a4454ec27b7fcc84ec54">
<!ENTITY opensp-size "1.4 MB">
<!ENTITY opensp-buildsize "43 MB">
<!ENTITY opensp-time "1.03 SBU">
]>
 
<sect1 id="opensp" xreflabel="OpenSP-&opensp-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="opensp.html"?>
<title>OpenSP-&opensp-version;</title>
 
&opensp-intro;
&opensp-inst;
&opensp-exp;
&opensp-desc;
<sect2>
<title>Introduction to <application>OpenSP</application></title>
 
<para>The <application>OpenSP</application> package contains a
<application>C++</application> library for using
<acronym>SGML</acronym>/<acronym>XML</acronym> files.
This is useful for validating, parsing and manipulating
<acronym>SGML</acronym> and <acronym>XML</acronym>
documents.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&opensp-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&opensp-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &opensp-md5sum;</para></listitem>
<listitem><para>Download size: &opensp-size;</para></listitem>
<listitem><para>Estimated disk space required:
&opensp-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&opensp-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch (removes some annoying messages that can appear
while running <command>openjade</command>): <ulink
url="&patch-root;/OpenSP-&opensp-version;-LITLEN-1.patch"/></para></listitem>
<listitem><para>Required Patch: <ulink
url="&patch-root;/OpenSP-&opensp-version;-gcc34-1.patch"/></para></listitem>
</itemizedlist></sect3>
 
<sect3><title><application>OpenSP</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="sgml-common"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>OpenSP</application></title>
 
<para>Install <application>OpenSP</application> by running the following
commands:</para>
 
<screen><userinput><command>patch -Np1 -i ../OpenSP-&opensp-version;-LITLEN-1.patch &amp;&amp;
patch -Np1 -i ../OpenSP-&opensp-version;-gcc34-1.patch &amp;&amp;
./configure --prefix=/usr --disable-static --enable-http \
--enable-default-catalog=/etc/sgml/catalog \
--enable-default-search-path=/usr/share/sgml &amp;&amp;
make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version; &amp;&amp;
make pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version; install &amp;&amp;
ln -sf onsgmls /usr/bin/nsgmls &amp;&amp;
ln -sf osgmlnorm /usr/bin/sgmlnorm &amp;&amp;
ln -sf ospam /usr/bin/spam &amp;&amp;
ln -sf ospcat /usr/bin/spcat &amp;&amp;
ln -sf ospent /usr/bin/spent &amp;&amp;
ln -sf osx /usr/bin/sx &amp;&amp;
ln -sf osx /usr/bin/sgml2xml &amp;&amp;
ln -sf libosp.so /usr/lib/libsp.so</command></userinput></screen>
 
<!-- install-catalog -add /etc/sgml/OpenSP-&opensp-version;.cat \
/usr/share/sgml/OpenSP-&opensp-version;/catalog &amp;&amp;
install-catalog -add /etc/sgml/sgml-docbook.cat \
/etc/sgml/OpenSP-&opensp-version;.cat</command></userinput></screen>
 
<tip><title>Update hint</title>
<para>Remove the above catalog items prior to upgrading with:
<screen><command>install-catalog -remove /etc/sgml/OpenSP-<replaceable>[version]</replaceable>.cat \
/usr/share/sgml/OpenSP-<replaceable>[version]</replaceable>/catalog &amp;&amp;
install-catalog -remove /etc/sgml/sgml-docbook.cat \
/etc/sgml/OpenSP-<replaceable>[version]</replaceable>.cat</command></screen></para></tip> -->
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><option>--disable-static</option>: This switch prevents
the building of the static library.</para>
 
<para><option>--enable-http</option>: This switch adds support
for <acronym>HTTP</acronym>.</para>
 
<para><parameter>--enable-default-catalog=/etc/sgml/catalog</parameter>: This
switch sets the path to the centralized catalog.</para>
 
<para><parameter>--enable-default-search-path</parameter>: This switch
sets the default value of <envar>SGML_SEARCH_PATH</envar>.</para>
 
<para><option>--enable-xml-messages</option>: This switch adds
support for <acronym>XML</acronym> Formatted Messages.</para>
 
<para><command>make
pkgdatadir=/usr/share/sgml/OpenSP-&opensp-version;</command>: This sets the
pkgdatadir variable in the <filename>Makefile</filename> from
<filename class="directory">/usr/share/OpenSP</filename> to
<filename class="directory">/usr/share/sgml/OpenSP-&opensp-version;</filename>.
</para>
 
<para><command>ln -sf ...</command>: These commands create the
<application>SP</application> equivalents of
<application>OpenSP</application> executables and libraries.</para>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>OpenSP</application> package contains
<command>onsgmls</command>,
<command>ospam</command>,
<command>osx</command>,
<command>ospcat</command> and
<command>ospent</command>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>onsgmls</title>
<para><command>onsgmls</command> processes <acronym>SGML</acronym>
files.</para></sect3>
 
<sect3><title>ospam</title>
<para><command>ospam</command> is a markup stream editor.</para></sect3>
 
<sect3><title>osx</title>
<para><command>osx</command> is a <acronym>SGML</acronym> normalizer or a
converter of <acronym>SGML</acronym> to <acronym>XML</acronym>.</para></sect3>
 
<sect3><title>ospcat</title>
<para><command>ospcat</command> prints effective system identifiers found in
the catalogs.</para></sect3>
 
<sect3><title>ospent</title>
<para><command>ospent</command> provides access to
<application>OpenSP</application>'s entity manager.</para></sect3>
 
</sect2>
 
</sect1>
 
/trunk/blfs/pst/sgml/openjade.xml
1,13 → 1,141
<?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 openjade-download-http "http://prdownloads.sourceforge.net/openjade/openjade-&openjade-version;.tar.gz">
<!ENTITY openjade-download-ftp "ftp://ftp.freestandards.org/pub/lsb/app-battery/packages/openjade-&openjade-version;.tar.gz">
<!ENTITY openjade-md5sum "7df692e3186109cc00db6825b777201e">
<!ENTITY openjade-size "880 KB">
<!ENTITY openjade-buildsize "19 MB">
<!ENTITY openjade-time "0.78 SBU">
]>
 
<sect1 id="openjade" xreflabel="OpenJade-&openjade-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="openjade.html"?>
<title>OpenJade-&openjade-version;</title>
 
&openjade-intro;
&openjade-inst;
&openjade-exp;
&openjade-config;
&openjade-desc;
<sect2>
<title>Introduction to <application>OpenJade</application></title>
 
<para>The <application>OpenJade</application> package contains a
<acronym>DSSSL</acronym> engine. This is useful for
<acronym>SGML</acronym> and <acronym>XML</acronym> transformations into
<acronym>RTF</acronym>, TeX, <acronym>SGML</acronym>
and <acronym>XML</acronym>.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&openjade-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&openjade-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &openjade-md5sum;</para></listitem>
<listitem><para>Download size: &openjade-size;</para></listitem>
<listitem><para>Estimated disk space required:
&openjade-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&openjade-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>OpenJade</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="opensp"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>OpenJade</application></title>
 
<para>Install <application>OpenJade</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --enable-http --disable-static \
--enable-default-catalog=/etc/sgml/catalog \
--enable-default-search-path=/usr/share/sgml \
--datadir=/usr/share/sgml/openjade-&openjade-version; &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
ln -sf openjade /usr/bin/jade &amp;&amp;
ln -sf libogrove.so /usr/lib/libgrove.so &amp;&amp;
ln -sf libospgrove.so /usr/lib/libspgrove.so &amp;&amp;
ln -sf libostyle.so /usr/lib/libstyle.so &amp;&amp;
install -m644 dsssl/catalog /usr/share/sgml/openjade-&openjade-version;/ &amp;&amp;
install -m644 dsssl/*.{dtd,dsl,sgm} \
/usr/share/sgml/openjade-&openjade-version; &amp;&amp;
install-catalog --add /etc/sgml/openjade-&openjade-version;.cat \
/usr/share/sgml/openjade-&openjade-version;/catalog &amp;&amp;
install-catalog --add /etc/sgml/sgml-docbook.cat \
/etc/sgml/openjade-&openjade-version;.cat</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><option>--disable-static</option>: This switch prevents
the building of the static library.</para>
 
<para><option>--enable-http</option>: This switch adds support
for <acronym>HTTP</acronym>.</para>
 
<para><parameter>--enable-default-catalog=/etc/sgml/catalog</parameter>: This
switch sets the path to the centralized catalog.</para>
 
<para><parameter>--enable-default-search-path</parameter>: This switch
sets the default value of <envar>SGML_SEARCH_PATH</envar>.</para>
 
<para>
<parameter>--datadir=/usr/share/sgml/openjade-&openjade-version;</parameter>:
This switch puts data files in
<filename>/usr/share/sgml/openjade-&openjade-version;</filename> instead of
<filename class="directory">/usr/share</filename>.</para>
 
<para><command>ln -sf ...</command>: These commands create the
<application>Jade</application> equivalents of
<application>OpenJade</application> executables and libraries.</para>
 
</sect2>
 
<sect2>
<title>Configuring OpenJade</title>
 
<sect3><title>Configuration Information</title>
 
<screen><userinput><command>echo "SYSTEM \"http://www.oasis-open.org/docbook/xml/&DocBook-version;/docbookx.dtd\" \
\"/usr/share/xml/docbook/xml-dtd-&DocBook-version;/docbookx.dtd\"" &gt;&gt; \
/usr/share/sgml/openjade-&openjade-version;/catalog</command></userinput></screen>
 
<para>This configuration is only necessary if you intend to use
<application>OpenJade</application> to process the
<acronym>BLFS</acronym> <acronym>XML</acronym> files through
<acronym>DSSSL</acronym> Stylesheets.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>OpenJade</application> package contains
<command>openjade</command> and the <application>OpenJade</application>
libraries.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>openjade</title>
<para><command>openjade</command> is a <acronym>DSSSL</acronym> engine used for
transformations.</para></sect3>
 
</sect2>
 
</sect1>
 
/trunk/blfs/pst/sgml/docbook-dsssl.xml
1,13 → 1,131
<?xml version="1.0" encoding="ISO-8859-1"?>
<sect1 id="docbook-dsssl" xreflabel="DocBook DSSSL Stylesheets-&docbook-dsssl-version;">
<!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 docbook-dsssl-download-http "http://prdownloads.sourceforge.net/docbook/docbook-dsssl-&docbook-dsssl-version;.tar.gz">
<!ENTITY docbook-dsssl-download-ftp " ">
<!ENTITY docbook-dsssl-md5sum "f60521a38bd425e76f50d3f15b0325c0">
<!ENTITY docbook-dsssl-size "384 KB">
<!ENTITY docbook-dsssl-buildsize "6.3 MB">
<!ENTITY docbook-dsssl-time "0.01 SBU">
]>
 
<sect1 id="docbook-dsssl"
xreflabel="DocBook DSSSL Stylesheets-&docbook-dsssl-version;">
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="docbook-dsssl.html"?>
<title>DocBook DSSSL Stylesheets-&docbook-dsssl-version;</title>
 
&docbook-dsssl-intro;
&docbook-dsssl-inst;
&docbook-dsssl-exp;
&docbook-dsssl-config;
&docbook-dsssl-desc;
<sect2>
<title>Introduction to <application>DocBook <acronym>DSSSL</acronym>
Stylesheets</application></title>
 
<para>The <application>DocBook <acronym>DSSSL</acronym>
Stylesheets</application> package contains <acronym>DSSSL</acronym>
stylesheets. These are used by <application>OpenJade</application> or other
tools to transform <acronym>SGML</acronym> and <acronym>XML</acronym> DocBook
files.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&docbook-dsssl-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&docbook-dsssl-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &docbook-dsssl-md5sum;</para></listitem>
<listitem><para>Download size: &docbook-dsssl-size;</para></listitem>
<listitem><para>Estimated disk space required:
&docbook-dsssl-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&docbook-dsssl-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>DocBook <acronym>DSSSL</acronym>
Stylesheets</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="sgml-common"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>DocBook <acronym>DSSSL</acronym>
Stylesheets</application></title>
 
<para>Install <application>DocBook <acronym>DSSSL</acronym>
Stylesheets</application> by running the following commands:</para>
 
<screen><userinput><command>mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/dtds/decls &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/lib &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/common &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/html &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/print &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/test &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/images &amp;&amp;
install bin/collateindex.pl /usr/bin &amp;&amp;
cp catalog VERSION /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version; &amp;&amp;
cp dtds/decls/*.dcl \
/usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/dtds/decls &amp;&amp;
cp lib/dblib.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/lib &amp;&amp;
cp common/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/common &amp;&amp;
cp common/*.ent /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/common &amp;&amp;
cp html/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/html &amp;&amp;
cp print/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/print &amp;&amp;
cp images/*.gif /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/images &amp;&amp;
install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
/usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/catalog &amp;&amp;
install-catalog --add /etc/sgml/sgml-docbook.cat \
/etc/sgml/dsssl-docbook-stylesheets.cat</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para>The above commands create a <command>make install</command> script
for this package.</para>
 
</sect2>
 
<!--
<sect2>
<title>Configuring <application>DocBook <acronym>DSSSL</acronym>
Stylesheets</application></title>
 
<sect3><title>Configuration Information</title>
 
<para>The following configuration is necessary in order to utilize
<application>OpenJade</application> to convert the <acronym>BLFS</acronym>
Book from <acronym>XML</acronym> to <acronym>HTML</acronym>:</para>
 
<screen><userinput><command>ln -sf <replaceable>[your home directory]</replaceable>/BLFS/BOOK/blfs.dsl \
/usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/html/</command></userinput></screen>
 
</sect3>
 
</sect2>
-->
<sect2>
<title>Contents</title>
 
<para>The <application>DocBook <acronym>DSSSL</acronym>
Stylesheets</application> package contains <acronym>DSSSL</acronym>
stylesheets and <command>collateindex.pl</command>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>collateindex.pl</title>
<para><command>collateindex.pl</command> is a <application>Perl</application>
script that creates a DocBook index from raw index data.</para></sect3>
 
</sect2>
 
</sect1>
 
/trunk/blfs/pst/sgml/sgml-common.xml
1,11 → 1,139
<?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 sgml-common-download-http "http://gd.tuwien.ac.at/hci/kde/devel/docbook/SOURCES/sgml-common-&sgml-common-version;.tgz">
<!ENTITY sgml-common-download-ftp "ftp://sources.redhat.com/pub/docbook-tools/new-trials/SOURCES/sgml-common-&sgml-common-version;.tgz">
<!ENTITY sgml-common-md5sum "103c9828f24820df86e55e7862e28974">
<!ENTITY sgml-common-size "75 KB">
<!ENTITY sgml-common-buildsize "648 KB">
<!ENTITY sgml-common-time "0.00 SBU">
]>
 
<sect1 id="sgml-common" xreflabel="SGML Common-&sgml-common-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="sgml-common.html"?>
<title>SGML Common-&sgml-common-version;</title>
 
&sgml-common-intro;
&sgml-common-inst;
&sgml-common-config;
&sgml-common-desc;
<sect2>
<title>Introduction to <application><acronym>SGML</acronym>
Common</application></title>
 
<para>The <application><acronym>SGML</acronym> Common</application> package
contains <command>install-catalog</command>. This is useful for creating and
maintaining centralized <acronym>SGML</acronym> catalogs.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&sgml-common-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&sgml-common-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &sgml-common-md5sum;</para></listitem>
<listitem><para>Download size: &sgml-common-size;</para></listitem>
<listitem><para>Estimated disk space required:
&sgml-common-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&sgml-common-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch: <ulink
url="&patch-root;/sgml-common-&sgml-common-version;-manpage-1.patch"/></para>
</listitem>
</itemizedlist>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application><acronym>SGML</acronym>
Common</application></title>
 
<para>First apply the patch:</para>
 
<screen><userinput><command>patch -Np1 -i ../sgml-common-0.6.3-manpage-1.patch</command></userinput></screen>
 
<para>The autotools files included with
<application><acronym>SGML</acronym> Common</application> are old. Use
the following commands to regenerate the files.</para>
 
<screen><userinput><command>aclocal &amp;&amp;
automake -acf &amp;&amp;
autoconf</command></userinput></screen>
 
<para>Install <application><acronym>SGML</acronym> Common</application> by
running the following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
install-catalog --add /etc/sgml/sgml-ent.cat \
/usr/share/sgml/sgml-iso-entities-8879.1986/catalog &amp;&amp;
install-catalog --add /etc/sgml/sgml-docbook.cat \
/etc/sgml/sgml-ent.cat</command></userinput></screen>
 
<tip><title>Update hint</title>
<para>Remove the above catalog items prior to upgrading with:
 
<screen><command>install-catalog --remove /etc/sgml/sgml-ent.cat \
/usr/share/sgml/sgml-iso-entities-8879.1986/catalog &amp;&amp;
install-catalog --remove /etc/sgml/sgml-docbook.cat \
/etc/sgml/sgml-ent.cat</command></screen></para></tip>
 
</sect2>
 
<sect2>
<title>Configuring <application><acronym>SGML</acronym>
Common</application></title>
 
<sect3><title>Config files</title>
<para><filename>/etc/sgml/sgml.conf</filename></para>
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para>No change in this file is necessary.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application><acronym>SGML</acronym> Common</application> package
contains <command>install-catalog</command>,
<command>sgmlwhich</command>, <acronym>SGML</acronym> entities
files and <acronym>XML</acronym> entities files.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>install-catalog</title>
<para><command>install-catalog</command> creates a centralized catalog that
maintains references to catalogs scattered throughout the
<filename class="directory">/usr/share/sgml</filename> directory
tree.</para></sect3>
 
<sect3><title>sgmlwhich</title>
<para><command>sgmlwhich</command> will print to standard output the name of
the main configuration file.</para></sect3>
 
<sect3><title>SGML entities files</title>
<para><acronym>SGML</acronym> entities files contain the basic character
entities defined with <acronym>SDATA</acronym> entries.</para></sect3>
 
<sect3><title>XML entities files</title>
<para><acronym>XML</acronym> entities files contain the basic character
entities defined by a hexadecimal representation of the Unicode character
number.</para></sect3>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/sgml/sgml-dtd-3.xml
1,13 → 1,145
<?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 sgml-dtd-3-download-http "http://www.docbook.org/sgml/3.1/docbk31.zip">
<!ENTITY sgml-dtd-3-download-ftp "ftp://ftp.kde.org/pub/kde/devel/docbook/SOURCES/docbk31.zip">
<!ENTITY sgml-dtd-3-md5sum "432749c0c806dbae81c8bcb70da3b5d3">
<!ENTITY sgml-dtd-3-size "55 KB">
<!ENTITY sgml-dtd-3-buildsize "336 KB">
<!ENTITY sgml-dtd-3-time "0.01 SBU">
]>
 
<sect1 id="sgml-dtd-3" xreflabel="DocBook SGML DTD-&sgml-dtd-3-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="sgml-dtd-3.html"?>
<title>DocBook SGML DTD-&sgml-dtd-3-version;</title>
 
&sgml-dtd-3-intro;
&sgml-dtd-3-inst;
&sgml-dtd-3-exp;
&sgml-dtd-3-config;
&sgml-dtd-3-desc;
<sect2>
<title>Introduction to <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application></title>
 
<para>The <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application> package contains document type definitions
for verification of <acronym>SGML</acronym> data files against the DocBook rule
set. These are useful for structuring books and software documentation to a
standard allowing you to utilize transformations already written for that
standard.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&sgml-dtd-3-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&sgml-dtd-3-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &sgml-dtd-3-md5sum;</para></listitem>
<listitem><para>Download size: &sgml-dtd-3-size;</para></listitem>
<listitem><para>Estimated disk space required:
&sgml-dtd-3-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&sgml-dtd-3-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="sgml-common"/> and <xref linkend="unzip"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application></title>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../use-unzip.xml"/>
 
<para>Install <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application> by running the following commands:</para>
 
<screen><userinput><command>sed -i -e '/ISO 8879/d' \
-e 's|DTDDECL "-//OASIS//DTD DocBook V&sgml-dtd-3-version;//EN"|SGMLDECL|g' \
docbook.cat &amp;&amp;
install -d /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-3-version; &amp;&amp;
chown -R root:root . &amp;&amp;
install docbook.cat /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-3-version;/catalog &amp;&amp;
cp -af *.dtd *.mod *.dcl /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-3-version; &amp;&amp;
install-catalog --add /etc/sgml/sgml-docbook-dtd-&sgml-dtd-3-version;.cat \
/usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-3-version;/catalog &amp;&amp;
install-catalog --add /etc/sgml/sgml-docbook-dtd-&sgml-dtd-3-version;.cat \
/etc/sgml/sgml-docbook.cat</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sed -i -e '/ISO 8879/d' docbook.cat</command>: This command
removes the ENT definitions from the catalog file.</para>
 
<para><command>sed -i -e 's|DTDDECL
"-//OASIS//DTD Docbook V&sgml-dtd-3-version;//EN"|SGMLDECL|g'
docbook.cat</command>: This command replaces the DTDDECL catalog entry,
which is not supported by Linux <acronym>SGML</acronym> tools, with the
SGMLDECL catalog entry.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application></title>
 
<sect3><title>Config files</title>
<para><filename>/etc/sgml/catalog</filename></para>
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para>The above installation script updates the catalog.</para>
 
<para>Using only the most current 3.x version of <application>DocBook
<acronym>SGML</acronym> <acronym>DTD</acronym></application> requires the
following:</para>
 
<screen><userinput><command>cat &gt;&gt; /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-3-version;/catalog &lt;&lt; "EOF"</command>
-- Begin Single Major Version catalog changes --
 
PUBLIC "-//Davenport//DTD DocBook V3.0//EN" "docbook.dtd"
 
-- End Single Major Version catalog changes --
<command>EOF</command></userinput></screen>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application> package contains <filename>DTD</filename>
files and <filename>MOD</filename> files.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>DTD files</title>
<para><filename>DTD</filename> files contain a document type definition which
defines the element types and the attribute lists that can be used in the
corresponding <acronym>SGML</acronym> files.</para></sect3>
 
<sect3><title>MOD files</title>
<para><filename>MOD</filename> files contain components of the document type
definition that are sourced into the <filename>DTD</filename> files.</para>
</sect3>
 
</sect2>
 
</sect1>
 
/trunk/blfs/pst/sgml/sgml-dtd.xml
1,13 → 1,140
<?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 sgml-dtd-download-http "http://www.docbook.org/sgml/4.3/docbook-&sgml-dtd-version;.zip">
<!ENTITY sgml-dtd-download-ftp " ">
<!ENTITY sgml-dtd-md5sum "e3beb1b0b2923c24fa55a68e88654b01">
<!ENTITY sgml-dtd-size "76 KB">
<!ENTITY sgml-dtd-buildsize "389 KB">
<!ENTITY sgml-dtd-time "0.01 SBU">
]>
 
<sect1 id="sgml-dtd" xreflabel="DocBook SGML DTD-&sgml-dtd-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="sgml-dtd.html"?>
<title>DocBook SGML DTD-&sgml-dtd-version;</title>
 
&sgml-dtd-intro;
&sgml-dtd-inst;
&sgml-dtd-exp;
&sgml-dtd-config;
&sgml-dtd-desc;
<sect2>
<title>Introduction to <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application></title>
 
<para>The <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application> package contains document type definitions
for verification of <acronym>SGML</acronym> data files against the DocBook rule
set. These are useful for structuring books and software documentation to a
standard allowing you to utilize transformations already written for that
standard.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&sgml-dtd-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&sgml-dtd-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &sgml-dtd-md5sum;</para></listitem>
<listitem><para>Download size: &sgml-dtd-size;</para></listitem>
<listitem><para>Estimated disk space required:
&sgml-dtd-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&sgml-dtd-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="sgml-common"/> and <xref linkend="unzip"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application></title>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../use-unzip.xml"/>
 
<para>Install <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application> by running the following commands:</para>
 
<screen><userinput><command>sed -i -e '/ISO 8879/d' \
-e '/gml/d' docbook.cat &amp;&amp;
install -d /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-version; &amp;&amp;
chown -R root:root . &amp;&amp;
install docbook.cat /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-version;/catalog &amp;&amp;
cp -af *.dtd *.mod *.dcl /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-version; &amp;&amp;
install-catalog --add /etc/sgml/sgml-docbook-dtd-&sgml-dtd-version;.cat \
/usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-version;/catalog &amp;&amp;
install-catalog --add /etc/sgml/sgml-docbook-dtd-&sgml-dtd-version;.cat \
/etc/sgml/sgml-docbook.cat</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sed -i -e '/ISO 8879/d' -e '/gml/d' docbook.cat</command>:
This command removes the ENT definitions from the catalog file.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application></title>
 
<sect3><title>Config files</title>
<para><filename>/etc/sgml/catalog</filename></para>
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para>The above installation script updates the catalog.</para>
 
<para>Using only the most current 4.x version of <application>DocBook
<acronym>SGML</acronym> <acronym>DTD</acronym></application> requires the
following:</para>
 
<screen><userinput><command>cat &gt;&gt; /usr/share/sgml/docbook/sgml-dtd-&sgml-dtd-version;/catalog &lt;&lt; "EOF"</command>
-- Begin Single Major Version catalog changes --
 
PUBLIC "-//OASIS//DTD DocBook V4.2//EN" "docbook.dtd"
PUBLIC "-//OASIS//DTD DocBook V4.1//EN" "docbook.dtd"
PUBLIC "-//OASIS//DTD DocBook V4.0//EN" "docbook.dtd"
 
-- End Single Major Version catalog changes --
<command>EOF</command></userinput></screen>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>DocBook <acronym>SGML</acronym>
<acronym>DTD</acronym></application> package contains <filename>DTD</filename>
files and <filename>MOD</filename> files.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>DTD files</title>
<para><filename>DTD</filename> files contain a document type definition which
defines the element types and the attribute lists that can be used in the
corresponding <acronym>SGML</acronym> files.</para></sect3>
 
<sect3><title>MOD files</title>
<para><filename>MOD</filename> files contain components of the document type
definition that are sourced into the <filename>DTD</filename> files.</para>
</sect3>
 
</sect2>
 
</sect1>
 
/trunk/blfs/pst/sgml/docbook-utils.xml
0,0 → 1,187
<?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 docbook-utils-download-http "http://sources-redhat.mirrors.redwire.net/docbook-tools/new-trials/SOURCES/docbook-utils-&docbook-utils-version;.tar.gz">
<!ENTITY docbook-utils-download-ftp "ftp://sources.redhat.com/pub/docbook-tools/new-trials/SOURCES/docbook-utils-&docbook-utils-version;.tar.gz">
<!ENTITY docbook-utils-md5sum "6b41b18c365c01f225bc417cf632d81c">
<!ENTITY docbook-utils-size "125 KB">
<!ENTITY docbook-utils-buildsize "1.5 MB">
<!ENTITY docbook-utils-time ".04 SBU">
]>
 
<sect1 id="docbook-utils" xreflabel="DocBook-utils-&docbook-utils-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="docbook-utils.html"?>
<title>DocBook-utils-&docbook-utils-version;</title>
<indexterm zone="docbook-utils">
<primary sortas="a-DocBook-utils">DocBook-utils</primary></indexterm>
 
<sect2>
<title>Introduction to <application>DocBook-utils</application></title>
 
<para>The <application>DocBook-utils</application> package is a collection of
utility scripts used to convert and analyze <acronym>SGML</acronym> documents
in general, and DocBook files in particular. The scripts are used to convert
from DocBook or other <acronym>SGML</acronym> formats into
<quote>classical</quote> file formats like <acronym>HTML</acronym>, man, info,
<acronym>RTF</acronym> and many more. There's also a utility to compare two
<acronym>SGML</acronym> files and only display the differences in markup. This
is useful for comparing documents prepared for different languages.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&docbook-utils-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&docbook-utils-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum:
&docbook-utils-md5sum;</para></listitem>
<listitem><para>Download size:
&docbook-utils-size;</para></listitem>
<listitem><para>Estimated disk space required:
&docbook-utils-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&docbook-utils-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>DocBook-utils</application> dependencies</title>
 
<sect4><title>Required</title>
<para><xref linkend="openjade"/>,
<xref linkend="docbook-dsssl"/> and
<xref linkend="sgml-dtd-3"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="jadetex"/> (for conversion to
<acronym>DVI</acronym>, <acronym>PS</acronym> and <acronym>PDF</acronym>),
<xref linkend="perl-modules"/>: SGMLSpm-&SGMLSpm-version; (for conversion to
man and texinfo), and
<xref linkend="lynx"/> or <xref linkend="Links"/> or <xref linkend="w3m"/>
(for conversion to <acronym>ASCII</acronym> text)</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>DocBook-utils</application></title>
 
<note><para>Earlier versions of the <acronym>BLFS</acronym>
<application>OpenSP</application> instructions installed a catalog
containing an SGMLDECL <filename>unicode.sd</filename> declaration
into the system <acronym>SGML</acronym> catalogs. This declaration
causes some of the <application>OpenJade</application> programs to
fail occasionally. You'll need to remove these catalog definitions
if they exist, or the package build will fail. The following command
can determine if you need to remove these catalog definitions:</para>
 
<screen><userinput><command>grep "OpenSP-1.5.1" /etc/sgml/catalog</command></userinput></screen>
 
<para>If anything was returned, run the following command as the root user to
remove the catalog definitions:</para>
 
<screen><userinput role='root'><command>sed -i.orig \
-e "/CATALOG \/etc\/sgml\/OpenSP-1.5.1.cat/d" \
/etc/sgml/catalog \
/etc/sgml/sgml-docbook.cat</command></userinput></screen></note>
 
<para>Install <application>DocBook-utils</application> by running the
following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
<para>Many packages use an alternate name for the
<application>DocBook-utils</application> scripts. If you wish to create these
alternate names, use the following command:</para>
 
<screen><userinput role='root'><command>for doctype in html ps dvi man pdf rtf tex texi txt
do
ln -s docbook2$doctype /usr/bin/db2$doctype
done</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<segtitle>Installed Symlinks</segtitle>
 
<seglistitem>
<seg>docbook2dvi, docbook2html, docbook2man, docbook2pdf, docbook2ps,
docbook2rtf, docbook2tex, docbook2texi, docbook2txt, jw and sgmldiff</seg>
<seg>None</seg>
<seg>/usr/share/doc/html/docbook-utils-&docbook-utils-version; and
/usr/share/sgml/docbook/utils-&docbook-utils-version;</seg>
<seg>db2dvi, db2html, db2man, db2pdf, db2ps, db2rtf, db2tex, db2texi and
db2txt</seg>
 
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="docbook2">
<term><command>docbook2*</command></term>
<listitem><para>are simple one-line wrapper scripts to <command>jw</command>.
They are provided as easy-to-remember names used to convert DocBook or
other <acronym>SGML</acronym> files to the respective format.</para>
<indexterm zone="docbook-utils docbook2">
<primary sortas="b-docbook2-star">docbook2*</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="db2">
<term><command>db2*</command></term>
<listitem><para>are symlinks pointing at the respectively named
<command>docbook2*</command> commands, created to satisfy some program's
use of these names.</para>
<indexterm zone="docbook-utils db2">
<primary sortas="g-db2-star">db2*</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="jw">
<term><command>jw</command></term>
<listitem><para>is a script used to convert DocBook or other
<acronym>SGML</acronym> files to various output formats. It hides most of
<application>OpenJade</application>'s complexity and adds comfortable
features.</para>
<indexterm zone="docbook-utils jw">
<primary sortas="b-jw">jw</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="sgmldiff">
<term><command>sgmldiff</command></term>
<listitem><para>is used to compare two <acronym>SGML</acronym> files and
only return the differences in the markup. This is especially useful to
compare files that should be identical except for language differences in the
content.</para>
<indexterm zone="docbook-utils sgmldiff">
<primary sortas="b-sgmldiff">sgmldiff</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
 
/trunk/blfs/pst/pst.xml
1,13 → 1,19
<?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="pst" xreflabel="Printing, Scanning and Typesetting">
<?dbhtml filename="pst.html" dir="pst"?>
<title>Impression, Scannérisation et frappe clavier</title>
<title>Printing, Scanning and Typesetting</title>
 
&pst-printing;
&pst-scanning;
&pst-sgml;
&pst-xml;
&pst-ps;
&pst-typesetting;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="printing/printing.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="scanning/scanning.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sgml/sgml.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xml/xml.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ps/ps.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="typesetting/typesetting.xml"/>
 
</part>
/trunk/blfs/pst/printing/espgs/espgs.ent
File deleted
/trunk/blfs/pst/printing/espgs/espgs-intro.xml
File deleted
/trunk/blfs/pst/printing/espgs/espgs-exp.xml
File deleted
/trunk/blfs/pst/printing/espgs/espgs-inst.xml
File deleted
/trunk/blfs/pst/printing/espgs/espgs-desc.xml
File deleted
/trunk/blfs/pst/printing/gimp-print/gimp-print-config.xml
File deleted
/trunk/blfs/pst/printing/gimp-print/gimp-print.ent
File deleted
/trunk/blfs/pst/printing/gimp-print/gimp-print-intro.xml
File deleted
/trunk/blfs/pst/printing/gimp-print/gimp-print-exp.xml
File deleted
/trunk/blfs/pst/printing/gimp-print/gimp-print-inst.xml
File deleted
/trunk/blfs/pst/printing/gimp-print/gimp-print-desc.xml
File deleted
/trunk/blfs/pst/printing/gs/gs.ent
File deleted
\ No newline at end of file
/trunk/blfs/pst/printing/gs/gs-intro.xml
File deleted
/trunk/blfs/pst/printing/gs/gs-inst.xml
File deleted
/trunk/blfs/pst/printing/gs/gs-desc.xml
File deleted
/trunk/blfs/pst/printing/cups/cups.ent
File deleted
/trunk/blfs/pst/printing/cups/cups-intro.xml
File deleted
/trunk/blfs/pst/printing/cups/cups-exp.xml
File deleted
/trunk/blfs/pst/printing/cups/cups-inst.xml
File deleted
/trunk/blfs/pst/printing/cups/cups-desc.xml
File deleted
/trunk/blfs/pst/printing/cups/cups-config.xml
File deleted
/trunk/blfs/pst/printing/lprng/lprng-intro.xml
File deleted
/trunk/blfs/pst/printing/lprng/lprng-inst.xml
File deleted
/trunk/blfs/pst/printing/lprng/lprng-desc.xml
File deleted
/trunk/blfs/pst/printing/lprng/lprng-config.xml
File deleted
\ No newline at end of file
/trunk/blfs/pst/printing/lprng/lprng.ent
File deleted
/trunk/blfs/pst/printing/espgs.xml
1,11 → 1,185
<?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 espgs-download-http "http://prdownloads.sourceforge.net/espgs/espgs-&espgs-version;-source.tar.bz2">
<!ENTITY espgs-download-ftp "ftp://ftp.gtlib.cc.gatech.edu/pub/slackware/slackware-current/source/ap/espgs/espgs-&espgs-version;-source.tar.bz2">
<!ENTITY espgs-md5sum "d30bf5c09f2c7caa8291f6305cf03044">
<!ENTITY espgs-size "5.3 MB">
<!ENTITY espgs-buildsize "116-140 MB (depends if libgs.so is installed)">
<!ENTITY espgs-time "1.65-3.20 SBU">
 
<!ENTITY espgs-standard-fonts-download "ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/fonts/ghostscript-fonts-std-8.11.tar.gz">
<!ENTITY espgs-standard-fonts-md5sum "6865682b095f8c4500c54b285ff05ef6">
<!ENTITY espgs-standard-fonts-size "3.7 MB">
 
<!ENTITY espgs-other-fonts-download "http://ftp.gnu.org/pub/gnu/ghostscript/gnu-gs-fonts-other-6.0.tar.gz">
<!ENTITY espgs-other-fonts-md5sum "33457d3f37de7ef03d2eea05a9e6aa4f">
<!ENTITY espgs-other-fonts-size "796 KB">
]>
 
<sect1 id="espgs" xreflabel="ESP Ghostscript-&espgs-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="espgs.html"?>
<title>ESP Ghostscript-&espgs-version;</title>
<title><application><acronym>ESP</acronym>
Ghostscript</application>-&espgs-version;</title>
 
&espgs-intro;
&espgs-inst;
&espgs-exp;
&espgs-desc;
<sect2>
<title>Introduction to <application><acronym>ESP</acronym>
Ghostscript</application></title>
 
<para><application><acronym>ESP</acronym> Ghostscript</application> is a
versatile processor for PostScript data with the ability to render PostScript
to different targets.
<application><acronym>ESP</acronym> Ghostscript</application> is a customized
version of <acronym>GNU</acronym> Ghostscript that includes an enhanced
configuration script, the <acronym>CUPS</acronym> raster driver to support
<acronym>CUPS</acronym> raster printer drivers, and additional patches and
drivers from various Linux distributors.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&espgs-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&espgs-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &espgs-md5sum;</para></listitem>
<listitem><para>Download size: &espgs-size;</para></listitem>
<listitem><para>Estimated disk space required:
&espgs-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&espgs-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Additional downloads</title>
<sect4><title>Standard fonts</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (FTP):
<ulink url="&espgs-standard-fonts-download;"/></para></listitem>
<listitem><para>Download MD5 sum:
&espgs-standard-fonts-md5sum;</para></listitem>
<listitem><para>Download size:
&espgs-standard-fonts-size;</para></listitem>
</itemizedlist>
</sect4>
 
<sect4><title>Other fonts</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&espgs-other-fonts-download;"/></para></listitem>
<listitem><para>Download MD5 sum:
&espgs-other-fonts-md5sum;</para></listitem>
<listitem><para>Download size:
&espgs-other-fonts-size;</para></listitem>
</itemizedlist>
</sect4>
</sect3>
 
<sect3><title><application><acronym>ESP</acronym> Ghostscript</application>
dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="cups"/>,
<xref linkend="libjpeg"/>,
<xref linkend="libpng"/>,
X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="GLib"/>,
<xref linkend="GTK"/> and
<xref linkend="gimp-print"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application><acronym>ESP</acronym>
Ghostscript</application></title>
 
<para>Install <application><acronym>ESP</acronym> Ghostscript</application>
by running the following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --without-gimp-print --without-omni &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
<para>To install the shared library
<filename class='libraryfile'>libgs.so</filename> you
will need <xref linkend="GTK"/>.</para>
 
<para>Proceed with the following commands:</para>
 
<screen><userinput><command>make CFLAGS_SO='-fPIC $(ACDEFS)' so &amp;&amp;
make soinstall &amp;&amp;
install -d -m755 /usr/include/ps &amp;&amp;
install -m644 src/*.h /usr/include/ps</command></userinput></screen>
 
<note><para>The shared library is only used in external programs like
<xref linkend="gsview"/>.</para></note>
 
<para>To finish the installation, unpack all fonts you've downloaded to
<filename class="directory">/usr/share/ghostscript</filename> and ensure
the ownerships of the files are root:root.</para>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><parameter>--without-gimp-print</parameter>: This switch disables
the building of the <application><acronym>GIMP</acronym></application> print
driver as a <application>Ghostscript</application> device since this is
deprecated. This driver may be still accessible via <acronym>IJS</acronym>
or <application><acronym>CUPS</acronym></application>,
and this is the preferred way.</para>
 
<para><option>--without-omni</option>: This switch disables the
omni driver support.</para>
 
<para><option>--without-ijs</option>: This switch disables the
<acronym>IJS</acronym> driver support.</para>
 
<para><command>install ...</command>: Some packages
(<application>ImageMagick</application> is one) need the
<application>Ghostscript</application> headers in place to link to the
shared library. These commands install the headers.</para>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application><acronym>ESP</acronym> Ghostscript</application>
package contains <command>gs</command>,
the <filename class='libraryfile'>libgs</filename> library and many filters
to render PostScript/<acronym>PDF</acronym> files back and forth. Please refer
to the <acronym>HTML</acronym> documentation or try
<command>man gs</command> for information about the capabilities provided
by the package. <application><acronym>ESP</acronym> Ghostscript</application>
also provides the <filename>pstoraster</filename>
<application><acronym>CUPS</acronym></application> print filter.</para>
 
</sect2>
 
<sect2>
<title>Description</title>
 
<sect3>
<title>gs</title>
<para><command>gs</command> invokes <application>Ghostscript</application>, an
interpreter of Adobe Systems' PostScript(tm) and Portable Document Format
(<acronym>PDF</acronym>) languages.</para></sect3>
 
<sect3>
<title>pstoraster</title>
<para><application><acronym>CUPS</acronym></application> uses the
<command>pstoraster</command> filter to convert PostScript to a generic raster
image format that is acceptable as an input to drivers for non-PostScript
printers (e.g., from <xref linkend="gimp-print"/>). It is built and installed
only if <xref linkend="cups"/> is found.</para></sect3>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/printing/lprng.xml
1,12 → 1,249
<?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 LPRng-download-http "http://www.lprng.com/DISTRIB/LPRng/LPRng-&LPRng-version;.tgz">
<!ENTITY LPRng-download-ftp "ftp://ftp.lprng.com/pub/LPRng/LPRng/LPRng-&LPRng-version;.tgz">
<!ENTITY LPRng-md5sum "1b3a0abd291b260eab6087ac0e61ed84">
<!ENTITY LPRng-size "10.2 MB">
<!ENTITY LPRng-buildsize "71.8 MB">
<!ENTITY LPRng-time "0.42 SBU">
]>
 
<sect1 id="LPRng" xreflabel="LPRng-&LPRng-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="LPRng.html"?>
<title>LPRng-&LPRng-version;</title>
<title><application><acronym>LPR</acronym>ng</application>-&LPRng-version;
</title>
<indexterm zone="LPRng">
<primary sortas="a-LPRng">LPRng</primary></indexterm>
 
&LPRng-intro;
&LPRng-inst;
&LPRng-config;
&LPRng-desc;
<sect2>
<title>Introduction to
<application><acronym>LPR</acronym>ng</application></title>
 
<para>The <application><acronym>LPR</acronym>ng</application> package contains
an enhanced, extended and portable implementation of the Berkeley Line PRinter
(<acronym>LPR</acronym>) print spooler. This is useful for queuing print
jobs.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&LPRng-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&LPRng-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &LPRng-md5sum;</para></listitem>
<listitem><para>Download size: &LPRng-size;</para></listitem>
<listitem><para>Estimated disk space required:
&LPRng-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&LPRng-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application><acronym>LPR</acronym>ng</application>
dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="openssl"/>,
<xref linkend="tcpwrappers"/>,
<xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
and <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink>
</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of
<application><acronym>LPR</acronym>ng</application></title>
 
<para>Install <application><acronym>LPR</acronym>ng</application> by running
the following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --libexecdir=/usr/lib/lprng \
--sysconfdir=/etc --enable-shared &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install
install -v -d -m755 /usr/share/doc/lprng-&LPRng-version; &amp;&amp;
cp -v -R DOCS/* PrintingCookbook \
/usr/share/doc/lprng-&LPRng-version;</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Configuring <application><acronym>LPR</acronym>ng</application></title>
 
<sect3 id="lprng-config"><title>Config files</title>
<para><filename>/etc/printcap</filename> and
<filename>/etc/lpd/*</filename></para>
<indexterm zone="LPRng lprng-config">
<primary sortas="e-etc-printcap">/etc/printcap</primary></indexterm>
<indexterm zone="LPRng lprng-config">
<primary sortas="e-etc-lpd-star">/etc/lpd/*</primary></indexterm>
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para>There is no generic <filename>printcap</filename> for all
printers. A sample printcap is loaded into the
<filename class="directory">/etc</filename> directory which can be of some
help. Information is also available at <ulink url="http://www.lprng.org"/>,
<ulink url="http://www.linuxprinting.org"/> and the documentation installed in
<filename class='directory'>/usr/share/doc/lprng-&LPRng-version;</filename>.
</para>
 
<para id="lprng-init">The init script installed by
<application><acronym>LPR</acronym>ng</application> is not consistent with
other <acronym>BLFS</acronym> scripts; therefore, install the
<filename>/etc/rc.d/init.d/lprng</filename> init script included in the
<xref linkend="intro-important-bootscripts"/> package (as the root user):</para>
<indexterm zone="LPRng lprng-init">
<primary sortas="f-lprng">lprng</primary></indexterm>
 
<screen><userinput role='root'><command>make install-lprng</command></userinput></screen>
 
<note><para>You may also want to remove the <command>lpd</command> script that
was installed in
<filename class='directory'>/etc/rc.d/init.d</filename>.</para></note>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
 
<seglistitem>
<seg>cancel, checkpc, lp, lpc, lpd, lpq, lpr, lprm, lprng_certs,
lprng_index_certs and lpstat</seg>
<seg>liblpr.[so,a]</seg>
<seg>/etc/lpd, /usr/lib/lprng, /usr/share/doc/&LPRng-version;,
/var/run/lpd and /var/spool/lpd</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="cancel">
<term><command>cancel</command></term>
<listitem><para>is a symlink to <command>lprm</command> used to send cancel
requests to an <application><acronym>LPR</acronym>ng</application> print
service.</para>
<indexterm zone="LPRng cancel">
<primary sortas="b-cancel">cancel</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="checkpc">
<term><command>checkpc</command></term>
<listitem><para>checks out the printcap database.</para>
<indexterm zone="LPRng checkpc">
<primary sortas="b-checkpc">checkpc</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="lp">
<term><command>lp</command></term>
<listitem><para>is a symlink to <command>lpr</command> used to send requests
to an <application><acronym>LPR</acronym>ng</application> print service.</para>
<indexterm zone="LPRng lp">
<primary sortas="b-lp">lp</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="lpc">
<term><command>lpc</command></term>
<listitem><para>is a control program for the <command>lpd</command>
daemon.</para>
<indexterm zone="LPRng lpc">
<primary sortas="b-lpc">lpc</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="lpd">
<term><command>lpd</command></term>
<listitem><para>is the print queueing daemon.</para>
<indexterm zone="LPRng lpd">
<primary sortas="b-lpd">lpd</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="lpq">
<term><command>lpq</command></term>
<listitem><para>is a status monitoring program.</para>
<indexterm zone="LPRng lpq">
<primary sortas="b-lpq">lpq</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="lpr">
<term><command>lpr</command></term>
<listitem><para>is a print job spooler program.</para>
<indexterm zone="LPRng lpr">
<primary sortas="b-lpr">lpr</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="lprm">
<term><command>lprm</command></term>
<listitem><para>is a print job removal program.</para>
<indexterm zone="LPRng lprm">
<primary sortas="b-lprm">lprm</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="lprng_certs">
<term><command>lprng_certs</command></term>
<listitem><para>is a program used to manage <acronym>SSL</acronym>
certificates for the <application><acronym>LPR</acronym>ng</application>
software.</para>
<indexterm zone="LPRng lprng_certs">
<primary sortas="b-lprng_certs">lprng_certs</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="lprng_index_certs">
<term><command>lprng_index_certs</command></term>
<listitem><para>creates a set of index files in the
<application><acronym>LPR</acronym>ng</application> signing certificate
directory.</para>
<indexterm zone="LPRng lprng_index_certs">
<primary sortas="b-lprng_index_certs">lprng_index_certs</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="lpstat">
<term><command>lpstat</command></term>
<listitem><para>is a print job status reporting program.</para>
<indexterm zone="LPRng lpstat">
<primary sortas="b-lpstat">lpstat</primary>
</indexterm></listitem>
</varlistentry>
 
<varlistentry id="liblpr">
<term><filename class='libraryfile'>liblpr.[so,a]</filename></term>
<listitem><para>contains the <acronym>API</acronym> functions used by the
<application><acronym>LPR</acronym>ng</application> programs.</para>
<indexterm zone="LPRng liblpr">
<primary sortas="c-liblpr">liblpr.[so,a]</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
 
/trunk/blfs/pst/printing/gimp-print.xml
1,12 → 1,152
<?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 gimp-print-download-http "http://prdownloads.sourceforge.net/gimp-print/gimp-print-&gimp-print-version;.tar.gz">
<!ENTITY gimp-print-download-ftp " ">
<!ENTITY gimp-print-md5sum "766be49f44a6a682d857e5aefec414d4">
<!ENTITY gimp-print-size "5.2 MB">
<!ENTITY gimp-print-buildsize "27 MB">
<!ENTITY gimp-print-time "0.29 SBU">
]>
 
<sect1 id="gimp-print" xreflabel="Gimp-Print-&gimp-print-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="gimp-print.html"?>
<title>Gimp-Print-&gimp-print-version;</title>
 
&gimp-print-intro;
&gimp-print-inst;
&gimp-print-exp;
&gimp-print-config;
&gimp-print-desc;
<sect2>
<title>Introduction to <application>Gimp-Print</application></title>
 
<para>The <application>Gimp-Print</application> package contains
high quality drivers for Canon, Epson, Lexmark and <acronym>PCL</acronym>
printers for use with <xref linkend="espgs"/>, <xref linkend="cups"/>,
<ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>,
<xref linkend="LPRng"/>, <command>lpr</command> and the
<application><acronym>GIMP</acronym>-1.2</application>. See a list of
supported printers at
<ulink url="http://gimp-print.sourceforge.net/p_Supported_Printers.php3"/>.
</para>
<!-- FIXME: APFL Ghostscript is not tested. Don't forget to check the license. -->
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&gimp-print-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&gimp-print-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &gimp-print-md5sum;</para></listitem>
<listitem><para>Download size: &gimp-print-size;</para></listitem>
<listitem><para>Estimated disk space required:
&gimp-print-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&gimp-print-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3><title><application>Gimp-Print</application> dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="cups"/>,
<ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>,
<ulink url="http://www.linuxprinting.org/ijs/">IJS</ulink>,
<xref linkend="tex"/>, and
<xref linkend="espgs"/> or <xref linkend="gs"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Gimp-Print</application></title>
 
<para>Install <application>Gimp-Print</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><option>--with-translated-ppds=no</option>: When this switch is given,
only <acronym>US</acronym> English <acronym>PPD</acronym> files
for <application><acronym>CUPS</acronym></application> will be built. Useful
if the <acronym>PPD</acronym> files are not yet translated into your native
language and you want to save some space by not installing unneeded
translations.</para>
 
<para><option>--enable-cups-level3-ps</option>: This option causes
the build process to generate PostScript level 3 <acronym>PPD</acronym> files
instead of level 2 ones.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>Gimp-Print</application></title>
 
<sect3><title>Configuration Information</title>
 
<para>For <application><acronym>CUPS</acronym></application> to see newly
installed <acronym>PPD</acronym> files, it has to be restarted:</para>
 
<screen><userinput><command>/etc/rc.d/init.d/cups restart</command></userinput></screen>
 
<note><para>This command may take a very long time (up to 10 minutes) to
complete. Don't panic while
<application><acronym>CUPS</acronym></application> is rescanning the
list of <acronym>PPD</acronym> files. The long delay will happen only
once.</para></note>
 
<para>Then point your web browser to <ulink url="http://127.0.0.1:631"/> to
add a new printer to
<application><acronym>CUPS</acronym></application>.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>Gimp-Print</application> package contains
<command>gimpprint-config</command>, <command>escputil</command>,
<filename class='libraryfile'>libgimpprint</filename> libraries and
optionally, <command>rastertoprinter</command> and
<command>pstopxl</command> filter scripts for
<application><acronym>CUPS</acronym></application>,
<command>cups-calibrate</command>, <command>ijsgimpprint</command> and a
plugin that allows printing images from
<application><acronym>GIMP</acronym>-1.2</application>.</para>
</sect2>
 
<sect2>
<title>Description</title>
 
<sect3><title>gimpprint-config</title>
<para><command>gimpprint-config</command> is a script to get information about
the installed version of gimpprint.</para></sect3>
 
<sect3><title>escputil</title>
<para><command>escputil</command> is a command line utility to perform various
maintenance tasks on Epson Stylus inkjet printers.</para></sect3>
 
<sect3><title>cups-calibrate</title>
<para><command>cups-calibrate</command> calibrates the color output of printers
using the <application>Gimp-Print</application>
<application><acronym>CUPS</acronym></application> or
<application><acronym>ESP</acronym> Print Pro</application> drivers.</para>
</sect3>
 
<sect3><title>ijsgimpprint</title>
<para><command>ijsgimpprint</command> is a Ghostscript driver for
<application>Gimp-Print</application>.</para></sect3>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/printing/gs.xml
1,10 → 1,129
<?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 gs-download-http "http://prdownloads.sourceforge.net/ghostscript/ghostscript-&gs-version;.tar.bz2">
<!ENTITY gs-download-ftp "ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/AFPL/gs814/ghostscript-&gs-version;.tar.bz2">
<!ENTITY gs-md5sum "5f22dbe24b7fc8c8c07e249f8b14f9ce">
<!ENTITY gs-size "5.5 MB">
<!ENTITY gs-buildsize "37-49 MB (depends if libgs.so is installed)">
<!ENTITY gs-time "1.16-2.26 SBU">
 
<!ENTITY gs-standard-fonts-download "ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/fonts/ghostscript-fonts-std-8.11.tar.gz">
<!ENTITY gs-standard-fonts-md5sum "6865682b095f8c4500c54b285ff05ef6">
<!ENTITY gs-standard-fonts-size "3.7 MB">
 
<!ENTITY gs-other-fonts-download "http://ftp.gnu.org/pub/gnu/ghostscript/gnu-gs-fonts-other-6.0.tar.gz">
<!ENTITY gs-other-fonts-md5sum "33457d3f37de7ef03d2eea05a9e6aa4f">
<!ENTITY gs-other-fonts-size "796 KB">
]>
 
<sect1 id="gs" xreflabel="AFPL Ghostscript-&gs-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="gs.html"?>
<title>AFPL Ghostscript-&gs-version;</title>
 
&gs-intro;
&gs-inst;
&gs-desc;
<sect2>
<title>Introduction to <application>Ghostscript</application></title>
 
<para><application>Ghostscript</application> is a versatile processor for
PostScript data with the ability to render PostScript to different
targets.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&gs-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&gs-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &gs-md5sum;</para></listitem>
<listitem><para>Download size: &gs-size;</para></listitem>
<listitem><para>Estimated disk space required:
&gs-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&gs-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title>Additional downloads</title>
<sect4><title>Standard fonts</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (FTP):
<ulink url="&gs-standard-fonts-download;"/></para></listitem>
<listitem><para>Download MD5 sum:
&gs-standard-fonts-md5sum;</para></listitem>
<listitem><para>Download size:
&gs-standard-fonts-size;</para></listitem>
</itemizedlist>
</sect4>
 
<sect4><title>Other fonts</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&gs-other-fonts-download;"/></para></listitem>
<listitem><para>Download MD5 sum:
&gs-other-fonts-md5sum;</para></listitem>
<listitem><para>Download size:
&gs-other-fonts-size;</para></listitem>
</itemizedlist>
</sect4>
</sect3>
 
<sect3><title><application>Ghostscript</application> dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="libjpeg"/>,
<xref linkend="libpng"/>,
<xref linkend="GTK"/> and
X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
</sect4>
</sect3>
 
<sect3><title>Conflicts</title>
<para>This version of Ghostscript does not work with
<application><acronym>CUPS</acronym></application> due to missing
generic "cups" raster image driver. The necessary support cannot be patched in
due to incompatible licenses. Use <xref linkend="espgs"/> instead if you have
<application><acronym>CUPS</acronym></application>.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Ghostscript</application></title>
 
<para>Install <application>Ghostscript</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
<para>To install the shared library
<filename class='libraryfile'>libgs.so</filename>, run the following
additional commands:</para>
 
<screen><userinput><command>make so &amp;&amp;
make soinstall</command></userinput></screen>
 
<note><para>The shared library depends on <xref linkend="GTK"/>. It is
only used in external programs like <xref linkend="gsview"/>.</para></note>
 
<para>To finish the installation, unpack all fonts you've downloaded to
<filename class="directory">/usr/share/ghostscript</filename>.</para>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para><application>Ghostscript</application> comes with a lot of filters to
render PostScript/<acronym>PDF</acronym> files back and forth. Please refer to
the <acronym>HTML</acronym> documentation or try
<command>man gs</command>.</para>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/printing/cups.xml
1,12 → 1,271
<?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 cups-download-http "http://ftp.easysw.com/pub/cups/&cups-version;/cups-&cups-version;-source.tar.bz2">
<!ENTITY cups-download-ftp "ftp://ftp.easysw.com/pub/cups/&cups-version;/cups-&cups-version;-source.tar.bz2">
<!ENTITY cups-md5sum "4ce09b1dce09b6b9398af0daae9adf63">
<!ENTITY cups-size "8.7 MB">
<!ENTITY cups-buildsize "46 MB">
<!ENTITY cups-time "0.54 SBU (additional 69 SBU to run full test suite)">
]>
 
<sect1 id="cups" xreflabel="CUPS-&cups-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:18:19 $</date>
</sect1info>
<?dbhtml filename="cups.html"?>
<title>CUPS-&cups-version;</title>
 
&cups-intro;
&cups-inst;
&cups-exp;
&cups-config;
&cups-desc;
<sect2>
<title>Introduction to
<application><acronym>CUPS</acronym></application></title>
 
<para>The Common Unix Printing System (<acronym>CUPS</acronym>) is a print
spooler and associated utilities. It is based on the "Internet Printing
Protocol" and provides printing services to most PostScript and raster
printers.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&cups-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&cups-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &cups-md5sum;</para></listitem>
<listitem><para>Download size: &cups-size;</para></listitem>
<listitem><para>Estimated disk space required:
&cups-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&cups-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application><acronym>CUPS</acronym></application>
dependencies</title>
<sect4><title>Recommended</title>
<para><xref linkend="libjpeg"/>,
<xref linkend="libpng"/>,
and <xref linkend="libtiff"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="openssl"/> or
<ulink url="http://www.gnu.org/software/gnutls/">GnuTLS</ulink> (which needs
<ulink url="ftp://ftp.gnupg.org/gcrypt/alpha/libgpg-error/">
libgpg-error</ulink>,
<ulink url="ftp://ftp.gnupg.org/gcrypt/libgcrypt/">libgcrypt</ulink> and
<ulink url="ftp://ftp.gnupg.org/gcrypt/alpha/gnutls/opencdk/">opencdk</ulink>,
in that order),
<xref linkend="Linux_PAM"/>,
<xref linkend="php"/>,
<xref linkend="python"/>,
<xref linkend="j2sdk"/>,
<ulink url="http://www.openslp.org/">OpenSLP</ulink>,
<ulink url="http://packages.debian.org/unstable/source/libpaper">
libpaper</ulink> and
<ulink url="http://valgrind.kde.org/">Valgrind</ulink> (optionally used if
running the test suites)</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of
<application><acronym>CUPS</acronym></application></title>
 
<para>Create an 'lp' user, as
<application><acronym>CUPS</acronym></application> will install the
<command>lppasswd</command> command <acronym>SUID</acronym> to this user. Use
the following command as the root user:</para>
 
<screen><userinput role='root'><command>useradd -c "Print Service User" -d /dev/null -g lp -s /bin/false lp</command></userinput></screen>
 
<para>If you utilize <application>Linux-<acronym>PAM</acronym></application>,
you need to modify some files so
<application><acronym>CUPS</acronym></application> can find needed headers.
Make the appropriate modifications using the following command:</para>
 
<screen><userinput><command>sed -i -e "s@pam/pam@security/pam@g" \
{config-scripts/cups-pam.m4,scheduler/auth.c,configure}</command></userinput></screen>
 
<para>Install <application><acronym>CUPS</acronym></application> by
running the following commands:</para>
 
<screen><userinput><command>./configure &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para>The basic default behavior of the installation is appropriate for
<acronym>LFS</acronym> systems. <application><acronym>CUPS</acronym>
</application> files are placed in
<filename class="directory">/usr/bin</filename>,
<filename class="directory">/usr/sbin</filename>,
<filename class="directory">/var</filename> and
<filename class="directory">/etc/cups</filename>.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application><acronym>CUPS</acronym></application></title>
 
<para>Configuration of <application><acronym>CUPS</acronym></application> is
dependent on the type of printer and can be complex. Generally, PostScript
printers are easier. For detailed instructions on configuration and use of
<application><acronym>CUPS</acronym></application>, see
<ulink url="http://www.cups.org/documentation.php"/>. The Software
Administrators Manual and Software Users Manual are particularly useful.</para>
 
<para>For non-PostScript printers to print with
<application><acronym>CUPS</acronym></application>, you need to install
<xref linkend="espgs"/> to convert PostScript to raster images
and a driver (e.g., from <xref linkend="gimp-print"/>) to convert
the resulting raster images to a form that the printer understands.
<ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>
drivers use Ghostscript to convert PostScript to a printable form directly, but
this is considered to be a hack by
<application><acronym>CUPS</acronym></application> developers.</para>
 
<para>During the install, <application><acronym>CUPS</acronym></application>
created the startup file <command>/etc/rc.d/init.d/cups</command>. The file
works, but you may want to change it to a more conventional
<acronym>LFS</acronym> startup file by installing the script included in the
<xref linkend="intro-important-bootscripts"/> package:</para>
 
<screen><userinput><command>make install-cups</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para><application><acronym>CUPS</acronym></application> provides
<command>accept</command>,
<command>cupsaddsmb</command>,
<command>cupsd</command>,
<command>cupstestppd</command>,
<command>lpadmin</command>,
<command>lpc</command>,
<command>lpinfo</command>,
<command>lpmove</command>,
<command>reject</command>,
<command>cancel</command>,
<command>cups-config</command>,
<command>disable</command>,
<command>enable</command>,
<command>lp</command>,
<command>lpoptions</command>,
<command>lppasswd</command>,
<command>lpq</command>,
<command>lpr</command>,
<command>lprm</command>,
<command>lpstat</command>,
<filename class="libraryfile">libcups</filename>,
<filename class="libraryfile">libcupsimage</filename> and various
scripts and filters.</para>
 
<sect3><title>lpc</title>
<para><command>lpc</command> provides limited control over printer
and class queues provided by <application><acronym>CUPS</acronym>
</application>.
</para></sect3>
 
<sect3><title>cupsd</title>
<para><command>cupsd</command> is the scheduler for the Common Unix Printing
System.
</para></sect3>
 
<sect3><title>accept</title>
<para><command>accept</command> instructs the printing system to accept print
jobs to the specified destinations.
</para></sect3>
 
<sect3><title>reject</title>
<para><command>reject</command> instructs the printing system to
reject print jobs to the specified destinations.
</para></sect3>
 
<sect3><title>cupsaddsmb</title>
<para><command>cupsaddsmb</command> exports printers to the SAMBA software for
use with Windows clients.
</para></sect3>
 
<sect3><title>lpadmin</title>
<para><command>lpadmin</command> configures printer and class queues provided
by <acronym>CUPS</acronym>.
</para></sect3>
 
<sect3><title>lpinfo</title>
<para><command>lpinfo</command> lists the available devices or drivers known to
the <acronym>CUPS</acronym> server.
</para></sect3>
 
<sect3><title>lpmove</title>
<para><command>lpmove</command> moves the specified job to a new destination.
</para></sect3>
 
<sect3><title>cupstestppd</title>
<para><command>cupstestppd</command> tests the conformance of
<filename>PPD</filename> files.
</para></sect3>
 
<sect3><title>lpq</title>
<para><command>lpq</command> shows the current print queue status on the named
printer.
</para></sect3>
 
<sect3><title>lpr</title>
<para><command>lpr</command> submits files for printing.
</para></sect3>
 
<sect3><title>lprm</title>
<para><command>lprm</command> cancels print jobs that have been queued for
printing.
</para></sect3>
 
<sect3><title>cancel</title>
<para><command>cancel</command> cancels existing print jobs.
</para></sect3>
 
<sect3><title>disable</title>
<para><command>disable</command> stops the named printers or classes.
</para></sect3>
 
<sect3><title>enable</title>
<para><command>enable</command> starts the named printers or classes.
</para></sect3>
 
<sect3><title>lp</title>
<para><command>lp</command> submits files for printing or alters a pending job.
</para></sect3>
 
<sect3><title>lpoptions</title>
<para><command>lpoptions</command> displays or sets printer options and
defaults.
</para></sect3>
 
<sect3><title>lpstat</title>
<para><command>lpstat</command> displays status information about the
current classes, jobs, and printers.</para></sect3>
 
<sect3><title>lppasswd</title>
<para><command>lppasswd</command> adds, changes or deletes passwords in
the <application><acronym>CUPS</acronym></application> digest password file
<filename>passwd.md5</filename>.
</para></sect3>
 
<sect3><title>cups-config</title>
<para><command>cups-config</command> is the <application><acronym>CUPS
</acronym></application> program configuration utility.
</para></sect3>
 
</sect2>
 
</sect1>
/trunk/blfs/pst/printing/printing.xml
1,16 → 1,21
<?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="pst-printing">
<?dbhtml filename="printing.html"?>
<title>Impression</title>
<title>Printing</title>
 
<para>Ce chapitre contient des système de gestion d'imprimantes avec spoolers et
des applications ghostscript pour afficher du PostScript sur des affichages
comme des terminaux ou du papier.</para>
<para>This chapter contains spooling printer management systems and
ghostscript applications to render PostScript for display on terminals
or paper.</para>
 
&cups;
&LPRng;
&gs;
&espgs;
&gimp-print;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="cups.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lprng.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gs.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="espgs.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gimp-print.xml"/>
 
</chapter>