r3370 - in trunk/BOOK: . general/genlib introduction/welcome pst/scanning

randy at linuxfromscratch.org randy at linuxfromscratch.org
Mon Jan 31 12:21:46 PST 2005


Author: randy
Date: 2005-01-31 13:21:45 -0700 (Mon, 31 Jan 2005)
New Revision: 3370

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/genlib/slib.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/pst/scanning/sane.xml
   trunk/BOOK/pst/scanning/xsane.xml
Log:
Updated to XSane-0.97 and added indexing tags to Sane

Modified: trunk/BOOK/general/genlib/slib.xml
===================================================================
--- trunk/BOOK/general/genlib/slib.xml	2005-01-31 15:26:33 UTC (rev 3369)
+++ trunk/BOOK/general/genlib/slib.xml	2005-01-31 20:21:45 UTC (rev 3370)
@@ -102,7 +102,7 @@
 <seglistitem>
 <seg>slib</seg>
 <seg>The <application>SLIB</application> package contains a 
-<application>Scheme</application> library System.</seg>
+<application>Scheme</application> library system.</seg>
 <seg>/usr/share/guile/slib</seg>
 </seglistitem>
 </segmentedlist>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2005-01-31 15:26:33 UTC (rev 3369)
+++ trunk/BOOK/general.ent	2005-01-31 20:21:45 UTC (rev 3370)
@@ -478,7 +478,7 @@
 
 <!-- Chapter 42 --> 
 <!ENTITY sane-version                 "1.0.15"> 
-<!ENTITY xsane-version                "0.95">     
+<!ENTITY xsane-version                "0.97">     
 
 <!-- Chapter 43 --> 
 <!ENTITY sgml-common-version          "0.6.3">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2005-01-31 15:26:33 UTC (rev 3369)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2005-01-31 20:21:45 UTC (rev 3370)
@@ -22,6 +22,9 @@
 
 <itemizedlist>
 
+<listitem><para>January 31st, 2005 [randy]: Updated to 
+XSane-0.97.</para></listitem>
+
 <listitem><para>January 30th, 2005 [dj]: Fixed cracklib_dict_path check
 in Linux_PAM configure.  Added change to 
 Linux-PAM-linkage-2.patch.</para></listitem>

Modified: trunk/BOOK/pst/scanning/sane.xml
===================================================================
--- trunk/BOOK/pst/scanning/sane.xml	2005-01-31 15:26:33 UTC (rev 3369)
+++ trunk/BOOK/pst/scanning/sane.xml	2005-01-31 20:21:45 UTC (rev 3370)
@@ -26,6 +26,8 @@
 </sect1info>
 <?dbhtml filename="sane.html"?>
 <title>SANE-&sane-version;</title>
+<indexterm zone="sane">
+<primary sortas="a-SANE">SANE</primary></indexterm>
 
 <sect2>
 <title>Introduction to 
@@ -94,15 +96,18 @@
 <title>Installation of 
 <application><acronym>SANE</acronym></application></title>
 
-<sect3><title>Preparing your system for scanner access</title>
+<sect3 id="sane-kernel"><title>Preparing your system for scanner access</title>
+<indexterm zone="sane sane-kernel">
+<primary sortas="d-Scanning-devices">Scanning devices</primary></indexterm>
+
 <para>To access your scanner, you will probably need the related kernel
-drivers or additional support packages (<application>libusb</application>). 
+drivers or additional support packages (<xref linkend="libusb"/>). 
 A <acronym>SCSI</acronym> scanner will need <acronym>SCSI</acronym> 
 drivers, a parallel port scanner needs parallel port support (you should use 
 enhanced <acronym>EPP</acronym> modes) and a <acronym>USB</acronym> scanner 
 will need the <application>libusb</application> package and a 
 <acronym>SCSI</acronym> system for emulation. Be sure that you have got the 
-necessary drivers to access the devices.</para>
+necessary drivers configured to access the devices.</para>
 </sect3>
 
 <sect3><title>Installation of 
@@ -112,8 +117,11 @@
 running the following commands:</para>
 
 <screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &&
-make &&
-make install</command></userinput></screen>
+make</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
 </sect3>
 
 <sect3><title>Installation of 
@@ -131,14 +139,17 @@
 use the following commands:</para>
 
 <screen><userinput><command>./configure --prefix=/usr &&
-make &&
-make install</command></userinput></screen>
+make</command></userinput></screen>
 
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
+
 <para>If <application>GIMP</application> was linked into the build and you 
 wish <application>GIMP</application> to use <command>xscanimage</command> as 
