source: archive/a2ps.xml@ 3eeb0ce7

10.0 10.1 11.0 qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 3eeb0ce7 was 3eeb0ce7, checked in by Bruce Dubbs <bdubbs@…>, 13 months ago

Finish tagging pst packages
Archive a2ps and psutils

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

  • Property mode set to 100644
File size: 13.4 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 a2ps-download-http "&gnu-http;/a2ps/a2ps-&a2ps-version;.tar.gz">
8 <!ENTITY a2ps-download-ftp "&gnu-ftp;/a2ps/a2ps-&a2ps-version;.tar.gz">
9 <!ENTITY a2ps-md5sum "781ac3d9b213fa3e1ed0d79f986dc8c7">
10 <!ENTITY a2ps-size "2.6 MB">
11 <!ENTITY a2ps-buildsize "22 MB">
12 <!ENTITY a2ps-time "0.3 SBU">
13
14 <!ENTITY i18n-fonts-version "0.1">
15]>
16
17<sect1 id="a2ps" xreflabel="a2ps-&a2ps-version;">
18 <?dbhtml filename="a2ps.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>a2ps-&a2ps-version;</title>
26
27 <indexterm zone="a2ps">
28 <primary sortas="a-a2ps">a2ps</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to a2ps</title>
33
34 <para>
35 <application>a2ps</application> is a filter utilized mainly
36 in the background and primarily by printing scripts to convert almost
37 every input format into PostScript output. The application's name
38 expands appropriately to <quote>all to PostScript</quote>.
39 </para>
40
41 &lfs91_checked;
42
43 <caution>
44 <para>
45 <application>a2ps</application> cannot convert UTF-8 encoded
46 text to PostScript. The issue is discussed in detail in the
47 <xref linkend="locale-not-valid-option"/> section of the
48 <xref linkend="locale-issues"/> page.
49 The solution is to use <xref linkend="paps"/> instead of
50 <application>a2ps</application> for converting
51 UTF-8 encoded text to PostScript.
52 </para>
53 </caution>
54
55 <bridgehead renderas="sect3">Package Information</bridgehead>
56 <itemizedlist spacing="compact">
57 <listitem>
58 <para>
59 Download (HTTP): <ulink url="&a2ps-download-http;"/>
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Download (FTP): <ulink url="&a2ps-download-ftp;"/>
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Download MD5 sum: &a2ps-md5sum;
70 </para>
71 </listitem>
72 <listitem>
73 <para>
74 Download size: &a2ps-size;
75 </para>
76 </listitem>
77 <listitem>
78 <para>
79 Estimated disk space required: &a2ps-buildsize;
80 </para>
81 </listitem>
82 <listitem>
83 <para>
84 Estimated build time: &a2ps-time;
85 </para>
86 </listitem>
87 </itemizedlist>
88
89 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
90 <itemizedlist spacing='compact'>
91 <listitem>
92 <para>
93 International fonts: <ulink url=
94 "&sources-anduin-http;/i18n-fonts/i18n-fonts-&i18n-fonts-version;.tar.bz2"/>
95 </para>
96 </listitem>
97 </itemizedlist>
98
99 <bridgehead renderas="sect3">a2ps Dependencies</bridgehead>
100
101 <bridgehead renderas="sect4">Recommended</bridgehead>
102 <para role="recommended">
103 <xref linkend="psutils"/>, and
104 <xref linkend="cups"/>
105 (otherwise, <application>a2ps</application> will use the
106 <command>cat &gt;/dev/lp0</command> command instead of <command>lpr</command>
107 for sending its output to the printer)
108 </para>
109
110 <bridgehead renderas="sect4">Optional</bridgehead>
111 <para role="optional">
112 <xref linkend="gs"/>,
113 <xref linkend="libpaper"/>,
114 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
115 <xref linkend="x-window-system"/>,
116 <ulink url="http://www.adobe.com/products/acrobat/readstep2.html">Adobe Reader</ulink>, and
117 <ulink url="http://www.gnu.org/software/ghostview/ghostview.html">Ghostview</ulink>
118 </para>
119
120 <para condition="html" role="usernotes">User Notes:
121 <ulink url="&blfs-wiki;/A2PS"/></para>
122
123 </sect2>
124
125 <sect2 role="installation">
126 <title>Installation of a2ps</title>
127
128 <para>
129 Install <application>a2ps</application> by running the following
130 commands:
131 </para>
132
133<screen><userinput>autoconf &amp;&amp;
134sed -i -e "s/GPERF --version |/&amp; head -n 1 |/" \
135 -e "s|/usr/local/share|/usr/share|" configure &amp;&amp;
136
137./configure --prefix=/usr \
138 --sysconfdir=/etc/a2ps \
139 --enable-shared \
140 --with-medium=letter &amp;&amp;
141make &amp;&amp;
142touch doc/*.info</userinput></screen>
143
144 <para>
145 To test the results, issue: <command>make check</command>.
146 The <filename>printers.tst</filename> test will fail, as there is no
147 default test printer. The <filename>styles.tst</filename> may also
148 fail, as the tests report some inconsistencies between the generated
149 postscript and the reference sets. This is caused by version number
150 differences between the postscript test files and those generated by
151 the tests &mdash; these do not affect the operation of the program
152 and can be ignored.
153 </para>
154
155 <para>
156 Now, as the <systemitem class="username">root</systemitem> user:
157 </para>
158
159<screen role="root"><userinput>make install</userinput></screen>
160
161 <para>
162 If desired, install the downloaded i18n-fonts by running the following
163 commands as the <systemitem class="username">root</systemitem> user:
164 </para>
165
166<screen role="root"><userinput>tar -xf ../i18n-fonts-&i18n-fonts-version;.tar.bz2 &amp;&amp;
167cp -v i18n-fonts-&i18n-fonts-version;/fonts/* /usr/share/a2ps/fonts &amp;&amp;
168cp -v i18n-fonts-&i18n-fonts-version;/afm/* /usr/share/a2ps/afm &amp;&amp;
169pushd /usr/share/a2ps/afm &amp;&amp;
170 ./make_fonts_map.sh &amp;&amp;
171 mv fonts.map.new fonts.map &amp;&amp;
172popd</userinput></screen>
173
174 </sect2>
175
176 <sect2 role="commands">
177 <title>Command Explanations</title>
178
179 <para>
180 <command>autoconf</command>: This command is used to recreate the
181 <command>configure</command> script. This is required because there is
182 an issue in the mktime test which causes the
183 <command>configure</command> script to hang for 60 seconds and then
184 report that there is no working mktime function.
185 </para>
186
187 <para>
188 <command>sed -i "s/GPERF --version |/&amp; head -n 1 |/" configure</command>:
189 This fixes a bug in the handling of the version output of
190 <command>gperf</command>.
191 </para>
192
193 <para>
194 <command>sed -i "s|/usr/local/share|/usr/share|" configure</command>:
195 This command modifies the <command>configure</command> script to search
196 for <application>Ghostscript</application> fonts at the location where
197 they were installed by the BLFS instructions.
198 </para>
199
200 <para>
201 <parameter>--sysconfdir=/etc/a2ps</parameter>: Configuration data is
202 installed in <filename class="directory">/etc/a2ps</filename> instead of
203 <filename class="directory">/usr/etc</filename>.
204 </para>
205
206 <para>
207 <parameter>--enable-shared</parameter>: This switch enables building
208 the dynamic <filename class='libraryfile'>liba2ps</filename> library.
209 </para>
210
211 <para>
212 <parameter>--with-medium=letter</parameter>: This switch changes the
213 default paper format to US letter. It can either be given here or set
214 in <filename>/etc/a2ps/a2ps-site.cfg</filename> after installation. The
215 default is A4, but there are several other options, in particular: A4dj
216 or letterdj are good settings for HP Deskjet and other printers that need
217 wider paper-handling margins. See <filename>/etc/a2ps/a2ps.cfg</filename>
218 after installation.
219 </para>
220
221 <para>
222 <command>touch doc/*.info</command>: This command avoids trying to
223 regenerate the info files. This is an older package and the current
224 <filename class="extension">.texi</filename> files will produce errors
225 preventing <command>make install</command> from working properly.
226 </para>
227
228 </sect2>
229
230 <sect2 role="configuration">
231 <title>Configuring a2ps</title>
232
233 <sect3 id="a2ps-config">
234 <title>Config Files</title>
235
236 <para>
237 <filename>/etc/a2ps/a2ps.cfg</filename> and
238 <filename>/etc/a2ps/a2ps-site.cfg</filename>
239 </para>
240
241 <indexterm zone="a2ps a2ps-config">
242 <primary sortas="e-etc-a2ps-a2ps.cfg">/etc/a2ps/a2ps.cfg</primary>
243 </indexterm>
244
245 <indexterm zone="a2ps a2ps-config">
246 <primary sortas="e-etc-a2ps-a2ps-site.cfg">/etc/a2ps/a2ps-site.cfg</primary>
247 </indexterm>
248
249 </sect3>
250
251 <sect3>
252 <title>Configuration Information</title>
253
254 <para>
255 Information about configuring <application>a2ps</application>
256 can be found in the comments contained in the above files, and also
257 by running <command>info a2ps</command>.
258 </para>
259
260 </sect3>
261
262 </sect2>
263
264 <sect2 role="content">
265 <title>Contents</title>
266
267 <segmentedlist>
268 <segtitle>Installed Programs</segtitle>
269 <segtitle>Installed Libraries</segtitle>
270 <segtitle>Installed Directories</segtitle>
271
272 <seglistitem>
273 <seg>a2ps, card, composeglyphs, fixnt, fixps, ogonkify,
274 pdiff, psmandup, psset, and texi2dvi4a2ps</seg>
275 <seg>liba2ps.{so,a} and filter data</seg>
276 <seg>/etc/a2ps and /usr/share/a2ps</seg>
277 </seglistitem>
278 </segmentedlist>
279
280 <variablelist>
281 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
282 <?dbfo list-presentation="list"?>
283 <?dbhtml list-presentation="table"?>
284
285 <varlistentry id="a2ps-prog">
286 <term><command>a2ps</command></term>
287 <listitem>
288 <para>
289 is a filter, utilized primarily by printing scripts,
290 that converts standard input or supported files to PostScript.
291 </para>
292 <indexterm zone="a2ps a2ps-prog">
293 <primary sortas="b-a2ps">a2ps</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="card">
299 <term><command>card</command></term>
300 <listitem>
301 <para>
302 prints a reference card of a given program's options.
303 </para>
304 <indexterm zone="a2ps card">
305 <primary sortas="b-card">card</primary>
306 </indexterm>
307 </listitem>
308 </varlistentry>
309
310 <varlistentry id="composeglyphs">
311 <term><command>composeglyphs</command></term>
312 <listitem>
313 <para>
314 creates a composite font program.
315 </para>
316 <indexterm zone="a2ps composeglyphs">
317 <primary sortas="b-composeglyphs">composeglyphs</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="fixnt">
323 <term><command>fixnt</command></term>
324 <listitem>
325 <para>
326 is supposed to fix the problems in the PostScript files
327 generated by the Microsoft PostScript driver under Windows NT
328 (3.5 and 4.0).
329 </para>
330 <indexterm zone="a2ps fixnt">
331 <primary sortas="b-fixnt">fixnt</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 <varlistentry id="fixps">
337 <term><command>fixps</command></term>
338 <listitem>
339 <para>
340 tries to fix common PostScript problems that break
341 postprocessing.
342 </para>
343 <indexterm zone="a2ps fixps">
344 <primary sortas="b-fixps">fixps</primary>
345 </indexterm>
346 </listitem>
347 </varlistentry>
348
349 <varlistentry id="ogonkify">
350 <term><command>ogonkify</command></term>
351 <listitem>
352 <para>
353 provides international support for Postscript by performing various
354 munging of PostScript files related to printing in different
355 languages.
356 </para>
357 <indexterm zone="a2ps ogonkify">
358 <primary sortas="b-ogonkify">ogonkify</primary>
359 </indexterm>
360 </listitem>
361 </varlistentry>
362
363 <varlistentry id="pdiff">
364 <term><command>pdiff</command></term>
365 <listitem>
366 <para>
367 produces a pretty comparison between files.
368 </para>
369 <indexterm zone="a2ps pdiff">
370 <primary sortas="b-pdiff">pdiff</primary>
371 </indexterm>
372 </listitem>
373 </varlistentry>
374
375 <varlistentry id="psmandup">
376 <term><command>psmandup</command></term>
377 <listitem>
378 <para>
379 tries to produce a version of a given PostScript file to
380 print in manual duplex.
381 </para>
382 <indexterm zone="a2ps psmandup">
383 <primary sortas="b-psmandup">psmandup</primary>
384 </indexterm>
385 </listitem>
386 </varlistentry>
387
388 <varlistentry id="psset">
389 <term><command>psset</command></term>
390 <listitem>
391 <para>
392 produces a version of a given PostScript file with a
393 protected call to the PostScript operator 'setpagedevice'.
394 Typical use is making a file print duplex, or on the manual
395 tray, etc.
396 </para>
397 <indexterm zone="a2ps psset">
398 <primary sortas="b-psset">psset</primary>
399 </indexterm>
400 </listitem>
401 </varlistentry>
402
403 <varlistentry id="texi2dvi4a2ps">
404 <term><command>texi2dvi4a2ps</command></term>
405 <listitem>
406 <para>
407 compiles Texinfo and LaTeX files to DVI or PDF.
408 </para>
409 <indexterm zone="a2ps texi2dvi4a2ps">
410 <primary sortas="b-texi2dvi4a2ps">texi2dvi4a2ps</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 </variablelist>
416
417 </sect2>
418
419</sect1>
Note: See TracBrowser for help on using the repository browser.