MUTTPRINT(1)

NAME
muttprint - pretty printing of mails with Mutt

SYNOPSIS
muttprint [options]... [-f file]

DESCRIPTION
This manual page documents briefly the Muttprint utility. This manual page was written orginally written for the Debian GNU/Linux distribution because the original program did not have a manual page, but now I took over this manpage in POD-format.

Muttprint is a utility that formats the printing of Mutt and other mail clients like XFMail or PINE to be like the printing of Netscape Messenger or Kmail. It can print a little penguin on the first page and a headline on every page. Furthermore, it only prints the most important headers, but not the whole plethora of them.

For detailed informations about Muttprint look read the User's guide in PDF and HTML format at /usr/local/share/doc/muttprint/.

Anyway, you have to put the following line in your /usr/local/etc/Muttrc or ~/.muttrc:

        set print_command="muttprint"
If you want to customize the settings of Muttprint, just copy /usr/local/share/doc/muttprint/sample-muttprintrc-en to /usr/local/etc/Muttprintrc or ~/.muttprintrc in reliance if you want change the settings for the whole system or one user.

Muttprint defaults to English lanuage settings if the environment variable LANG is not set. For example in a German environment you should set:

        export LANG=de_DE
This can for instance be done in in your local ~/.bashrc.

If Muttprint should not print with the message `lpr: unable to print file: ...', you should try to use another printer than lp, e. g. lp5 or tp0 (if you use TurboPrint).

CUPS USERS NOTE: The setting `PRINTER="lp"' will not work, and you have to set the Cups printer name instead (e. g. LaserJet), which you can easily check by typing lpq on the commandline.

aufgebrochen =head1 OPTIONS

PLEASE NOTICE: This options override the corresponding settings in ~/.muttprintrc and /usr/local/etc/Muttprintrc.

And here's the description of all command line options (a descriptions of the settings in the rcfile is included in the sample-muttprintrc-en distributed with Muttprint): Prints a list of all possible options. Prints the current version of Muttprint. Reads from file instad of STDIN. Useful for some mail clients as XFMail. If file is -, Muttprint reads from STDIN. Uses another printer than the default lp or the setting in the rcfile. You can also print in file using TO_FILE:/path/to/file as printer name. If you would like to have the result in STDOUT, set the printer name to -. Takes file as picture printed on the right top of the sheet. file must contain the full path. Set file to off if you wouldn't like to print a picture. Turns on or off the printing of the picture which was transmitted in the X-Face: header. Read the documentation for a detailed explanation. This is the amount of time in seconds which your printer needs to print one page. It is only necessary if you use duplex printing. Default is 30 (seconds). Amount of time in seconds which Muttprint should wait between printing odd and even pages for duplex printing. Here you can choose a nice font family for your printing. Possible are: Latex, Latex-bright, Times, Utopia, Palatino, Charter and Bookman. If all fonts are available on your system depends of your installed LaTeX-system. Default is Latex. Here you can choose whether it should be printed a rule after the topline on pages greater than 2 or not. Here you can choose whether it should be printed a rule over the footline or not. Choose a style for the printing of the mailheaders on the first page: plain, border (default), fbox, shadowbox, ovalbox, Ovalbox, doublebox, grey, greybox. Read the manual for a detailed description of this values. Specify the headers that should be printed. Separate each header with `_'. Headers that are embedded in * are printed bold; use / for italic printing. If a header does not exist, it will be omitted. The given order is the same as on the printing.

Two examples:

        Date_To_From_CC_Newsgroups_*Subject*   (default)
        /Date/_To_From_X-Mailer_*/Subject/*
Choose your paper format: A4 in most countries ("DIN A4" in Germany) and letter in the U.S. Give the short form of your language. Currently are supported: de (German), en (English), it (Italian), fr (French), es (Spanish) and cs (Czech). Default is the LANG environment, fallback is English. This option sets the input charset:

        charset         Muttprint option
        --------------------------------
        ISO-8859-1      latin1
        ISO-8859-2      latin2
        ISO-8859-3      latin3
        ISO-8859-4      latin4
        ISO-8859-9      latin5
        ISO-8859-15     latin9
        Windows-1252    latin1
        Windows-1250    latin2
                        auto
        ---------------------------------
The auto setting tries to find a mailheader that contains the charset of the mail. This works only under specific circumstances, so use this carefully. This option accepts two settings: original and local. If you use original, the date will be printed unchanged as it appears in the mailheader, i. e. in English and in the sender's time zone. If set to local, the date will be printed in the local language and in the system's time zone. See the options --date-format and --lang.

Examples:

        original: Tue, 15 Jan 2002 21:43:49 +0100
        local:    Dienstag, 15. Januar 2002 21:43:49
                          (German locale)
This options allows you to change the date format (if you've choosen local before). The argument is a format string according to strftime(3), e. g.:

        "%A, %d. %B %Y %H:%M:%S" (standard in Germany)
        "%a, %d.%m.%y %H:%M"     (shorten form)
        "%Y-%m-%d %H:%M:%S"      (ISO format)
With this option you can set how mail adresses are printed. The value original does not change the header. Otherwise you have to specify a format string; following substitutions are done:

        %r              name ("real name")
        %a              mail address
        \n              newline
The default setting is %r <%a>,\n. Moreover, you can emphasize some parts with bold or italic printing. You have to enclose these parts with stars (`*') for bold or with slashes (`/') for italics.

