![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to maha.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / new / dipress / man / mann|
Return to maha.1 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / new / dipress / man / mann |
1.1 root 1: .\" (c) Copyright 1986 Xerox Corporation
2: .\" All rights reserved.
3: .ds f. maha.1.tbl
4: .\" tbl maha.1.tbl | troff -man
5: .TH MAHA 1 2/11/86
6: .UC 4
7: .tr -\-
8: .\" differences between troff and nroff compensated here:
9: .ie t .ds sc \(sc
10: .el .ds sc section\
11: .ds lq \&"\"
12: .ds rq \&"\"
13: .if t \
14: . ds lq ``
15: .if t \
16: . ds rq ''
17: .SH NAME
18: maha - make and print interpress files
19: .SH SYNOPSIS
20: .B maha
21: [ options ] [ files ]
22: .SH DESCRIPTION
23: .I Maha
24: (maharani-the Interpress version of the program czarina) reads in text
25: files, converts them to interpress format and ships them to an
26: interpress printer. It also performs some simple page formatting.
27: .PP
28: The environment variable MAHA may be used to specify default options.
29: The value of MAHA is parsed as a string of arguments before the arguments
30: that appear on the command line. For example, "MAHA=`-f Classic/8'" sets
31: your default body font to 8 point Classic.
32: .PP
33: In case conflicting options are given, the last option seen takes precidence.
34: Options are processed left to right, first processing any options in the
35: MAHA environment variable, then any options given on the command line.
36: .PP
37: The possible options are:
38: .TP
39: .BI - n
40: Prints output
41: .I n
42: columns per page (note that
43: .I n
44: is limited to one digit)
45: .TP
46: .BI -b \ banner
47: Uses
48: .I
49: banner
50: to label the output. It will appear on the cover page
51: on the line labeled \*(lqDocument\*(rq.
52: .TP
53: .BI -c \ n
54: Causes
55: .I n
56: copies of the output to be printed. The default is 1.
57: .TP
58: .BI -f \ font\ \ \ \ \
59: Sets the font to be used for the body of each page.
60: The default is \*(lqVintage-Printwheel/10\*(rq.
61: .TP
62: .BI -F \ font
63: Sets the font to be used for page headings.
64: The default is \*(lqModern-Bold/12\*(rq.
65: .TP
66: .BI -H \ header
67: Sets the format for page headings to the string
68: .IR header .
69: This overrides the
70: .B -t
71: option.
72: Certain formatting options can be embedded in this string. See the
73: section below entitled \*(lqHeader Format\*(rq.
74: The default header is constructed from the file name, its last
75: modification date, and a page and line number.
76: .TP
77: .BI -h \ header
78: Appends the string
79: .I header
80: to the current header format string. This can be used to append
81: something to the default header.
82: This overrides the
83: .B -t
84: option.
85: .TP
86: .B -l
87: Causes line printer simulation mode to be used: pages will be 66 lines
88: long and headers will be omitted.
89: Turns on the
90: .B -t
91: option.
92: .TP
93: .BI -n \ name
94: Sets the delivery address of your output (the \*(lqFor\*(rq field on the
95: cover sheet) to
96: .IR name .
97: The default is your full name as recorded in the gecos field of the password
98: file (\*(lq/etc/passwd\*(rq).
99: .TP
100: .BI -o \ file\ \ \ \ \
101: The interpress code is written into
102: .IR file .
103: The default is generated from the process i.d. of the program.
104: .TP
105: .BI -P \ printer
106: Directs the interpresss code to
107: .I printer
108: for printing.
109: .TP
110: .B -r
111: Rotates the output 90 degrees on the page (landscape mode).
112: This is good for output that requires a wide page or for program listings
113: when specifying two columns. Some people like the program listings produced
114: by the command \*(lq\fBmaha -2 -r\fP files\*(rq.
115: .TP
116: .B -R
117: Forces portrait mode (default). This overrides the
118: .B -r
119: option. It is useful (for example) if the environment variable MAHA sets
120: .BR -r .
121: .TP
122: .BI -s \ pages
123: Selects pages to be printed.
124: .I Pages
125: may be a single page specification (eg. \*(lq5\*(rq), a range
126: of pages (\*(lq5-10\*(rq),
127: or a list of page specifications (eg. \*(lq3,11-13\*(rq). Note
128: that this syntax is identical to that accepted by the
129: .B -o
130: option of
131: .IR troff .
132: .TP
133: .B -t
134: Causes page headings (titles) to be omitted.
135: .sp
136: .PP
137: .B "Specifying Fonts"
138: .PP
139: The naming scheme for fonts is a slight variant on the universal naming
140: scheme used by interpress. See \*(sc3.2.2 in
141: .I "Interpress Electronic Printing Standard"
142: (\s8XSIS\s0 048404) for a description of universal names.
143: Each identifier of a universal font name is
144: separated by a slash (\*(lq/\*(rq). If the final identifier in
145: the name is nothing more than a series of digits,
146: as in \*(lqClassic/8\*(rq, then it is taken to be a point size. The actual
147: universal name is formed by removing this last identifier.
148: If the last part of the name is not strictly a number, then the
149: point size is assumed to be 10.
150: Since most
151: environments use the same prefix for a universal font name,
152: A standard prefix of several identifiers
153: is prepended to every font name given on the command line.
154: This can be overridden by placing a slash at the front of the given name
155: in which case the universal name is formed by simply removing the slash
156: from the front of the name. Note that the point size calculation mentioned
157: above will still be performed on this type of name.
158: .PP
159: Here are some examples that should clear the air:
160: .sp
161: .TS
162: .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
163: .de 35
164: .ps \n(.s
165: .vs \n(.vu
166: .in \n(.iu
167: .if \n(.u .fi
168: .if \n(.j .ad
169: .if \n(.j=0 .na
170: ..
171: .nf
172: .nr #~ 0
173: .if n .nr #~ 0.6n
174: .ds #d .d
175: .if \(ts\n(.z\(ts\(ts .ds #d nl
176: .fc
177: .nr 33 \n(.s
178: .rm 80 81 82
179: .nr 80 0
180: .nr 38 \wName Given
181: .if \n(80<\n(38 .nr 80 \n(38
182: .nr 38 \wClassic
183: .if \n(80<\n(38 .nr 80 \n(38
184: .nr 38 \wModern/12
185: .if \n(80<\n(38 .nr 80 \n(38
186: .nr 38 \w/Rice/TimesRoman
187: .if \n(80<\n(38 .nr 80 \n(38
188: .nr 38 \w/Rice/TimesRoman/Italic/8
189: .if \n(80<\n(38 .nr 80 \n(38
190: .nr 38 \w/Rice/VileBlob/8/10
191: .if \n(80<\n(38 .nr 80 \n(38
192: .80
193: .rm 80
194: .nr 81 0
195: .nr 38 \wUniversal Name
196: .if \n(81<\n(38 .nr 81 \n(38
197: .nr 38 \wXerox/XC1-1-1/Classic
198: .if \n(81<\n(38 .nr 81 \n(38
199: .nr 38 \wXerox/XC1-1-1/Modern
200: .if \n(81<\n(38 .nr 81 \n(38
201: .nr 38 \wRice/TimesRoman
202: .if \n(81<\n(38 .nr 81 \n(38
203: .nr 38 \wRice/TimesRoman/Italic
204: .if \n(81<\n(38 .nr 81 \n(38
205: .nr 38 \wRice/VileBlob/8
206: .if \n(81<\n(38 .nr 81 \n(38
207: .81
208: .rm 81
209: .nr 82 0
210: .nr 38 \wPoint Size
211: .if \n(82<\n(38 .nr 82 \n(38
212: .nr 38 \w10
213: .if \n(82<\n(38 .nr 82 \n(38
214: .nr 38 \w12
215: .if \n(82<\n(38 .nr 82 \n(38
216: .nr 38 \w10
217: .if \n(82<\n(38 .nr 82 \n(38
218: .nr 38 \w8
219: .if \n(82<\n(38 .nr 82 \n(38
220: .nr 38 \w10
221: .if \n(82<\n(38 .nr 82 \n(38
222: .82
223: .rm 82
224: .nr 38 1n
225: .nr 79 0
226: .nr 40 \n(79+(0*\n(38)
227: .nr 80 +\n(40
228: .nr 41 \n(80+(3*\n(38)
229: .nr 81 +\n(41
230: .nr 42 \n(81+(3*\n(38)
231: .nr 82 +\n(42
232: .nr TW \n(82
233: .if t .if (\n(TW+\n(.o)>7.65i .tm Table at line 150 file maha.1.tbl is too wide - \n(TW units
234: .nr #I \n(.i
235: .in +(\n(.lu-\n(TWu-\n(.iu)/2u
236: .fc
237: .nr #T 0-1
238: .nr #a 0-1
239: .eo
240: .de T#
241: .ds #d .d
242: .if \(ts\n(.z\(ts\(ts .ds #d nl
243: .mk ##
244: .nr ## -1v
245: .ls 1
246: .ls
247: ..
248: .ec
249: .ta \n(80u \n(81u \n(82u
250: .nr 31 \n(.f
251: .nr 35 1m
252: \&\h'|\n(40u'Name Given\h'|\n(41u'Universal Name\h'|\n(42u'Point Size
253: .ta \n(80u \n(81u \n(82u
254: .nr 31 \n(.f
255: .nr 35 1m
256: \&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
257: .ta \n(80u \n(81u \n(82u
258: .nr 31 \n(.f
259: .nr 35 1m
260: \&\h'|\n(40u'Classic\h'|\n(41u'Xerox/XC1-1-1/Classic\h'|\n(42u'10
261: .ta \n(80u \n(81u \n(82u
262: .nr 31 \n(.f
263: .nr 35 1m
264: \&\h'|\n(40u'Modern/12\h'|\n(41u'Xerox/XC1-1-1/Modern\h'|\n(42u'12
265: .ta \n(80u \n(81u \n(82u
266: .nr 31 \n(.f
267: .nr 35 1m
268: \&\h'|\n(40u'/Rice/TimesRoman\h'|\n(41u'Rice/TimesRoman\h'|\n(42u'10
269: .ta \n(80u \n(81u \n(82u
270: .nr 31 \n(.f
271: .nr 35 1m
272: \&\h'|\n(40u'/Rice/TimesRoman/Italic/8\h'|\n(41u'Rice/TimesRoman/Italic\h'|\n(42u'8
273: .ta \n(80u \n(81u \n(82u
274: .nr 31 \n(.f
275: .nr 35 1m
276: \&\h'|\n(40u'/Rice/VileBlob/8/10\h'|\n(41u'Rice/VileBlob/8\h'|\n(42u'10
277: .fc
278: .nr T. 1
279: .T# 1
280: .in \n(#Iu
281: .35
282: .TE
283: .if \n-(b.=0 .nr c. \n(.c-\n(d.-10
284: .sp
285: If a font name has the unfortunate characteristic of containing nothing but
286: numbers in its last identifier, it can still be specified by always appending
287: a point size to the name, as in the last example above.
288: .sp
289: .PP
290: .B "Header Format"
291: .PP
292: The string that is used to build the header can have format options embedded
293: in it. Each formatting option is preceded with the character \*(lq%\*(rq in
294: a manner similar to
295: .IR printf (3S)
296: strings in C. The following format characters are recognized:
297: .sp
298: .TS
299: .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
300: .de 35
301: .ps \n(.s
302: .vs \n(.vu
303: .in \n(.iu
304: .if \n(.u .fi
305: .if \n(.j .ad
306: .if \n(.j=0 .na
307: ..
308: .nf
309: .nr #~ 0
310: .if n .nr #~ 0.6n
311: .ds #d .d
312: .if \(ts\n(.z\(ts\(ts .ds #d nl
313: .fc
314: .nr 33 \n(.s
315: .rm 80 81
316: .nr 80 0
317: .nr 38 \wf
318: .if \n(80<\n(38 .nr 80 \n(38
319: .nr 38 \wt
320: .if \n(80<\n(38 .nr 80 \n(38
321: .nr 38 \wp
322: .if \n(80<\n(38 .nr 80 \n(38
323: .nr 38 \wl
324: .if \n(80<\n(38 .nr 80 \n(38
325: .80
326: .rm 80
327: .nr 81 0
328: .nr 38 \wcurrent file name
329: .if \n(81<\n(38 .nr 81 \n(38
330: .nr 38 \wlast modified time of the current file
331: .if \n(81<\n(38 .nr 81 \n(38
332: .nr 38 \wcurrent page number
333: .if \n(81<\n(38 .nr 81 \n(38
334: .nr 38 \wline number for the top line of the current page
335: .if \n(81<\n(38 .nr 81 \n(38
336: .81
337: .rm 81
338: .nr 38 1n
339: .nr 79 0
340: .nr 40 \n(79+(0*\n(38)
341: .nr 80 +\n(40
342: .nr 41 \n(80+(3*\n(38)
343: .nr 81 +\n(41
344: .nr TW \n(81
345: .if t .if (\n(TW+\n(.o)>7.65i .tm Table at line 172 file maha.1.tbl is too wide - \n(TW units
346: .nr #I \n(.i
347: .in +(\n(.lu-\n(TWu-\n(.iu)/2u
348: .fc
349: .nr #T 0-1
350: .nr #a 0-1
351: .eo
352: .de T#
353: .ds #d .d
354: .if \(ts\n(.z\(ts\(ts .ds #d nl
355: .mk ##
356: .nr ## -1v
357: .ls 1
358: .ls
359: ..
360: .ec
361: .ta \n(80u \n(81u
362: .nr 31 \n(.f
363: .nr 35 1m
364: \&\h'|\n(40u'f\h'|\n(41u'current file name
365: .ta \n(80u \n(81u
366: .nr 31 \n(.f
367: .nr 35 1m
368: \&\h'|\n(40u't\h'|\n(41u'last modified time of the current file
369: .ta \n(80u \n(81u
370: .nr 31 \n(.f
371: .nr 35 1m
372: \&\h'|\n(40u'p\h'|\n(41u'current page number
373: .ta \n(80u \n(81u
374: .nr 31 \n(.f
375: .nr 35 1m
376: \&\h'|\n(40u'l\h'|\n(41u'line number for the top line of the current page
377: .fc
378: .nr T. 1
379: .T# 1
380: .in \n(#Iu
381: .35
382: .TE
383: .if \n-(b.=0 .nr c. \n(.c-\n(d.-7
384: .sp
385: If a percent sign is followed by a character not in the list above, then
386: that character gets printed (without the leading percent sign). Note that a
387: percent sign can still be printed in the header by placing two in the
388: format. The default format string is:
389: .sp
390: .nf
391: .ce
392: "%f %t Page %p, line %l"
393: .fi
394: .SH ENVIRONMENT
395: .DT
396: MAHA strings of options to be used by
397: .IR maha .
398: .PP
399: .SH FILES
400: /etc/passwd contains information about system users
401: .SH "SEE ALSO"
402: cz(1) czarina
403: .PP
404: Interpress Electronic Printing Standard, \s8XSIS\s0 048404
405: .SH BUGS
406: The document name doesn't appear on the banner page like it should.
407: This is really the fault of the queueing software.
408: .PP
409: .I Maha
410: will not
411: realize that a file is already in interpress format and skip the
412: conversion phase.
413: .PP
414: .I Maha
415: doesn't have any metric information. Thus it won't wrap or clip lines.
416: If you are using a fixed width font, use ``pr'' as pre-processor.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.