source: archive/a2ps.xml@ fa91d2e

11.0 qt5new trunk
Last change on this file since fa91d2e was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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