source: pst/printing/gutenprint.xml@ 60d53ec3

10.0 10.1 11.0 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 60d53ec3 was 60d53ec3, checked in by Bruce Dubbs <bdubbs@…>, 6 years ago

Tags and some minor formatting

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

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