SunOS man pages : mp (1)
User Commands mp(1)
NAME
mp - text to PDL (Printer Description Language) pretty print
filter
SYNOPSIS
mp [ -A4 ] [ -C ] [ -D target_printer_name ] [ -F ] [
-L localename ] [ -P target_spool_printer ] [ -PS ] [ -US
] [ -a ] [ -c chars ] [ -d ] [ -e ] [ -ff ] [ -fp ] [
-l ] [ -m ] [ -o ] [ -p prologue ] [ -s subject ] [ -tm
] [ -ts ] [ -u config_file_path ] [ -v ] [ -w words ] [
-? ] [ filename ... ]
DESCRIPTION
The mp program, when called without the -D or -P option,
reads each filename in sequence and generates a prettified
version of the contents in PostScript format, sent to stan-
dard 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 Control-d.
The -D and -P options require the target printer name as an
argument and produce the Printer Description Language (PDL)
of the target printer. The -D option causes the PDL to out-
put to stdout and the -P option causes the PDL to be
directly spooled to the printer. In the absence of these
options, mp will product default PostScript output.
The mp program accepts international text files of various
Solaris locales and produces output which is proper for the
specified locale. The output will also contain proper text
layout. For instance, the output will contain bidirectional
text rendering, and also shaping, since the complex text
layout (CTL) is supported in mp.
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, or
the outline of the same dimensions as the lozenges, contain-
ing banner information at the top and bottom of every page.
OPTIONS
The following options are supported:
-a Formats 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 "News-
groups:" line.
-A4 Uses A4 paper size (8.26 x 11.69 inches).
-c chars
The maximum number of characters to extract from the
SunOS 5.8 Last change: 30 Oct 2000 1
User Commands mp(1)
gecos field of the user's /etc/passwd entry. The
default is 18.
-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 is
wrong, and mp falls back to looking for the next
"\nFrom" in the mail folder.
-d Formats the file as a digest.
-D target_printer_name
Produces the PDL for the target printer. Requires X
Print Server connection.
-e Assumes the ELM mail frontend intermediate file for-
mat. 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 Formats the file for use with a Filofax personal
organizer.
-fp Formats the file for use with a Franklin Planner per-
sonal organizer.
-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 Formats output in landscape mode. Two pages of text
will be printed per sheet of paper.
-L localename
Provides 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 can-
not, then it assumes it is running in the C locale.
-m Formats the file as a mail folder, printing multiple
messages.
-o Formats the file as an ordinary ASCII file.
-p prologue
Employs the file prologue as the PostScript/Xprt
SunOS 5.8 Last change: 30 Oct 2000 2
User Commands mp(1)
prologue file, overriding any previously defined file
names. This file specifies the format of the print
output. For PostScript output, the prologue file will
have a .ps extension; for Xprt clients (when the -D
option is specified), this file have an .xpr exten-
sion. These files are defined in the SUPPLIED PROLOGUE
FILES section below.
-P target_spool_printer
Spools the PDL to the target printer. No output is
sent to stdout. Requires X Print Server connection.
-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.
-s subject
Uses subject as the new subject for the printout. If
you are printing ordinary ASCII files that have been
specified on the command line, the subject will
default to the name of each of these files.
-tm Formats the file for use with the Time Manager per-
sonal organizer.
-ts Formats the file for use with the Time/System Interna-
tional personal organizer.
-US Uses US paper size (8.5 x 11 inches). This is the
default paper size.
-u config_file_path
Specifies an alternate configuration file to the
default file
/usr/lib/lp/locale/locale_name/mp/mp.conf. The abso-
lute file path name must be used.
-v Prints the version number of this release of mp.
-w words
The maximum number of words to extract from the gecos
field of the user's /etc/passwd entry. The default is
3.
-? Prints the usage line for mp (notice that the ? char-
acter must be escaped if using csh(1)).
OPERANDS
The following operand is supported:
filename
SunOS 5.8 Last change: 30 Oct 2000 3
User Commands mp(1)
The name of the file to be read.
ENVIRONMENT VARIABLES
XPDISPLAY
Used with option -D or -P to determine to which X
Print Display the client should connect.
MP_PROLOGUE
Used to determine the directory where the page format-
ting files (.xpr or .ps) are kept. These files deter-
mine page decorations, number of logical pages per
physical page, landscape or portrait format, and so
forth. In the absence of MP_PROLOGUE, the default
location of the directory is /usr/lib/lp/locale/C/mp.
MP_LANG
LANG If neither of the -D or -P options are specified, a
prologue file called
/usr/openwin/lib/locale/localename/print/prolog.ps or
/usr/lib/lp/locale/localename/mp/prolog.ps, where
localename is the value of the MP_LANG or LANG
environment variable, if present, is prepended to the
output to be printed. If both of them are present then
the file
/usr/openwin/lib/locale/localename/print/prolog.ps
will be given preference due to backward compatibility
reasons. If either ofthese file are not present, and
the -D option is not specified, a configuration file
of the locale called
/usr/lib/lp/locale/localename/mp/mp.conf is used as
the source of the configuration information that sub-
stitutes the prologue information for printing. The
presence of prolog.ps disables mp.conf for backward
compatibility.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 An error occurred.
SUPPLIED PROLOGUE FILES
The following prologue files are provided. Files with .ps
extensions are for the PostScript output; files with .xpr
extensions are for the Print Server client. .xpr files are
created for 300dpi printers and will scale to other resolu-
tion values.
mp.common.ps
Common prologue file for all other .ps files in this
SunOS 5.8 Last change: 30 Oct 2000 4
User Commands mp(1)
directory.
mp.pro.ps
mp.pro.xpr
Used by default.
mp.pro.ff.ps
mp.pro.ff.xpr
Used if the -ff option is in effect.
mp.pro.fp.ps
mp.pro.fp.xpr
Used if the -fp option is in effect.
mp.pro.tm.ps
mp.pro.tm.xpr
Used if the -tm option is in effect.
mp.pro.ts.ps
mp.pro.ts.xpr
Used if the -ts option is in effect.
mp.pro.alt.ps
mp.pro.alt.xpr
An alternative modification of the default prologue
file which outputs the page number in the right corner
of the bottom banner.
mp.pro.l.ps
mp.pro.l.xpr
Prologue file used for landscape outputs.
mp.pro.altl.ps
mp.pro.altl.xpr
Alternate prologue file used for landscape outputs.
FILES
.cshrc
Initialization file for csh(1).
.mailrc
Initialization file for mail(1).
/usr/bin/mp
SunOS 5.8 Last change: 30 Oct 2000 5
User Commands mp(1)
Executable.
/usr/lib/lp/locale/C/mp/mp.conf
Default configuration file.
/usr/lib/lp/locale/C/mp/mp.common.ps
Common prologue file for all other .ps files in this
directory. Not for .xpr files.
/usr/lib/lp/locale/C/mp/mp.pro.ps
/usr/lib/lp/locale/C/mp/mp.pro.xpr
Default prologue files for mail printing.
/usr/lib/lp/locale/C/mp/mp.pro.l.ps
/usr/lib/lp/locale/C/mp/mp.pro.l.xpr
Default prologue files for landscape format.
/usr/lib/lp/locale/C/mp/mp.pro.altl.ps
/usr/lib/lp/locale/C/mp/mp.pro.altl.xpr
Alternate prologue files for landscape format.
/usr/lib/lp/locale/C/mp/mp.pro.alt.ps
/usr/lib/lp/locale/C/mp/mp.pro.alt.xpr
Alternative "default" prologue files. Insert page
numbers in the bottom right corner of each page.
/usr/lib/lp/locale/C/mp/mp.pro.ff.ps
/usr/lib/lp/locale/C/mp/mp.pro.ff.xpr
Default prologue files for Filofax format.
/usr/lib/lp/locale/C/mp/mp.pro.fp.ps
/usr/lib/lp/locale/C/mp/mp.pro.fp.xpr
Default prologue files for Franklin Planner format.
/usr/lib/lp/locale/C/mp/mp.pro.tm.ps
/usr/lib/lp/locale/C/mp/mp.pro.tm.xpr
Default prologue files for Time Manager format.
/usr/lib/lp/locale/C/mp/mp.pro.ts.ps
/usr/lib/lp/locale/C/mp/mp.pro.ts.xpr
Default prologue files for Time/System International
format.
/usr/openwin/lib/locale/localename/print/prolog.ps
SunOS 5.8 Last change: 30 Oct 2000 6
User Commands mp(1)
/usr/lib/lp/locale/localename/mp/prolog.ps
Default locale-specific prologued file as an alterna-
tive to the mp.conf file. See ENVIRONMENT VARIABLES
for more detail on the relationship.
The structure and format for mp.conf and .xpr files are
documented in the International Language Environments Guide.
Refer to this document if you need to use alternate fonts,
including Printer Resident Fonts, or if you want to make
changes to output format.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWmp |
|_____________________________|_____________________________|
SEE ALSO
csh(1), mail(1), mailtool(1), attributes(5)
SunOS 5.8 Last change: 30 Oct 2000 7
|
 |
|
|
