source: pst/printing/gutenprint.xml@ 2b7420b

10.1 11.0 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 2b7420b was 2b7420b, checked in by Bruce Dubbs <bdubbs@…>, 10 months ago

Tag printer stack, window managers, and misc

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

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