ctlmp(1)ctlmp(1)WARNINGctlmp - PostScript pretty printer might not be supported in a future
release. Please use mp(1) print filter or another suitable printing
mechanism instead.
NAMEctlmp - PostScript pretty printer
SYNOPSISctlmp [ -A4 ] [ -C ] [ -F ] [ -L localename ] [ -O orientation ] [ -PS
] [ -US ] [ -a ] [ -c chars ] [ -d ] [ -e ] [ -ff ] [ -fp ] [ -l ] [ -m
] [ -o ] [ -p prologue ] [ -s subject ] [ -tm ] [ -ts ] [ -v ] [ -w
words ] [ -W ][ -? ] [ filename... ]
DESCRIPTION
The ctlmp program reads each filename in sequence and generates a pret‐
tified version of the contents in POSTSCRIPT format, sent to standard
output. If no filename argument is provided, ctlmp reads the standard
input. If the standard input is a terminal, input is terminated by an
EOF signal, usually Ctrl-D.
Mail items, news articles, ordinary ASCII files, complete mail folders,
and digests are all acceptable input formats for ctlmp. The output
format includes grayscale lozenges containing banner information at the
top and bottom of every page.
The program is conveniently used in conjunction with the print button
of the mailtool(1) program, or the pipe command provided by mail(1).
Add the following two lines to your .mailrc file:
set printmail='ctlmp | lp'
set cmd="ctlmp | lp &"
Source the .mailrc file, and you are ready to use ctlmp. For printing
ordinary ASCII files, the following alias (to be placed in your .cshrc
file) may also prove useful:
alias print 'ctlmp -o -s "\!*" <\!* | lp'
OPTIONS-A4 Use A4 paper size (8.5 x 11.4 inches).
-C Instead of using "\nFrom" to denote the start of new mail mes‐
sages, ctlmp will look for (and use) the value of the Content-
Length: mail header. If the Content-Length doesn't take you to
the next "\nFrom", then it's wrong, and ctlmp falls back to
looking for the next "\nFrom" in the mail folder.
-F Instead of printing who the mail article is for, the top header
will contain who the mail article is from. A useful option for
people with their own personal printer.
-L localename
Provide the locale of the file to be printed. If this command
line option is not present, then ctlmp looks for the MP_LANG
environment variable. If that is not present, then the LANG
environment variable is used. If none of these options are
present, then ctlmp tries to determine the locale it is running
in, and if it cannot, then it assumes it is running in the C
locale, otherwise a prologue file specific to the given locale
is prepended to the output. This is to provide I18N level 4
(multibyte) printing.
In CTL locales (ar, he, and th_TH) the printed text layout can be con‐
trolled by a file located at:
($OPENWINHOME/lib/locale/<localename>/print/ctlmpresource).
The following controls can be added to ctlmpresource file:
Orientation : ORIENTATION_LTR or
: ORIENTATION_LTR or
: ORIENTATION_CONTEXTUAL
Numerals : NUMERALS_NOMINAL or
: NUMERALS_NATIONAL or
: NUMERALS_CONTEXTUAL
TextShaping : TEXT_SHAPED or
: TEXT_NOMINAL or
: TEXT_SHFORM1 or
: TEXT_SHFORM2 or
: TEXT_SHFORM3 or
: TEXT_SHFORM4
SWAPPING : YES or NO
TEXT_VISUAL or TEXT_IMPLICIT
CONTEXT_LTR or CONTEXT_RTL
If one of these values is not correctly set in the ctlmpresource
or the file doesn't exist then ctlmp will use the default layout
values.
-O orientation
A command line that controls the text orientation of the printed
file, specifically for Arabic and Hebrew locales. the orienta‐
tion could be rtl for right to left layout and right justified
printed text, ltr for left to right text, and context for the
context dependent layout direction. if this command line option
is not present, then ctlmp will use the Orientation setting in
the ctlmpresource file, if the Orientation is not set in the
ctlmpresource file then the default locale orientation will be
used.
-PS If the mail or digest message just has PostScript as the text of
the message, then this is normally just passed straight through.
Specifying this option, causes PostScript to be printed as text.
-US Use US paper size (8.5 x 11 inches). This is the default paper
size.
-a Format the file as a news article. The top banner contains the
text: "Article from newsgroup", where newsgroup is the first
news group found on the Newsgroups: line.
-c chars
The maximum number of characters to extract from the gecos field
of the users /etc/passwd entry. The default is 18.
-d Format the file as a digest.
-e Assume the ELM mail frontend intermediate file format. Used when
printing messages from within ELM (using the "p" command), espe‐
cially for printing tagged messages. This option must be speci‐
fied in your ELM option setup.
-ff Format the file for use with a Filofax personal organiser.
-fp Format the file for use with a Franklin Planner personal organ‐
iser.
-l Format output in landscape mode. Two pages of text will be
printed per sheet of paper.
-m Format the file as a mail folder, printing multiple messages.
-o Format the file as an ordinary ASCII file.
-p prologue
Employ the file prologue as the POSTSCRIPT prologue file, over‐
riding any previously defined file names.
-s subject
Use subject as the new subject for the printout. If you are
printing ordinary ASCII files which have been specified on the
command line, the the subject will default to the name of each
of these files.
-tm Format the file for use with the Time Manager personal organ‐
iser.
-ts format the file for use with the Time/System International per‐
sonal organiser.
-v Print the version number of this release of ctlmp.
-v Print the version number of this release of
-w words
The maximum number of words to extract from the gecos field of
the users /etc/passwd entry. The default is 3.
-W Disable the line wrap. (line wrap is enabled by default).
-? Print the usage line for ctlmp (note that the ? character must
be escaped if using csh(1)).
ENVIRONMENT VARIABLES
The ctlmp prologue file is determined by first looking for the environ‐
ment variable MP_PROLOGUE, which specifies the directory where ctlmp
prologue files are to be found. If MP_PROLOGUE is not found, then the
default directory is assumed ($OPENWINHOME/share/xnews/client/ctlmp).
ctlmp also checks for the MP_LANG and LANG environment variables. If
present, then a prologue file called ($OPENWINHOME/lib/locale/<locale‐
name>/print/prolog.ps) is prepended to the output to be printed.
SUPPLIED PROLOGUE FILES
The following prologue files are provided:
ctlmp.pro.ps
Used by default
ctlmp.pro.ff.ps
Used if the -ff option is in effect
ctlmp.pro.fp.ps
Used if the -fp option is in effect
ctlmp.pro.tm.ps
Used if the -tm option is in effect
ctlmp.pro.ts.ps
Used if the -ts option is in effect
ctlmp.pro.alt.ps
An alternative modification of the default prologue file
which outputs the page number in the right corner of the
bottom banner.
FILES
.cshrc initialization file for csh(1)
.mailrc
initialization file for mail(1)
$OPENWINHOME/bin/ctlmp
executable
$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.ps
POSTSCRIPT prologue for mail printing
$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.l.ps
POSTSCRIPT prologue for landscape format
$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.alt.ps
alternative "default" POSTSCRIPT prologue, inserts page numbers
in the bottom right corner of each page
$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.ff.ps
POSTSCRIPT prologue for Filofax format
LIBDIR/ctlmp.pro.fp.ps
POSTSCRIPT prologue for Franklin Planner format.
$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.tm.ps
POSTSCRIPT prologue for Time Manager format
$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.ts.ps
POSTSCRIPT prologue for Time/System International format.
SEE ALSOmail(1), mailtool(1),
AUTHORS
Original version by Steve Holden.
Converted to C, modified and maintained by Rich Burridge, SunSoft Inc,
Mountain View.
Original modified to handle net news articles and MH mail by Bruno Pil‐
lard, Chorus Systemes, France.
Handling of mail digests added by Dave Glowacki of Public Works Com‐
puter Services, St Paul, MN.
Manual page revised by Rick Rodgers, UCSF School of Pharmacy, San Fran‐
cisco.
Support for Personal Organiser printing style added by Douglas
Buchanan, Sun Microsystems Europe.
Substantial modifications to header parsing by Jeremy Webber, Computer
Science Department, University of Adelaide, Australia.
Support for printing multiple files and subject line filename print for
ordinary ASCII files added by Sam Manoharan, Edinburgh University.
Support for landscape mode written by Michael Tuciarone.
Revision of the POSTSCRIPT structuring and the way that the prologue
files are handled was included by Johan Vromans.
New style POSTSCRIPT prologue files by John Macdonald.
Support for the ISO8859 character set by Bertrand DeCouty.
Rich Burridge. MAIL: richb@Eng.Sun.COM
The CTL (complex text languages) support added by Moataz Madkour MAIL: moatazm@ireland.sun.com
6 Jul 1998 ctlmp(1)