source: pst/ps/enscript.xml@ 3eeb0ce7

10.0 10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 3eeb0ce7 was 3eeb0ce7, checked in by Bruce Dubbs <bdubbs@…>, 2 years 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: 8.8 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 <!-- Keeping this URL as this is the actual maintainer's site
8 <!ENTITY enscript-download-http "http://www.iki.fi/mtr/genscript/enscript-&enscript-version;.tar.gz">
9 -->
10
11 <!ENTITY enscript-download-http "&gnu-http;/enscript/enscript-&enscript-version;.tar.gz">
12 <!ENTITY enscript-download-ftp "&gnu-ftp;/enscript/enscript-&enscript-version;.tar.gz">
13 <!ENTITY enscript-md5sum "3acc242b829adacabcaf28533f049afd">
14 <!ENTITY enscript-size "1.3 MB">
15 <!ENTITY enscript-buildsize "14 MB">
16 <!ENTITY enscript-time "0.1 SBU">
17]>
18
19<sect1 id="enscript" xreflabel="Enscript-&enscript-version;">
20 <?dbhtml filename="enscript.html"?>
21
22 <sect1info>
23 <othername>$LastChangedBy$</othername>
24 <date>$Date$</date>
25 </sect1info>
26
27 <title>Enscript-&enscript-version;</title>
28
29 <indexterm zone="enscript">
30 <primary sortas="a-Enscript">Enscript</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to Enscript</title>
35
36 <para>
37 <application>Enscript</application> converts ASCII text files
38 to PostScript, HTML, RTF, ANSI and overstrikes.
39 </para>
40
41 &lfs10_checked;
42
43 <caution>
44 <para>
45 <application>Enscript</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>Enscript</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="&enscript-download-http;"/>
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Download (FTP): <ulink url="&enscript-download-ftp;"/>
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Download MD5 sum: &enscript-md5sum;
70 </para>
71 </listitem>
72 <listitem>
73 <para>
74 Download size: &enscript-size;
75 </para>
76 </listitem>
77 <listitem>
78 <para>
79 Estimated disk space required: &enscript-buildsize;
80 </para>
81 </listitem>
82 <listitem>
83 <para>
84 Estimated build time: &enscript-time;
85 </para>
86 </listitem>
87 </itemizedlist>
88
89 <!-- <bridgehead renderas="sect3">Additional Downloads</bridgehead>
90 <itemizedlist spacing="compact">
91 <listitem>
92 <para>
93 Required patch: <ulink url=
94 "&patch-root;/enscript-&enscript-version;-security_fixes-1.patch"/>
95 </para>
96 </listitem>
97 </itemizedlist> -->
98
99 <bridgehead renderas="sect3">Enscript Dependencies</bridgehead>
100
101 <bridgehead renderas="sect4">Optional</bridgehead>
102 <para role="optional">
103 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
104 </para>
105
106 <para condition="html" role="usernotes">User Notes:
107 <ulink url="&blfs-wiki;/Enscript"/></para>
108 </sect2>
109
110 <sect2 role="installation">
111 <title>Installation of Enscript</title>
112
113 <para>
114 Install <application>Enscript</application> by running the
115 following commands:
116 </para>
117
118<screen><userinput>./configure --prefix=/usr \
119 --sysconfdir=/etc/enscript \
120 --localstatedir=/var \
121 --with-media=Letter &amp;&amp;
122make &amp;&amp;
123
124pushd docs &amp;&amp;
125 makeinfo --plaintext -o enscript.txt enscript.texi &amp;&amp;
126popd</userinput></screen>
127
128 <para>
129 If you have <xref linkend="texlive"/> installed, you can create
130 Postscript and PDF documentation by issuing (does not support parallel
131 make):
132 </para>
133
134<screen remap="doc"><userinput>make -j1 -C docs ps pdf</userinput></screen>
135
136 <para>
137 To test the results, issue: <command>make check</command>.
138 </para>
139
140 <para>
141 Now, as the <systemitem class="username">root</systemitem> user:
142 </para>
143
144<screen role="root"><userinput>make install &amp;&amp;
145
146install -v -m755 -d /usr/share/doc/enscript-&enscript-version; &amp;&amp;
147install -v -m644 README* *.txt docs/*.txt \
148 /usr/share/doc/enscript-&enscript-version;</userinput></screen>
149
150 <para>
151 If you built Postscript and PDF documentation, install it
152 using the following command as the
153 <systemitem class="username">root</systemitem> user:
154 </para>
155
156<screen role="root"
157 remap="doc"><userinput>install -v -m644 docs/*.{dvi,pdf,ps} \
158 /usr/share/doc/enscript-&enscript-version;</userinput></screen>
159 </sect2>
160
161 <sect2 role="commands">
162 <title>Command Explanations</title>
163
164 <para>
165 <parameter>--sysconfdir=/etc/enscript</parameter>: This switch puts
166 configuration data in <filename class="directory">/etc/enscript</filename>
167 instead of <filename class="directory">/usr/etc</filename>.
168 </para>
169
170 <para>
171 <parameter>--localstatedir=/var</parameter>: This switch sets the
172 directory for runtime data to <filename class="directory">/var</filename>
173 instead of <filename class="directory">/usr/var</filename>.
174 </para>
175
176 <para>
177 <parameter>--with-media=Letter</parameter>: This switch sets the
178 medium format to letter size instead of the A4 default.
179 </para>
180 </sect2>
181
182 <sect2 role="content">
183 <title>Contents</title>
184
185 <segmentedlist>
186 <segtitle>Installed Programs</segtitle>
187 <segtitle>Installed Libraries</segtitle>
188 <segtitle>Installed Directories</segtitle>
189
190 <seglistitem>
191 <seg>diffpp, enscript, mkafmmap, over, sliceprint,
192 and states</seg>
193 <seg>None</seg>
194 <seg>/etc/enscript, /usr/share/doc/enscript-&enscript-version;, and
195 /usr/share/enscript</seg>
196 </seglistitem>
197 </segmentedlist>
198
199 <variablelist>
200 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
201 <?dbfo list-presentation="list"?>
202 <?dbhtml list-presentation="table"?>
203
204 <varlistentry id="diffpp">
205 <term><command>diffpp</command></term>
206 <listitem>
207 <para>
208 converts <command>diff</command> output files to a format
209 suitable to be printed with <command>enscript</command>.
210 </para>
211 <indexterm zone="enscript diffpp">
212 <primary sortas="b-diffpp">diffpp</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 <varlistentry id="enscript-prog">
218 <term><command>enscript</command></term>
219 <listitem>
220 <para>
221 is a filter, used primarily by printing scripts, that
222 converts ASCII text files to PostScript, HTML, RTF, ANSI and
223 overstrikes.
224 </para>
225 <indexterm zone="enscript enscript-prog">
226 <primary sortas="b-enscript">enscript</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="mkafmmap">
232 <term><command>mkafmmap</command></term>
233 <listitem>
234 <para>
235 creates a font map from a given file.
236 </para>
237 <indexterm zone="enscript mkafmmap">
238 <primary sortas="b-mkafmmap">mkafmmap</primary>
239 </indexterm>
240 </listitem>
241 </varlistentry>
242
243 <varlistentry id="over">
244 <term><command>over</command></term>
245 <listitem>
246 <para>
247 is a script which calls <command>enscript</command> and
248 passes the correct parameters to create overstriked fonts.
249 </para>
250 <indexterm zone="enscript over">
251 <primary sortas="b-over">over</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="sliceprint">
257 <term><command>sliceprint</command></term>
258 <listitem>
259 <para>
260 slices documents with long lines.
261 </para>
262 <indexterm zone="enscript sliceprint">
263 <primary sortas="b-sliceprint">sliceprint</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267
268 <varlistentry id="states">
269 <term><command>states</command></term>
270 <listitem>
271 <para>
272 is an <command>awk</command>-like text processing tool
273 with some state machine extensions. It is designed for program
274 source code highlighting and for similar tasks where state
275 information helps input processing.
276 </para>
277 <indexterm zone="enscript states">
278 <primary sortas="b-states">states</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 </variablelist>
284
285 </sect2>
286
287</sect1>
Note: See TracBrowser for help on using the repository browser.