source: pst/scanning/xsane.xml@ 81076bb6

10.0 10.1 11.0 8.4 9.0 9.1 lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 81076bb6 was 81076bb6, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tags for networking and postscript.
Archive two unused files.

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

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