2.11BSD/local/man/cat1/mp.0
MP(1) UNIX Programmer's Manual MP(1)
NAME
mp - POSTSCRIPT pretty printer
SYNOPSIS
mp [-A4] [-C] [-F] [-PS] [-US] [-a] [-d] [-e] [-ff] [-fp]
[-l] [-m] [-o] [-p _p_r_o_l_o_g_u_e] [-s _s_u_b_j_e_c_t] [-tm] [-ts] [-v]
[-?] [_f_i_l_e_n_a_m_e...]
DESCRIPTION
The _m_p program reads each _f_i_l_e_n_a_m_e in sequence and generates
a prettified version of the contents in POSTSCRIPT format,
sent to standard output. If no filename argument is pro-
vided, _m_p 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 _m_p. The output format includes grayscale lozenges con-
taining banner information at the top and bottom of every
page.
The program is conveniently used in conjunction with the
print button of the SunView/_x_n_e_w_s(1) _m_a_i_l_t_o_o_l(1) programs,
or the _p_i_p_e command provided by _m_a_i_l(1). Add the following
two lines to your ._m_a_i_l_r_c file:
set printmail='mp | lpr'
set cmd="mp | lpr &"
Source the ._m_a_i_l_r_c file, and you are ready to use _m_p. For
printing ordinary ASCII files, the following alias (to be
placed in your ._c_s_h_r_c file) may also prove useful:
alias print 'mp -o -s "\!*" <\!* | lpr'
OPTIONS
-A4 Use A4 paper size (8.5 x 11.4 inches).
-C Instead of using "\nFrom" to denote the start of new
mail messages, mp 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 mp 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.
-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
Printed 11/26/99 17 February 1992 1
MP(1) UNIX Programmer's Manual MP(1)
PostScript to be printed as text.
-US Use US paper size (8.5 x 11 inches).
-a Format the file as a news article. The top banner con-
tains the text: "Article from _n_e_w_s_g_r_o_u_p ", where _n_e_w_s_-
_g_r_o_u_p is the first news group found on the Newsgroups:
line.
-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), especially for printing tagged messages.
This option must be specified 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 per-
sonal organiser.
-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 _p_r_o_l_o_g_u_e
Employ the file _p_r_o_l_o_g_u_e as the POSTSCRIPT prologue
file, overriding any previously defined file names.
-s _s_u_b_j_e_c_t
Use _s_u_b_j_e_c_t 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
organiser.
-ts format the file for use with the Time/System Interna-
tional personal organiser.
-v Print the version number of this release of _m_p.
-? Print the usage line for _m_p (note that the ? character
must be escaped if using _c_s_h(1)).
Printed 11/26/99 17 February 1992 2
MP(1) UNIX Programmer's Manual MP(1)
ENVIRONMENT VARIABLES
The _m_p prologue file is determined by first looking for the
environment variable _M_P__P_R_O_L_O_G_U_E, which specifies the direc-
tory where _m_p prologue files are to be found. If
_M_P__P_R_O_L_O_G_U_E is not found, then the default directory is
assumed (/_u_s_r/_l_o_c_a_l/_l_i_b/_m_p/_m_p._p_r_o._p_s).
SUPPLIED PROLOGUE FILES
The following prologue files are provided:
_m_p._p_r_o._p_s
Used by default
_m_p._p_r_o._l._p_s
Used by the -l landscape mode option
_m_p._p_r_o._f_f._p_s
Used if the -ff option is in effect
_m_p._p_r_o._f_p._p_s
Used if the -fp option is in effect
_m_p._p_r_o._t_m._p_s
Used if the -tm option is in effect
_m_p._p_r_o._t_s._p_s
Used if the -ts option is in effect
_m_p._p_r_o._a_l_t._p_s
An alternative modification of the default prolo-
gue file which outputs the page number in the
right corner of the bottom banner.
_m_p._p_r_o._a_l_t_l._p_s
An alternative landscape option mode prologue
file.
FILES
._c_s_h_r_c
initialization file for _c_s_h(1)
._m_a_i_l_r_c
initialization file for _m_a_i_l(1)
/_u_s_r/_l_o_c_a_l/_m_p
executable
/_u_s_r/_l_o_c_a_l/_l_i_b/_m_p/_m_p._p_r_o._p_s
POSTSCRIPT prologue for mail printing
/_u_s_r/_l_o_c_a_l/_l_i_b/_m_p/_m_p._p_r_o._l._p_s
POSTSCRIPT prologue for landscape format
Printed 11/26/99 17 February 1992 3
MP(1) UNIX Programmer's Manual MP(1)
/_u_s_r/_l_o_c_a_l/_l_i_b/_m_p/_m_p._p_r_o._a_l_t._p_s
alternative "default" POSTSCRIPT prologue, inserts page
numbers in the bottom right corner of each page
/_u_s_r/_l_o_c_a_l/_l_i_b/_m_p/_m_p._p_r_o._a_l_t_l._p_s
alternative "landscape" POSTSCRIPT prologue.
/_u_s_r/_l_o_c_a_l/_l_i_b/_m_p/_m_p._p_r_o._f_f._p_s
POSTSCRIPT prologue for Filofax format
/_u_s_r/_l_o_c_a_l/_l_i_b/_m_p/_m_p._p_r_o._f_p._p_s
POSTSCRIPT prologue for Franklin Planner format.
/_u_s_r/_l_o_c_a_l/_l_i_b/_m_p/_m_p._p_r_o._t_m._p_s
POSTSCRIPT prologue for Time Manager format
/_u_s_r/_l_o_c_a_l/_l_i_b/_m_p/_m_p._p_r_o._t_s._p_s
POSTSCRIPT prologue for Time/System International for-
mat.
SEE ALSO
_m_a_i_l(1), _m_a_i_l_t_o_o_l(1), _x_n_e_w_s(1)
AUTHORS
Original version by Steve Holden.
Converted to C, modified and maintained by Rich Burridge,
Sun Microsystems, Australia.
Original modified to handle net news articles and MH mail by
Bruno Pillard, Chorus Systemes, France.
Handling of mail digests added by Dave Glowacki of Public
Works Computer Services, St Paul, MN.
Manual page revised by Rick Rodgers, UCSF School of Phar-
macy, San Francicso.
Support for Personal Organiser printing style added by Doug-
las 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 Tuchiarone.
Printed 11/26/99 17 February 1992 4
MP(1) UNIX Programmer's Manual MP(1)
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. PHONE: +61 2 413 2666 MAIL: richb@Aus.Sun.COM
Printed 11/26/99 17 February 1992 5