.TH mimep 1 "Release 1"
.SH NAME
mimep - to print a Multimedia Internet MEssage
.SH SYNOPSIS
.ta 8n
\fBmimep\fP   [source_file] [\-o target_file] [\-f] [\-fp] [\-printer printername] [\-a4] [\-us] [\-typesize size] [\-noburstpage] [\-nopagenum] [\-addhdrs headertype...] [\-rmhdrs headertype...] [\-allheaders] [\-boundary filename | default | none]
.br
.SH DESCRIPTION
The
.I mimep
program allows users to print multimedia messages composed with any UA respecting the MIME standard. It can print most of the bodyparts composing this kind of mail (gif, jpeg images, text/plain, text/enriched, postscript files ...). To achieve its goal, mimep builds a LaTeX document from the MIME message. Afterwards, it converts it into a "dvi" file, then into Postscript, outputting either to a file or to a printer.

.P
To mimep, use need to have LaTeX and a printing system installed.  To install
these on a Debian system, use the command
.IP
apt-get install texlive-latex-base texlive-base-bin cupsys-client
.P

Mimep may be distributed as part of the Mp distribution, because it uses some files of this distribution, and also because Mp was one of the first Postscript pretty printer command for mailers.

So for its own configuration, mimep uses the same file as mp:

.I              .mpdefaults

which by default is in the user's home directory. ($HOME/.mpdefaults)

This file may contain the following X resources...
Note these resource names will be prepended with the running application name; so that you can have different sets of resources for mimep and for mp...

 
.SH RESOURCES

.sp
.\"=========================================================================
.TP 15
.PD 0
.B Resource:
allHeaders
.TP
.B Values:
True, False (default value: False)
.TP
.B Description
If set to true, then all mail or news headers are printed out. (rfc 822 headers)
.sp
.\"=========================================================================
.TP 15
.PD 0
.B Resource:
addHeaders
.TP
.B Values:
Headers to add (string)
.TP
.B Description
A comma separated list of the extra headers that
.I mimep
should print out. (example: mimep*addHeaders: From:, To:)
.sp
.\"=========================================================================
.TP 15
.PD 0
.B Resource:
removeHeaders   
.TP
.B Values:
Headers to remove (string)
.TP
.B Description
A comma separated list of the standard headers that
.I mimep
should not print out.
.sp
.\"=========================================================================
.TP 15
.PD 0
.B Resource:
paperSize
.TP
.B Values:
None, A4 or US (A4)
.TP
.B Description
Describes the size of the paper the output will be printed on.
.sp
.\"=========================================================================
.TP 15
.PD 0
.B Resource:
printHeaderPage
.TP
.B Values:
True, False (False)
.TP
.B Description
If set to true then a burst banner page will be printed at the beginning of
the
.I mimep
output.
.sp
.\"=========================================================================
.TP 15
.PD 0
.B Resource:
printerName
.TP
.B Values:
Text string (NULL)
.TP
.B Description
The name of the printer to send output to. If no name is supplied, then
.I mimep
will use the default printer.
.sp
.\"=========================================================================
.TP 15
.PD 0
.B Resource:
boundary
.TP
.B Values:
none, default or the location of the Postscript boundary file (Text string).
(none by default...)
.TP
.B Description
.I mimep
can put a boundary between the bodyparts of a mail if you
specify one...
(example: mimep*boundary: /images/myboundary.eps)
.sp
.\"=========================================================================
.TP 15
.PD 0
.B Resource:
paginate
.TP
.B Values:
True, False (True)
.TP
.B Description
If set to true, then mimep will print the page numbers.
.sp
.\"=========================================================================
.TP 15
.PD 0
.B Resource:
typeSize
.TP
.B Values:
10, 11 or 12 (10)
.TP
.B Description
Size of the characters to print.

.SH OPTIONS
.sp
.TP
.B \mimep by default
Mimep by default will interpret the "source_file" or the standard input,
and print the Postscript resulting from its interpretation.
.\"=========================================================================
.sp
.TP
.B [source_file]
If no source_file is specified, mimep will use the standard input,
else mimep will interpret the mail named "source_file".
.\"=========================================================================
.sp
.TP
.B \-o target_file
Creates a document (from the mail) in LaTeX, named "target_file",
the same document in dvi and postscript formats.
.\"=========================================================================
.sp
.TP
.B \-f
Write the Postscript file resulting from the interpretation of the message to
the standard output.
.\"=========================================================================
.sp
.TP
.B \-fp
Print the document even if the -o option is specified. (not applicable with -f).
.\"=========================================================================
.sp
.TP
.B \-printer printername
Send output to the named printer. Otherwise send output to the printer named
in the PRINTER or LPDEST environment variables.
.\"=========================================================================
.sp
.TP
.B \-a4
Use A4 paper size (8.5 x 11.4 inches).
.\"=========================================================================
.sp
.TP
.B \-us
Use US paper size (8.5 x 11 inches).
.\"=========================================================================
.sp
.TP
.B \-typesize size
To specify the size of the characters to print.
.\"=========================================================================
.sp
.TP
.B \-noburstpage
Disable the printing of the burst banner page.
.\"=========================================================================
.sp
.TP
.B \-nopagenum
Disable the printing of the page numbers.
.\"=========================================================================
.sp
.TP
.B \-addhdrs headertype1 headertype2...
Enable the printing of the headers following the option.
.\"=========================================================================
.sp
.TP
.B \-rmhdrs headertype1 headertype2...
Disable the printing of the headers following the option.
.\"=========================================================================
.sp
.TP
.B \-allheaders
Print all headers.
.\"=========================================================================
.sp
.TP
.B \-boundary filename | default | none
If set to "none", disable the printing of a boundary between the bodyparts
else, if set to "default" makes mimep print a horizontal line between
two bodyparts;
else prints the Postscript (EPS) file named "filename" between these parts.
.\"=========================================================================

