mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-02-03 06:27:16 +08:00
Updated to XSane-0.97 and added indexing tags to Sane
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3370 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Randy McMurchy
parent
ef9795f8f2
commit
345857adb3
@ -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">
|
||||
|
||||
@ -102,7 +102,7 @@ the <command>info</command> documentation.</para>
|
||||
<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>
|
||||
|
||||
@ -22,6 +22,9 @@ who wrote what.</para>
|
||||
|
||||
<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>
|
||||
|
||||
@ -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 @@ dependencies</title>
|
||||
<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 @@ necessary drivers to access the devices.</para>
|
||||
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 @@ a list of frontend packages, see
|
||||
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 @@ instead of <filename class="directory">/usr/etc/sane.d</filename>.</para>
|
||||
<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 @@ scanning devices, run <command>man sane-usb</command>. For information about
|
||||
|
||||
<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,73 +213,135 @@ setting up and securing the <command>saned</command> daemon can be found at
|
||||
<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
|
||||
<bridgehead renderas="sect4">Back Ends:</bridgehead>
|
||||
<segmentedlist>
|
||||
<segtitle>Installed Programs</segtitle>
|
||||
<segtitle>Installed Libraries</segtitle>
|
||||
<segtitle>Installed Directories</segtitle>
|
||||
|
||||
<seglistitem>
|
||||
<seg>gamma4scanimage, sane-config, saned, sane-find-scanner and scanimage</seg>
|
||||
<seg>libsane.so and numerous scanner backend modules</seg>
|
||||
<seg>/etc/sane.d, /usr/include/sane, /usr/lib/sane, /usr/share/sane and
|
||||
/usr/share/doc/sane-&sane-version;</seg>
|
||||
</seglistitem>
|
||||
</segmentedlist>
|
||||
|
||||
<bridgehead renderas="sect4">Front Ends:</bridgehead>
|
||||
<segmentedlist>
|
||||
<segtitle>Installed Programs</segtitle>
|
||||
<segtitle>Installed Library</segtitle>
|
||||
<segtitle>Installed Directory</segtitle>
|
||||
|
||||
<seglistitem>
|
||||
<seg>scanadf, xcam and xscanimage</seg>
|
||||
<seg><application>GIMP</application> plugin imbedded in
|
||||
<command>xscanimage</command></seg>
|
||||
<seg>/usr/share/sane</seg>
|
||||
</seglistitem>
|
||||
</segmentedlist>
|
||||
|
||||
<variablelist>
|
||||
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
||||
<?dbfo list-presentation="list"?>
|
||||
|
||||
<varlistentry id="gamma4scanimage">
|
||||
<term><command>gamma4scanimage</command></term>
|
||||
<listitem><para>creates a gamma table in the format expected by
|
||||
<command>scanimage</command>.</para>
|
||||
<indexterm zone="sane gamma4scanimage">
|
||||
<primary sortas="b-gamma4scanimage">gamma4scanimage</primary>
|
||||
</indexterm></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="sane-config-prog">
|
||||
<term><command>sane-config</command></term>
|
||||
<listitem><para>is a tool used to determine the compiler and linker flags that
|
||||
should be used to compile and link
|
||||
<application><acronym>SANE</acronym></application>.</para>
|
||||
<indexterm zone="sane sane-config-prog">
|
||||
<primary sortas="b-sane-config">sane-config</primary>
|
||||
</indexterm></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="saned">
|
||||
<term><command>saned</command></term>
|
||||
<listitem><para>is the <application><acronym>SANE</acronym></application>
|
||||
daemon that allows remote clients to access image acquisition devices
|
||||
available on the local host.</para>
|
||||
<indexterm zone="sane saned">
|
||||
<primary sortas="b-saned">saned</primary>
|
||||
</indexterm></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="sane-find-scanner">
|
||||
<term><command>sane-find-scanner</command></term>
|
||||
<listitem><para>is a command-line tool to find <acronym>SCSI</acronym> and
|
||||
<acronym>USB</acronym> scanners and determine their device files. Its primary
|
||||
aim is to make sure that scanners can be detected by
|
||||
<application><acronym>SANE</acronym></application> backends.</para>
|
||||
<indexterm zone="sane sane-find-scanner">
|
||||
<primary sortas="b-sane-find-scanner">sane-find-scanner</primary>
|
||||
</indexterm></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="scanadf">
|
||||
<term><command>scanadf</command></term>
|
||||
<listitem><para>is a command-line interface to control image acquisition
|
||||
devices which are equipped with an automatic document feeder
|
||||
(<acronym>ADF</acronym>).</para>
|
||||
<indexterm zone="sane scanadf">
|
||||
<primary sortas="b-scanadf">scanadf</primary>
|
||||
</indexterm></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="scanimage">
|
||||
<term><command>scanimage</command></term>
|
||||
<listitem><para>is a command line interface for scanning from image
|
||||
acquisition devices such as flatbed scanners or cameras. It is also used to
|
||||
list the available backend devices.</para>
|
||||
<indexterm zone="sane scanimage">
|
||||
<primary sortas="b-scanimage">scanimage</primary>
|
||||
</indexterm></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="xcam">
|
||||
<term><command>xcam</command></term>
|
||||
<listitem><para>is a graphical camera front end for
|
||||
<application><acronym>SANE</acronym></application>.</para>
|
||||
<indexterm zone="sane xcam">
|
||||
<primary sortas="b-xcam">xcam</primary>
|
||||
</indexterm></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="xscanimage">
|
||||
<term><command>xscanimage</command></term>
|
||||
<listitem><para>is a graphical user interface for scanning.</para>
|
||||
<indexterm zone="sane xscanimage">
|
||||
<primary sortas="b-xscanimage">xscanimage</primary>
|
||||
</indexterm></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="libsane">
|
||||
<term><filename class='libraryfile'>libsane.so</filename></term>
|
||||
<listitem><para>is the application programming interface that is used to
|
||||
communicate between frontends and backends.</para>
|
||||
<indexterm zone="sane libsane">
|
||||
<primary sortas="c-libsane">libsane.so</primary>
|
||||
</indexterm></listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry id="libsane-module">
|
||||
<term><filename class='libraryfile'>libsane-*.so</filename></term>
|
||||
<listitem><para>modules are backend scanning library plugins used to interface
|
||||
with scanning devices. See
|
||||
<ulink url="http://www.sane-project.org/sane-supported-devices.html"/>
|
||||
for a list of supported backends.</para>
|
||||
</sect3>
|
||||
|
||||
<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>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Description</title>
|
||||
|
||||
<sect3><title>gamma4scanimage</title>
|
||||
<para><command>gamma4scanimage</command> creates a gamma table in the format
|
||||
expected by <command>scanimage</command>.</para></sect3>
|
||||
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<sect3><title>xcam</title>
|
||||
<para><command>xcam</command> is a graphical camera front end for
|
||||
<application><acronym>SANE</acronym></application>.</para></sect3>
|
||||
|
||||
<sect3><title>xscanimage</title>
|
||||
<para><command>xscanimage</command> is a graphical user interface for
|
||||
scanning.</para></sect3>
|
||||
<indexterm zone="sane libsane-module">
|
||||
<primary sortas="c-libsane-module">libsane-*.so</primary>
|
||||
</indexterm></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
</sect2>
|
||||
|
||||
|
||||
@ -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 @@ url="&xsane-download-ftp;"/></para></listitem>
|
||||
|
||||
<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,9 +62,16 @@ url="&xsane-download-ftp;"/></para></listitem>
|
||||
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>
|
||||
|
||||
@ -82,20 +95,31 @@ additional information.</para>
|
||||
<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>
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user