source: pst/ps/enscript.xml

trunk
Last change on this file was 7b2fed0f, checked in by Bruce Dubbs <bdubbs@…>, 7 weeks ago

Tags

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