Subversion Repositories svn LFS-FR

Compare Revisions

Ignore whitespace Rev 899 → Rev 900

/trunk/blfs/content/databases/postgresql.xml
File deleted
/trunk/blfs/content/databases/db.xml
File deleted
/trunk/blfs/content/databases/mysql.xml
File deleted
/trunk/blfs/content/databases/databases.xml
File deleted
/trunk/blfs/content/content.xml
File deleted
/trunk/blfs/content/web/apache.xml
File deleted
/trunk/blfs/content/web/vsftpd.xml
File deleted
/trunk/blfs/content/web/php.xml
File deleted
/trunk/blfs/content/web/web.xml
File deleted
/trunk/blfs/content/web/proftpd.xml
File deleted
/trunk/blfs/connect/connect.xml
File deleted
/trunk/blfs/connect/dhcp/dhcp.xml
File deleted
/trunk/blfs/connect/dhcp/dhcpcd.xml
File deleted
/trunk/blfs/connect/dhcp/dhcp-client.xml
File deleted
/trunk/blfs/connect/dialup/dialup.xml
File deleted
/trunk/blfs/connect/dialup/ppp.xml
File deleted
/trunk/blfs/connect/dialup/wvdial.xml
File deleted
/trunk/blfs/connect/other/other.xml
File deleted
/trunk/blfs/connect/other/pppoe.xml
File deleted
/trunk/blfs/introduction/important/locale-issues.xml
0,0 → 1,305
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<sect1 id="locale-issues" xreflabel="Locale Related Issues">
<?dbhtml filename="locale-issues.html"?>
 
<sect1info>
<othername>$LastChangedBy: ag $</othername>
<date>$Date: 2007-11-02 00:23:19 +0100 (ven, 02 nov 2007) $</date>
</sect1info>
 
<title>Locale Related Issues</title>
 
<para>This page contains information about locale related problems and
issues. In the following paragraphs you'll find a generic overview of
things that can come up when configuring your system for various locales.
Many (but not all) existing locale related problems can be classified
and fall under one of the headings below. The severity ratings below use
the following criteria:</para>
 
<itemizedlist>
<listitem>
<para>Critical: The program doesn't perform its main function.
The fix would be very intrusive, it's better to search for a
replacement.</para>
</listitem>
<listitem>
<para>High: Part of the functionality that the program provides
is not usable. If that functionality is required, it's better to
search for a replacement.</para>
</listitem>
<listitem>
<para>Low: The program works in all typical use cases, but lacks
some functionality normally provided by its equivalents.</para>
</listitem>
</itemizedlist>
 
<para>If there is a known workaround for a specific package, it will
appear on that package's page. For the most recent information
about locale related issues for individual packages, check the
<ulink url="&blfs-wiki;/BlfsNotes">User Notes</ulink> in the BLFS
Wiki.</para>
 
<sect2 id="locale-not-valid-option"
xreflabel="Needed Encoding Not a Valid Option">
 
<title>The Needed Encoding is Not a Valid Option in the Program</title>
 
<para>Severity: Critical</para>
 
<para>Some programs require the user to specify the character encoding
for their input or output data and present only a limited choice of
encodings. This is the case for the <option>-X</option> option in
<xref linkend="a2ps"/> and <xref linkend="enscript"/>,
the <option>-input-charset</option> option in unpatched
<xref linkend="cdrtools"/>, and the character sets offered for display
in the menu of <xref linkend="Links"/>. If the required encoding is not
in the list, the program usually becomes completely unusable. For
non-interactive programs, it may be possible to work around this by
converting the document to a supported input character set before
submitting to the program.</para>
 
<para>A solution to this type of problem is to implement the necessary
support for the missing encoding as a patch to the original program
(as done for <xref linkend="cdrtools"/> in this book), or to find a
replacement.</para>
 
</sect2>
 
<sect2 id="locale-assumed-encoding"
xreflabel="Program Assumes Encoding">
 
<title>The Program Assumes the Locale-Based Encoding of External
Documents</title>
 
<para>Severity: High for non-text documents, low for text
documents</para>
 
<para>Some programs, <xref linkend="nano"/> or
<xref linkend="joe"/> for example, assume that documents are always
in the encoding implied by the current locale. While this assumption
may be valid for the user-created documents, it is not safe for
external ones. When this assumption fails, non-ASCII characters are
displayed incorrectly, and the document may become unreadable.</para>
 
<para>If the external document is entirely text based, it can be
converted to the current locale encoding using the
<command>iconv</command> program.</para>
 
<para>For documents that are not text-based, this is not possible.
In fact, the assumption made in the program may be completely
invalid for documents where the Microsoft Windows operating system
has set de facto standards. An example of this problem is ID3v1 tags
in MP3 files (see the <ulink url="&blfs-wiki;/ID3v1Coding">BLFS Wiki
ID3v1Coding page</ulink>
for more details). For these cases, the only solution is to find a
replacement program that doesn't have the issue (e.g., one that
will allow you to specify the assumed document encoding).</para>
 
<para>Among BLFS packages, this problem applies to
<xref linkend="nano"/>, <xref linkend="joe"/>, and all media players
except <xref linkend="audacious"/>.</para>
 
<para>Another problem in this category is when someone cannot read
the documents you've sent them because their operating system is
set up to handle character encodings differently. This can happen
often when the other person is using Microsoft Windows, which only
provides one character encoding for a given country. For example,
this causes problems with UTF-8 encoded TeX documents created in
Linux. On Windows, most applications will assume that these documents
have been created using the default Windows 8-bit encoding. See the
<ulink url="&blfs-wiki;/tetex">teTeX</ulink> Wiki page for more
details.</para>
 
<para>In extreme cases, Windows encoding compatibility issues may be
solved only by running Windows programs under
<ulink url="http://www.winehq.com/">Wine</ulink>.</para>
 
</sect2>
 
<sect2 id="locale-wrong-filename-encoding"
xreflabel="Wrong Filename Encoding">
 
<title>The Program Uses or Creates Filenames in the Wrong Encoding</title>
 
<para>Severity: Critical</para>
 
<para>The POSIX standard mandates that the filename encoding is
the encoding implied by the current LC_CTYPE locale category. This
information is well-hidden on the page which specifies the behavior
of <application>Tar</application> and <application>Cpio</application>
programs. Some programs get it wrong by default (or simply don't
have enough information to get it right). The result is that they
create filenames which are not subsequently shown correctly by
<command>ls</command>, or they refuse to accept filenames that
<command>ls</command> shows properly. For the <xref linkend="glib2"/>
library, the problem can be corrected by setting the
<envar>G_FILENAME_ENCODING</envar> environment variable to the special
"@locale" value. <application>Glib2</application> based programs that
don't respect that environment variable are buggy.</para>
 
<para>The <xref linkend="zip"/>, <xref linkend="unzip"/>, and
<xref linkend="nautilus-cd-burner"/> have this problem because
they hard-code the expected filename encoding.
<application>UnZip</application> contains a hard-coded conversion
table between the CP850 (DOS) and ISO-8859-1 (UNIX) encodings and
uses this table when extracting archives created under DOS or
Microsoft Windows. However, this assumption only works for those
in the US and not for anyone using a UTF-8 locale. Non-ASCII
characters will be mangled in the extracted filenames.</para>
 
<para>On the other hand,
<application>Nautilus CD Burner</application> checks names of
files added to its window for UTF-8 validity. This is wrong for
users of non-UTF-8 locales. Also,
<application>Nautilus CD Burner</application> unconditionally
calls <command>mkisofs</command> with the
<parameter>-input-charset UTF-8</parameter> parameter, which is
only correct in UTF-8 locales.</para>
 
<para>The general rule for avoiding this class of problems is to
avoid installing broken programs. If this is impossible, the
<ulink url="http://j3e.de/linux/convmv/">convmv</ulink>
command-line tool can be used to fix filenames created by these
broken programs, or intentionally mangle the existing filenames
to meet the broken expectations of such programs.</para>
 
<para>In other cases, a similar problem is caused by importing
filenames from a system using a different locale with a tool that
is not locale-aware (e.g., <xref linkend="nfs-utils"/> or
<xref linkend="openssh"/>). In order to avoid mangling non-ASCII
characters when transferring files to a system with a different
locale, any of the following methods can be used:</para>
 
<itemizedlist>
<listitem>
<para>Transfer anyway, fix the damage with
<command>convmv</command>.</para>
</listitem>
<listitem>
<para>On the sending side, create a tar archive with the
<parameter>--format=posix</parameter> switch passed to
<command>tar</command> (this will be the default in a future
version of <command>tar</command>).</para>
</listitem>
<listitem>
<para>Mail the files as attachments. Mail clients specify the
encoding of attached filenames.</para>
</listitem>
<listitem>
<para>Write the files to a removable disk formatted with a FAT or
FAT32 filesystem.</para>
</listitem>
<listitem>
<para>Transfer the files using Samba.</para>
</listitem>
<listitem>
<para>Transfer the files via FTP using RFC2640-aware server
(this currently means only wu-ftpd, which has bad security history)
and client (e.g., lftp).</para>
</listitem>
</itemizedlist>
 
<para>The last four methods work because the filenames are automatically
converted from the sender's locale to UNICODE and stored or sent in this
form. They are then transparently converted from UNICODE to the
recipient's locale encoding.</para>
 
</sect2>
 
<sect2 id="locale-wrong-multibyte-characters"
xreflabel="Breaks Multibyte Characters">
 
<title>The Program Breaks Multibyte Characters or Doesn't Count
Character Cells Correctly</title>
 
<para>Severity: High or critical</para>
 
<para>Many programs were written in an older era where multibyte
locales were not common. Such programs assume that C "char" data
type, which is one byte, can be used to store single characters.
Further, they assume that any sequence of characters is a valid
string and that every character occupies a single character cell.
Such assumptions completely break in UTF-8 locales. The visible
manifestation is that the program truncates strings prematurely
(i.e., at 80 bytes instead of 80 characters). Terminal-based
programs don't place the cursor correctly on the screen, don't react
to the "Backspace" key by erasing one character, and leave junk
characters around when updating the screen, usually turning the
screen into a complete mess.</para>
 
<para>Fixing this kind of problems is a tedious task from a
programmer's point of view, like all other cases of retrofitting new
concepts into the old flawed design. In this case, one has to redesign
all data structures in order to accommodate to the fact that a complete
character may span a variable number of "char"s (or switch to wchar_t
and convert as needed). Also, for every call to the "strlen" and
similar functions, find out whether a number of bytes, a number of
characters, or the width of the string was really meant. Sometimes it
is faster to write a program with the same functionality from scratch.
</para>
 
<para>Among BLFS packages, this problem applies to
<xref linkend="xine-ui"/> and all the shells.</para>
 
</sect2>
 
<sect2 id="locale-wrong-manpage-encoding"
xreflabel="Incorrect Manual Page Encoding">
 
<title>The Package Installs Manual Pages in Incorrect or
Non-Displayable Encoding</title>
 
<para>Severity: Low</para>
 
<para>LFS expects that manual pages are in the language-specific (usually
8-bit) encoding, as specified on the <ulink
url="&lfs-root;/chapter06/man-db.html">LFS Man DB page</ulink>. However,
some packages install translated manual pages in UTF-8 encoding (e.g.,
Shadow, already dealt with), or manual pages in languages not in the table.
Not all BLFS packages have been audited for conformance with the
requirements put in LFS (the large majority have been checked, and fixes
placed in the book for packages known to install non-conforming manual
pages). If you find a manual page installed by any of BLFS packages that is
obviously in the wrong encoding, please remove or convert it as needed, and
report this to BLFS team as a bug.</para>
 
