mptool(1)

NAME

mptool - a Gtk+ window-based front-end to the mp

POSTSCRIPT pretty printer program.

SYNOPSIS

The mptool program has virtually the same command line options as the mp program. See those manual pages for more details.
The additional mptool options are:
[ -tooltips ]

DESCRIPTION

The mp program is used to pretty print mail, news articles

or ordinary text files. There are now lots of command line op

tions to mp which can be used to setup various options to change

the way the text is output. These are not always easy to remem

ber. The mptool program is provided as a simpler means of setting

these options and thereby making it easier to print your files in

the desired format.

It is also possible to select text in another Gtk+ appli

cation, and drag and drop that text over the mptool open window,

and it will be automatically printed out using the current set

tings.

OPTIONS

The mptool program has virtually the same command line op

tions as the mp program. See those manual pages for more details.

The additional mptool options are:

-tooltips

Enable Gtk+ help tooltips. By default, tooltips

will be disabled.

RESOURCES

On startup, mptool look for various X resources which by

default are stored in $HOME/.mpdefaults. Note these resource

names will be prepended with mptool. Virtually all of these X

resources are described in the mp manual pages. The additional

mptool resources are:

Resource: tooltips
Values: True, False (False)
Description If set to true Gtk+ help tooltips are en

abled.

USAGE

mptool operates via a set of graphical items both in the

main window and the various option sheets. Tooltip help on the

various options can be enabled (or disabled if already enabled),

via the Help keyboard key. Commonly used operations are easily

accessable via options in the main window; the remainder are on

the option sheets. Each option equates to an mp command line op

tion. This section gives the match up between these graphical op

tions and the equivalent mp command line option. Refer to the mp

manuals pages for more details on each option.

Filenames: The file(s) to be printed.

Input type: Nothing, "-news", "-postscript" or

"-text", depending upon the setting.

Output type: Nothing, "-landscape" or an Organis

er type (see below).

Organiser: "-filofax", "-franklin", "-proplan",

"-timeman", "-tsintl" or "-tspartner" depending upon the organis

er type selected.

Paper Size: Nothing, "-a4" or "-us".

Subject: Nothing or "-subject <subject>".

Copies: "-copies #".

Number of Sides:

Nothing or "-duplex".

Clicking on the Print button causes mptool to execute an

mp job with the various command line settings. Clicking on the

Reset button will reset all the options to their default values.

Note that the Filename: field can contain multiple file

names. These should be separated by spaces. If any of the file

names contain a space character, then this filename needs to be

quoted.

There are various option property windows. The Header op

tions window contains the following options:

Print all headers:

"-allhdrs".

Headers to Print:

"-addhdr <header>" or "-remhdr

<header>" depending upon whether the header is a new one added by

the user, or a default one that was removed from the initial

list.

The Input options window contains the following options:

Prologue Name: nothing or "-prologue <name>".

Mail folder Nothing or "-folder".

Mail digest Nothing or "-digest".

Elm mail file: nothing or "-elm".

Use From header:

nothing or "-from".

Use Content-Length: field:

nothing or "-content".

Use file last modification time:

nothing or "-modtime".

The Output options window contains the following options:

Printer Name: "-printer" or "-printer <name> de

pending upon whether a printer name was given.

Line Length: "-linelength #".

Page Length: "-pagelength #".

Output to BSD printer system:

"-bsdprint".

The Printing options window contains the following op

tions:

Columns per Page:

"-columns #".

Spaces per Tab Character:

"-tab #".

Margins: "-top #", "-left #", "-bottom #" and

"-right #".

Print header page

Nothing or "-banner".

Wrap words onto next line of output:

nothing or "-wrap".

Flip banner headings:

nothing or "-flip".

Force new page:

nothing or "-forcepage".

Number each line of output:

nothing or "-number".

Adjust reverse page for duplex printing

nothing or "-tumble".

The User Name options window contains the following op

tions:

Alias Name: "-alias name".

Characters in User Name:

"-chars #".

Words in User Name:

"-words #".

These options will only be applyed if you click on the Ap

ply button on the appropriate options sheet. Clicking on the Re

set button on that property sheet, resets those property sheet

values back to their default values. Clicking on the Save as De

faults option in the Options menu, causes all the current option

sheet settings to be the defaults the next time mptool is start

ed.

ENVIRONMENT VARIABLES

The default output printer is determined by looking at

the. PRINTER environment variable for BSD systems or the LPDEST

environment variable for System V systems.
An alternative file containing the mptool X resources can

be given with the MPDEFAULTS environment variable.

FILES

$HOME/.mpdefaults

X resource initialisation file.

BINDIR/mptool

executable

SEE ALSO

mp(1), lp(1), lpr(1)

AUTHOR

Rich Burridge. MAIL: Rich.Burridge@Sun.Com

15 October 2002

MPTOOL(1)