source: pst/printing/gutenprint.xml@ 1a518e97

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 nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 1a518e97 was 1a518e97, checked in by Pierre Labastie <pieere@…>, 5 years ago

Last round of option vs parameter fixes

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

  • Property mode set to 100644
File size: 11.2 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 "fa6083535b7235fe531cd57e7345a81f">
10 <!ENTITY gutenprint-size "6.3 MB">
11 <!ENTITY gutenprint-buildsize "81 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="gs"/>, <xref linkend="cups"/>,
36 <ulink url="http://www.linuxfoundation.org/collaborate/workgroups/openprinting/database/foomatic">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 &lfs7a_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.linuxfoundation.org/collaborate/workgroups/openprinting/database/foomatic">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
127./configure --prefix=/usr --disable-static &amp;&amp;
128
129make</userinput></screen>
130
131 <!-- this is supposed to discourage you from running the tests if you upgrade
132 the package - I suppose you could sed the tests/Makefile to only run 'curve',
133 and perhaps 'run-testdither', it's 'run-weavetest' which takes most of the time -->
134 <para>To test the results, issue: <command>make check</command>. The tests
135 take a very long time and use a lot of disk space but reports vary substantially.
136 When last tested (version 5.2.11, BLFS-7.8, using -j2) needed 154 SBU and 8.6 GB
137 to complete the tests.</para>
138
139 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
140
141<screen role="root"><userinput>make install &amp;&amp;
142install -v -m755 -d /usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprint{,ui2} &amp;&amp;
143install -v -m644 doc/gutenprint/html/* \
144 /usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprint &amp;&amp;
145install -v -m644 doc/gutenprintui2/html/* \
146 /usr/share/doc/gutenprint-&gutenprint-version;/api/gutenprintui2</userinput></screen>
147
148 </sect2>
149
150 <sect2 role="commands">
151 <title>Command Explanations</title>
152
153 <para><command>sed -i '...' ...Makefile.in</command>: This
154 command is used so that the package documentation is installed in the
155 conventional <filename class='directory'>/usr/share/doc</filename>
156 directory structure instead of
157 <filename class='directory'>/usr/share/gutenprint/doc</filename>.</para>
158
159 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
160 href="../../xincludes/static-libraries.xml"/>
161
162 <!-- redundant, only applies to cups < 1.2.0 : cups-5.0 gives a version of 1.5.0
163 FIXME - delete this on next version upgrade
164 <para><option>\-\-with-translated-ppds=no</option>: When this parameter is
165 given, only US English PPD files for <application>CUPS</application>
166 will be built. Useful if the PPD files are not yet translated into your
167 native language and you want to save some space by not installing unneeded
168 translations.</para>-->
169
170 </sect2>
171
172 <sect2 role="configuration">
173 <title>Configuring Gutenprint</title>
174
175 <sect3>
176 <title>Configuration Information</title>
177
178 <para>For <application>CUPS</application> to see newly installed print
179 drivers, it has to be restarted (as the <systemitem
180 class="username">root</systemitem> user):</para>
181
182<screen role="root" revision="sysv"><userinput>/etc/rc.d/init.d/cups restart</userinput></screen>
183
184<screen role="root" revision="systemd"><userinput>systemctl restart org.cups.cupsd</userinput></screen>
185
186 <!-- <para>This command may take a long time (up to 10 minutes)
187 to complete. Don't panic while <application>CUPS</application>
188 is rescanning the list of PPD files. The long delay will happen
189 only once.</para> -->
190
191 <para>Then point your web browser to <ulink url="http://localhost:631/"/>
192 to add a new printer to <application>CUPS</application>.</para>
193
194 </sect3>
195
196 </sect2>
197
198 <sect2 role="content">
199 <title>Contents</title>
200
201 <segmentedlist>
202 <segtitle>Installed Programs</segtitle>
203 <segtitle>Installed Libraries</segtitle>
204 <segtitle>Installed Directories</segtitle>
205
206 <seglistitem>
207 <seg>
208 cups-calibrate, cups-genppd.5.2, cups-genppdupdate, escputil,
209 ijsgutenprint.5.2 (if compiled using ijs), and testpattern
210 </seg>
211 <seg>
212 libgutenprint.so, libgutenprintui2.so and optionally, various
213 <application>CUPS</application> filters and backend drivers under
214 /usr/lib/gutenprint/5.2/modules/
215 </seg>
216 <seg>
217 /usr/{include,lib,share}/gutenprint,
218 /usr/include/gutenprintui2 and
219 /usr/share/doc/gutenprint-&gutenprint-version;
220 </seg>
221 </seglistitem>
222 </segmentedlist>
223
224 <variablelist>
225 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
226 <?dbfo list-presentation="list"?>
227 <?dbhtml list-presentation="table"?>
228
229 <varlistentry id="cups-calibrate">
230 <term><command>cups-calibrate</command></term>
231 <listitem>
232 <para>calibrates the color output of printers using the
233 <application>Gutenprint</application>,
234 <application>CUPS</application> or
235 <application>ESP Print Pro</application> drivers.</para>
236 <indexterm zone="gutenprint cups-calibrate">
237 <primary sortas="b-cups-calibrate">cups-calibrate</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="cups-genppd.5.2">
243 <term><command>cups-genppd.5.2</command></term>
244 <listitem>
245 <para>
246 generates Gutenprint PPD files for use with CUPS.
247 </para>
248 <indexterm zone="gutenprint cups-genppd.5.2">
249 <primary sortas="b-cups-genppd.5.2">cups-genppd.5.2</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="cups-genppdupdate">
255 <term><command>cups-genppdupdate</command></term>
256 <listitem>
257 <para>
258 regenerates the Gutenprint PPD files in use by CUPS.
259 </para>
260 <indexterm zone="gutenprint cups-genppdupdate">
261 <primary sortas="b-cups-genppdupdate">cups-genppdupdate</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 <varlistentry id="escputil">
267 <term><command>escputil</command></term>
268 <listitem>
269 <para>is a command line utility to perform various maintenance
270 tasks on Epson Stylus inkjet printers.</para>
271 <indexterm zone="gutenprint escputil">
272 <primary sortas="b-escputil">escputil</primary>
273 </indexterm>
274 </listitem>
275 </varlistentry>
276
277 <varlistentry id="ijsgutenprint.5.2">
278 <term><command>ijsgutenprint.5.2</command></term>
279 <listitem>
280 <para>is a Ghostscript driver for HP InkJet and LaserJet printers.</para>
281 <indexterm zone="gutenprint ijsgutenprint.5.2">
282 <primary sortas="b-ijsgutenprint.5.2">ijsgutenprint.5.2</primary>
283 </indexterm>
284 </listitem>
285 </varlistentry>
286
287 <varlistentry id="testpattern">
288 <term><command>testpattern</command></term>
289 <listitem>
290 <para>
291 is a test program to learn how to use libgutenprint.
292 </para>
293 <indexterm zone="gutenprint testpattern">
294 <primary sortas="b-testpattern">testpattern</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 </variablelist>
300
301 </sect2>
302
303</sect1>
Note: See TracBrowser for help on using the repository browser.