source: pst/ps/enscript.xml

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

Still more tags

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