ATP(1) | General Commands Manual | ATP(1) |
NAME¶
atp - Convert an ASCII or a text file to PostScript format for printingSYNOPSIS¶
atp [ -BCghlNoprRsvVW ] [ -c columns ] [ -t tabsize ] [ -f font ] [ -F headingsFont ] [ -cf commentsFont ] [ -title Title ] [ -date Date ] [ -M Tm,Bm,Lm,Rm [cm|in] ] [ -T papersize ] [ -wm string [font] ] [ -# copies ] [ -fonts ] [ -level1 ] [ -postscript ] [ file... ]DESCRIPTION¶
atp reads in text files and converts them to PostScript format. By default, it formats the output in two columns landscape mode in either an A4 or letter-size page, whichever was chosen by your system admin, with a 'fancy' header and using a 7 points Courier font. Fonts, paper sizes, headings and formatting options may be specified. atp -Co source.c
writes a two columns landscape listing of the file source.c in the file
source.c.ps, highlighting comments and function's headers.
atp -p file.txt | lpr
prints a copy of the file file.txt, in portrait mode, on the default printer
used by lpr.
-a font name, as known to PostScript (e.g.: Times-Roman, Courier-Bold)
-a point size (1 point = 1/72 inch); a valid font size is any floating point value comprised between 5 and 50 points.
-an (optional) transformation matrix, that consists of four floating point values, separated by a comma and preceded by a colon.
Courier-Bold9:1,0,0.25,1
Helvetica10.5
AvantGarde-Demi7.34:1.75,0,-0.4,.8
x' = a x + c y + e
y' = b x + d y + f
OPTIONS¶
- -o
- Direct the output to file filename.ps
- -p
- Print the output in portrait mode (the default is the
landscape mode).
- -C
- Assume that the input file is a C or a C++ source,
recognizes and highlights the comments and the function definition's
headers.
- -c columns
- Specify the number of the columns in which each page is
subdivided.
- -B
- Turn off page headings.
- -title Title
- Print the text specified by Title as the title on
each page, rather than the filename.
- -date Date
- Print the text specified by Date as the date on each page, rather than the current. Only the first 12 characters of Date are used.
- -f font
- Set the font to be used for the body of each page. The
default is Courier7 in landscape mode, Courier10 in portrait mode, and
Courier7:.83,0,0,1 if the -C option is set.
- -F headingFont
- Set the font to be used for the page headings. Defaults to
Helvetica-Bold16.
- -cf commentFont
- Set the font to be used for emphasize the comments in a C
source (when the -C option is specified). Defaults to Courier-BoldItalic7.
- -M Tm,Bm,Lm,Rm [cm|in]
- Set Top,Bottom,Left,Right margins. Their length is
specified in points (1 point = 1/72 inch), unless the suffix cm or
in are used.
- -g
- Disable the 'gaudy mode': don't paint the shaded frames in
the headings.
- -s
- Turn off the shading of the headings
- -T papersize
- Set the output paper type as per the argument. The
following paper sizes are recognized by atp: A3, A4,
A5, B4, B5, Executive, Folio,
Ledger, Legal, Letter, Quarto,
Statement, Tabloid, 10x14.
- -N
- Precede each line with it's line number relative to the
start of the file.
- -t tabsize
- Sets the number of columns to which tabs are expanded. The
default is eight columns.
- -h
- Print usage message.
- -v or -V
- Display information identifying the version of atp.
Nothing will be printed regardless of the other arguments.
- -r or -R
- Wrap the text on the space character preceding the
right margin.
- -W
- Truncate lines which are wide for the page.
- -l
- Simulate a line printer: make pages 66 lines long and omit
headers. (Useful to print manual pages).
- -wm string [Font]
- Print the watermark string on each page, using the
font Font or Times-BoldItalic, by default.
- -# copies
- Print each page copies times.
- -fonts
- List the fonts recognized by atp.
- -level1 (or -l1)
- Generate a PostScript output suitable for a PostScript
level 1 printer. With this option, the text file must contain only 7-bit
characters. By default, atp recognizes 8-bit characters and
produces a level 2 PostScript program.
- -postscript
- Do not pass through PostScript files.
SEE ALSO¶
lpr(1), lpq(1), lprm(1)BUGS¶
If a font is specified that is not available on the printer, the result is undetermined.AUTHOR¶
Paolo Severini - lendl@dist.dist.unige.it (MSDOS support by Kenneth H. Carpenter - khc@eece.ksu.edu; preprocessor papersize option and -date switch by Gabor J. Toth - jtoth@princeton.edu)January 28, 1995 |