.SH FILES
.TP
.I $HOME/.mpdefaults 
X resource initialisation file.
.TP
.I $HOME/.mailcap 
metamail configuration file.
.TP
.I BINDIR/mimep 
executable.
.TP
.I BINDIR/metamail 
.
a program mimep uses.
.TP
.I BINDIR/latex 
.
a program mimep uses.
.TP
.I BINDIR/dvips 
.
a program mimep uses.
.TP
.I BINDIR/mp 
.
a program mimep can use.
.TP
.I BINDIR/lpr
.
a program mimep uses.
.TP
.I BINDIR/iseps
.
a program of the mimep distribution.
.TP
.I BINDIR/ertf2latex
.
a program of the mimep distribution.
.TP
.I BINDIR/text2latex
.
a program of the mimep distribution.
.TP
.I BINDIR/cutlines
.
a program of the mimep distribution.
.TP
.I BINDIR/mimepurl
.
a program of the mimep distribution.
.TP
.I BINDIR/printmim
.
a shell script of the mimep distribution.
.sp
.\"=========================================================================
.SH ENVIRONMENT VARIABLES
mimep uses the following environment variables:
.sp
.TP
.B \MIMEPTMPDIR
If set, this variable overrides both the TMPDIR environment variable and "/tmp" as the name of the directory in which mimep will create temporary files.
.\"=========================================================================
.sp
.TP
.B \TMPDIR
If set, this variable overrides "/tmp" as the name of the directory in which mimep will create temporary files.
.\"=========================================================================
.sp
.TP
.B \PRINTER or LPDEST
If no printername is defined, either in the $HOME/.mpdefaults file or with the -printer option, mimep will use the name set in the LPDEST or the PRINTER variable.
.\"=========================================================================
.sp
.SH ENVIRONMENT VARIABLES CREATED BY MIMEP
mimep creates some environment variables to interact with other programs of its distribution and with the shell script metamail called to treat the bodyparts of a message. Because these variables might be useful to implement some extensions to mimep, here they are:
.sp
.TP
.B \MIMEPOUT
This variable is set to the name of the output file of mimep.
(for the LaTeX document it creates)
.\"=========================================================================
.sp
.TP
.B \MIMEPBOUND
This variable can be set to "none", "default", or to the path of an EPS file used by mimep to draw a boundary between bodyparts. If set to default, mimep will just draw a horizontal line with a height defined in the MIMEPRULEH variable.
.\"=========================================================================
.sp
.TP
.B \MIMEPRULEH
Height of the horizontal line, if used to draw a boundary.
.\"=========================================================================
.sp
.TP
.B \MIMEPMAXCH
Used by the program cutlines which needs to know the maximum size of a line in characters.
.\"=========================================================================
.sp
.TP
.B \MIMEPPRINTER
If set, the printername in this variable overrides the default name of the printer given by the LPDEST or the PRINTER environment variables. It can be used in the shell script and in other programs to make them use the same printer as mimep. 
.\"=========================================================================
.sp
.SH SEE ALSO
latex(1) metamail(1) dvips(1) mp(1) lpr(1) 
.SH BUGS
Please, report bugs to Serge Aumont.
 Serge.Aumont@univ-rennes1.fr
.SH COPYRIGHT
Copyright (c) 1995 C.R.I. of Rennes 1. 
(University of Rennes 1 - France)

Permission to use, copy, modify, and distribute this material 
for any purpose and without fee is hereby granted, provided 
that the above copyright notice and this permission notice 
appear in all copies, and that neither the name of the C.R.I. of
Rennes 1 nor the one of the University of Rennes 1 be 
used in advertising or publicity pertaining to this 
material without the specific, prior written permission 
of an authorized representative of the University.  
.sp
THE C.R.I. MAKES NO REPRESENTATIONS ABOUT THE ACCURACY OR
SUITABILITY OF THIS MATERIAL FOR ANY PURPOSE. 
IT IS PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES.
.sp
.SH AUTHORS
Mikael Cam,
student at the Vannes Institute of Technology
 with a lot of pieces of advice from Serge Aumont,
 Eric Picheral & Rich Burridge.