source: pst/scanning/xsane.xml

trunk
Last change on this file was 12a3cd17, checked in by Bruce Dubbs <bdubbs@…>, 3 months ago

A few more tags

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