<para>You can easily check your system for any non-conforming manual pages
by copying the following short shell script to some accessible location,
 
<screen><literal>#!/bin/sh
# Begin checkman.sh
# Usage: find /usr/share/man -type f | xargs checkman.sh
for a in "$@"
do
# echo "Checking $a..."
# Pure-ASCII manual page (possibly except comments) is OK
grep -v '.\\"' "$a" | iconv -f US-ASCII -t US-ASCII >/dev/null 2>&amp;1 \
&amp;&amp; continue
# Non-UTF-8 manual page is OK
iconv -f UTF-8 -t UTF-8 "$a" >/dev/null 2>&amp;1 || continue
# If we got here, we found UTF-8 manual page, bad.
echo "UTF-8 manual page: $a" >&amp;2
done
# End checkman.sh
</literal></screen>
 
and then issuing the following command (modify the command below if the
<command>checkman.sh</command> script is not in your <envar>PATH</envar>
environment variable):</para>
 
<screen><userinput>find /usr/share/man -type f | xargs checkman.sh</userinput></screen>
 
<para>Note that if you have manual pages installed in any location other
than <filename class='directory'>/usr/share/man</filename> (e.g.,
<filename class='directory'>/usr/local/share/man</filename>), you must
modify the above command to include this additional location.</para>
 
</sect2>
 
</sect1>
/trunk/blfs/obfuscate.sh
1,7 → 1,7
#!/bin/bash
 
# $LastChangedBy: manuel $
# $Date: 2008-11-16 21:28:00 $
# $Date: 2007-07-07 12:41:20 +0200 (sam, 07 jui 2007) $
 
# obfuscate.sh
# obfuscate email addresses in XML/HTML
/trunk/blfs/basicnet/mailnews/tin.xml
0,0 → 1,304
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY tin-download-http "http://gd.tuwien.ac.at/infosys/newsreaders/tin/v1.8/tin-&tin-version;.tar.bz2">
<!ENTITY tin-download-ftp "ftp://ftp.tin.org/pub/news/clients/tin/v1.8/tin-&tin-version;.tar.bz2">
<!ENTITY tin-md5sum "e6ed45205020665c097556822b0d575b">
<!ENTITY tin-size "1.4 MB">
<!ENTITY tin-buildsize "12.4 MB">
<!ENTITY tin-time "0.4 SBU">
]>
 
<sect1 id="tin" xreflabel="tin-&tin-version;">
<?dbhtml filename="tin.html"?>
 
<sect1info>
<othername>$LastChangedBy: alexander $</othername>
<date>$Date: 2008-03-11 17:31:08 +0100 (mar 11 mar 2008) $</date>
</sect1info>
 
<title>TIN-&tin-version;</title>
 
<indexterm zone="tin">
<primary sortas="a-TIN">TIN</primary>
</indexterm>
 
<sect2 role="package">
<title>Introduction to TIN</title>
 
<para><application>TIN</application> is a threaded NNTP and spool based
console-mode UseNet newsreader. It supports threading, scoring,
different charsets, and many other useful things. It has also support for
different languages.</para>
 
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing='compact'>
<listitem>
<para>Download (HTTP): <ulink url="&tin-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&tin-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &tin-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &tin-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &tin-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &tin-time;</para>
</listitem>
</itemizedlist>
 
<bridgehead renderas="sect3">TIN Dependencies</bridgehead>
 
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="pcre"/>,
<xref linkend="libidn"/>,
an <xref linkend="server-mail"/> that provides the
<command>sendmail</command> command or <xref linkend="mailx"/>,
<xref linkend="gnupg"/>,
<!-- a spell checker (<xref linkend="ispell"/> or <xref linkend="aspell"/>), -->
<xref linkend="aspell"/>,
<ulink url="http://www.isc.org/index.pl?/sw/inn/">INN</ulink>,
<ulink url="http://www.fpx.de/fp/Software/UUDeview/">UUDeview</ulink>,
<ulink url="http://www.inet.no/dante/">Socks</ulink>,
<ulink
url="http://ftp4.de.freesbie.org/pub/misc/metamail/mm2.7.tar.Z">Metamail</ulink>,
and
<ulink url="http://dmalloc.com/">Dmalloc</ulink>
or
<ulink url="ftp://invisible-island.net/dbmalloc/">dbmalloc</ulink></para>
 
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/Tin"/></para>
 
</sect2>
 
<sect2 role="installation">
<title>Installation of TIN</title>
 
<para>Install <application>TIN</application> by running the following
commands:</para>
 
<screen><userinput>./configure --prefix=/usr --with-screen=ncursesw \
--enable-nntp-only --disable-printing &amp;&amp;
make build</userinput></screen>
 