-a scanning plugin, issue the following command:</para>
+a scanning plugin, issue the following command as the root user:</para>
 
-<screen><userinput><command>ln -s /usr/bin/xscanimage /usr/lib/gimp/2.0/plug-ins</command></userinput></screen>
+<screen><userinput role='root'><command>ln -s /usr/bin/xscanimage /usr/lib/gimp/2.0/plug-ins</command></userinput></screen>
 </sect3>
 
 </sect2>
@@ -155,8 +166,10 @@
 <sect2>
 <title>Configuring <application><acronym>SANE</acronym></application></title>
 
-<sect3><title>Config files</title>
+<sect3 id="sane-config"><title>Config files</title>
 <para><filename>/etc/sane.d/*.conf</filename></para>
+<indexterm zone="sane sane-config">
+<primary sortas="e-etc-sane.d-conf">/etc/sane.d/*.conf</primary></indexterm>
 </sect3>
 
 <sect3><title>Configuration information</title>
@@ -181,14 +194,14 @@
 
 <sect4><title>Configuration and setup of the <command>saned</command> 
 daemon</title>
-<para>The <command>saned</command> daemon is not meant to be used for untrusted 
-clients. You should provide <application>tcpwrapper</application> and/or 
-firewall protection to insure only trusted clients access the daemon. Due to 
-the complex security requirements to insure only trusted clients access the 
-daemon, <acronym>BLFS</acronym> does not provide instructions to configure the 
-<command>saned</command> daemon. If you desire to make the daemon available, 
-ensure you provide adequate security, configure your 
-<filename>[x]inetd.conf</filename> file and send a 
+<para>The <command>saned</command> daemon is not meant to be used for 
+untrusted clients. You should provide <xref linkend="tcpwrappers"/> and/or 
+<xref linkend="fw-firewall"/> protection to insure only trusted clients access 
+the daemon. Due to the complex security requirements to insure only trusted 
+clients access the daemon, <acronym>BLFS</acronym> does not provide 
+instructions to configure the <command>saned</command> daemon. If you desire 
+to make the daemon available, ensure you provide adequate security, configure 
+your <filename>[x]inetd.conf</filename> file and send a 
 <userinput>SIGHUP</userinput> to the [x]inetd daemon. Some good information for 
 setting up and securing the <command>saned</command> daemon can be found at 
 <ulink url="http://penguin-breeder.org/sane/saned/"/>.</para>
@@ -200,74 +213,136 @@
 <sect2>
 <title>Contents</title>
 
-<sect3><title>Back ends:</title>
-<para>The <application><acronym>SANE</acronym></application>-backends package 
-contains 
-<command>gamma4scanimage</command>, 
-<command>sane-config</command>, 
-<command>saned</command>, 
-<command>sane-find-scanner</command>, 
-<command>scanimage</command>, 
-the <filename class='libraryfile'>libsane</filename> library and 
-numerous scanner backend modules. See 
-<ulink url="http://www.sane-project.org/sane-supported-devices.html"/> 
-for a list of supported backends.</para>
-</sect3>
+<bridgehead renderas="sect4">Back Ends:</bridgehead>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directories</segtitle>
 
-<sect3><title>Front ends:</title>
-<para>The <application><acronym>SANE</acronym></application>-frontends package 
-contains 
-<command>scanadf</command>, 
-<command>xcam</command>, 
-<command>xscanimage</command> and a <application>GIMP</application> plugin 
-imbedded in <command>xscanimage</command>.</para>
-</sect3>
+<seglistitem>
+<seg>gamma4scanimage, sane-config, saned, sane-find-scanner and scanimage</seg>
+<seg>libsane.so and numerous scanner backend modules</seg>
+<seg>/etc/sane.d, /usr/include/sane, /usr/lib/sane, /usr/share/sane and 
+/usr/share/doc/sane-&sane-version;</seg>
+</seglistitem>
+</segmentedlist>
 
-</sect2>
+<bridgehead renderas="sect4">Front Ends:</bridgehead>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Library</segtitle>
+<segtitle>Installed Directory</segtitle>
 
-<sect2>
-<title>Description</title>
+<seglistitem>
+<seg>scanadf, xcam and xscanimage</seg>
+<seg><application>GIMP</application> plugin imbedded in 
+<command>xscanimage</command></seg>
+<seg>/usr/share/sane</seg>
+</seglistitem>
+</segmentedlist>
 
-<sect3><title>gamma4scanimage</title>
-<para><command>gamma4scanimage</command> creates a gamma table in the format 
-expected by <command>scanimage</command>.</para></sect3>
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
 
-<sect3><title>sane-config</title>
-<para><command>sane-config</command> is a tool used to determine the compiler 
-and linker flags that should be used to compile and link 
-<application><acronym>SANE</acronym></application>.</para></sect3>
+<varlistentry id="gamma4scanimage">
+<term><command>gamma4scanimage</command></term>
+<listitem><para>creates a gamma table in the format expected by 
+<command>scanimage</command>.</para>
+<indexterm zone="sane gamma4scanimage">
+<primary sortas="b-gamma4scanimage">gamma4scanimage</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>saned</title>
-<para><command>saned</command> is the 
-<application><acronym>SANE</acronym></application> daemon that allows remote 
-clients to access image acquisition devices available on the local 
-host.</para></sect3>
+<varlistentry id="sane-config-prog">
+<term><command>sane-config</command></term>
+<listitem><para>is a tool used to determine the compiler and linker flags that 
+should be used to compile and link 
+<application><acronym>SANE</acronym></application>.</para>
+<indexterm zone="sane sane-config-prog">
+<primary sortas="b-sane-config">sane-config</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>sane-find-scanner</title>
-<para><command>sane-find-scanner</command> is a command-line tool to find 
-<acronym>SCSI</acronym> and <acronym>USB</acronym> scanners and determine 
-their device files. Its primary aim is to make sure that scanners can be 
-detected by <application><acronym>SANE</acronym></application> 
-backends.</para></sect3>
+<varlistentry id="saned">
+<term><command>saned</command></term>
+<listitem><para>is the <application><acronym>SANE</acronym></application> 
+daemon that allows remote clients to access image acquisition devices 
+available on the local host.</para>
+<indexterm zone="sane saned">
+<primary sortas="b-saned">saned</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>scanadf</title>
-<para><command>scanadf</command> is a command-line interface to control image 
-acquisition devices which are equipped with an automatic document feeder 
-(<acronym>ADF</acronym>).</para></sect3>
+<varlistentry id="sane-find-scanner">
+<term><command>sane-find-scanner</command></term>
+<listitem><para>is a command-line tool to find <acronym>SCSI</acronym> and 
+<acronym>USB</acronym> scanners and determine their device files. Its primary 
+aim is to make sure that scanners can be detected by 
+<application><acronym>SANE</acronym></application> backends.</para>
+<indexterm zone="sane sane-find-scanner">
+<primary sortas="b-sane-find-scanner">sane-find-scanner</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>scanimage</title>
-<para><command>scanimage</command> is a command line interface for scanning 
-from image acquisition devices such as flatbed scanners or cameras. It is 
-also used to list the available backend devices.</para></sect3>
+<varlistentry id="scanadf">
+<term><command>scanadf</command></term>
+<listitem><para>is a command-line interface to control image acquisition 
+devices which are equipped with an automatic document feeder
+(<acronym>ADF</acronym>).</para>
+<indexterm zone="sane scanadf">
+<primary sortas="b-scanadf">scanadf</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>xcam</title>
-<para><command>xcam</command> is a graphical camera front end for 
-<application><acronym>SANE</acronym></application>.</para></sect3>
+<varlistentry id="scanimage">
+<term><command>scanimage</command></term>
+<listitem><para>is a command line interface for scanning from image 
+acquisition devices such as flatbed scanners or cameras. It is also used to 
+list the available backend devices.</para>
+<indexterm zone="sane scanimage">
+<primary sortas="b-scanimage">scanimage</primary>
+</indexterm></listitem>
+</varlistentry>
 
-<sect3><title>xscanimage</title>
-<para><command>xscanimage</command> is a graphical user interface for 
-scanning.</para></sect3>
+<varlistentry id="xcam">
+<term><command>xcam</command></term>
+<listitem><para>is a graphical camera front end for 
+<application><acronym>SANE</acronym></application>.</para>
+<indexterm zone="sane xcam">
+<primary sortas="b-xcam">xcam</primary>
+</indexterm></listitem>
+</varlistentry>
 
+<varlistentry id="xscanimage">
+<term><command>xscanimage</command></term>
+<listitem><para>is a graphical user interface for scanning.</para>
+<indexterm zone="sane xscanimage">
+<primary sortas="b-xscanimage">xscanimage</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="libsane">
+<term><filename class='libraryfile'>libsane.so</filename></term>
+<listitem><para>is the application programming interface that is used to 
+communicate between frontends and backends.</para>
+<indexterm zone="sane libsane">
+<primary sortas="c-libsane">libsane.so</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="libsane-module">
+<term><filename class='libraryfile'>libsane-*.so</filename></term>
+<listitem><para>modules are backend scanning library plugins used to interface 
+with scanning devices. See 
+<ulink url="http://www.sane-project.org/sane-supported-devices.html"/> 
+for a list of supported backends.</para>
+<indexterm zone="sane libsane-module">
+<primary sortas="c-libsane-module">libsane-*.so</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
+
 </sect2>
 
 </sect1>

Modified: trunk/BOOK/pst/scanning/xsane.xml
===================================================================
--- trunk/BOOK/pst/scanning/xsane.xml	2005-01-31 15:26:33 UTC (rev 3369)
+++ trunk/BOOK/pst/scanning/xsane.xml	2005-01-31 20:21:45 UTC (rev 3370)
@@ -5,8 +5,8 @@
 
   <!ENTITY xsane-download-http "http://gd.tuwien.ac.at/hci/sane/xsane/xsane-&xsane-version;.tar.gz">
   <!ENTITY xsane-download-ftp  "ftp://ftp.sane-project.org/pub/sane/xsane-&xsane-version;.tar.gz">
-  <!ENTITY xsane-size          "2.9 MB">
-  <!ENTITY xsane-buildsize     "19.1 MB">
+  <!ENTITY xsane-size          "3.1 MB">
+  <!ENTITY xsane-buildsize     "21.3 MB">
   <!ENTITY xsane-time          "0.22 SBU">
 ]>
 
@@ -17,6 +17,8 @@
 </sect1info>
 <?dbhtml filename="xsane.html"?>
 <title>XSane-&xsane-version;</title>
+<indexterm zone="xsane">
+<primary sortas="a-XSane">XSane</primary></indexterm>
 
 <sect2>
 <title>Introduction to <application>XSane</application></title>
@@ -40,11 +42,15 @@
 
 <sect3><title><application>XSane</application> dependencies</title>
 <sect4><title>Required</title>
-<para><xref linkend="sane"/> (back ends) and
-<xref linkend="gtk2"/></para></sect4>
+<para><xref linkend="gtk2"/> or <xref linkend="GTK"/> and 
+<xref linkend="sane"/> (back ends)</para>
+</sect4>
+
 <sect4><title>Optional</title>
 <para><xref linkend="libtiff"/>, 
-<xref linkend="libjpeg"/> and <xref linkend="gimp"/></para></sect4>
+<xref linkend="libjpeg"/> and 
+<xref linkend="gimp"/></para>
+</sect4>
 </sect3>
 
 </sect2>
@@ -56,10 +62,17 @@
 commands:</para>
 
 <screen><userinput><command>./configure --prefix=/usr &&
-make &&
-make install &&
-ln -s /usr/bin/xsane /usr/lib/gimp/2.0/plug-ins/</command></userinput></screen>
+make</command></userinput></screen>
 
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install</command></userinput></screen>
+
+<para>If <application><acronym>GIMP</acronym></application> is installed, 
+issue the following command as the root user:</para>
+
+<screen><userinput role='root'><command>ln -s /usr/bin/xsane /usr/lib/gimp/2.0/plug-ins/</command></userinput></screen>
+
 </sect2>
 
 <sect2>
@@ -82,20 +95,31 @@
 <sect2>
 <title>Contents</title>
 
-<para><application>XSane</application> comes with a graphical user interface, 
-<command>xsane</command>, and (if <xref linkend="gimp"/> is available) a
-<application><acronym>GIMP</acronym></application> plugin. Please refer to the 
-documentation for further support.</para>
+<segmentedlist>
+<segtitle>Installed Program</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directory</segtitle>
 
-</sect2>
+<seglistitem>
+<seg>xsane</seg>
+<seg>None</seg>
+<seg>/usr/share/sane/xsane</seg>
+</seglistitem>
+</segmentedlist>
 
-<sect2>
-<title>Description</title>
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
 
-<sect3><title>xsane</title>
-<para><command>xsane</command> is a graphical user-interface to control an 
-image acquisition device such as a flatbed scanner.</para>
-</sect3>
+<varlistentry id="xsane-prog">
+<term><command>xsane</command></term>
+<listitem><para>is a graphical user-interface to control an image acquisition 
+device such as a flatbed scanner.</para>
+<indexterm zone="xsane xsane-prog">
+<primary sortas="b-xsane">xsane</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
 




More information about the blfs-book mailing list