source: pst/ps/a2ps.xml@ 81076bb6

10.0 10.1 11.0 8.4 9.0 9.1 lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 81076bb6 was 81076bb6, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tags for networking and postscript.
Archive two unused files.

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

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