Scanning section - 1st submission and later plans

alex at 22-music.com alex at 22-music.com
Thu Jan 2 09:57:18 PST 2003


Hello, BLFS developers!

Attached you'll find my submission on the scanning section. About the
future plans: I want to add 2 free (as in GPL) OCR programs, gocr and
clara soon, but I don't know if this should go into BLFS 1.0 or into
a later version.

Anyway, I'll be busy the next week with my studies. Hope you like my
patch (and correct all errors)...

Alex
-------------- next part --------------
diff -Naur BLFS-old/BOOK/pst/pst.ent BLFS/BOOK/pst/pst.ent
--- BLFS-old/BOOK/pst/pst.ent	2002-12-30 18:09:48.000000000 +0100
+++ BLFS/BOOK/pst/pst.ent	2003-01-02 11:03:31.000000000 +0100
@@ -7,6 +7,10 @@
 
 <!-- Scanning -->
 <!ENTITY pst-scanning SYSTEM "scanning/scanning.xml">
+<!ENTITY % sane SYSTEM "scanning/sane/sane.ent">
+<!ENTITY % xsane SYSTEM "scanning/xsane/xsane.ent">
+%sane;
+%xsane;
 
 <!-- SGML -->
 <!ENTITY pst-sgml SYSTEM "typesetting/sgml.xml">
