-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathnenscript.1
233 lines (188 loc) · 6.57 KB
/
nenscript.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
.TH NENSCRIPT 1 "28 October 1997"
.SH NAME
nenscript \- format an ASCII file and convert to PostScript
.SH SYNOPSIS
.B nenscript
[
.B \-?12BGghlNnRrsVWwZ
] [
.BI \-f font
] [
.BI \-F titlefont
] [
.BI \-b header
] [
.BI \-i filetitle
] [
.BI \-L lines
] [
.BI \-p filename
] [
.BI \-P printer
] [
.BI \-S classification
] [
.BI \-U 1st_page_classification
] [
.BI \-T papertype
] [
.BI \-t tabstops
] [
.BI \-# copies
] [
.I file...
]
.SH DESCRIPTION
Formats the specified ASCII files and produces PostScript output conforming to the Adobe Structuring Conventions.
The output pages may be in landscape or portrait mode, with one or two columns, with or without headers.
If no input files are specified, then input is accepted from stdin.
Tabs in the input stream are expanded (by default) to eight character positions.
Formfeed (control-L) characters in the input stream cause a new page or column to be started. Form feed characters must
be at the start start of a line, or preceded only by whitespace.
PostScript output is directed to a printer using
.B lpr
unless otherwise specified using the \-p option. The printer to use is set by the PRINTER environment variable.
If this is not set, then the printer "Postscript" ("prn" for MSDOS) will be used.
Font specifications are formed from the font name and the font size, i.e.
.B Courier10
specifies a 10 point Courier font, and Courier-Bold12 specifies a bold, 12 point Courier font. Sizes can also be given with a decimal point, i.e.
.B Courier7.5
specifies a 7.5 point font, this might however result in a marginal error in
the size calculations, since a linear approximation of the character width
is done.
The NENSCRIPT environment variable may be used to set default values for most
configurable attributes. Values set in this way will be overridden by any
options specified on the commands line.
The current version of nenscript is 1.13.
.SH OPTIONS
.TP
.B \-?
.B \-h
Print usage message.
.TP
.B \-1
Specifies single column output (default).
.TP
.B \-2
Specifies two column output.
.TP
.B \-B
Turns off page titles.
.TP
.BI \-b header
Print the text specified by
.I header
as the title on each page, rather than the default header which is composed of the name of
the source file, the current time and date and the page number. If in gaudy mode, the title
is displayed in the blank area just above the file title.
.TP
.BI \-f font
Use
.I font
for printing text. Only Courier in sizes 5 to 30 can be used for printing text. The default font is Courier10, unless two column landscape mode is specified in which case the default font is Courier7.
.TP
.BI \-F titlefont
Use
.I titlefont
for printing titles. Any font in any point size can be used for printing titles.The default font is Courier-Bold10.
.TP
.B \-G
Enable gaudy mode.
.TP
.B \-g
Disable gaudy mode (default).
.TP
.BI \-i filetitle
Use the specified string as the displayed filename. Useful when inputting from stdin.
.TP
.BI \-L lines
Set the maximum number of lines which will be printed per page or column. The actual
number of lines which appear may be less depending upon the font and paper size.
.TP
.B \-l
Do not set a limit on on the maximum number of lines per page, i.e. the
number of lines is determined by the font size and the paper size (default).
.TP
.B \-N
Precede each line with it's line number relative to the start of the file.
.TP
.B \-n
Disable line numbering (default).
.TP
.BI \-p filename
Direct the PostScript to
.I filename
rather than the default printer. If '-' is specified as the filename, then the
PostScript is sent to stdout.
.TP
.BI \-P printer
Overrides the PRINTER environment variable in determining the printer to spool output to. Ignored if \-p is used.
.TP
.B \-R
Don't rotate the page, i.e. output in portrait mode (default).
.TP
.B \-r
Rotate the page, i.e. output in landscape mode.
.TP
.BI \-S classification
Prints the string argument in Helvetica-Bold28 at the top and bottom of the page in conformance to regulations for printing classified material.
.TP
.BI \-U 1st_page_classification
Print a different classification header for the first page. Useful
for marking banner sheets that need to be marked with a higher level of
classification until the document can be reviewed and declassified.
.TP
.B \-s
Disable a previous heading specified with the \-S option.
.TP
.BI \-T papertype
Sets the output paper type as per the argument. At the moment, only two paper types are supported: A4 and US. The
default paper size will be A4, unless the US_VERSION define is specified at compilation time.
.TP
.BI \-t tabsize
Sets the number of columns to which tabs are expanded. The default is eight columns.
.TP
.B \-V
Display information identifying the version of
.B nenscript. Nothing will be printed regardless of the other arguments.
.TP
.B \-W
Truncate lines which are wide for the page.
.TP
.B \-w
Wrap lines which are too wide for the page onto successive lines (default).
Continuation lines are marked with + character before the left margin.
.TP
.B \-Z
Check the first two characters of the input for the character string %!. If a match is found,
the input is copied directly to the output with no processing.
.TP
.BI \-# copies
Print each page
.I copies
times.
.SH ENVIRONMENT
.TP 15
.SB PRINTER
Specifies the name of the printer to direct PostScript output to. If not set, the default is a printer named "PostScript".
.TP 15
.SB NENSCRIPT
If defined, this string is searched for valid options before the command line supplied by the user.
.SH BUGS
As
.B nenscript
does not have access to complete PostScript font tables, it must use some other technique for
calculating the number of characters that fit across the page. The solution was to use a fixed table
for the Courier font in a range of sizes. If this table was extended, other fonts and sizes could be
used for printing text. Alternatively, if the text processing was done on the printer, then there
would be no need to know anything about the font sizes...
No checking is performed on font names, other than checking that only Courier can be specified for the
text font. If a font is specified that is not available on the final printer, the result is undetermined.
No checking is performed on the input file to detect accidental printing of garbage files. Caveat emptor!
No mapping of the input characters is performed, so output may vary depending upon the vagaries of
downstream software and hardware.
No support for manual feed, page prefeed, mail upon completion or any of the other rarely used options
of
.B enscript.
No messages are displayed whilst processing.
Input line lengths are limited to 8192 characters after expansion of tabs.