source: pst/printing/gutenprint.xml@ b65d0d9

10.0 10.1 11.0 11.1 9.0 9.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since b65d0d9 was b65d0d9, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Update to gutenprint-5.3.3.
Update to xfce4-settings-4.14.1.
Update to bind-9.14.5.

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

  • Property mode set to 100644
File size: 11.7 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 gutenprint-download-http "&sourceforge-dl;/gimp-print/gutenprint-&gutenprint-version;.tar.xz">
8 <!ENTITY gutenprint-download-ftp " ">
9 <!ENTITY gutenprint-md5sum "8703d3e27283c4cf9cd475aaacfe8e4b">
10 <!ENTITY gutenprint-size "4.8 MB">
11 <!ENTITY gutenprint-buildsize "57 MB (without tests)">
12 <!ENTITY gutenprint-time "0.2 SBU (without tests)">
13 <!-- Tests add 75 SBU and 13GB to the equation - updated info in the tests below -->
14]>
15
16<sect1 id="gutenprint" xreflabel="Gutenprint-&gutenprint-version;">
17 <?dbhtml filename="gutenprint.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Gutenprint-&gutenprint-version;</title>
25
26 <indexterm zone="gutenprint">
27 <primary sortas="a-Gutenprint">Gutenprint</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Gutenprint</title>
32
33 <para>The <application>Gutenprint</application> (formerly
34 <application>Gimp-Print</application>) package contains high
35 quality drivers for many brands and models of printers for use with
36 <xref linkend="cups"/>
37 and the
38 <application>GIMP-2.0</application>. See a list of supported printers at
39 <ulink url="http://gutenprint.sourceforge.net/p_Supported_Printers.php"/>.
40 </para>
41
42 &lfs90_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>Download (HTTP): <ulink url="&gutenprint-download-http;"/></para>
48 </listitem>
49 <listitem>
50 <para>Download (FTP): <ulink url="&gutenprint-download-ftp;"/></para>
51 </listitem>
52 <listitem>
53 <para>Download MD5 sum: &gutenprint-md5sum;</para>
54 </listitem>
55 <listitem>
56 <para>Download size: &gutenprint-size;</para>
57 </listitem>
58 <listitem>
59 <para>Estimated disk space required: &gutenprint-buildsize;</para>
60 </listitem>
61 <listitem>
62 <para>Estimated build time: &gutenprint-time;</para>
63 </listitem>
64 </itemizedlist>
65
66 <bridgehead renderas="sect3">Gutenprint Dependencies</bridgehead>
67
68 <!-- recommend cups since we describe how to use it, and the gimp
69 so that we can use gutenprint's driver to print photos there -->
70 <bridgehead renderas="sect4">Recommended</bridgehead>
71 <para role="recommended">
72 <xref linkend="cups"/> and
73 <xref linkend="gimp"/>
74 </para>
75
76 <bridgehead renderas="sect4">Recommended (at runtime)</bridgehead>
77 <para role="recommended">
78 Two families of DyeSub photo printers each require another library at
79 runtime. Unless you have one of these devices you will not want these
80 libraries.
81 </para>
82
83 <para role="recommended">
84 For the Sinfonia S6145 and the Ciaat Brava 21, <ulink
85 url="http://git.shaftnet.org/cgit/selphy_print.git/tree/lib6145">libS6145ImageReProcess</ulink>,
86 see <ulink role="nodep"
87 url="http://www.peachyphotos.com/blog/posts/201601301524-sinfonia-chc-s6145-cs2-and-ciaat-brava-21-revited/">Peachy
88 Photos (Sinfonia)</ulink> for instructions on how to build and test this.
89 </para>
90
91 <para role="recommended">
92 For the Mitsubishi D70 family and the similar Kodak 305, <ulink
93 url="http://git.shaftnet.org/cgit/selphy_print.git/tree/lib70x">libMitsuD70ImageReProcess</ulink>,
94 see <ulink role="nodep"
95 url="http://www.peachyphotos.com/blog/posts/201610061508-mitsubishi-cp-d70-family-working/">Peachy
96 Photos (Mitsubishi CP-D70)</ulink> for instructions on how to build and
97 test this.
98 </para>
99
100 <bridgehead renderas="sect4">Optional (to Regenerate Documentation)</bridgehead>
101 <para role="optional">
102 <xref linkend="imagemagick"/>,
103 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>),
104 <xref linkend="doxygen"/>, and
105 <xref linkend="docbook-utils"/>
106 </para>
107
108 <para condition="html" role="usernotes">User Notes:
109 <ulink url="&blfs-wiki;/gutenprint"/></para>
110
111 </sect2>
112
113 <sect2 role="kernel" id="gutenprint-escputil">
114 <title>Kernel Configuration</title>
115
116 <para>
117 If you intend to use <application>escputil</application> with a USB-connected
118 Epson Stylus printer for commands such as <command>--ink-level</command>
119 which need to access the raw device, you must enable the kernel's usblp
120 driver. Enable the following options in your kernel configuration and
121 recompile the kernel:
122 </para>
123
124<screen><literal>Device Drivers ---&gt;
125 [*] USB support ---&gt; [CONFIG_USB_SUPPORT]
126 &lt;*/M&gt; OHCI HCD (USB 1.1) support [CONFIG_USB_OHCI_HCD]
127 &lt;*/M&gt; UHCI HCD (most Intel and VIA) support [CONFIG_USB_UHCI_HCD]
128 &lt;*/M&gt; USB Printer support [CONFIG_USB_PRINTER]</literal></screen>
129
130 <indexterm zone="gutenprint escputil">
131 <primary sortas="d-escputil">escputil for usb printers</primary>
132 </indexterm>
133
134 </sect2>
135
136 <sect2 role="installation">
137 <title>Installation of Gutenprint</title>
138
139 <para>Install <application>Gutenprint</application> by running the
140 following commands:</para>
141
142<screen><userinput>sed -i 's|$(PACKAGE)/doc|doc/$(PACKAGE)-$(VERSION)|' \
143 {,doc/,doc/developer/}Makefile.in &amp;&amp;
144
145./configure --prefix=/usr --disable-static &amp;&amp;
146
147make</userinput></screen>
148
149 <!-- this is supposed to discourage you from running the tests if you upgrade
150 the package - but the tests in 5.2.12 have changed and I thought I read they
151 were more parallel -->
152 <para>To test the results, issue: <command>make check</command>. The tests
153 take a very long time and use a lot of disk space. When last tested
154 (version 5.2.15 in June 2019) this needed 75 SBU and 13.5 GB
155 to complete the tests (one test, rastertogutenprint failed because the CUPS
156 ppds are for a previous version. Maybe genppds should be run before the
157 tests). Note that the tests used only one CPU.</para>
158
159 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
160
161<screen role="root"><userinput>make install &amp;&amp;
162install -v -m755 -d /usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprint{,ui2} &amp;&amp;
163install -v -m644 doc/gutenprint/html/* \
164 /usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprint &amp;&amp;
165install -v -m644 doc/gutenprintui2/html/* \
166 /usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprintui2</userinput></screen>
167
168 </sect2>
169
170 <sect2 role="commands">
171 <title>Command Explanations</title>
172
173 <para><command>sed -i '...' ...Makefile.in</command>: This
174 command is used so that the package documentation is installed in the
175 conventional <filename class='directory'>/usr/share/doc</filename>
176 directory structure instead of
177 <filename class='directory'>/usr/share/gutenprint/doc</filename>.</para>
178
179 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
180 href="../../xincludes/static-libraries.xml"/>
181
182 </sect2>
183
184 <sect2 role="configuration">
185 <title>Configuring Gutenprint</title>
186
187 <sect3>
188 <title>Configuration Information</title>
189
190 <para>For <application>CUPS</application> to see newly installed print
191 drivers, it has to be restarted (as the <systemitem
192 class="username">root</systemitem> user):</para>
193
194<screen role="root" revision="sysv"><userinput>/etc/rc.d/init.d/cups restart</userinput></screen>
195
196<screen role="root" revision="systemd"><userinput>systemctl restart org.cups.cupsd</userinput></screen>
197
198 <!-- <para>This command may take a long time (up to 10 minutes)
199 to complete. Don't panic while <application>CUPS</application>
200 is rescanning the list of PPD files. The long delay will happen
201 only once.</para> -->
202
203 <para>Then point your web browser to <ulink url="http://localhost:631/"/>
204 to add a new printer to <application>CUPS</application>.</para>
205
206 </sect3>
207
208 </sect2>
209
210 <sect2 role="content">
211 <title>Contents</title>
212
213 <segmentedlist>
214 <segtitle>Installed Programs</segtitle>
215 <segtitle>Installed Libraries</segtitle>
216 <segtitle>Installed Directories</segtitle>
217
218 <seglistitem>
219 <seg>
220 cups-calibrate, cups-genppd.5.2, cups-genppdupdate, escputil,
221 and testpattern
222 </seg>
223 <seg>
224 libgutenprint.so, libgutenprintui2.so and optionally, various
225 <application>CUPS</application> filters and backend drivers under
226 /usr/lib/gutenprint/5.2/modules/
227 </seg>
228 <seg>
229 /usr/{include,lib,share}/gutenprint,
230 /usr/include/gutenprintui2 and
231 /usr/share/doc/gutenprint-&gutenprint-version;
232 </seg>
233 </seglistitem>
234 </segmentedlist>
235
236 <variablelist>
237 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
238 <?dbfo list-presentation="list"?>
239 <?dbhtml list-presentation="table"?>
240
241 <varlistentry id="cups-calibrate">
242 <term><command>cups-calibrate</command></term>
243 <listitem>
244 <para>calibrates the color output of printers using the
245 <application>Gutenprint</application>,
246 <application>CUPS</application> or
247 <application>ESP Print Pro</application> drivers.</para>
248 <indexterm zone="gutenprint cups-calibrate">
249 <primary sortas="b-cups-calibrate">cups-calibrate</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="cups-genppd.5.2">
255 <term><command>cups-genppd.5.2</command></term>
256 <listitem>
257 <para>
258 generates Gutenprint PPD files for use with CUPS.
259 </para>
260 <indexterm zone="gutenprint cups-genppd.5.2">
261 <primary sortas="b-cups-genppd.5.2">cups-genppd.5.2</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 <varlistentry id="cups-genppdupdate">
267 <term><command>cups-genppdupdate</command></term>
268 <listitem>
269 <para>
270 regenerates the Gutenprint PPD files in use by CUPS.
271 </para>
272 <indexterm zone="gutenprint cups-genppdupdate">
273 <primary sortas="b-cups-genppdupdate">cups-genppdupdate</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277
278 <varlistentry id="escputil">
279 <term><command>escputil</command></term>
280 <listitem>
281 <para>is a command line utility to perform various maintenance
282 tasks on Epson Stylus inkjet printers.</para>
283 <indexterm zone="gutenprint escputil">
284 <primary sortas="b-escputil">escputil</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288 <!-- With 5.2.15, even with IJS installed, this program no longer exists.
289 cups-filters-1.25.0 dropped support for IJS filters entirely. -->
290 <!--
291 <varlistentry id="ijsgutenprint.5.2">
292 <term><command>ijsgutenprint.5.2</command></term>
293 <listitem>
294 <para>is a Ghostscript driver for HP InkJet and LaserJet printers.</para>
295 <indexterm zone="gutenprint ijsgutenprint.5.2">
296 <primary sortas="b-ijsgutenprint.5.2">ijsgutenprint.5.2</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300 -->
301
302 <varlistentry id="testpattern">
303 <term><command>testpattern</command></term>
304 <listitem>
305 <para>
306 is a test program to learn how to use libgutenprint.
307 </para>
308 <indexterm zone="gutenprint testpattern">
309 <primary sortas="b-testpattern">testpattern</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 </variablelist>
315
316 </sect2>
317
318</sect1>
Note: See TracBrowser for help on using the repository browser.