diff -Naur BLFS-old/BOOK/pst/scanning/sane/sane-desc.xml BLFS/BOOK/pst/scanning/sane/sane-desc.xml
--- BLFS-old/BOOK/pst/scanning/sane/sane-desc.xml	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/sane/sane-desc.xml	2003-01-02 16:26:57.000000000 +0100
@@ -0,0 +1,18 @@
+<sect2>
+<title>Contents</title>
+
+<sect3><title>Backends:</title>
+<para>See <ulink url="http://www.mostang.com/sane/sane-supported-devices.html"/>
+for a list of available backends.</para>
+</sect3>
+
+<sect3><title>Frontends:</title>
+<para><userinput>scanimage :</userinput> Command line interface for 
+scanning.</para>
+<para><userinput>xscanimage :</userinput> Graphical user interface for
+scanning.</para>
+<para><userinput>gimp-plugin :</userinput> xscanimage as Gimp-plugin.</para>
+</sect3>
+
+</sect2>
+
diff -Naur BLFS-old/BOOK/pst/scanning/sane/sane-exp.xml BLFS/BOOK/pst/scanning/sane/sane-exp.xml
--- BLFS-old/BOOK/pst/scanning/sane/sane-exp.xml	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/sane/sane-exp.xml	2003-01-02 11:39:23.000000000 +0100
@@ -0,0 +1,7 @@
+<sect2>
+<title>Installation command explanations</title>
+
+<para><userinput>--prefix=/usr :</userinput> All software is going to
+be installed in directories relative to<filename>/usr</filename>.</para>
+
+</sect2>
diff -Naur BLFS-old/BOOK/pst/scanning/sane/sane-inst.xml BLFS/BOOK/pst/scanning/sane/sane-inst.xml
--- BLFS-old/BOOK/pst/scanning/sane/sane-inst.xml	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/sane/sane-inst.xml	2003-01-02 13:29:53.000000000 +0100
@@ -0,0 +1,35 @@
+<sect2>
+<title>Installation of sane</title>
+
+<sect3><title>Preparing your system for scanner access</title>
+<para>To access your scanner, you will probably need the related kernel
+drivers. A SCSI scanner will need SCSI drivers, a parallel port scanner
+needs parallel port support (you should use enhanced EPP modes, too) and
+an USB scanner will need the USB scanner module and a SCSI system for 
+emulation. Be sure that you have got the necessary devices to access the
+drivers.</para>
+</sect3>
+
+<sect3><title>Installation of sane-backends</title>
+
+<para>Install sane-backends by running the following commands:</para>
+
+<para><screen><userinput>./configure --prefix=/usr &&
+make &&
+make install
+</userinput></screen></para>
+
+</sect3>
+
+<sect3><title>Installation of sane-frontends</title>
+
+<para>To install sane-frontends, use the following commands:</para>
+
+<para><screen><userinput>./configure --prefix=/usr &&
+make &&
+make install
+</userinput></screen></para>
+
+</sect3>
+
+</sect2>
diff -Naur BLFS-old/BOOK/pst/scanning/sane/sane-intro.xml BLFS/BOOK/pst/scanning/sane/sane-intro.xml
--- BLFS-old/BOOK/pst/scanning/sane/sane-intro.xml	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/sane/sane-intro.xml	2003-01-02 11:43:39.000000000 +0100
@@ -0,0 +1,25 @@
+<sect2>
+<title>Introduction to sane</title>
+
+<screen>Required:
+Download location (HTTP):       <ulink url="&sane-download-http;"/>
+Download location (FTP):        <ulink url="&sane-be-download-ftp;"/>
+                                <ulink url="&sane-fe-download-ftp;"/>
+Version used:                   &sane-version;
+Package size:                   &sane-be-size; (Backends), &sane-fe-size; (Frontends)
+Estimated Disk space required:  &sane-be-buildsize; (Backends), &sane-fe-buildsize; (Frontends)</screen>
+
+<para>SANE is short for Scanner Access Now Easy. Alas, scanner access is
+not really easy, since every vendor has own protocols. The only known
+protocol that should bring some unity into this chaos is the TWAIN interface,
+but this is too unprecise to allow a stable scanning framework. Therefore,
+SANE comes with its own protocol, so the vendor drivers can't be used.</para>
+
+<para>SANE is split into backends and frontends. The backends are drivers
+for the supported scanners. The frontends are user interfaces to access the
+backends.</para>
+
+<screen>The frontends will utilize:
+<xref linkend="xfree86"/>, <xref linkend="GTK"/>, <xref linkend="gimp"/></screen>
+
+</sect2>
diff -Naur BLFS-old/BOOK/pst/scanning/sane/sane.ent BLFS/BOOK/pst/scanning/sane/sane.ent
--- BLFS-old/BOOK/pst/scanning/sane/sane.ent	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/sane/sane.ent	2003-01-02 16:11:37.000000000 +0100
@@ -0,0 +1,13 @@
+<!ENTITY sane SYSTEM "../sane.xml">
+<!ENTITY sane-intro SYSTEM "sane-intro.xml">
+<!ENTITY sane-inst SYSTEM "sane-inst.xml">
+<!ENTITY sane-desc SYSTEM "sane-desc.xml">
+<!ENTITY sane-exp SYSTEM "sane-exp.xml">
+<!ENTITY sane-be-buildsize "31 MB">
+<!ENTITY sane-fe-buildsize "3.1 MB">
+<!ENTITY sane-version "1.0.9">
+<!ENTITY sane-download-http "http://www.mostang.com/sane">
+<!ENTITY sane-be-download-ftp "ftp://ftp.mostang.com/pub/sane/sane-backends-1.0.9.tar.gz">
+<!ENTITY sane-fe-download-ftp "ftp://ftp.mostang.com/pub/sane/sane-frontends-1.0.9.tar.gz">
+<!ENTITY sane-be-size "2.2 MB">
+<!ENTITY sane-fe-size "174 kb">
diff -Naur BLFS-old/BOOK/pst/scanning/sane.xml BLFS/BOOK/pst/scanning/sane.xml
--- BLFS-old/BOOK/pst/scanning/sane.xml	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/sane.xml	2003-01-02 11:02:13.000000000 +0100
@@ -0,0 +1,10 @@
+<sect1 id="sane" xreflabel="sane-&sane-version;">
+<?dbhtml filename="sane.html" dir="pst"?>
+<title>sane-&sane-version;</title>
+
+&sane-intro;
+&sane-inst;
+&sane-exp;
+&sane-desc;
+
+</sect1>
diff -Naur BLFS-old/BOOK/pst/scanning/scanning.xml BLFS/BOOK/pst/scanning/scanning.xml
--- BLFS-old/BOOK/pst/scanning/scanning.xml	2002-07-07 22:28:46.000000000 +0200
+++ BLFS/BOOK/pst/scanning/scanning.xml	2003-01-02 16:25:28.000000000 +0100
@@ -2,6 +2,7 @@
 <?dbhtml filename="scanning.html" dir="pst"?>
 <title>Scanning</title>
 
-<para>Placeholder for sane and xsane.</para>
+&sane;
+&xsane;
 
 </chapter>
