source: pst/printing/gutenprint.xml@ 63a0217

11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 63a0217 was 2ff29ed, checked in by Douglas R. Reno <renodr@…>, 13 months ago

Gutenprint: Reference proper systemd unit

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