NAME

mp - PostScript pretty printer

SYNOPSIS

mp [ -A4 ] [ -C ] [ -F ] [ -L localename ] [ -PS ] [ -US ] [ -a ] [ -c chars ] [ -d ] [ -e ] [ -ff ] [ -fp ] [ -l ] [ -m ] [ -o ] [ -p prologue ] [ -s subject ] [ -tm ] [ -ts ] [ -v ] [ -w words ] [ -? ] [ filename. . . ]

DESCRIPTION

The mp program reads each filename in sequence and generates a prettified version of the contents in POSTS CRIPTformat, sent to standard output. If no filename argument is provided, mp 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 mp . 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='mp | lp'

set cmd="mp | lp &"

Source the .mailrc file, and you are ready to use mp. For printing ordinary ASCII files, the following alias (to be placed in your

alias print 'mp -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 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.

-L localename

Provide the locale of the file to be printed. If this command line option is not present, then mp 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 mp 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.

-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), 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 personal 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 prologue

Employ the file prologue as the POSTS CRIPTprologue file, overriding 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 organiser.

-ts

format the file for use with the Time/System International personal organiser.

-v

Print the version number of this release of mp.

-w words

The maximum number of words to extract from the gecos field of the users /etc/passwd entry. The default is 3.

-?

Print the usage line for mp (note that the ? character must be escaped if using csh(1)).

ENVIRONMENT VARIABLES

The mp prologue file is determined by first looking for the environment variable MP_PROLOGUE, which specifies the directory where mp prologue files are to be found. If MP_PROLOGUE is not found, then the default directory is assumed

($OPENWINHOME/share/xnews/client/mp).

mp also checks for the MP_LANG and LANG environment variables. If present, then a prologue file called ($OPENWINHOME/lib/locale/<localename>/print/prolog.ps) is prepended to the output to be printed.

SUPPLIED PROLOGUE FILES

The following prologue files are provided:

mp.pro.ps

Used by default

mp.pro.ff.ps
        Used if the -ff option is in effect

mp.pro.fp.ps

Used if the -fp option is in effect

mp.pro.tm.ps

Used if the -tm option is in effect

mp.pro.ts.ps

Used if the -ts option is in effect

mp.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/mp

executable

$OPENWINHOME/share/xnews/client/mp/mp.pro.ps

POSTS CRIPTprologue for mail printing

$OPENWINHOME/share/xnews/client/mp/mp.pro.l.ps

POSTS CRIPTprologue for landscape format

$OPENWINHOME/share/xnews/client/mp/mp.pro.alt.ps

alternative "default" POSTS CRIPTprologue, inserts page numbers in the bottom right corner of each page

$OPENWINHOME/share/xnews/client/mp/mp.pro.ff.ps

POSTS CRIPTprologue for Filofax format

LIBDIR/mp.pro.fp.ps

POSTS CRIPTprologue for Franklin Planner format.

$OPENWINHOME/share/xnews/client/mp/mp.pro.tm.ps

POSTS CRIPTprologue for Time Manager format

$OPENWINHOME/share/xnews/client/mp/mp.pro.ts.ps

POSTS CRIPTprologue for Time/System International format.

SEE ALSO

mail(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 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 Pharmacy, San Francisco.

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 POSTS CRIPTstructuring and the way that the prologue files are handled was included by Johan Vromans.

New style POSTS CRIPTprologue files by John Macdonald.

Support for the ISO8859 character set by Bertrand DeCouty.

Rich Burridge. MAIL: richb@Eng.Sun.COM