source: pst/scanning/xsane.xml@ 3eeb0ce7

10.0 10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 3eeb0ce7 was 3eeb0ce7, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Finish tagging pst packages
Archive a2ps and psutils

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

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