source: pst/printing/gutenprint.xml@ 6495834

10.0 10.1 11.0 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6495834 was 6495834, checked in by Ken Moffat <ken@…>, 5 years ago

gutenprint-5.2.12

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

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