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 originally written for the Debian GNU/Linux distribution
because the original program did not have a manual page, but now I took over
this man page 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 information about Muttprint look read the User's guide in PDF and
HTML format at
/usr/share/doc/muttprint/.
Anyway, you have to put the following line in your
/etc/Muttrc or
~/.muttrc:
set print_command="muttprint"
If you want to customize the settings of
Muttprint, just copy
/usr/share/doc/muttprint/sample-muttprintrc-en to
/etc/Muttprintrc or
~/.muttprintrc in reliance if you want
change the settings for the whole system or one user.
Muttprint defaults to English language 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. For a more
detailed information about localization of
Muttprint read the User's
guide.
OPTIONS¶
PLEASE NOTICE: This options override the corresponding settings in
~/.muttprintrc and
/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):
- -h, --help
- Prints a list of all possible options.
- -v, --version
- Prints the current version of Muttprint.
- --print-locale
- Prints out information about the current locale environment
and exits.
- -f file, --file file
- Reads from file instead of STDIN. Useful for some mail
clients as XFMail. If file is -, Muttprint
reads from STDIN.
- -p printername, --printer
printername
- Uses another printer than the default printer 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 -.
- -C print command, --printcommand
print command
- Sets the command which is used for printing to print
command. Thereby the string $PRINTER is replaced
by the specified printer name. CUPS support could be activated by
CUPS; alternatively you can specify any command that contains the
string $CUPS_OPTIONS which is replaced by the options
used for CUPS.
- -i file, --penguin file
- 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.
- -x, --x-face | -nox, --nox-face
- Turns on or off the printing of the picture which was
transmitted in the X-Face: header. Read the documentation for a
detailed explanation.
- -t number, --speed number
- 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).
- -w number, --wait number
- Amount of time in seconds which Muttprint should
wait between printing odd and even pages for duplex printing.
- -F fontname, --font
fontname
- Here you can choose a nice font family for your printing.
Possible are: Latex, Latex-bright, Latin-modern,
Times, Utopia, Palatino, Charter,
Bookman, CentSchool, Chancery, Helvetica and
AvantGarde. If all fonts are available on your system depends of
your installed LaTeX-system. Default is Latex.
- -H, --headrule | -noH, --noheadrule
- Here you can choose whether it should be printed a rule
after the top line on pages greater than 2 or not.
- -b, --footrule | -nob, --nofootrule
- Here you can choose whether it should be printed a rule
over the foot line or not.
- -S style, --frontstyle
style
- Choose a style for the printing of the mail headers on the
first page: plain, border (default), Border,
fbox, shadowbox, ovalbox, Ovalbox,
doublebox, grey, greybox. Read the manual for a
detailed description of this values.
- -a headers, --printed-headers
headers
- 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/*
- -P paperformat, --paper
paperformat
- Choose your paper format: A4 in most countries
("DIN A4" in Germany) and letter in the U.S.
- -e String, --date String
- This option accepts two settings: original and
local. If you use original, the date will be printed
unchanged as it appears in the mail header, 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)
- -E String, --date-format
String
- This options allows you to change the date format (if
you've chosen 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)
- -A String, --addressformat
String
- With this option you can set how mail addresses 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.
- -n String, --verbatimnormal
String
- This sets the options which are passed to the
Verbatim environment that is necessary to print the normal mail
text. Detailed 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.
- -V String, --verbatimsig
String
- 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.
- -D, --debug | -noD, --nodebug
- Choose whether Muttprint writes to a log file
/tmp/muttprint.log. Useful to ask some other about help if
Muttprint doesn't work.
- -B, --background | -noB, --nobackground
- After reading from standard input, Muttprint runs in
the background. The advantage is that the you can use mail client
immediately after start printing. The disadvantage is that error message
could not be printed anymore. So use this option only if Muttprint
works error-free on your system.
- -d, --duplex | -nod, --noduplex
- Enables or disables duplex printing. If enabled,
Muttprint prints only odd pages and waits some time before it
prints even pages.
- -2 | -1
- Prints two pages on one sheet as shown here:
+----------+----------+
| | |
| | |
| 1 | 2 |
| | |
| | |
| | |
+----------+----------+
This feature is called papersave mode in the manual and in the
rcfile.
- -g number, --topmargin
number
- Sets the top margin in millimeters.
- -G number, --bottommargin
number
- Sets the bottom margin in millimeters.
- -j number, --leftmargin
number
- Sets the left margin in millimeters.
- -J number, --rightmargin
number
- Sets the right margin in millimeters.
- -s, --rem_sig | -nos, --norem_sig
- 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, see also the next option.
- --sig_regexp Regular Expression
- Sets the regular expression (in Perl syntax) used to
recognize signatures. The default is ^-- $.
- -q, --rem_quote | -noq, --norem_quote
- Remove the quoted paragraph from the printing.
Muttprint detects the quoting with the same regular expression as
Mutt, so it should work.
- -z size, --fontsize size
- Specifies the font size. Possible values are 10pt,
11pt and 12pt.
- -W number, --wrapmargin
number
- Controls how long the longest line could be. Longer lines
are wrapped automatically and the paragraph will be reformatted.
- -r file, --rcfile file
- Specifies another configuration file, which is read
additionally to /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¶
- /usr/bin/muttprint
- The program Muttprint itself.
- /usr/bin/muttprint-langinfo
- Helping program for reading the system's default
encoding.
- /etc/Muttprintrc
- System-wide configuration file.
- ~/.muttprintrc
- User configuration file.
- /tmp/muttprint-XXXXX
- Temporary files created by Muttprint.
- /usr/share/doc/muttprint/
- Muttprint manual files in different languages and
formats.
- /usr/share/ospics/
- Some pictures which can be used for printing on the first
page of your mail.
- /usr/lib/muttprint/translations
- Translation files.
SEE ALSO¶
mutt(1)
Homepage:
http://muttprint.sf.net
COPYRIGHT¶
X 2000-03 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>
MAINTAINER¶
Lukas Ruf <lukas.ruf@lpr.ch>