diff -Naur BLFS-old/BOOK/pst/scanning/xsane/xsane-desc.xml BLFS/BOOK/pst/scanning/xsane/xsane-desc.xml
--- BLFS-old/BOOK/pst/scanning/xsane/xsane-desc.xml	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/xsane/xsane-desc.xml	2003-01-02 16:17:09.000000000 +0100
@@ -0,0 +1,9 @@
+<sect2>
+<title>Contents</title>
+
+<para>xsane comes with a graphical user interface, and (if gimp 1.2 is
+available) a gimp plugin with advanced features. Please refer to the
+documentation for further support.</para>
+
+</sect2>
+
diff -Naur BLFS-old/BOOK/pst/scanning/xsane/xsane-exp.xml BLFS/BOOK/pst/scanning/xsane/xsane-exp.xml
--- BLFS-old/BOOK/pst/scanning/xsane/xsane-exp.xml	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/xsane/xsane-exp.xml	2003-01-02 16:17:18.000000000 +0100
@@ -0,0 +1,7 @@
+<sect2>
+<title>Installation command explanations</title>
+
+<para><userinput>--prefix=/usr :</userinput> All software is going to
+be installed in directories relative to<filename>/usr</filename>.</para>
+
+</sect2>
diff -Naur BLFS-old/BOOK/pst/scanning/xsane/xsane-inst.xml BLFS/BOOK/pst/scanning/xsane/xsane-inst.xml
--- BLFS-old/BOOK/pst/scanning/xsane/xsane-inst.xml	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/xsane/xsane-inst.xml	2003-01-02 16:15:26.000000000 +0100
@@ -0,0 +1,11 @@
+<sect2>
+<title>Installation of xsane</title>
+
+<para>Install xsane by running the following commands:</para>
+
+<para><screen><userinput>./configure --prefix=/usr &&
+make &&
+make install
+</userinput></screen></para>
+
+</sect2>
diff -Naur BLFS-old/BOOK/pst/scanning/xsane/xsane-intro.xml BLFS/BOOK/pst/scanning/xsane/xsane-intro.xml
--- BLFS-old/BOOK/pst/scanning/xsane/xsane-intro.xml	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/xsane/xsane-intro.xml	2003-01-02 16:32:22.000000000 +0100
@@ -0,0 +1,18 @@
+<sect2>
+<title>Introduction to xsane</title>
+
+<screen>Required:
+Download location (HTTP):       <ulink url="&xsane-download-http;"/>
+Download location (FTP):        <ulink url="&xsane-download-ftp;"/>
+Version used:                   &xsane-version;
+Package size:                   &xsane-size;
+Estimated Disk space required:  &xsane-buildsize;</screen>
+
+<para>xsane is another frontend for <xref linkend="sane"/>. It has
+additional features to improve the image quality compared to 
+xscanimage.</para>
+
+<screen>xsane requires:
+<xref linkend="sane"/>, <xref linkend="xfree86"/>, <xref linkend="libpng"/>, <xref linkend="GTK"/> and <xref linkend="gimp"/></screen>
+
+</sect2>
diff -Naur BLFS-old/BOOK/pst/scanning/xsane/xsane.ent BLFS/BOOK/pst/scanning/xsane/xsane.ent
--- BLFS-old/BOOK/pst/scanning/xsane/xsane.ent	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/xsane/xsane.ent	2003-01-02 16:24:36.000000000 +0100
@@ -0,0 +1,10 @@
+<!ENTITY xsane SYSTEM "../xsane.xml">
+<!ENTITY xsane-intro SYSTEM "xsane-intro.xml">
+<!ENTITY xsane-inst SYSTEM "xsane-inst.xml">
+<!ENTITY xsane-desc SYSTEM "xsane-desc.xml">
+<!ENTITY xsane-exp SYSTEM "xsane-exp.xml">
+<!ENTITY xsane-buildsize "16 MB">
+<!ENTITY xsane-version "0.90">
+<!ENTITY xsane-download-http "http://www.xsane.org">
+<!ENTITY xsane-download-ftp "ftp://ftp.mostang.com/pub/sane/xsane/xsane-0.90.tar.gz">
+<!ENTITY xsane-size "2.5 MB">
diff -Naur BLFS-old/BOOK/pst/scanning/xsane.xml BLFS/BOOK/pst/scanning/xsane.xml
--- BLFS-old/BOOK/pst/scanning/xsane.xml	1970-01-01 01:00:00.000000000 +0100
+++ BLFS/BOOK/pst/scanning/xsane.xml	2003-01-02 11:02:30.000000000 +0100
@@ -0,0 +1,10 @@
+<sect1 id="xsane" xreflabel="xsane-&xsane-version;">
+<?dbhtml filename="xsane.html" dir="pst"?>
+<title>xsane-&xsane-version;</title>
+
+&xsane-intro;
+&xsane-inst;
+&xsane-exp;
+&xsane-desc;
+
+</sect1>


More information about the blfs-book mailing list