Changeset 2b3ffa0 for pst/scanning/sane.xml

Timestamp:

02/07/2013 09:05:35 PM (11 years ago)

Author:

Randy McMurchy <randy@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

a162375

Parents:

558985f9

Message:

Minor modifications and added dependencies to the SANE instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11002 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• pst/scanning/sane.xml (modified) (9 diffs)

pst/scanning/sane.xml

@@ -5 +5 @@
   %general-entities;
 
-  <!ENTITY sane-be-download-http "http://alioth.debian.org/frs/?group_id=30186">
-  <!ENTITY sane-be-download-ftp  "ftp://ftp2.sane-project.org/pub/sane/">
+  <!-- <!ENTITY sane-be-download-http "http://alioth.debian.org/frs/?group_id=30186"> -->
+  <!ENTITY sane-be-download-http " ">
+  <!ENTITY sane-be-download-ftp  "ftp://ftp2.sane-project.org/pub/sane/sane-backends-&sane-version;.tar.gz">
   <!--<!ENTITY sane-be-download-ftp  "&gentoo-ftp-repo;/sane-backends-&sane-version;.tar.gz">-->
-  <!ENTITY sane-be-md5sum        "e226a89c54173efea80e91e9a5eb6573">
+  <!ENTITY sane-be-md5sum        "979c9dbb23920d04e322be23122c7de7">
   <!ENTITY sane-be-size          "5.1 MB">
   <!ENTITY sane-be-buildsize     "120 MB">
@@ -39 +40 @@
 
     <para><application>SANE</application> is short for Scanner Access Now Easy.
-    Scanner access, however, is far from easy, since every vendor has their own
+    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
@@ -51 +52 @@
     &lfs72_checked;
 
+    <!-- This note is not applicable. First, there is no issue downloading the
+         ftp://ftp2.sane-project.org/pub/sane/sane-backends-1.0.23.tar.gz
+         tarball with wget. Next, the combined tarball exists on the SANE FTP
+         site, but the MD5sum is wrong. We can simply point the download to
+         the SANE FTP site and create our own MD5sum (as we do on many packages).
+
     <note><para>The upstream web site uses a self signed security
-    certificate.  If using <command>wget</command>, the option --no-check-certificate
+    certificate.  If using <command>wget</command>, the option -no-check-certificate
     needs to be added.</para>
 
@@ -60 +67 @@
     the correct md5sum is located at <ulink
     url="http://anduin.linuxfromscratch.org/sources/other/sane-backends-1.0.23.tar.gz">http://anduin.linuxfromscratch.org/sources/other/sane-backends-1.0.23.tar.gz</ulink>.</para></note>
+    -->
 
     <bridgehead renderas="sect3">Back Ends Package Information</bridgehead>
@@ -118 +126 @@
     <bridgehead renderas="sect4">Optional (Back Ends)</bridgehead>
     <para role="optional">
+      <xref linkend="avahi"/>,
+      <xref linkend="cups"/>,
       <xref linkend="libjpeg"/>,
       <xref linkend="libtiff"/>,
-      <xref linkend="libusb-compat"/>,
+      <xref linkend="libusb"/>,
+      <ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>,
       <ulink url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink>,
-      <ulink url="http://www.gphoto.org/">libgphoto2</ulink>, and
+      <ulink url="http://www.gphoto.org/">libgphoto2</ulink>,
+      <ulink url="http://linuxtv.org/downloads/v4l-utils/">Video4Linux</ulink>, and
       <xref linkend="texlive"/>
     </para>
@@ -149 +161 @@
     drivers, a parallel port scanner needs parallel port support (you should
     use enhanced EPP modes) and perhaps <ulink
-    url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink> and a USB
+    url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink>, and a USB
     scanner will need the <xref linkend="libusb"/> package. Ensure you have
     the necessary drivers properly configured to access the devices.</para>
@@ -160 +172 @@
     <sect3>
       <title>Installation of SANE Back Ends</title>
+
+      <note>
+        <para>
+          You may safely disregard any messages printed on the screen when you
+          unpack the tarball.
+        </para>
+      </note>
 
       <para>The <application>SANE</application> daemon should run with its own
@@ -167 +186 @@
 <screen><userinput>groupadd -g 70 scanner</userinput></screen>
 
-      <note><para>The user building <application>SANE</application>-backends
-      should be a member of the scanner group before proceeding.  The easiest
-      way to ensure the system knows you have been added to a new group is to
-      log out log in again.  You can check with the output of the
-      <userinput>groups</userinput> command.</para></note>
+      <note>
+        <para>
+          The user building <application>SANE</application>-backends should be
+          a member of the <systemitem class="groupname">scanner</systemitem>
+          group before proceeding. After you have added the user building the
+          package to the <systemitem class="groupname">scanner</systemitem>
+          group, issue the following command to create a new shell:
+        </para>
+
+<screen><userinput>su $(whoami)</userinput></screen>
+
+        <para>
+          Check the output of the <userinput>groups</userinput> command and
+          ensure the user is a member of the
+          <systemitem class="groupname">scanner</systemitem> group.
+        </para>
+      </note>
 
       <para>Install <application>SANE</application>-backends by
       running the following commands:</para>
 
-<screen><userinput>./configure --prefix=/usr        \
-            --sysconfdir=/etc    \
-            --with-group=scanner \
-            --localstatedir=/var \
-            --disable-latex &amp;&amp;
-make</userinput></screen>
-
-      <para>This package does not come with a test suite.</para>
+            <!-- Not sure why this was there as it works if TeX is installed
+                 and it doesn't try to use it if TeX is not installed
+                 -disable-latex &amp;&amp; -->
+
+<screen><userinput>./configure --prefix=/usr                                    \
+            --sysconfdir=/etc                                \
+            --localstatedir=/var                             \
+            --with-docdir=/usr/share/doc/sane-backend-1.0.23 \
+            --with-group=scanner                             &amp;&amp;
+make                                                         &amp;&amp;
+exit</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 &amp;&amp;
-install -m 644 -v tools/udev/libsane.rules /etc/udev/rules.d/65-scanner.rules</userinput></screen>
+<screen role="root"><userinput>make install                                         &amp;&amp;
+install -m 644 -v tools/udev/libsane.rules           \
+                  /etc/udev/rules.d/65-scanner.rules &amp;&amp;
+chgrp -v scanner  /var/lock/sane</userinput></screen>
 
     </sect3>
@@ -236 +274 @@
     instead of <filename class="directory">/usr/etc/sane.d</filename>.</para>
 
+    <para><parameter>--with-group=scanner</parameter>: This parameter causes
+    the directory created for the locking files to be group owned by the
+    <systemitem class="groupname">scanner</systemitem> group instead of the
+    default <systemitem class="groupname">uucp</systemitem> group.</para>
+
+    <para><command>exit</command>: This command is used to exit the shell
+    created by the <command>su</command> command.</para>
   </sect2>