source: pst/printing/gutenprint.xml@ f89fc45

10.0 10.1 11.0 11.1 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since f89fc45 was f89fc45, checked in by Ken Moffat <ken@…>, 7 years ago

more tags

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

  • Property mode set to 100644
File size: 9.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-repo;/gimp-print/gutenprint-&gutenprint-version;.tar.bz2">
8 <!ENTITY gutenprint-download-ftp " ">
9 <!ENTITY gutenprint-md5sum "9ff027103bafac419c37e19da75163ae">
10 <!ENTITY gutenprint-size "6.0 MB">
11 <!ENTITY gutenprint-buildsize "73 MB">
12 <!ENTITY gutenprint-time "0.5 SBU">
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="gs"/>, <xref linkend="cups"/>,
36 <ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>,
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 &lfs77_checked; &gcc5_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"><xref linkend="cups"/>, and
72 <xref linkend="gimp"/></para>
73
74 <bridgehead renderas="sect4">Optional</bridgehead>
75 <para role="optional">
76 <ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>,
77 <xref linkend="ijs"/></para>
78
79 <bridgehead renderas="sect4">Optional (to Regenerate Documentation)</bridgehead>
80 <para role="optional"><xref linkend="imagemagick"/>,
81 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
82 <xref linkend="doxygen"/>, and
83 <xref linkend="docbook-utils"/></para>
84
85 <para condition="html" role="usernotes">User Notes:
86 <ulink url="&blfs-wiki;/gutenprint"/></para>
87
88 </sect2>
89
90 <sect2 role="kernel" id="gutenprint-escputil">
91 <title>Kernel Configuration</title>
92
93 <para>
94 If you intend to use <application>escputil</application> with a USB-connected
95 Epson Stylus printer for commands such as <command>--ink-level</command>
96 which need to access the raw device, you must enable the kernel's usblp
97 driver. Enable the following options in your kernel configuration and
98 recompile the kernel:
99 </para>
100
101<screen><literal>Device Drivers ---&gt;
102 [*] USB support ---&gt; [CONFIG_USB_SUPPORT]
103 &lt;*/M&gt; OHCI HCD (USB 1.1) support [CONFIG_USB_OHCI_HCD]
104 &lt;*/M&gt; UHCI HCD (most Intel and VIA) support [CONFIG_USB_UHCI_HCD]
105 &lt;*/M&gt; USB Printer support [CONFIG_USB_PRINTER]</literal></screen>
106
107 <indexterm zone="gutenprint escputil">
108 <primary sortas="d-escputil">escputil for usb printers</primary>
109 </indexterm>
110
111 </sect2>
112
113 <sect2 role="installation">
114 <title>Installation of Gutenprint</title>
115
116 <para>Install <application>Gutenprint</application> by running the
117 following commands:</para>
118
119<screen><userinput>sed -i 's|$(PACKAGE)/doc|doc/$(PACKAGE)-$(VERSION)|' \
120 {,doc/,doc/developer/}Makefile.in &amp;&amp;
121./configure --prefix=/usr --disable-static &amp;&amp;
122make</userinput></screen>
123
124 <!-- this is supposed to discourage you from running the tests if you upgrade
125 the package - I suppose you could sed the tests/Makefile to only run 'curve',
126 and perhaps 'run-testdither', it's 'run-weavetest' which takes most of the time -->
127 <para>To test the results, issue: <command>make check</command>. When last
128 tested (version 5.2.7, LFS-7.1, on a uniprocessor box which is admittedly short of
129 memory) this took more than 800 SBUs (more than two days for that box) and used an
130 extra 678 MB of disk space.</para>
131
132 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
133
134<screen role="root"><userinput>make install &amp;&amp;
135install -v -m755 -d /usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprint{,ui2} &amp;&amp;
136install -v -m644 doc/gutenprint/html/* \
137 /usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprint &amp;&amp;
138install -v -m644 doc/gutenprintui2/html/* \
139 /usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprintui2</userinput></screen>
140
141 </sect2>
142
143 <sect2 role="commands">
144 <title>Command Explanations</title>
145
146 <para><command>sed -i '...' ...Makefile.in</command>: This
147 command is used so that the package documentation is installed in the
148 conventional <filename class='directory'>/usr/share/doc</filename>
149 directory structure instead of
150 <filename class='directory'>/usr/share/gutenprint/doc</filename>.</para>
151
152 <para><option>--disable-static</option>: This switch prevents the static
153 libraries being installed.</para>
154
155 <!-- redundant, only applies to cups < 1.2.0 : cups-5.0 gives a version of 1.5.0
156 FIXME - delete this on next version upgrade
157 <para><option>\-\-with-translated-ppds=no</option>: When this parameter is
158 given, only US English PPD files for <application>CUPS</application>
159 will be built. Useful if the PPD files are not yet translated into your
160 native language and you want to save some space by not installing unneeded
161 translations.</para>-->
162
163 </sect2>
164
165 <sect2 role="configuration">
166 <title>Configuring Gutenprint</title>
167
168 <sect3>
169 <title>Configuration Information</title>
170
171 <para>For <application>CUPS</application> to see newly installed print
172 drivers, it has to be restarted (as the <systemitem
173 class="username">root</systemitem> user):</para>
174
175<screen role="root"><userinput>/etc/rc.d/init.d/cups restart</userinput></screen>
176
177 <!-- <para>This command may take a long time (up to 10 minutes)
178 to complete. Don't panic while <application>CUPS</application>
179 is rescanning the list of PPD files. The long delay will happen
180 only once.</para> -->
181
182 <para>Then point your web browser to <ulink url="http://localhost:631/"/>
183 to add a new printer to <application>CUPS</application>.</para>
184
185 </sect3>
186
187 </sect2>
188
189 <sect2 role="content">
190 <title>Contents</title>
191
192 <segmentedlist>
193 <segtitle>Installed Programs</segtitle>
194 <segtitle>Installed Libraries</segtitle>
195 <segtitle>Installed Directories</segtitle>
196
197 <seglistitem>
198 <seg>cups-calibrate, cups-genppd.5.2, cups-genppdupdate, escputil,
199 ijsgutenprint.5.2 (if compiled using ijs), and
200 testpattern</seg>
201 <seg>libgutenprint.so, libgutenprintui2.so
202 and optionally, various
203 <application>CUPS</application> filters and backend
204 drivers under /usr/lib/gutenprint/5.2/modules/</seg>
205 <seg>/usr/include/gutenprint,
206 /usr/include/gutenprintui2,
207 /usr/lib/gutenprint,
208 /usr/share/doc/gutenprint-&gutenprint-version; and
209 /usr/share/gutenprint</seg>
210 </seglistitem>
211 </segmentedlist>
212
213 <variablelist>
214 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
215 <?dbfo list-presentation="list"?>
216 <?dbhtml list-presentation="table"?>
217
218 <varlistentry id="cups-calibrate">
219 <term><command>cups-calibrate</command></term>
220 <listitem>
221 <para>calibrates the color output of printers using the
222 <application>Gutenprint</application>,
223 <application>CUPS</application> or
224 <application>ESP Print Pro</application> drivers.</para>
225 <indexterm zone="gutenprint cups-calibrate">
226 <primary sortas="b-cups-calibrate">cups-calibrate</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="escputil">
232 <term><command>escputil</command></term>
233 <listitem>
234 <para>is a command line utility to perform various maintenance
235 tasks on Epson Stylus inkjet printers.</para>
236 <indexterm zone="gutenprint escputil">
237 <primary sortas="b-escputil">escputil</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="ijsgutenprint.5.2">
243 <term><command>ijsgutenprint.5.2</command></term>
244 <listitem>
245 <para>is a Ghostscript driver for HP inkjet and laserjet printers.</para>
246 <indexterm zone="gutenprint ijsgutenprint.5.2">
247 <primary sortas="b-ijsgutenprint.5.2">ijsgutenprint.5.2</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 </variablelist>
253
254 </sect2>
255
256</sect1>
Note: See TracBrowser for help on using the repository browser.