glfs/pst/scanning/sane.xml

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
 
  <!ENTITY sane-download-http "http://gd.tuwien.ac.at/api/sane/sane-backends-&sane-version;/sane-backends-&sane-version;.tar.gz">
  <!ENTITY sane-download-ftp  "ftp://ftp.sane-project.org/pub/sane/sane-backends-&sane-version;/sane-backends-&sane-version;.tar.gz">
  <!ENTITY sane-size          "3.1 MB">
  <!ENTITY sane-buildsize     "42 MB">
  <!ENTITY sane-time          "1.77 SBU">
]>

<sect1 id="sane" xreflabel="SANE-&sane-version;">
<?dbhtml filename="sane.html"?>
<title>SANE-&sane-version;</title>

<sect2>
<title>Introduction to <application><acronym>SANE</acronym></application></title>

<para><acronym>SANE</acronym> is short for Scanner Access Now Easy. 
Scanner access, however, is far from easy, since every vendor has their own 
protocols. The only known protocol that should bring some unity into this 
chaos is the TWAIN interface, but this is too imprecise to 
allow a stable scanning framework. Therefore, <acronym>SANE</acronym> comes 
with its own protocol, so the vendor drivers can't be used.</para>
                                                                                
<para><acronym>SANE</acronym> is split into back ends and front ends. The 
back ends are drivers for the supported scanners. The front ends are user 
interfaces to access the backends.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&sane-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&sane-download-ftp;"/></para></listitem>
<listitem><para>Download size: &sane-size;</para></listitem>
<listitem><para>Estimated Disk space required: &sane-buildsize;</para></listitem>
<listitem><para>Estimated build time: &sane-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Front ends: <ulink
url="ftp://ftp.sane-project.org/pub/sane/sane-frontends-1.0.12/sane-frontends-1.0.12.tar.gz"/></para></listitem>
</itemizedlist>
</sect3>
                                                                                
<sect3><title><application><acronym>SANE</acronym></application> dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="libusb"/>,
<ulink url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink>,
<ulink url="http://www.gphoto.org/">gPhoto2</ulink>,
X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), <xref linkend="GTK2"/> and <xref
linkend="gimp"/></para></sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application><acronym>SANE</acronym></application></title>

<sect3><title>Preparing your system for scanner access</title>
<para>To access your scanner, you will probably need the related kernel
drivers. 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 an <acronym>USB</acronym> scanner 
will need the <acronym>USB</acronym> scanner module and a <acronym>SCSI
</acronym> system for emulation. Be sure that you have got the necessary 
devices to access the drivers.</para>
</sect3>

<sect3><title>Installation of <application><acronym>SANE</acronym></application> backends</title>

<para>Install <application><acronym>SANE</acronym></application> backends by 
running the following commands:</para>

<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

</sect3>

<sect3><title>Installation of <application><acronym>SANE</acronym></application> front ends</title>

<para>To install <application><acronym>SANE</acronym></application> front ends, use the following 
commands:</para>

<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

</sect3>

</sect2>

<sect2>
<title>Installation command explanations</title>

<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
configuration files in <filename class="directory">/etc/sane.d</filename>
instead of <filename class="directory">/usr/etc/sane.d</filename>.</para>

</sect2>

<sect2>
<title>Contents</title>

<sect3><title>Back ends:</title>
<para>See <ulink url="http://www.sane-project.org/sane-supported-devices.html"/>
for a list of available backends.</para>
</sect3>

<sect3><title>Front ends:</title>
<para><command>scanimage</command>: Command line interface for 
scanning.</para>
<para><command>xscanimage</command>: Graphical user interface for
scanning.</para>
<para><command>gimp-plugin</command>: xscanimage as
<application><acronym>GIMP</acronym></application> plugin.</para>
</sect3>

</sect2>

</sect1>