source: pst/scanning/xsane.xml@ 66966b2

10.0 10.1 11.0 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 66966b2 was 66966b2, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Archive qtwebkit5.
Tags for printing and X libraries.

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

  • Property mode set to 100644
File size: 6.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY xsane-download-http "http://www.xsane.org/download/xsane-&xsane-version;.tar.gz">
8 <!ENTITY xsane-download-ftp " ">
9<!-- <!ENTITY xsane-download-ftp "ftp://ftp2.sane-project.org/pub/sane/xsane/xsane-&xsane-version;.tar.gz"> -->
10 <!ENTITY xsane-md5sum "9927f21e1ab6ba96315e7f0e30746deb">
11 <!ENTITY xsane-size "2.9 MB">
12 <!ENTITY xsane-buildsize "23 MB">
13 <!ENTITY xsane-time "0.2 SBU">
14]>
15
16<sect1 id="xsane" xreflabel="XSane-&xsane-version;">
17 <?dbhtml filename="xsane.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>XSane-&xsane-version;</title>
25
26 <indexterm zone="xsane">
27 <primary sortas="a-XSane">XSane</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to XSane</title>
32
33 <para><application>XSane</application> is another front end for
34 <xref linkend="sane"/>. It has additional features to improve the image
35 quality and ease of use compared to <command>xscanimage</command>.</para>
36
37 &lfs83_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>Download (HTTP): <ulink url="&xsane-download-http;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download (FTP): <ulink url="&xsane-download-ftp;"/></para>
46 </listitem>
47 <listitem>
48 <para>Download MD5 sum: &xsane-md5sum;</para>
49 </listitem>
50 <listitem>
51 <para>Download size: &xsane-size;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated disk space required: &xsane-buildsize;</para>
55 </listitem>
56 <listitem>
57 <para>Estimated build time: &xsane-time;</para>
58 </listitem>
59 </itemizedlist>
60
61 <bridgehead renderas="sect3">XSane Dependencies</bridgehead>
62
63 <bridgehead renderas="sect4">Required</bridgehead>
64 <para role="required">
65 <xref linkend="gtk2"/> and
66 <xref linkend="sane"/> (back ends)
67 </para>
68<!--
69 <bridgehead renderas="sect4">Recommended</bridgehead>
70 <para role="recommended">
71 <xref linkend="xdg-utils"/> (for the help documentation at runtime)
72 </para>-->
73
74 <bridgehead renderas="sect4">Optional</bridgehead>
75 <para role="optional">
76 <xref linkend="lcms"/> and
77 <xref linkend="gimp"/>
78 </para>
79
80 <para condition="html" role="usernotes">User Notes:
81 <ulink url="&blfs-wiki;/xsane"/></para>
82
83 </sect2>
84
85 <sect2 role="installation">
86 <title>Installation of XSane</title>
87
88 <para>Install <application>XSane</application> by running the following
89 commands:</para>
90
91<!--sed -i -e 's/netscape/xdg-open/' src/xsane.h &amp;&amp;-->
92<screen><userinput>sed -i -e 's/png_ptr->jmpbuf/png_jmpbuf(png_ptr)/' src/xsane-save.c &amp;&amp;
93./configure --prefix=/usr &amp;&amp;
94make</userinput></screen>
95
96 <para>This package does not come with a test suite.</para>
97
98 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
99
100<screen role="root"><userinput>make xsanedocdir=/usr/share/doc/xsane-&xsane-version; install &amp;&amp;
101ln -v -s ../../doc/xsane-&xsane-version; /usr/share/sane/xsane/doc</userinput></screen>
102<!--
103 <para>If you have not installed <xref linkend="xdg-utils"/> and have not
104 issued the first sed:</para>-->
105 <para>A browser of your choice can be used to get inline help, using the
106 following command, as the <systemitem class="username">root</systemitem>
107 user:</para>
108
109<screen role="root"><userinput>ln -v -s &lt;browser&gt; /usr/bin/netscape</userinput></screen>
110
111 <note><para>Be sure to replace &lt;browser&gt; with the browser of your
112 choice on your system.</para></note>
113
114 <para>Alternatively, if the environment variable BROWSER is set to the
115 browser you want to use, eg, BROWSER="/usr/bin/firefox", the first time you
116 run <command>xsane</command>, it will be recorded in ~/.sane/xsane/xsane.rc.
117 If you wish to change it, edit this file, or remove it, and use the
118 instructions above, so that a new one is created.</para>
119
120 <para>If <application>GIMP</application> is installed, issue the following
121 command as the <systemitem class="username">root</systemitem> user:</para>
122
123<screen role="root"><userinput>ln -v -s /usr/bin/xsane /usr/lib/gimp/2.0/plug-ins/</userinput></screen>
124
125 </sect2>
126
127 <sect2 role="commands">
128 <title>Command Explanations</title>
129<!--
130 <para><command>sed -i -e 's/netscape/xdg-open/' src/xsane.h </command>:
131 This is to use <command>xdg-open</command> for the help documentation,
132 instead of the hardcoded browser.</para>-->
133
134 <para><command>ln -v -s ../../doc/xsane-&xsane-version;
135 /usr/share/sane/xsane/doc</command>: This symlink is created to ensure that
136 any program that looks for the <application>XSane</application>
137 documentation in the default location will find it, as the documentation
138 is installed in an alternate location specified in the
139 <command>make install</command> command.</para>
140
141 <para><command>ln -v -s /usr/bin/xsane /usr/lib/gimp/2.0/plug-ins/</command>:
142 This creates a link in the system-wide <application>GIMP</application>
143 <filename class='directory'>plug-ins</filename> directory so that users can
144 access <application>XSane</application> directly from
145 <application>GIMP</application>. <application>GIMP</application> must be
146 available before building <application>XSane</application> for this to work.
147 Alternatively, create the link in <filename
148 class='directory'>~/.gimp-2.0/plug-ins/</filename> to provide individual
149 user access. <command>man xsane</command> for additional information.</para>
150
151 </sect2>
152
153 <sect2 role="content">
154 <title>Contents</title>
155
156 <segmentedlist>
157 <segtitle>Installed Program</segtitle>
158 <segtitle>Installed Libraries</segtitle>
159 <segtitle>Installed Directory</segtitle>
160
161 <seglistitem>
162 <seg>xsane</seg>
163 <seg>None</seg>
164 <seg>/usr/share/doc/xsane-&xsane-version; and
165 /usr/share/sane/xsane</seg>
166 </seglistitem>
167 </segmentedlist>
168
169 <variablelist>
170 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
171 <?dbfo list-presentation="list"?>
172 <?dbhtml list-presentation="table"?>
173
174 <varlistentry id="xsane-prog">
175 <term><command>xsane</command></term>
176 <listitem>
177 <para>is a graphical user-interface to control an image acquisition
178 device such as a flatbed scanner.</para>
179 <indexterm zone="xsane xsane-prog">
180 <primary sortas="b-xsane">xsane</primary>
181 </indexterm>
182 </listitem>
183 </varlistentry>
184
185 </variablelist>
186
187 </sect2>
188
189</sect1>
Note: See TracBrowser for help on using the repository browser.