.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "MUTTPRINT 1" .TH MUTTPRINT 1 "2021-12-13" "perl v5.32.1" "Muttprint Short Manual" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh muttprint \- pretty printing of mails with Mutt .SH "SYNOPSIS" .IX Header "SYNOPSIS" muttprint [\fIoptions\fR]... [\-f \fIfile\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" This manual page documents briefly the \fBMuttprint\fR 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. .PP \&\fBMuttprint\fR is a utility that formats the printing of Mutt and other mail clients like XFMail or \s-1PINE\s0 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. .PP For detailed information about Muttprint look read the User's guide in \s-1PDF\s0 and \s-1HTML\s0 format at \fI/usr/share/doc/muttprint/\fR. .PP Anyway, you have to put the following line in your \fI/etc/Muttrc\fR or \&\fI~/.muttrc\fR: .PP .Vb 1 \& set print_command="muttprint" .Ve .PP If you want to customize the settings of \fBMuttprint\fR, just copy \&\fI/usr/share/doc/muttprint/sample\-muttprintrc\-en\fR to \fI/etc/Muttprintrc\fR or \fI~/.muttprintrc\fR in reliance if you want change the settings for the whole system or one user. .PP \&\fBMuttprint\fR defaults to English language settings if the environment variable \fI\s-1LANG\s0\fR is not set. For example in a German environment you should set: .PP .Vb 1 \& export LANG=de_DE .Ve .PP This can for instance be done in in your local \fI~/.bashrc\fR. For a more detailed information about localization of \fBMuttprint\fR read the User's guide. .SH "OPTIONS" .IX Header "OPTIONS" \&\fB\s-1PLEASE NOTICE:\s0\fR This options override the corresponding settings in \fI~/.muttprintrc\fR and \fI/etc/Muttprintrc\fR. .PP And here's the description of all command line options (a descriptions of the settings in the rcfile is included in the \fIsample-muttprintrc-en\fR distributed with \fBMuttprint\fR): .IP "\fB\-h, \-\-help\fR" 7 .IX Item "-h, --help" Prints a list of all possible options. .IP "\fB\-v, \-\-version\fR" 7 .IX Item "-v, --version" Prints the current version of \fBMuttprint\fR. .IP "\fB\-\-print\-locale\fR" 7 .IX Item "--print-locale" Prints out information about the current locale environment and exits. .IP "\fB\-f\fR \fIfile\fR\fB, \-\-file\fR \fIfile\fR" 7 .IX Item "-f file, --file file" Reads from file instead of \s-1STDIN.\s0 Useful for some mail clients as \fIXFMail\fR. If \fIfile\fR is \fI\-\fR, \fBMuttprint\fR reads from \s-1STDIN.\s0 .IP "\fB\-p\fR \fIprintername\fR\fB, \-\-printer\fR \fIprintername\fR" 7 .IX Item "-p printername, --printer printername" Uses another printer than the default printer or the setting in the rcfile. You can also \fBprint in file\fR using \fITO_FILE:/path/to/file\fR as printer name. If you would like to have the result in \fB\s-1STDOUT\s0\fR, set the printer name to \fI\-\fR. .IP "\fB\-C\fR \fIprint command\fR\fB, \-\-printcommand\fR \fIprint command\fR" 7 .IX Item "-C print command, --printcommand print command" Sets the command which is used for printing to \fIprint command\fR. Thereby the string \fI\f(CI$PRINTER\fI\fR is replaced by the specified printer name. \&\s-1CUPS\s0 support could be activated by \fI\s-1CUPS\s0\fR; alternatively you can specify any command that contains the string \fI\f(CI$CUPS_OPTIONS\fI\fR which is replaced by the options used for \s-1CUPS.\s0 .IP "\fB\-i\fR \fIfile\fR\fB, \-\-penguin\fR \fIfile\fR" 7 .IX Item "-i file, --penguin file" Takes \fIfile\fR as picture printed on the right top of the sheet. \fIfile\fR must contain the full path. Set \fIfile\fR to \fIoff\fR if you wouldn't like to print a picture. .IP "\fB\-x, \-\-x\-face\fR | \fB\-nox, \-\-nox\-face\fR" 7 .IX Item "-x, --x-face | -nox, --nox-face" Turns on or off the printing of the picture which was transmitted in the \&\fIX\-Face:\fR header. Read the documentation for a detailed explanation. .IP "\fB\-t\fR \fInumber\fR\fB, \-\-speed\fR \fInumber\fR" 7 .IX Item "-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). .IP "\fB\-w\fR \fInumber\fR\fB, \-\-wait\fR \fInumber\fR" 7 .IX Item "-w number, --wait number" Amount of time in seconds which \fBMuttprint\fR should wait between printing odd and even pages for duplex printing. .IP "\fB\-F\fR \fIfontname\fR\fB, \-\-font\fR \fIfontname\fR" 7 .IX Item "-F fontname, --font fontname" Here you can choose a nice font family for your printing. Possible are: \&\fILatex\fR, \fILatex-bright\fR, \fILatin-modern\fR, \fITimes\fR, \fIUtopia\fR, \fIPalatino\fR, \&\fICharter\fR, \fIBookman\fR, \fICentSchool\fR, \fIChancery\fR, \fIHelvetica\fR and \&\fIAvantGarde\fR. If all fonts are available on your system depends of your installed LaTeX-system. Default is \fILatex\fR. .IP "\fB\-H, \-\-headrule\fR | \fB\-noH, \-\-noheadrule\fR" 7 .IX Item "-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. .IP "\fB\-b, \-\-footrule\fR | \fB\-nob, \-\-nofootrule\fR" 7 .IX Item "-b, --footrule | -nob, --nofootrule" Here you can choose whether it should be printed a rule over the foot line or not. .IP "\fB\-S\fR \fIstyle\fR\fB, \-\-frontstyle\fR \fIstyle\fR" 7 .IX Item "-S style, --frontstyle style" Choose a style for the printing of the mail headers on the first page: \fIplain\fR, \&\fIborder\fR (default), \fIBorder\fR, \fIfbox\fR, \fIshadowbox\fR, \fIovalbox\fR, \fIOvalbox\fR, \&\fIdoublebox\fR, \fIgrey\fR, \fIgreybox\fR. Read the manual for a detailed description of this values. .IP "\fB\-a\fR \fIheaders\fR\fB, \-\-printed\-headers\fR \fIheaders\fR" 7 .IX Item "-a headers, --printed-headers headers" Specify the headers that should be printed. Separate each header with \&\f(CW\*(C`_\*(C'\fR. Headers that are embedded in \fI*\fR are printed bold; use \&\fI/\fR for italic printing. If a header does not exist, it will be omitted. The given order is the same as on the printing. .Sp Two examples: .Sp .Vb 2 \& Date_To_From_CC_Newsgroups_*Subject* (default) \& /Date/_To_From_X\-Mailer_*/Subject/* .Ve .IP "\fB\-P\fR \fIpaperformat\fR\fB, \-\-paper\fR \fIpaperformat\fR" 7 .IX Item "-P paperformat, --paper paperformat" Choose your paper format: \fIA4\fR in most countries (\*(L"\s-1DIN A4\*(R"\s0 in Germany) and \fIletter\fR in the U.S. .IP "\fB\-e\fR \fIString\fR\fB, \-\-date\fR \fIString\fR" 7 .IX Item "-e String, --date String" This option accepts two settings: \fIoriginal\fR and \fIlocal\fR. If you use \fIoriginal\fR, 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 \fIlocal\fR, the date will be printed in the local language and in the system's time zone. See the options \&\fI\-\-date\-format\fR and \fI\-\-lang\fR. .Sp Examples: .Sp .Vb 3 \& original: Tue, 15 Jan 2002 21:43:49 +0100 \& local: Dienstag, 15. Januar 2002 21:43:49 \& (German locale) .Ve .IP "\fB\-E\fR \fIString\fR\fB, \-\-date\-format\fR \fIString\fR" 7 .IX Item "-E String, --date-format String" This options allows you to change the date format (if you've chosen \fIlocal\fR before). The argument is a format string according to \fBstrftime\fR\|(3), e. g.: .Sp .Vb 3 \& "%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) .Ve .IP "\fB\-A\fR \fIString\fR\fB, \-\-addressformat\fR \fIString\fR" 7 .IX Item "-A String, --addressformat String" With this option you can set how mail addresses are printed. The value \&\fIoriginal\fR does not change the header. Otherwise you have to specify a format string; following substitutions are done: .Sp .Vb 3 \& %r name ("real name") \& %a mail address \& \en newline .Ve .Sp The default setting is \fI\f(CI%r\fI <%a>,\en\fR. Moreover, you can emphasize some parts with bold or italic printing. You have to enclose these parts with stars (\f(CW\*(C`*\*(C'\fR) for bold or with slashes (\f(CW\*(C`/\*(C'\fR) for italics. .Sp Example: .Sp .Vb 1 \& "/%r/ (%a)," .Ve .Sp The quotes are necessary because the string contains spaces. Otherwise the shell splits the string into two parts. .IP "\fB\-n\fR \fIString\fR\fB, \-\-verbatimnormal\fR \fIString\fR" 7 .IX Item "-n String, --verbatimnormal String" This sets the options which are passed to the \fIVerbatim\fR environment that is necessary to print the normal mail text. Detailed explanations are in the user's guide. Some examples: .Sp .Vb 4 \& fontshape=it italic fonts \& frame=topline border above the block \& fontfamily=helvetica Helvetica font \& fontsize=\eHuge huge font .Ve .Sp To combine options, you have to separate each option with a comma, e. g. \&\fIfontshape=it,fontseries=b\fR. .IP "\fB\-V\fR \fIString\fR\fB, \-\-verbatimsig\fR \fIString\fR" 7 .IX Item "-V String, --verbatimsig String" Same as \fB\-\-verbatimnormal\fR, but this sets how the signature is printed. If the argument is \fIraw\fR, there is now discrimination between normal text and signature. .IP "\fB\-D, \-\-debug\fR | \fB\-noD, \-\-nodebug\fR" 7 .IX Item "-D, --debug | -noD, --nodebug" Choose whether \fBMuttprint\fR writes to a log file \fI/tmp/muttprint.log\fR. Useful to ask some other about help if \fBMuttprint\fR doesn't work. .IP "\fB\-B, \-\-background\fR | \fB\-noB, \-\-nobackground\fR" 7 .IX Item "-B, --background | -noB, --nobackground" After reading from standard input, \fBMuttprint\fR 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 \fBMuttprint\fR works error-free on your system. .IP "\fB\-d, \-\-duplex\fR | \fB\-nod, \-\-noduplex\fR" 7 .IX Item "-d, --duplex | -nod, --noduplex" Enables or disables duplex printing. If enabled, \fBMuttprint\fR prints only odd pages and waits some time before it prints even pages. .IP "\fB\-2\fR | \fB\-1\fR" 7 .IX Item "-2 | -1" Prints two pages on one sheet as shown here: .Sp .Vb 8 \& +\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-+ \& | | | \& | | | \& | 1 | 2 | \& | | | \& | | | \& | | | \& +\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-+ .Ve .Sp This feature is called \fIpapersave mode\fR in the manual and in the rcfile. .IP "\fB\-g\fR \fInumber\fR\fB, \-\-topmargin\fR \fInumber\fR" 7 .IX Item "-g number, --topmargin number" Sets the top margin in millimeters. .IP "\fB\-G\fR \fInumber\fR\fB, \-\-bottommargin\fR \fInumber\fR" 7 .IX Item "-G number, --bottommargin number" Sets the bottom margin in millimeters. .IP "\fB\-j\fR \fInumber\fR\fB, \-\-leftmargin\fR \fInumber\fR" 7 .IX Item "-j number, --leftmargin number" Sets the left margin in millimeters. .IP "\fB\-J\fR \fInumber\fR\fB, \-\-rightmargin\fR \fInumber\fR" 7 .IX Item "-J number, --rightmargin number" Sets the right margin in millimeters. .IP "\fB\-s, \-\-rem_sig\fR | \fB\-nos, \-\-norem_sig\fR" 7 .IX Item "-s, --rem_sig | -nos, --norem_sig" Removes the signature (separated by \f(CW\*(C`\-\- \*(C'\fR) 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. .IP "\fB\-\-sig_regexp\fR \fIRegular Expression\fR" 7 .IX Item "--sig_regexp Regular Expression" Sets the regular expression (in Perl syntax) used to recognize signatures. The default is \fI^\-\- $\fR. .IP "\fB\-q, \-\-rem_quote\fR | \fB\-noq, \-\-norem_quote\fR" 7 .IX Item "-q, --rem_quote | -noq, --norem_quote" Remove the quoted paragraph from the printing. .Sp \&\fBMuttprint\fR detects the quoting with the same regular expression as Mutt, so it should work. .IP "\fB\-z\fR \fIsize\fR\fB, \-\-fontsize\fR \fIsize\fR" 7 .IX Item "-z size, --fontsize size" Specifies the font size. Possible values are \fI10pt\fR, \fI11pt\fR and \fI12pt\fR. .IP "\fB\-W\fR \fInumber\fR\fB, \-\-wrapmargin\fR \fInumber\fR" 7 .IX Item "-W number, --wrapmargin number" Controls how long the longest line could be. Longer lines are wrapped automatically and the paragraph will be reformatted. .IP "\fB\-r\fR \fIfile\fR\fB, \-\-rcfile\fR \fIfile\fR" 7 .IX Item "-r file, --rcfile file" Specifies another configuration file, which is read additionally to \fI/etc/Muttprintrc\fR and \fI~/.muttprintrc\fR. 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 \fI\-f\fR if you use this option.) .SH "FILES" .IX Header "FILES" .IP "\fI/usr/bin/muttprint\fR" 7 .IX Item "/usr/bin/muttprint" The program \fBMuttprint\fR itself. .IP "\fI/usr/bin/muttprint\-langinfo\fR" 7 .IX Item "/usr/bin/muttprint-langinfo" Helping program for reading the system's default encoding. .IP "\fI/etc/Muttprintrc\fR" 7 .IX Item "/etc/Muttprintrc" System-wide configuration file. .IP "\fI~/.muttprintrc\fR" 7 .IX Item "~/.muttprintrc" User configuration file. .IP "\fI/tmp/muttprint\-XXXXX\fR" 7 .IX Item "/tmp/muttprint-XXXXX" Temporary files created by \fBMuttprint\fR. .IP "\fI/usr/share/doc/muttprint/\fR" 7 .IX Item "/usr/share/doc/muttprint/" \&\fBMuttprint\fR manual files in different languages and formats. .IP "\fI/usr/share/ospics/\fR" 7 .IX Item "/usr/share/ospics/" Some pictures which can be used for printing on the first page of your mail. .IP "\fI/usr/lib/x86_64\-linux\-gnu/muttprint/translations\fR" 7 .IX Item "/usr/lib/x86_64-linux-gnu/muttprint/translations" Translation files. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBmutt\fR\|(1) .PP Homepage: \fIhttp://muttprint.sf.net\fR .SH "COPYRIGHT" .IX Header "COPYRIGHT" X 2000\-03 Bernhard Walle .PP This is free software; see the source for copying conditions. There is \s-1NO\s0 warranty; not even for \s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 .SH "AUTHOR" .IX Header "AUTHOR" Bernhard Walle .SH "MAINTAINER" .IX Header "MAINTAINER" Lukas Ruf