Example:

        "/%r/ (%a),"
The quotes are necessary because the string contains spaces. Otherwise the shell splits the string into two parts. This sets the options which are passed to the Verbatim environment that is necessary to print the normal mail text. Detailled explanations are in the user's guide. Some examples:

        fontshape=it           italic fonts
        frame=topline          border above the block
        fontfamily=helvetica   Helvetica font
        fontsize=\Huge         huge font
To combine options, you have to separate each option with a comma, e. g. fontshape=it,fontseries=b. Same as --verbatimnormal, but this sets how the signature is printed. If the argument is raw, there is now discrimination between normal text and signature. Choose whether Muttprint writes to a logfile /tmp/muttprint.log. Useful to ask some other about help if Muttprint doesn't work. Enables or disables duplex printing. If enabled, Muttprint prints only odd pages and waits some time before it prints even pages. Prints two pages on one sheet as shown here:

        +----------+----------+
        |          |          |
        |          |          |
        |    1     |     2    |
        |          |          |
        |          |          |
        |          |          |
        +----------+----------+
This feature is called papersave mode in the manual and in the rcfile. Sets the top margin in millimeters. Sets the bottom margin in millimeters. Sets the left margin in millimeters. Sets the right margin in millimeters. Removes the signature (separated by `-- ') in the printing. This is useful for very long signatures. But more and more people (or mail clients) doesn't separate the signature correctly so this feature works not always. Remove the quoted paragraph from the printing.

Muttprint detects the quoting with the same regular expression as Mutt, so it should work. Specifies the font size. Possible values are 10pt, 11pt and 12pt. Controls how long the longest line could be. Longer lines are wraped automatically and the paragraph will be reformated. Specifies another configuration file, which is read additionally to /usr/local/etc/Muttprintrc and ~/.muttprintrc. This file overwrites all other settings, including this one which are done by command line parameters. (It makes no sense to include other options despite -f if you use this option.)

FILES
System-wide configuration file. User configuration file. Temporary files created by Muttprint. Muttprint manual files in different languages and formats. Some pictures which can be used for printing on the first page of your mail. Translation files.

SEE ALSO
mutt(1)

Homepage: http://muttprint.sourceforge.net

COPYRIGHT
(c) 2000-2001 Bernhard Walle

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

AUTHOR
Bernhard Walle <Bernhard.Walle@gmx.de>