<para>This package does not come with a test suite.</para>
 
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
<screen role='root'><userinput>make install &amp;&amp;
make install_sysdefs &amp;&amp;
rm -vf doc/*.? &amp;&amp;
install -v -m755 -d /usr/share/doc/tin-&tin-version; &amp;&amp;
install -v -m644 doc/* /usr/share/doc/tin-&tin-version;</userinput></screen>
 
</sect2>
 
<sect2 role="commands">
<title>Command Explanations</title>
 
<para><parameter>--with-screen=ncursesw</parameter>: This switch forces
the use of wide-character functions from the ncursesw library (for UTF-8
and Asian languages support).</para>
 
<para><parameter>--enable-nntp-only</parameter>: Reading news from a local
spool is disabled with this switch. Don't use this if you have installed
INN and want to use its spool.</para>
 
<para><parameter>--disable-printing</parameter>: This switch disables
printing since <application>TIN</application> cannot send non-ASCII text
to the printer correctly. Remove this switch if you can tolerate this
limitation.</para>
 
<para><parameter>--with-editor</parameter>: This switch sets the default
editor used by <application>TIN</application>. The default is
<command>vi</command>.</para>
 
</sect2>
 
<sect2 role="configuration">
<title>Configuring TIN</title>
 
<sect3 id="tin-config">
<title>Config Files</title>
 
<para><filename>/etc/tin/tinrc</filename>,
<filename>~/.tin/tinrc</filename>,
<filename>~/.newsrc</filename>,
<filename>/etc/tin/tin.defaults</filename>,
<filename>/etc/tin/mime.types</filename>,
<filename>/etc/tin/keymap</filename> and
<filename>/etc/mailcap</filename></para>
 
<indexterm zone="tin tin-config">
<primary sortas="e-etc-tinrc">/etc/tin/tinrc</primary>
</indexterm>
 
<indexterm zone="tin tin-config">
<primary sortas="e-AA.tinrc">~/.tin/tinrc</primary>
</indexterm>
 
<indexterm zone="tin tin-config">
<primary sortas="e-AA.newsrc">~/.newsrc</primary>
</indexterm>
 
<indexterm zone="tin tin-config">
<primary sortas="e-etc-tindefaults">/etc/tin/tin.defaults</primary>
</indexterm>
 
<indexterm zone="tin tin-config">
<primary sortas="e-etc-tinkeymap">/etc/tin/keymap</primary>
</indexterm>
 
<indexterm zone="tin tin-config">
<primary sortas="e-etc-mailcap">/etc/mailcap</primary>
</indexterm>
 
</sect3>
 
<sect3>
<title>Configuration Information</title>
 
<para>Set some global defaults for <application>TIN</application> by
running the following commands as the
<systemitem class="username">root</systemitem> user:</para>
 
<screen role='root'><userinput>cat &gt; /etc/tin/tinrc &lt;&lt; "EOF"
use_mouse=ON
getart_limit=100
translit=ON
EOF</userinput></screen>
 
<para>Now, as an unprivileged user, subscribe to some newsgroups,
specify the news server, and run <command>tin</command>:</para>
 
<screen><userinput>cat &gt;&gt; ~/.newsrc &lt;&lt; "EOF"
gmane.linux.lfs.devel:
gmane.linux.lfs.beyond.devel:
EOF
export NNTPSERVER=news.gmane.org
tin -Q</userinput></screen>
 
<para>For printing, <application>TIN</application> executes the
<command>lpr</command> command. This can be provided by
<xref linkend="cups"/> or <xref linkend="LPRng"/>.</para>
 
<para>If you do not have the <command>metamail</command> program,
<application>TIN</application> will use an internal parser for multipart
MIME articles. Alternatively, you can use <application>Mutt</application>
for MIME parsing through the <command>metamutt</command> shell script.
This requires both the <xref linkend="mutt"/> and
<xref linkend="procmail"/> programs. To use <command>metamutt</command>,
set <option>metamail_prog=metamutt</option> in
<command>tin</command>.</para>
 
</sect3>
 
</sect2>
 
<sect2 role="content">
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
 
<seglistitem>
<seg>tin, rtin, tinews.pl, metamutt, opt-case.pl, w2r.pl,
and url_handler.sh</seg>
<seg>None</seg>
<seg>/etc/tin</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
 
<varlistentry id="tin-prog">
<term><command>tin</command></term>
<listitem>
<para>is a UseNet news reader.</para>
<indexterm zone="tin tin-prog">
<primary sortas="b-tin">tin</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="rtin">
<term><command>rtin</command></term>
<listitem>
<para>is a symbolic link to <command>tin</command>.</para>
<indexterm zone="tin rtin">
<primary sortas="b-rtin">rtin</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="tinews.pl">
<term><command>tinews.pl</command></term>
<listitem>
<para>posts and signs an article via NNTP.</para>
<indexterm zone="tin tinews.pl">
<primary sortas="b-tinews.pl">tinews.pl</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="metamutt">
<term><command>metamutt</command></term>
<listitem>
<para>is a replacement of <command>metamail</command> using
<application>Mutt</application>.</para>
<indexterm zone="tin metamutt">
<primary sortas="b-metamutt">metamutt</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="opt-case.pl">
<term><command>opt-case.pl</command></term>
<listitem>
<para>optimizes case insensitive regexp filters for tin.</para>
<indexterm zone="tin opt-case.pl">
<primary sortas="b-opt-case.pl">opt-case.pl</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="w2r.pl">
<term><command>w2r.pl</command></term>
<listitem>
<para>converts tin wildmat filters to tin regexp filters.</para>
<indexterm zone="tin w2r.pl">
<primary sortas="b-w2r.pl">w2r.pl</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="url_handler.sh">
<term><command>url_handler.sh</command></term>
<listitem>
<para>calls a web browser for viewing hyperlinks.</para>
<indexterm zone="tin url_handler.sh">
<primary sortas="b-url_handler.sh">url_handler.sh</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
/trunk/blfs/postlfs/security/linux_pam.xml
File deleted
/trunk/blfs/postlfs/security/linux-pam.xml
0,0 → 1,325
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY linux-pam-download-http "http://www.kernel.org/pub/linux/libs/pam/library/Linux-PAM-&linux-pam-version;.tar.bz2">
<!ENTITY linux-pam-download-ftp "ftp://ftp.kernel.org/pub/linux/libs/pam/library/Linux-PAM-&linux-pam-version;.tar.bz2">
<!ENTITY linux-pam-md5sum "189171821b56aaf791cc890d0707ea82">
<!ENTITY linux-pam-size "1.0 MB">
<!ENTITY linux-pam-buildsize "21 MB (includes installing the optional documentation)">
<!ENTITY linux-pam-time "0.6 SBU">
 
<!ENTITY linux-pam-docs-download "http://www.kernel.org/pub/linux/libs/pam/documentation/Linux-PAM-&linux-pam-version;-docs.tar.bz2">
<!ENTITY linux-pam-docs-md5sum "c171a8f19ac79f51cc524c89bfa98716">
<!ENTITY linux-pam-docs-size "700 KB">
]>
 
<sect1 id="linux-pam" xreflabel="Linux-PAM-&linux-pam-version;">
<?dbhtml filename="linux-pam.html"?>
 
<sect1info>
<othername>$LastChangedBy: dj $</othername>
<date>$Date: 2009-05-10 21:25:42 +0200 (dim 10 mai 2009) $</date>
</sect1info>
 
<title>Linux-PAM-&linux-pam-version;</title>
 
<indexterm zone="linux-pam">
<primary sortas="a-Linux-PAM">Linux-PAM</primary>
</indexterm>
 
<sect2 role="package">
<title>Introduction to Linux-PAM</title>
 
<para>The <application>Linux-PAM</application> package contains
Pluggable Authentication Modules. This is useful to enable the
local system administrator to choose how applications authenticate
users.</para>
 
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&linux-pam-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&linux-pam-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &linux-pam-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &linux-pam-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &linux-pam-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &linux-pam-time;</para>
</listitem>
</itemizedlist>
 
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing='compact'>
<listitem>
<para>Optional documentation: <ulink url="&linux-pam-docs-download;"/></para>
</listitem>
<listitem>
<para>Download MD5sum: &linux-pam-docs-md5sum;</para>
</listitem>
<listitem>
<para>Download size &linux-pam-docs-size;</para>
</listitem>
</itemizedlist>
 
<bridgehead renderas="sect3">Linux-PAM Dependencies</bridgehead>
 
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="cracklib"/>,
<xref linkend="x-window-system"/>, and
<!-- <xref linkend="db"/> (for the pam_userdb module), -->
<ulink url="http://www.prelude-ids.org/">Prelude</ulink></para>
 
<bridgehead renderas="sect4">Optional (To {,Re}build the Documentation)</bridgehead>
<para role="optional"><xref linkend="libxslt"/>,
<xref linkend="DocBook"/>,
<xref linkend="docbook-xsl"/>,
<xref linkend="w3m"/>, and
<xref linkend="fop"/></para>
 
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/linux-pam"/></para>
 
</sect2>
 
<sect2 role="installation">
<title>Installation of Linux-PAM</title>
 
<para>If you downloaded the documentation, unpack the tarball by issuing
the following command.</para>
 
<screen><userinput>tar xf ../Linux-PAM-&linux-pam-version;-docs.tar.bz2 --strip-components=1</userinput></screen>
 
<para>Install <application>Linux-PAM</application> by
running the following commands:</para>
 
<screen><userinput>./configure --sbindir=/lib/security \
--docdir=/usr/share/doc/Linux-PAM-&linux-pam-version; \
--enable-read-both-confs &amp;&amp;
make</userinput></screen>
 
<para>To test the results, a configuration file must be created. This file
will be removed after the tests have completed. Ensure there are no errors
produced by the tests before continuing the installation. First create the
configuration file by issuing the following commands as the
<systemitem class="username">root</systemitem> user:</para>
 
<screen role="root"><userinput>install -v -m755 -d /etc/pam.d &amp;&amp;
 
cat &gt; /etc/pam.d/other &lt;&lt; "EOF"
auth required pam_deny.so
account required pam_deny.so
password required pam_deny.so
session required pam_deny.so
EOF</userinput></screen>
 
<para>Now run the tests by issuing <command>make check</command>.</para>
 
<para>Remove the configuration file created earlier by issuing the
following command as the
<systemitem class="username">root</systemitem> user:</para>
 
<screen role="root"><userinput>rm -rfv /etc/pam.d</userinput></screen>
 
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
<screen role="root"><userinput>make install &amp;&amp;
chmod -v 4755 /lib/security/unix_chkpwd &amp;&amp;
 
mv -v /lib/security/pam_tally /sbin &amp;&amp;
 
mv -v /lib/libpam{,c,_misc}.la /usr/lib &amp;&amp;
sed -i 's| /lib| /usr/lib|' /usr/lib/libpam_misc.la &amp;&amp;
 
if [ -L /lib/libpam.so ]; then
for LINK in libpam{,c,_misc}.so; do
ln -v -sf ../../lib/$(readlink /lib/${LINK}) /usr/lib/${LINK} &amp;&amp;
rm -v /lib/${LINK}
done
fi</userinput></screen>
 
</sect2>
 
<sect2 role="commands">
<title>Command Explanations</title>
 
<para><parameter>--sbindir=/lib/security</parameter>: This parameter
results in three executables, two of which are not intended to be run from
the command line, being installed in the same directory as the PAM modules.
The other executable is later moved to the
<filename class='directory'>/sbin</filename> directory.</para>
 
<para><parameter>--docdir=...</parameter>: This parameter results in
the documentation being installed in a versioned directory name.</para>
 
<para><parameter>--enable-read-both-confs</parameter>: This parameter
allows the local administrator to choose which configuration file setup to
use.</para>
 
<!-- This appears unnecessary as the xauth module is created even if X
has not yet been installed.
<para><parameter>-with-xauth=/usr/X11R6/bin/xauth</parameter>: This
parameter forces the build of the pam_xauth module, even if xauth is not
yet installed. Omit this switch if you have no plans to build
<application>Xorg</application>, or modify the path if you intend to
install <application>Xorg</application> into a non-standard path.</para> -->
 
<para><command>chmod -v 4755 /lib/security/unix_chkpwd</command>:
The <command>unix_chkpwd</command> password-helper program must be setuid
so that non-<systemitem class="username">root</systemitem> processes can
access the shadow-password file.</para>
 
<para><command>mv -v /lib/security/pam_tally /sbin</command>: The
<command>pam_tally</command> program is designed to be run by the system
administrator, possibly in single-user mode, so it is moved to the
appropriate directory.</para>
 
<para><command>mv -v /lib/libpam{,c,_misc}.la /usr/lib</command>: This
command moves the <application>Libtool</application> library files to
<filename class='directory'>/usr/lib</filename> as they are expected to
reside there.</para>
 
<para><command>sed -i 's| /lib| /usr/lib|'
/usr/lib/libpam_misc.la</command>: This command corrects an installation
reference due to the file being moved in the previous step.</para>
 
<para><command>for ...; do ...; done</command>: These commands are used
to relocate the <filename class='symlink'>.so</filename> symbolic links
into the <filename class='directory'>/usr/lib</filename> directory by
cloning and then removing the existing symlinks. Using
<command>readlink</command> ensures the new symlinks point at the correct
library filenames.</para>
 
</sect2>
 
<sect2 role="configuration">
<title>Configuring Linux-PAM</title>
 
<sect3 id="pam-config">
<title>Config Files</title>
 
<para><filename>/etc/security/*</filename> and
<filename>/etc/pam.d/*</filename> or
<filename>/etc/pam.conf</filename></para>
 
<indexterm zone="linux-pam pam-config">
<primary sortas="e-etc-security">/etc/security/*</primary>
</indexterm>
 
<indexterm zone="linux-pam pam-config">
<primary sortas="e-etc-pam.d">/etc/pam.d/*</primary>
</indexterm>
 
<indexterm zone="linux-pam pam-config">
<primary sortas="e-etc-pam.conf">/etc/pam.conf</primary>
</indexterm>
 
</sect3>
 
<sect3>
<title>Configuration Information</title>
 
<para>Configuration information is placed in
<filename class='directory'>/etc/pam.d/</filename> or
<filename>/etc/pam.conf</filename> depending on system administrator
preference. Below are example files of each type:</para>
 
<screen><literal># Begin /etc/pam.d/other
 
auth required pam_unix.so nullok
account required pam_unix.so
session required pam_unix.so
password required pam_unix.so nullok
 
# End /etc/pam.d/other
 
# Begin /etc/pam.conf
 
other auth required pam_unix.so nullok
other account required pam_unix.so
other session required pam_unix.so
other password required pam_unix.so nullok
 
# End /etc/pam.conf</literal></screen>
 
<para>The <application>PAM</application> man page
(<command>man pam</command>) provides a good starting point for
descriptions of fields and allowable entries. The <ulink
url="http://www.kernel.org/pub/linux/libs/pam/Linux-PAM-html/Linux-PAM_SAG.html">
Linux-PAM System Administrators' Guide</ulink>
is recommended for additional information.</para>
 
<para>Refer to <ulink
url="http://www.kernel.org/pub/linux/libs/pam/modules.html"/>
for a list of various third-party modules available.</para>
 
<important>
<para>You should now reinstall the <xref linkend="shadow"/>
package.</para>
</important>
 
</sect3>
 
</sect2>
 
<sect2 role="content">
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
 
<seglistitem>
<seg>pam_tally</seg>
<seg>libpam.{so,a}, libpamc.{so,a}, libpam_misc.{so,a} and
numerous PAM modules</seg>
<seg>/etc/pam.d, /etc/security, /lib/security,
/usr/include/security, /usr/share/doc/Linux-PAM-&linux-pam-version;
and /var/run/sepermit</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
 
<varlistentry id="pam_tally">
<term><command>pam_tally</command></term>
<listitem>
<para>is used to view or manipulate the <filename>faillog</filename>
file.</para>
<indexterm zone="linux-pam pam_tally">
<primary sortas="b-pam_tally">pam_tally</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="libpam">
<term><filename class='libraryfile'>libpam.{so,a}</filename></term>
<listitem>
<para>provides the interfaces between applications and the
PAM modules.</para>
<indexterm zone="linux-pam libpam">
<primary sortas="c-libpam">libpam.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
/trunk/blfs/tidy.conf
1,7 → 1,7
# Tidy configuration file
#
# $LastChangedBy: randy $
# $Date: 2008-11-16 21:28:00 $
# $Date: 2007-01-18 20:38:19 +0100 (jeu, 18 jan 2007) $
 
indent-spaces: 2
wrap: 78
/trunk/blfs/README
1,5 → 1,5
$LastChangedBy: randy $
$Date: 2008-11-16 21:27:59 $
$Date: 2007-01-18 20:38:19 +0100 (jeu, 18 jan 2007) $
 
How do I convert these XML files to other formats like HTML, PDF,
and TXT? You need to have some software installed that deal with these
/trunk/blfs/general.ent
1,19 → 1,19
<!--
$LastChangedBy: thomas $
$Date: 2008-11-16 21:27:59 $
$LastChangedBy: gdalziel $
$Date: 2009-07-15 19:27:23 +0200 (mer 15 jui 2009) $
-->
 
<!ENTITY day "14"> <!-- Always 2 digits -->
<!ENTITY month "11"> <!-- Always 2 digits -->
<!ENTITY year "2008">
<!ENTITY day "15"> <!-- Always 2 digits -->
<!ENTITY month "07"> <!-- Always 2 digits -->
<!ENTITY year "2009">
<!ENTITY copyrightdate "2001-&year;">
<!ENTITY copyholder "The BLFS Development Team">
<!ENTITY version "svn-&year;&month;&day;">
<!ENTITY releasedate "November &day;th, &year;">
<!ENTITY releasedate "July &day;th, &year;">
<!ENTITY pubdate "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
<!ENTITY blfs-version "svn"> <!-- svn|[release #] -->
<!ENTITY lfs-version "development"> <!-- version|testing|unstable|development] -->
<!ENTITY last-commit "$Date: 2008-11-16 21:27:59 $"> <!-- Automatic update -->
<!ENTITY last-commit "$Date: 2009-07-15 19:27:23 +0200 (mer 15 jui 2009) $"> <!-- Automatic update -->
 
<!ENTITY lfs-domainname "linuxfromscratch.org">
 
45,9 → 45,10
<!ENTITY lfs-flex-version "2.5.35">
<!ENTITY lfs-shadow-version "4.1.2.1">
<!ENTITY lfs-vim-version "7.2">
<!ENTITY lfs-m4-version "1.4.12">
<!-- End LFS versions -->
 
<!ENTITY blfs-bootscripts-version "20080816">
<!ENTITY blfs-bootscripts-version "20090302">
<!ENTITY blfs-bootscripts-download "&downloads-root;/blfs-bootscripts-&blfs-bootscripts-version;.tar.bz2">
 
<!ENTITY blfs-wiki "http://wiki.&lfs-domainname;/blfs/wiki">
58,13 → 59,14
 
<!-- Chapter 4 -->
 
<!ENTITY openssl-version "0.9.8g">
<!ENTITY openssl-version "0.9.8k">
<!ENTITY ca-bundle-version "20090409">
<!ENTITY gnutls-version "1.6.3">
<!ENTITY cracklib-version "2.8.13">
<!ENTITY linux-pam-version "0.99.10.0">
<!ENTITY shadow-version "4.0.18.1">
<!ENTITY linux-pam-version "1.0.4">
<!ENTITY shadow-version "4.1.3.1">
<!ENTITY iptables-version "1.3.8">
<!ENTITY gnupg-version "1.4.7">
<!ENTITY gnupg-version "1.4.9">
<!ENTITY gnupg2-version "2.0.8">
<!ENTITY tripwire-version "2.4.1.2">
<!ENTITY heimdal-version "1.1">
71,26 → 73,26
<!ENTITY mitkrb-version "1.6">
<!ENTITY cyrus-sasl-version "2.1.22">
<!ENTITY stunnel-version "4.21">
<!ENTITY sudo-version "1.6.9p15">
<!ENTITY sudo-version "1.7.0">
<!ENTITY nss-version "3.11.7">
 
<!-- Chapter 5 -->
<!ENTITY reiser-version "3.6.20">
<!ENTITY reiser-version "3.6.21">
<!ENTITY xfsprogs-version "2.9.7">
 
<!-- Chapter 6 -->
<!ENTITY vim-version "7.1">
<!ENTITY vim-version "7.2">
<!ENTITY emacs-version "22.1">
<!ENTITY nano-version "2.0.7">
<!ENTITY joe-version "3.5">
<!ENTITY ed-version "1.1">
<!ENTITY ed-version "1.3">
<!ENTITY bluefish-version "1.0.7">
 
<!-- Chapter 7 -->
<!ENTITY tcsh-version "6.15.00">
<!ENTITY zsh-version "4.3.6">
<!ENTITY dash-version "0.5.4">
<!ENTITY ksh-version "2008-02-02">
<!ENTITY tcsh-version "6.16.00">
<!ENTITY zsh-version "4.3.10">
<!ENTITY dash-version "0.5.5.1">
<!ENTITY ksh-version "2008-11-04">
 
<!-- Obsolete
<!ENTITY ash-version "0.4.0">
98,42 → 100,43
 
<!-- Part III -->
<!-- Chapter 8 -->
<!ENTITY pcre-version "7.6">
<!ENTITY pcre-version "7.9">
<!ENTITY popt-version "1.14">
<!ENTITY slang-version "2.1.3">
<!ENTITY gamin-version "0.1.9">
<!ENTITY libxml2-version "2.6.31">
<!ENTITY slang-version "2.1.4">
<!ENTITY gamin-version "0.1.10">
<!ENTITY libxml2-version "2.7.3">
<!ENTITY libxslt-version "1.1.24">
<!ENTITY libgtkhtml-version "2.11.1">
<!ENTITY gmp-version "4.2.2">
<!-- <!ENTITY gmp-version "4.2.2"> Now in LFS -->
<!ENTITY gdbm-version "1.8.3">
<!ENTITY GLib-version "1.2.10">
<!ENTITY glib2-version "2.12.12">
<!ENTITY libidl-version "0.8.8">
<!ENTITY glib2-version "2.18.4">
<!ENTITY libidl-version "0.8.12">
<!ENTITY libcroco-version "0.6.1">
<!ENTITY libgsf-version "1.14.7">
<!ENTITY libglade-version "2.6.1">
<!ENTITY libglade-version "2.6.3">
<!ENTITY expat-version "2.0.1">
<!ENTITY libesmtp-version "1.0.4">
<!ENTITY aspell-version "0.60.5">
<!ENTITY aspell-version "0.60.6">
<!ENTITY slib-version "3a4">
<!ENTITY gwrap-version "1.3.4">
<!ENTITY LZO-version "2.02">
<!ENTITY libusb-version "0.1.12">
<!ENTITY iso-codes-version "1.2">
<!ENTITY LZO-version "2.03">
<!ENTITY libusb-version "1.0.0">
<!ENTITY libusb-compat-version "0.1.0">
<!ENTITY iso-codes-version "3.5">
<!ENTITY gmime-version "2.2.10">
<!ENTITY libidn-version "0.6.14">
<!ENTITY dbus-glib-version "0.74">
<!ENTITY dbus-python-version "0.82.0">
<!ENTITY dbus-glib-version "0.80">
<!ENTITY dbus-python-version "0.83.0">
<!ENTITY dbus-qt3-version "0.62">
<!ENTITY libpthread-stubs-version "0.1">
<!ENTITY pth-version "2.0.7">
<!ENTITY libassuan-version "1.0.4">
<!ENTITY libgpg-error-version "1.5">
<!ENTITY libgcrypt-version "1.2.4">
<!ENTITY libgpg-error-version "1.7">
<!ENTITY libgcrypt-version "1.4.4">
<!ENTITY libksba-version "1.0.2">
<!ENTITY Mowgli-version "0.6.1">
<!ENTITY mcs-version "0.7.0">
<!ENTITY libmowgli-version "0.7.0">
<!ENTITY libmcs-version "0.7.1">
 
<!-- Obsolete
<!ENTITY fam-version "2.7.0">
143,21 → 146,23
 
<!-- Chapter 9 -->
<!ENTITY libjpeg-version "6b">
<!ENTITY libpng-version "1.2.29">
<!ENTITY libpng-version "1.2.35">
<!ENTITY libtiff-version "3.8.2">
<!ENTITY giflib-version "4.1.4">
<!ENTITY lcms-version "1.16">
<!ENTITY libmng-version "1.0.9">
<!ENTITY freetype2-version "2.3.7">
<!ENTITY fontconfig-version "2.4.2">
<!ENTITY libart_lgpl-version "2.3.19">
<!ENTITY giflib-version "4.1.6">
<!ENTITY lcms-version "1.17">
<!ENTITY libmng-version "1.0.10">
<!ENTITY freetype2-version "2.3.9">
<!ENTITY fontconfig-version "2.6.0">
<!ENTITY libart_lgpl-version "2.3.20">
<!ENTITY librsvg-version "2.16.1">
<!-- <!ENTITY imlib-version "1.9.15"> -->
<!ENTITY aalib-version "1.4rc5">
<!ENTITY imlib2-version "1.4.0">
<!ENTITY imlib2-version "1.4.2">
<!ENTITY libexif-version "0.6.16">
<!ENTITY fribidi-version "0.10.8">
<!ENTITY poppler-version "0.5.4">
<!ENTITY fribidi-version "0.10.9">
<!ENTITY poppler-version "0.10.1">
<!ENTITY jasper-version "1.900.1">
<!ENTITY pixman-version "0.14.0">
 
<!-- Obsolete
<!ENTITY libungif-version "4.1.3">
169,9 → 174,9
<!ENTITY compface-version "1.5.2">
<!ENTITY imagemagick-version "6.3.5">
<!ENTITY hd2u-version "1.0.1">
<!ENTITY gtk-doc-version "1.8">
<!ENTITY gtk-doc-version "1.11">
<!ENTITY scrollkeeper-version "0.3.14">
<!ENTITY intltool-version "0.35.5">
<!ENTITY intltool-version "0.40.6">
<!ENTITY screen-version "4.0.3">
<!ENTITY tidy-version "cvs_20070326">
<!ENTITY desktop-file-utils-version "0.13">
181,32 → 186,34
<!ENTITY graphviz-version "2.12">
<!ENTITY recode-version "3.6">
<!ENTITY xterm-version "231">
<!ENTITY icon-naming-utils-version "0.8.2">
<!ENTITY rxvt-unicode-version "9.02">
<!ENTITY icon-naming-utils-version "0.8.7">
<!ENTITY rxvt-unicode-version "9.06">
<!ENTITY pinentry-version "0.7.3">
<!ENTITY gperf-version "3.0.3">
 
<!-- Chapter 11 -->
<!ENTITY gpm-version "1.20.5">
<!ENTITY gpm-version "1.20.6">
<!ENTITY fcron-version "3.0.4">
<!ENTITY hdparm-version "7.7">
<!ENTITY hdparm-version "9.6">
<!ENTITY which-version "2.20">
<!ENTITY unzip-version "5.52">
<!ENTITY zip-version "2.32">
<!ENTITY pciutils-version "2.2.3">
<!ENTITY usbutils-version "0.72">
<!ENTITY zip-version "3.0">
<!ENTITY pciutils-version "3.0.3">
<!ENTITY usbutils-version "0.73">
<!ENTITY pkgconfig-version "0.23">
<!ENTITY cpio-version "2.9">
<!ENTITY mc-version "4.6.1">
<!ENTITY sysstat-version "7.0.4">
<!ENTITY apache-ant-version "1.7.0">
<!ENTITY dbus-version "1.0.2">
<!ENTITY sysstat-version "8.0.4.1">
<!ENTITY apache-ant-version "1.7.1">
<!ENTITY dbus-version "1.2.12">
<!ENTITY hal-version "0.5.9.1">
<!ENTITY unrar-version "3.7.8">
<!ENTITY lzma-utils-version "4.32.7">
 
 
<!-- Chapter 12 -->
<!ENTITY dejagnu-version "1.4.4">
<!ENTITY doxygen-version "1.5.2">
<!ENTITY doxygen-version "1.5.9">
<!ENTITY expect-version "5.43.0">
<!ENTITY gc-version "6.8">
<!ENTITY gcc-version "4.1.2">
218,11 → 225,11
<!ENTITY NASM-version "0.98.39">
<!ENTITY pdl-version "2.4.2">
<!ENTITY php-version "5.2.3">
<!ENTITY Python-version "2.5.2">
<!ENTITY python-majorver "2.5">
<!ENTITY ruby-version "1.8.6-p111">
<!ENTITY tcl-version "8.4.18">
<!ENTITY tk-version "8.4.18">
<!ENTITY Python-version "2.6.1">
<!ENTITY python-majorver "2.6">
<!ENTITY ruby-version "1.8.7-p72">
<!ENTITY tcl-version "8.5.6">
<!ENTITY tk-version "8.5.6">
 
<!-- Perl module versions used in the Perl Modules instructions -->
<!ENTITY Algorithm-Diff-version "1.1902">
321,13 → 328,13
 
<!-- Chapter 14 -->
<!ENTITY dhcp-version "3.0.6">
<!ENTITY dhcpcd-version "3.0.19">
<!ENTITY dhcpcd-version "4.0.11">
 
<!-- Chapter 15 -->
<!ENTITY pppoe-version "3.8">
 
<!-- Chapter 16 -->
<!ENTITY curl-version "7.19.0">
<!ENTITY curl-version "7.19.2">
<!ENTITY wvstreams-version "4.2.2">
<!ENTITY gnet-version "2.0.7">
<!ENTITY libsoup-version "2.2.100">
339,7 → 346,7
<!ENTITY w3m-version "0.5.2">
 
<!-- Chapter 18 -->
<!ENTITY cvs-version "1.11.22">
<!ENTITY cvs-version "1.11.23">
<!ENTITY inetutils-version "1.5">
<!ENTITY ncftp-version "3.2.1">
<!-- <!ENTITY ncpfs-version "2.2.4"> -->
346,16 → 353,16
<!ENTITY net-tools-version "1.60">
<!ENTITY wireless-tools-version "28">
<!ENTITY ntp-version "4.2.4p5">
<!ENTITY openssh-version "4.7p1">
<!ENTITY openssh-version "5.1p1">
<!ENTITY portmap-version "6.0">
<!ENTITY rsync-version "3.0.2">
<!ENTITY samba3-version "3.0.30">
<!ENTITY subversion-version "1.4.4">
<!ENTITY subversion-version "1.5.4">
<!ENTITY tcpwrappers-version "7.6">
<!ENTITY wget-version "1.11.4">
 
<!-- Chapter 19 -->
<!ENTITY traceroute-version "1.4a12">
<!ENTITY traceroute-version "2.0.12">
<!ENTITY nmap-version "4.20">
<!ENTITY whois-version "4.7.28">
<!ENTITY bind-version "9.4.1-P1">
362,10 → 369,10
<!ENTITY wireshark-version "0.99.6">
 
<!-- Chapter 20 -->
<!ENTITY mailx-version "12.2">
<!ENTITY mailx-version "12.4">
<!ENTITY procmail-version "3.22">
<!ENTITY fetchmail-version "6.3.8">
<!ENTITY mutt-version "1.5.18">
<!ENTITY fetchmail-version "6.3.9">
<!ENTITY mutt-version "1.5.20">
<!ENTITY pine-version "4.64">
<!ENTITY tin-version "1.8.3">
 
375,7 → 382,7
 
<!-- Part VI -->
<!-- Chapter 21 -->
<!ENTITY apache-version "2.2.8">
<!ENTITY apache-version "2.2.11">
<!-- bind (chapter 19) -->
<!ENTITY nfs-utils-version "1.1.4">
<!-- openssh (chapter 18) -->
394,7 → 401,7
<!-- Chapter 23 -->
 
<!ENTITY db-version "4.5.20">
<!ENTITY mysql-version "5.0.41">
<!ENTITY mysql-version "5.1.30">
<!ENTITY postgresql-version "8.2.4">
 
<!-- Chapter 24 -->
409,18 → 416,19
<!-- Part VII -->
<!-- Chapter 25 -->
<!ENTITY xfree86-version "4.6.0">
<!ENTITY xorg7-version "7.2">
<!ENTITY libXau-version "1.0.3">
<!ENTITY xorg7-version "7.4">
<!ENTITY libXau-version "1.0.4">
<!ENTITY libXdmcp-version "1.0.2">
<!ENTITY luit-version "1.0.2">
<!ENTITY xcb-proto-version "1.0">
<!ENTITY libxcb-version "1.0">
<!ENTITY luit-version "1.0.3">
<!ENTITY xcb-proto-version "1.1">
<!ENTITY libxcb-version "1.1">
<!ENTITY xcb-util-version "0.3.0">
<!ENTITY xcursor-themes-version "1.0.1">
<!ENTITY xkeyboard-config-version "1.2">
<!ENTITY xkeyboard-config-version "1.4">
<!ENTITY xbitmaps-version "1.0.1">
<!ENTITY xorg-server-version "1.2.0">
<!ENTITY libdrm-version "2.3.0">
<!ENTITY mesalib-version "6.5.2">
<!ENTITY xorg-server-version "1.5.3">
<!ENTITY libdrm-version "2.3.1">
<!ENTITY mesalib-version "7.2">
<!ENTITY rman-version "3.2">
 
<!-- Obsolete
429,21 → 437,23
 
<!-- Chapter 26 -->
<!ENTITY qt-version "3.3.8b">
<!ENTITY qt4-version "4.3.4">
<!ENTITY qt4-version "4.4.3">
<!ENTITY GTK-version "1.2.10">
<!ENTITY cairo-version "1.4.14">
<!ENTITY pango-version "1.16.4">
<!ENTITY atk-version "1.18.0">
<!ENTITY gtk2-version "2.10.13">
<!ENTITY cairo-version "1.8.4">
<!ENTITY pango-version "1.22.2">
<!ENTITY atk-version "1.24.0">
<!ENTITY gtk2-version "2.14.4">
<!ENTITY gtk2-libdir "2.0/2.10.0">
<!ENTITY lesstif-version "0.95.0">
<!ENTITY startup-notification-version "0.9">
<!ENTITY libwnck-version "2.18.3">
<!ENTITY shared-mime-info-version "0.21">
<!ENTITY shared-mime-info-version "0.23">
<!ENTITY hicolor-icon-theme-version "0.10">
<!ENTITY libxklavier-version "3.2">
<!ENTITY freeglut-version "2.4.0">
<!ENTITY goffice-version "0.6.1">
<!-- The xulrunner version also appears in the firefox mozconfig as a literal -->
<!ENTITY xulrunner-version "1.9.0.7">
 
<!-- Chapter 27 -->
<!ENTITY sawfish-version "1.3">
453,15 → 463,15
 
<!-- Part VIII -->
<!-- Chapter 28 & 29 -->
<!ENTITY kde-version "3.5.9">
<!ENTITY arts-version "1.5.9">
<!ENTITY kde-dldir "3.5.9">
<!ENTITY kde-version "3.5.10">
<!ENTITY arts-version "1.5.10">
<!ENTITY kde-dldir "3.5.10">
<!ENTITY kde-download-http "http://mirrors.isc.org/pub/kde/stable/&kde-dldir;/src">
<!ENTITY kde-download-ftp "ftp://ftp.kde.org/pub/kde/stable/&kde-dldir;/src">
<!ENTITY kde-dir "$KDE_PREFIX">
 
<!-- Chapter 30 -->
<!ENTITY kdevelop-version "3.5.1">
<!ENTITY kdevelop-version "3.5.4">
 
<!-- Part IX -->
<!ENTITY gnome-version "2.18">
597,7 → 607,7
 
<!-- Chapter 36 -->
<!ENTITY seamonkey-version "1.1.9">
<!ENTITY firefox-version "2.0.0.15">
<!ENTITY firefox-version "3.0.7">
<!ENTITY galeon-version "2.0.1">
<!-- <!ENTITY dillo-version "0.8.5"> removed -->
 
610,24 → 620,24
 
<!-- Part XI -->
<!-- Chapter 38 -->
<!ENTITY alsa-version "1.0.13">
<!ENTITY alsa-version "1.0.18">
<!ENTITY alsa-lib-version "&alsa-version;">
<!ENTITY alsa-plugins-version "&alsa-version;">
<!ENTITY alsa-utils-version "&alsa-version;">
<!ENTITY alsa-tools-version "&alsa-version;">
<!ENTITY alsa-firmware-version "&alsa-version;">
<!ENTITY alsa-oss-version "1.0.12">
<!ENTITY alsa-firmware-version "1.0.17">
<!ENTITY alsa-oss-version "1.0.17">
<!ENTITY alsa-download-http "http://gd.tuwien.ac.at/opsys/linux/alsa">
<!ENTITY alsa-download-ftp "ftp://ftp.alsa-project.org/pub">
<!ENTITY audiofile-version "0.2.6">
<!ENTITY esound-version "0.2.37">
<!ENTITY sdl-version "1.2.11">
<!ENTITY esound-version "0.2.40">
<!ENTITY sdl-version "1.2.13">
<!ENTITY libao-version "0.8.8">
<!ENTITY libogg-version "1.1.3">
<!ENTITY libvorbis-version "1.2.0">
<!ENTITY faad2-version "2.6.1">
<!ENTITY faac-version "1.26">
<!ENTITY nas-version "1.9">
<!ENTITY nas-version "1.9.1">
<!ENTITY libmpeg3-version "1.7">
<!ENTITY libmad-version "0.15.1b">
<!ENTITY libquicktime-version "1.0.0">
635,19 → 645,20
<!ENTITY speex-version "1.0.5">
<!ENTITY id3lib-version "3.8.3">
<!ENTITY flac-version "1.2.1">
<!ENTITY libdvdcss-version "1.2.9">
<!ENTITY libdvdcss-version "1.2.10">
<!ENTITY libdvdread-version "0.9.7">
<!ENTITY libdv-version "1.0.0">
<!ENTITY liba52-version "0.7.4">
<!ENTITY xvid-version "1.1.3">
<!ENTITY xine-lib-version "1.1.12">
<!ENTITY xvid-version "1.2.2">
<!ENTITY xine-lib-version "1.1.15">
<!ENTITY libmikmod-version "3.1.11">
<!ENTITY gstreamer-version "0.10.13">
<!ENTITY gst-plugins-base-version "0.10.13">
<!ENTITY gst-plugins-good-version "0.10.6">
<!ENTITY gst-plugins-ugly-version "0.10.6">
<!ENTITY gstreamer-version "0.10.21">
<!ENTITY gst-plugins-base-version "0.10.21">
<!ENTITY gst-plugins-good-version "0.10.11">
<!ENTITY gst-plugins-ugly-version "0.10.10">
<!ENTITY libmusicbrainz-version "2.1.5">
<!ENTITY libmpeg2-version "0.4.1">
<!ENTITY libtheora-version "1.0">
 
<!-- Obsolete
<!ENTITY openquicktime-version "1.0">
655,13 → 666,13
-->
 
<!-- Chapter 39 -->
<!ENTITY mpg123-version "1.4.2">
<!ENTITY mpg123-version "1.5.1">
<!ENTITY vorbistools-version "1.2.0">
<!ENTITY XMMS-version "1.2.10">
<!ENTITY lame-version "3.97">
<!ENTITY CDParanoia-version "III-9.8">
<!ENTITY lame-version "398-2">
<!ENTITY CDParanoia-version "III-10.2">
<!ENTITY freetts-version "1.2.1">
<!ENTITY audacious-version "1.3.2">
<!ENTITY audacious-version "1.5.1">
<!ENTITY amarok-version "1.4.8">
 
<!-- Chapter 40 -->
675,7 → 686,7
<!ENTITY cdrtools-version "2.01">
<!ENTITY cdrdao-version "1.2.2">
<!ENTITY udftools-version "1.0.0b3">
<!ENTITY dvd-rw-tools-version "7.0">
<!ENTITY dvd-rw-tools-version "7.1">
<!ENTITY k3b-version "1.0.4">
 
<!-- Part XII -->
691,7 → 702,7
-->
 
<!-- Chapter 43 -->
<!ENTITY sane-version "1.0.18">
<!ENTITY sane-version "1.0.19">
<!ENTITY xsane-version "0.994">
 
<!-- Chapter 44 -->
713,7 → 724,7
<!ENTITY psutils-version "p17">
<!ENTITY gsview-version "4.8">
<!ENTITY xpdf-version "3.02">
<!ENTITY fop-version "0.93">
<!ENTITY fop-version "0.95">
<!ENTITY paps-version "0.6.8">
 
<!-- Chapter 47 -->
/trunk/blfs/INSTALL
1,5 → 1,5
$LastChangedBy: bdubbs $
$Date: 2008-11-16 21:27:59 $
$Date: 2008-03-08 05:55:43 +0100 (sam, 08 mar 2008) $
 
 
Ok, so you have downloaded the XML source. Now what? You are probably
/trunk/blfs/index.xml
4,7 → 4,7
 
<!--
$LastChangedBy: bdubbs $
$Date: 2008-11-16 21:28:00 $
$Date: 2008-05-28 20:11:38 +0200 (mer, 28 mai 2008) $
-->
 
<book>
/trunk/blfs/x/installing/xfree86.xml
File deleted
/trunk/blfs/x/installing/xmono-dummy.xml
File deleted
/trunk/blfs/x/installing/x7data.xml
File deleted
/trunk/blfs/x/installing/xorg.xml
File deleted
/trunk/blfs/x/installing/xcb-util.xml
0,0 → 1,124
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY xcb-util-download-http "http://xcb.freedesktop.org/dist/xcb-util-&xcb-util-version;.tar.bz2">
<!ENTITY xcb-util-download-ftp " ">
<!ENTITY xcb-util-md5sum "5f2188492a7d12142d83f73cf0054c59">
<!ENTITY xcb-util-size "264 KB">
<!ENTITY xcb-util-buildsize "4.3 MB">
<!ENTITY xcb-util-time "less than 0.1 SBU">
]>
 
<sect1 id="xcb-util" xreflabel="xcb-util-&xcb-util-version;">
<?dbhtml filename="xcb-util.html"?>
 
<sect1info>
<othername>$LastChangedBy: dj $</othername>
<date>$Date: 2008-12-04 13:09:33 +0100 (jeu 04 déc 2008) $</date>
</sect1info>
 
<title>xcb-util-&xcb-util-version;</title>
 
<indexterm zone="xcb-util">
<primary sortas="a-xcb-util">xcb-util</primary>
</indexterm>
 
<sect2 role="package">
<title>Introduction to xcb-util</title>
 
<para>The <application>xcb-util</application> package provides additional
extensions to the <application>XCB</application> library, many that were
previously found in <application>Xlib</application>, but are not part of
core X protocol.</para>
 
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&xcb-util-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&xcb-util-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &xcb-util-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &xcb-util-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &xcb-util-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &xcb-util-time;</para>
</listitem>
</itemizedlist>
 
<bridgehead renderas="sect3">xcb-util Dependencies</bridgehead>
 
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="libxcb"/> and
<xref linkend="gperf"/></para>
 
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/xcb-util"/></para>
 
</sect2>
 
<sect2 role="installation">
<title>Installation of xcb-util</title>
 
<para>Install <application>xcb-util</application> by running the following
commands:</para>
 
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
 
<para>To test the results, issue: <command>make check</command>.</para>
 
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
<screen role="root"><userinput>make install</userinput></screen>
 
</sect2>
 
<sect2 role="content">
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
 
<seglistitem>
<seg>None</seg>
<seg>libxcb-atom.{a,so}, libxcb-aux.{a,so}, libxcb-event.{a,so},
libxcb-icccm.{a,so}, libxcb-image.{a,so}, libxcb-keysyms.{a,so},
libxcb-property.{a,so}, libxcb-render-util.{a,so}, libxcb-reply.{a,so},
and libxcb-wm.{a,so}</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<!--
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
 
<varlistentry id="xcb-util-libs">
<term><filename class='libraryfile'>libxcb-*.{so,a}</filename></term>
<listitem>
<para>.</para>
<indexterm zone="xcb-util xcb-util-libs">
<primary sortas="c-xcb-util">libxcb-*.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
-->
</sect2>
 
</sect1>
/trunk/blfs/x/lib/xulrunner.xml
0,0 → 1,380
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY xulrunner-download-http "http://releases.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;-source.tar.bz2">
<!ENTITY xulrunner-download-ftp "ftp://ftp.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;-source.tar.bz2">
<!-- md5sum and size should match firefox, but the buildize and time will differ -->
<!ENTITY xulrunner-md5sum "9875c9237b532009df8e91c3785539a3">
<!ENTITY xulrunner-size "35.3 MB">
<!ENTITY xulrunner-buildsize "663 MB">
<!ENTITY xulrunner-time "13.2 SBU">
]>
 
<sect1 id="xulrunner" xreflabel="Xulrunner-&xulrunner-version;">
<?dbhtml filename="xulrunner.html" ?>
 
<sect1info>
<othername>$LastChangedBy: ken $</othername>
<date>$Date: 2009-03-12 14:37:30 +0100 (jeu 12 mar 2009) $</date>
</sect1info>
 
<title>Xulrunner-&xulrunner-version;</title>
 
<indexterm zone="xulrunner">
<primary sortas="a-Xulrunner">Xulrunner</primary>
</indexterm>
 
<sect2 role="package">
<title>Introduction to Xulrunner</title>
 
<para><application>Xulrunner</application> is a runtime environment for XUL
applications, and forms the major part of the <application>Mozilla</application>
codebase. In particular, it provides the gecko engine together with pkgconfig
files so that applications such as <application>Epiphany</application> and
<application>Yelp</application> can use it.</para>
 
<note>
<para>If you later build a newer version of <application>xulrunner</application>
to pick up the latest security fixes, you <emphasis>must</emphasis> update the
symlinks (including for nss, nspr if you are using the versions in
<application>xulrunner</application>) and rebuild every application which uses
gecko, including upgrading <application>firefox</application> if you have installed
that.</para>
</note>
 
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&xulrunner-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&xulrunner-download-ftp;"/></para>
<tip><para>When a new version of <application>firefox</application> is
released, sometimes a corresponding new version of
<application>xulrunner</application> appears at the same time. At other
times it appears several days later or not at all. So far in the
<application>firefox-3.0</application> series, every new release has
created xulrunner libraries with a corresponding new version. Whenever
a separate xulrunner tarball has been released, it has been bitwise
identical to the corresponding firefox tarball. So, we will use the
<application>firefox</application> tarball to save downloading this
large package twice.</para></tip>
</listitem>
<listitem>
<para>Download MD5 sum: &xulrunner-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &xulrunner-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &xulrunner-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &xulrunner-time;</para>
</listitem>
</itemizedlist>
 
<bridgehead renderas="sect3">Xulrunner Dependencies</bridgehead>
 
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="gtk2"/>,
<xref linkend="libidl"/>
<xref linkend="pango"/>
<xref linkend="python"/>, and
<xref linkend="zip"/></para>
 
<para>Note: <application>libjpeg</application> should have been installed
before <application>GTK+</application> and should exist on your system. If
for some reason you haven't installed <application>libjpeg</application>,
you should remove the <option>--with-system-jpeg</option> option from the
<filename>.mozconfig</filename> file created below.</para>
 
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="dbus-glib"/>,
<xref linkend="doxygen"/>,
<xref linkend="curl"/> (only for crash-reporter),
<xref linkend="gnome-vfs"/> and <xref linkend="libgnomeui"/>
(for gnome integration),
<xref linkend="lcms"/>,
<xref linkend="libpng"/> (patched for apng support),
<ulink url="http://sqlite.org/">SQLite</ulink>,
<xref linkend="startup-notification"/>.
<xref linkend="unzip"/>,
<ulink url="http://www.valgrind.org/">Valgrind</ulink> (only for testing the
jemalloc code), and
<xref linkend="wget"/></para>
 
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/xulrunner"/></para>
 
</sect2>
 
<sect2 role="installation">
<title>Installation of Xulrunner</title>
 
<!-- FIXME : I assume current OOo can't use xulrunner ?
lines near the bottom of the file. If you are going to build the
<application>OpenOffice</application> package and you want to use this
<application>Xulrunner</application> installation as the default
<application>Mozilla</application> source, ensure you uncomment the
+ substitutions to stop the comment breaking the syntax
<option>++enable-ldap+/option+ option in the file created below. -->
<para>The configuration of <application>Xulrunner</application> is
accomplished by creating a <filename>.mozconfig</filename> file containing
the desired configuration options. A default <filename>.mozconfig</filename>
is created below. To see the entire list of available configuration options
(and an abbreviated description of each one), issue
<command>./configure --help</command>. If you are going to use
system-installed versions of the <application>NSS</application> and
<application>NSPR</application> libraries, ensure you uncomment the two
lines near the bottom of the file.
You should review the entire file and comment or uncomment options as
necessary. If you would prefer to download the file instead of creating
it by typing or cut-and-pasting, you can find it at <ulink
url="&files-anduin;/xulrunner-&xulrunner-version;-mozconfig"/>
(the file must be installed in the root of the source tree
<filename class='directory'>mozilla</filename> directory, and named
<filename>.mozconfig</filename>).</para>
 
<screen><?dbfo keep-together="auto"?><userinput>cat &gt; .mozconfig &lt;&lt; "EOF"
<literal># This file contains the options used in the Xulrunner build. You may
# need to specify additional options for your specific build needs.
# Use the information provided by running './configure --help' to
# help you determine if you need to add any additional options.
# Some additional options can be added by uncommenting the examples
# in this file or adding options by inserting a line containing
# 'ac_add_options --some-option-you-need'. Be aware that some accepted
# options, such as '--with-system-bz2', do not affect the build.
 
# specify that we want to build xulrunner
ac_add_options --enable-application=xulrunner
 
# Create an object directory and specify to build the package in that
# directory. If desired, modify the location of the object directory
# to a directory inside the source tree by removing '../' from the
# line below.
mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/../xulrunner-build
 
# Specify the installation prefix. If you would prefer Xulrunner
# installed in a different prefix, modify the line below to fit
# your needs (the config will always be written to /etc/gre.d)
ac_add_options --prefix=/usr
 
# apply a minimal level of optimization (-O)
ac_add_options --enable-optimize
 
# These options are used so that the Xulrunner binaries are linked to
# the system-installed copies of the specified libraries instead of
# the source tree code which may not be the most recent versions (or,
# for cairo, may contain additional patches) : with the exception of
# libsqlite3, the libraries are statically linked - using the shipped
# version of libsqlite3 has bee n reported to cause problems with other
# applications which were using sqlite3.
 
# (the --enable-system options)
# comment this if you want to use whatever patched version of cairo
# is in the shipped mozilla tree, together with the system headers.
ac_add_options --enable-system-cairo
 
# comment this if you have not installed lcms
ac_add_options --enable-system-lcms
 
# comment this if you have not installed sqlite
ac_add_options --enable-system-sqlite
 
# (the --with-system options)
# comment this if you did not build libjpeg before gtk+-2
ac_add_options --with-system-jpeg
 
# These two options enable support for building Xulrunner with
# system-installed versions of the Network Security Services (NSS)
# and Netscape Portable Runtime (NSPR) libraries. Uncomment both
# lines to enable support for system-installed NSS/NSPR instead of
# building the versions shipped with xulrunner.
#ac_add_options --with-system-nspr
#ac_add_options --with-system-nss
 
# comment this if you have not built png with the apng patch
ac_add_options --with-system-png
 
# The pthreads option is only used when building nspr
# so you can comment this if you enable --with-system-nspr
ac_add_options --with-pthreads
 
# zlib is in LFS
ac_add_options --with-system-zlib
 
# (options to disable parts of the package)
# This option is used to disable the a11y support in the Xulrunner
# binaries. Comment out this option if you require a11y support.
ac_add_options --disable-accessibility
 
# uncomment this if you did not build curl
#ac_add_options --disable-crashreporter
 
# comment this if you have built dbus-glib
ac_add_options --disable-dbus
 
# comment this if you have gnome-vfs and libgnomeui, and wish to
# integrate xulrunner into your gnome desktop
ac_add_options --disable-gnomevfs
 
# This option is added so that the Mozilla Installer program is not
# built or installed. The program is not required for a BLFS
# installation of Xulrunner.
ac_add_options --disable-installer
 
# If you enable javaxpcom, you must have a java compiler installed.
ac_add_options --disable-javaxpcom
 
# mochitest often causes problems
ac_add_options --disable-mochitest
 
# This option is added so that test libraries and programs are not
# built. These would only be required for debugging purposes.
ac_add_options --disable-tests
 
# Disable the updater, which is not appropriate if you build from source
ac_add_options --disable-updater
 
# (options to add extra parts of the package)
# This option is used to enable source tree included LDAP support in
# the Xulrunner binaries.
###################################################################
#
# NOTE: You must uncomment this option if there is any chance of
# compiling the OpenOffice package from source code using this copy
# of Xulrunner for your Mozilla support.
# This has NOT been tested, current versions of OpenOffice are
# assumed not to compile against this version of xulrunner!
#
###################################################################
#ac_add_options --enable-ldap
 
# Use the anti-phishing measures (a blacklist of sites)
ac_add_options --enable-safe-browsing
 
# This option is used so that the debugging symbols are removed from
# the installed binaries during the installation process. Comment out
# this option if you may have a need to retain the debugging symbols
# in the installed binaries (the resulting binaries will be about 7MB
# bigger).
ac_add_options --enable-strip
 
# Uncomment this option if you desire support for dual-monitor
# display using the X-Window Xinerama libraries.
#ac_add_options --enable-xinerama
 
# ('with' options)
# This option identifies the default binary directory of the Xulrunner
# installation and is used to locate Xulrunner's installed files. This
# option is not required for end-user browsing, and is only used for
# development purposes.
#ac_add_options --with-default-mozilla-five-home=/usr/lib/xulrunner-&xulrunner-version;</literal>
 
EOF</userinput></screen>
 
<para>Compile <application>Xulrunner</application> by issuing the
following commands:</para>
 
<screen><userinput>echo "Requires: nspr" >>xulrunner/installer/libxul-embedding.pc.in &amp;&amp;
make -f client.mk build</userinput></screen>
 
<para>This package does not come with a test suite.</para>
 
<para>Now, as the <systemitem class="username">root</systemitem> user,
install the package:</para>
 
<screen role="root"><userinput>make -f client.mk install &amp;&amp;
for DL in \
libnss3.so libnssutil3.so libsmime3.so libssl3.so libsoftokn3.so \
libplds4.so libplc4.so libnspr4.so ; do
ln -sv xulrunner-&xulrunner-version;/$DL /usr/lib/$DL
done &amp;&amp;
ln -sv mozilla-nspr.pc /usr/lib/pkgconfig/nspr.pc &amp;&amp;
mkdir /usr/lib/mozilla &amp;&amp;
ln -sv /usr/lib/xulrunner-&xulrunner-version;/plugins /usr/lib/mozilla/plugins</userinput></screen>
 
</sect2>
 
<sect2 role="commands">
<title>Command Explanations</title>
 
<para><command>echo "Requires: nspr" >>xulrunner/installer/libxul-embedding.pc.in</command>
: If you try to build <application>Yelp</application> without this, the
prtypes header from nspr will not be found. It is arguable whose error this
is (the code presumably works on earlier geckos), but this fix is unlikely
to cause any damage in other packages.</para>
 
<para><command>make -f client.mk ...</command>: Mozilla products are
packaged to allow the use of a configuration file which can be used to
pass the configuration settings to the <command>configure</command>
command. <command>make</command> uses the <filename>client.mk</filename>
file to get initial configuration and setup parameters, then depending on
the target parameter (<parameter>build</parameter> or
<parameter>install</parameter>), either runs the
<command>configure</command> script and compiles the package or installs
the package.</para>
 
<para><command>for DL in ...</command>: The nspr and nss libraries shipped
with this package are installed into /usr/lib/xulrunner-&xulrunner-version;
which means they will not be found at runtime. By using symbolic links from
<filename class="directory">/usr/lib</filename> they will be found and we can
easily change the links to point to a newer version when we upgrade.</para>
 
<para><command>ln -sv /usr/lib/xulrunner-&xulrunner-version;/plugins
/usr/lib/mozilla/plugins</command>: Some packages will install browser plugins
into /usr/lib/mozilla/plugins. By creating this as a symlink to the basic
plugins we keep them all together.</para>
 
<tip>
<para>When you upgrade xulrunner, remember to update the symlinks and to
copy any additional plugins compiled agaisnt this series of xulrunner to the
new plugin directory.</para>
</tip>
 
</sect2>
 
<sect2 role="content">
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
 
<seglistitem>
<seg>xulrunner</seg>
<seg>Numerous libraries, browser components, plugins, extensions, and
helper modules installed in <filename
class='directory'>/usr/lib/xulrunner-&xulrunner-version;</filename></seg>
<seg>/etc/gre.d, /usr/include/xulrunner-&xulrunner-version;,
/usr/lib/xulrunner-&xulrunner-version;, and
/usr/lib/xulrunner-devel-&xulrunner-version;</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
 
<varlistentry id="xulrunner-prog">
<term><command>xulrunner</command></term>
<listitem>
<para>is a shell script, useful for identifying the version
installed.</para>
<indexterm zone="xulrunner xulrunner-prog">
<primary sortas="b-xulrunner">xulrunner</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
/trunk/blfs/x/lib/lib.xml
1,33 → 1,45
<?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" [
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<!--
$LastChangedBy: ken $
$Date: 2009-03-12 14:37:30 +0100 (jeu 12 mar 2009) $
-->
 
<chapter id="x-lib">
<?dbhtml filename="lib.html" ?>
<title>X Libraries</title>
<?dbhtml filename="lib.html" ?>
 
<para>This chapter does not contain libraries that are required to run
<application>X</application>. It does contain libraries that enhance
<application>X</application>. In some cases the enhancement is as simple as
font support. In others it is as complex as libraries that sit between
<application>X</application> and applications that run on
<application>X</application> whose purpose is to standardize the look and feel
and inter-process communications for different applications. They also assist
programmers by supplying common elements.</para>
<title>X Libraries</title>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="qt.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gtk+.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pango.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="atk.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gtk+2.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lesstif.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="startup-notification.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="shared-mime-info.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hicolor-icon-theme.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libxklavier.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="freeglut.xml"/>
<para>This chapter does not contain libraries that are required to run
<application>X</application>. It does contain libraries that enhance
<application>X</application>. In some cases the enhancement is as simple as
font support. In others it is as complex as libraries that sit between
<application>X</application> and applications that run on
<application>X</application> whose purpose is to standardize the look and
feel and inter-process communications for different applications. They also
assist programmers by supplying common elements.</para>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="qt.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="qt4.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gtk+.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="cairo.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pango.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="atk.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gtk+2.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lesstif.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="startup-notification.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libwnck.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="shared-mime-info.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hicolor-icon-theme.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libxklavier.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="freeglut.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="goffice.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mesalib.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xulrunner.xml"/>
 
</chapter>
/trunk/blfs/general/sysutils/lzma-utils.xml
0,0 → 1,246
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY lzma-utils-download-http "http://tukaani.org/lzma/lzma-&lzma-utils-version;.tar.gz">
<!ENTITY lzma-utils-download-ftp "ftp://ftp.openbsd.org/pub/OpenBSD/distfiles/lzma-&lzma-utils-version;.tar.gz">
<!ENTITY lzma-utils-md5sum "2a748b77a2f8c3cbc322dbd0b4c9d06a">
<!ENTITY lzma-utils-size "479 KB">
<!ENTITY lzma-utils-buildsize "6 MB">
<!ENTITY lzma-utils-time "0.2 SBU">
]>
 
<sect1 id="lzma-utils" xreflabel="LZMA-Utils-&lzma-utils-version;">
<?dbhtml filename="lzma-utils.html"?>
 
<sect1info>
<othername>$LastChangedBy: ken $</othername>
<date>$Date: 2009-06-27 12:10:28 +0200 (sam 27 jun 2009) $</date>
</sect1info>
 
<title>LZMA-Utils-&lzma-utils-version;</title>
 
<indexterm zone="lzma-utils">
<primary sortas="a-LZMA-Utils">LZMA-Utils</primary>
</indexterm>
 
<sect2 role="package">
<title>Introduction to LZMA-Utils</title>
 
<para>The <application>LZMA-Utils</application> package contains
compression/decompression tools for files using the LZMA format. This is
useful as more and more Gnu Linux packages are being delivered in the
LZMA format.</para>
 
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&lzma-utils-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&lzma-utils-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &lzma-utils-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &lzma-utils-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &lzma-utils-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &lzma-utils-time;</para>
</listitem>
</itemizedlist>
 
</sect2>
 
<sect2 role="installation">
<title>Installation of LZMA-Utils</title>
 
<para>Install <application>LZMA-Utils</application> by running the
following commands:</para>
 
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
 
<para>To test the results, issue: <command>make check</command>.</para>
 
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
<screen role="root"><userinput>make install</userinput></screen>
 
</sect2>
 
<sect2 role="content">
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
 
<seglistitem>
<seg>lzcat, lzcmp, lzdiff, lzegrep, lzfgrep, lzgrep, lzless, lzma,
lzmadec, lzmainfo, lzmore and unlzma</seg>
<seg>liblzmadec.{so,a}</seg>
<seg>/usr/share/doc/lzma-&lzma-utils-version;</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
 
<varlistentry id="lzcat">
<term><command>lzcat</command></term>
<listitem>
<para>is a symbolic link to <command>lzma</command> used to invoke
<command>lzma</command> with the <parameter>-cd</parameter>
parameter.</para>
<indexterm zone="lzma-utils lzcat">
<primary sortas="b-lzcat">lzcat</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lzcmp">
<term><command>lzcmp</command></term>
<listitem>
<para>is a symbolic link to <command>lzdiff</command></para>
<indexterm zone="lzma-utils lzcmp">
<primary sortas="b-lzcmp">lzcmp</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lzdiff">
<term><command>lzdiff</command></term>
<listitem>
<para>is used to compare LZMA compressed files.</para>
<indexterm zone="lzma-utils lzdiff">
<primary sortas="b-lzdiff">lzdiff</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lzegrep">
<term><command>lzegrep</command></term>
<listitem>
<para>is a symbolic link to <command>lzgrep</command> and uses
<command>egrep</command> instead of <command>grep</command>.</para>
<indexterm zone="lzma-utils lzegrep">
<primary sortas="b-lzegrep">lzegrep</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lzfgrep">
<term><command>lzfgrep</command></term>
<listitem>
<para>is a symbolic link to <command>lzgrep</command> and uses
<command>fgrep</command> instead of <command>grep</command>.</para>
<indexterm zone="lzma-utils lzfgrep">
<primary sortas="b-lzfgrep">lzfgrep</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lzgrep">
<term><command>lzgrep</command></term>
<listitem>
<para>is used to search LZMA compressed files for a regular
expression.</para>
<indexterm zone="lzma-utils lzgrep">
<primary sortas="b-lzgrep">lzgrep</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lzless">
<term><command>lzless</command></term>
<listitem>
<para>is a symbolic link to <command>lzmore</command> which uses
<command>less</command> instead of <command>more</command>.</para>
<indexterm zone="lzma-utils lzless">
<primary sortas="b-lzless">lzless</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lzma">
<term><command>lzma</command></term>
<listitem>
<para>is an LZMA compression and decompression tool.</para>
<indexterm zone="lzma-utils lzma">
<primary sortas="b-lzma">lzma</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lzmadec">
<term><command>lzmadec</command></term>
<listitem>
<para>is a small and fast decoder for LZMA compressed files which
does not provide command-line arguments other than
<parameter>--help</parameter>.</para>
<indexterm zone="lzma-utils lzmadec">
<primary sortas="b-lzmadec">lzmadec</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lzmainfo">
<term><command>lzmainfo</command></term>
<listitem>
<para>is used to show information stored in the LZMA compressed file
header.</para>
<indexterm zone="lzma-utils lzmainfo">
<primary sortas="b-lzmainfo">lzmainfo</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="lzmore">
<term><command>lzmore</command></term>
<listitem>
<para>is a filter which allows examination of LZMA compressed text
files one screenful at a time.</para>
<indexterm zone="lzma-utils lzmore">
<primary sortas="b-lzmore">lzmore</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="unlzma">
<term><command>unlzma</command></term>
<listitem>
<para>is a symbolic link to <command>lzma</command> used to invoke
<command>lzma</command> with the <parameter>-d</parameter>
parameter.</para>
<indexterm zone="lzma-utils unlzma">
<primary sortas="b-unlzma">unlzma</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="liblzmadec">
<term><filename class='libraryfile'>liblzmadec.{so,a}</filename></term>
<listitem>
<para>contains functions to support compression and decompression of
LZMA files.</para>
<indexterm zone="lzma-utils liblzmadec">
<primary sortas="c-liblzmadec">liblzmadec.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
/trunk/blfs/general/genlib/guile.xml
File deleted
/trunk/blfs/general/genlib/libusb-compat.xml
0,0 → 1,122
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY libusb-compat-download-http "&sourceforge-repo;/libusb/libusb-compat-&libusb-compat-version;.tar.bz2">
<!ENTITY libusb-compat-download-ftp "&sources-anduin-ftp;/l/libusb-compat-&libusb-compat-version;.tar.bz2">
<!ENTITY libusb-compat-md5sum "652e1d9e6c6912fd924a5ad204f6d48b">
<!ENTITY libusb-compat-size "248 KB">
<!ENTITY libusb-compat-buildsize "2.0 MB">
<!ENTITY libusb-compat-time "less than 0.1 SBU">
]>
 
<sect1 id="libusb-compat" xreflabel="libusb-compat-&libusb-compat-version;">
<?dbhtml filename="libusb-compat.html"?>
 
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2008-12-29 00:45:33 -0600 (Mon, 29 Dec 2008) $</date>
</sect1info>
 
<title>libusb-compat-&libusb-compat-version;</title>
 
<indexterm zone="libusb-compat">
<primary sortas="a-Libusb-compat">Libusb-compat</primary>
</indexterm>
 
<sect2 role="package">
<title>Introduction to libusb-compat</title>
 
<para>The <application>libusb-compat</application> package aims to look,
feel and behave exactly like libusb-0.1. It is a compatibility layer needed
by packages that have not upgraded to the
<application>libusb-1</application> API.</para>
 
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&libusb-compat-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&libusb-compat-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &libusb-compat-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &libusb-compat-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &libusb-compat-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &libusb-compat-time;</para>
</listitem>
</itemizedlist>
 
<bridgehead renderas="sect3">libusb-compat Dependencies</bridgehead>
 
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="pkgconfig"/> and
<xref linkend="libusb"/></para>
 
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/libusb-compat"/></para>
 
</sect2>
 
<sect2 role="installation">
<title>Installation of libusb-compat</title>
 
<para>Install <application>libusb-compat</application> by running the
following commands:</para>
 
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
 
<para>This package does not come with a test suite.</para>
 
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
<screen role="root"><userinput>make install</userinput></screen>
 
</sect2>
 
<sect2 role="content">
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
 
<seglistitem>
<seg>libusb-config</seg>
<seg>libusb-0.1.so and libusb.a</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
 
<varlistentry id="libusb-compat-lib">
<term><filename class='libraryfile'>libusb.{so,a}</filename></term>
<listitem>
<para>Libraries that are compatible with libusb-0.1, but use
libusb-1.0 to provide functionality.</para>
<indexterm zone="libusb-compat libusb-compat-lib">
<primary sortas="c-libusb-compat">libusb-1.0.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
/trunk/blfs/general/graphlib/jasper.xml
0,0 → 1,228
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY jasper-download-http "http://www.ece.uvic.ca/~mdadams/jasper/software/jasper-&jasper-version;.zip">
<!ENTITY jasper-download-ftp " ">
<!ENTITY jasper-md5sum "a342b2b4495b3e1394e161eb5d85d754">
<!ENTITY jasper-size "1.4 MB">
<!ENTITY jasper-buildsize "11.1 MB (without the static library)">
<!ENTITY jasper-time "0.3 SBU">
]>
 
<sect1 id="jasper" xreflabel="JasPer-&jasper-version;">
<?dbhtml filename="jasper.html"?>
 
<sect1info>
<othername>$LastChangedBy: ken $</othername>
<date>$Date: 2009-01-14 16:16:44 +0100 (mer 14 jan 2009) $</date>
</sect1info>
 
<title>JasPer-&jasper-version;</title>
 
<indexterm zone="jasper">
<primary sortas="a-jasper-&jasper-version;">JasPer</primary>
</indexterm>
 
<sect2 role="package">
<title>Introduction to JasPer</title>
 
<para>The <application>JasPer</application> Project is an open-source
initiative to provide a free software-based reference implementation of the
JPEG-2000 codec.</para>
 
 
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&jasper-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&jasper-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &jasper-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &jasper-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &jasper-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &jasper-time;</para>
</listitem>
</itemizedlist>
 
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Required patch: <ulink
url="&patch-root;/jasper-&jasper-version;-security_fixes-1.patch"/></para>
</listitem>
</itemizedlist>
 
<bridgehead renderas="sect3">JasPer Dependencies</bridgehead>
 
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="unzip"/></para>
 
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="optional"><xref linkend="libjpeg"/>,
<xref linkend="x-window-system"/>, and
<xref linkend="mesalib"/> or <xref linkend="freeglut"/></para>
 
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/jasper"/></para>
 
</sect2>
 
<sect2 role="installation">
<title>Installation of JasPer</title>
 
<note>
<para>The package source is distributed in <filename class="extension">.zip</filename>
format and requires <command>unzip</command>, but it has been correctly packaged
and will create the jasper-&jasper-version; directory when you unzip it.</para>
</note>
 
<screen><userinput>patch -Np1 -i ../jasper-&jasper-version;-security_fixes-1.patch &amp;&amp;
./configure --prefix=/usr --enable-shared &amp;&amp;
make</userinput></screen>
 
<para>This package does not come with a testsuite.</para>
 
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
<screen role="root"><userinput>make install</userinput></screen>
 
<para>If you wish to install the PDF files for the Reference Manual and a
tutorial on the JPEG-2000 standard, run the following commands as the
<systemitem class="username">root</systemitem> user:</para>
 
<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/jasper-&jasper-version; &amp;&amp;
install -v -m644 doc/*.pdf /usr/share/doc/jasper-&jasper-version;</userinput></screen>
 
</sect2>
 
<sect2 role="commands">
<title>Command Explanations</title>
 
<para><command>--enable-shared</command>: This command
causes the shared library to be built.</para>
 
<para><option>--disable-static</option>: This causes the
static library to not be built.</para>
 
<para><option>--x-includes=DIR --x-libraries=DIR</option>: These tell the
<command>configure</command> script where to find <application>Xorg</application>
if it is not in
<filename class='directory'>/usr/X11</filename>,
<filename class='directory'>/usr/X11R6</filename>, or
<filename class='directory'>/usr</filename>.</para>
 
</sect2>
 
<!-- commented because make install has run ldconfig
<sect2 role="configuration">
<title>Configuring JasPer</title>
 
<sect3>
<title>Configuration Information</title>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../../xincludes/lib-config.xml"/>
 
</sect3>
 
</sect2>-->
 
<sect2 role="content">
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
 
<seglistitem>
<seg>imgcmp, imginfo, jasper, jiv, and tmrdemo</seg>
<seg>libjasper.{so,a}</seg>
<seg>/usr/include/jasper and /usr/share/doc/jasper-&jasper-version;</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
 
<varlistentry id="imgcmp">
<term><command>imgcmp</command></term>
<listitem>
<para>compares two images of the same geometry.</para>
<indexterm zone="jasper imgcmp">
<primary sortas="b-imgcmp">imgcmp</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="imginfo">
<term><command>imginfo</command></term>
<listitem>
<para>displays information about an image.</para>
<indexterm zone="jasper imginfo">
<primary sortas="b-imginfo">imginfo</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="jasper-command">
<term><command>jasper</command></term>
<listitem>
<para>converts images between formats (BMP, JPS, JPC, JPG, PGX, PNM, MIF,
and RAS).</para>
<indexterm zone="jasper jasper">
<primary sortas="b-jasper">jasper</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="jiv">
<term><command>jiv</command></term>
<listitem>
<para>displays images.</para>
<indexterm zone="jasper jiv">
<primary sortas="b-jiv">jiv</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="tmrdemo">
<term><command>tmrdemo</command></term>
<listitem>
<para>is a timer demonstration program.</para>
<indexterm zone="jasper tmrdemo">
<primary sortas="b-tmrdemo">tmrdemo</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="jasper-lib">
<term><filename class='libraryfile'>libjasper.{so,a}</filename></term>
<listitem>
<para>a library used by programs for reading and writing
JPEG2000 format files.</para>
<indexterm zone="jasper jasper-lib">
<primary sortas="c-jasper">libjasper.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
/trunk/blfs/general/graphlib/pixman.xml
0,0 → 1,121
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY pixman-download-http "http://cairographics.org/releases/pixman-&pixman-version;.tar.gz">
<!ENTITY pixman-download-ftp " ">
<!ENTITY pixman-md5sum "da330524bbd975271974378b1c5e7b5d">
<!ENTITY pixman-size "468 KB">
<!ENTITY pixman-buildsize "13 MB">
<!ENTITY pixman-time "0.3 SBU">
]>
 
<sect1 id="pixman" xreflabel="pixman-&pixman-version;">
<?dbhtml filename="pixman.html"?>
 
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2009-02-25 04:58:12 +0100 (mer 25 fév 2009) $</date>
</sect1info>
 
<title>pixman-&pixman-version;</title>
 
<indexterm zone="pixman">
<primary sortas="a-pixman">pixman</primary>
</indexterm>
 
<sect2 role="package">
<title>Introduction to pixman</title>
 
<para>The <application>pixman</application> package contains a library that
provides low-level pixel manipulation features such as image compositing
and trapezoid rasterization.</para>
 
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&pixman-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&pixman-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &pixman-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &pixman-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &pixman-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &pixman-time;</para>
</listitem>
</itemizedlist>
 
<bridgehead renderas="sect3">pixman Dependencies</bridgehead>
 
<bridgehead renderas="sect4">Optional (required to run the test suite)</bridgehead>
<para role="optional"><xref linkend="gtk2"/></para>
 
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/pixman"/></para>
 
</sect2>
 
<sect2 role="installation">
<title>Installation of pixman</title>
 
<para>Install <application>pixman</application> by running the following
commands:</para>
 
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
 
<para>To test the results, issue: <command>make check</command>. Note that
<application>GTK+2</application> must be installed.</para>
 
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
<screen role="root"><userinput>make install</userinput></screen>
 
</sect2>
 
<sect2 role="content">
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
 
<seglistitem>
<seg>None</seg>
<seg>libpixman-1.{so,a}</seg>
<seg>/usr/include/pixman-1</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
 
<varlistentry id="libpixman1">
<term><filename class='libraryfile'>libpixman1.{so,a}</filename></term>
<listitem>
<para>contains functions that provide low-level pixel manipulation
features.</para>
<indexterm zone="pixman libpixman1">
<primary sortas="c-libpixman1">libpixman1.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
/trunk/blfs/Makefile
2,7 → 2,7
# By Tushar Teredesai <tushar@linuxfromscratch.org>
# 2004-01-31
# $LastChangedBy: bdubbs $
# $Date: 2008-11-16 21:27:59 $
# $Date: 2008-07-16 19:17:52 +0000 (mer, 16 jui 2008) $
 
# Adjust these to suit your installation
BASEDIR ?= $(HOME)/public_html/blfs-book-xsl