MAILTOOL(1) — USER COMMANDS

NAME

mailtool - OpenWindows interface for the mail program

SYNOPSIS

mailtool [ −Mx ] [ −Mi interval ] [ generic-tool-arguments ]

AVAILABILITY

Although this command is available with both the SunView software installation and the OpenWindows environment, its appearance is not the same for both environments. The man page you are currently viewing refers to the mailtool that is available with OpenWindows. The primary difference between this and the SunView mailtool is the user interface. All OpenWindows standard tools use the OPEN LOOK Graphical User Interface. For more information about the OPEN LOOK UI, refer to the Guide,OpenWindowsUser’s the GraphicalOPENLOOK and the GraphicalOPENLOOK For information about installing OpenWindows, refer to the andOpenWindowsInstallation

DESCRIPTION

mailtool is the standard OpenWindows interface to mail(1). It provides a menu-driven facility for reading, storing, composing, and sending mail messages. Scrollable windows allow easy access to mailbox and mail folders.

The full editing capabilities of textedit(1) are available for modifying and composing mail messages as well as text fields within command panels.

OPTIONS

-Mx Expert mode. Do not ask for confirmation after potentially damaging mail commands. This has the same effect as setting the expert variable.

-Miinterval
Check for new mail every interval seconds. This has the same effect as specifying a value for the interval variable.

generictoolarguments
Mailtool accepts the generic tool arguments described in sunview(1).

USAGE

mailtool operates through the use of a set of command panel buttons, message windows, menus, and other components that conform to the OPEN LOOK Graphical User Interface Functional Specification. Mail messages are edited using the menus and commands of the textedit program. For more information about the general usage of OPEN LOOK software applications, see the Guide.OpenWindowsUser’s For more information about textedit conventions, see the textedit(1) man page. ButtonsCommandPanel The mailtool command panel is located near the top of the main window, under the window header. Select a command panel button to reveal the menu for that button.

File>

Open>

InTray Used to read mail from the user’s system mail file into mailtool.

MailFile Opens the mail file specified in the MailFile text field in the command panel.

MailMoveinto
Moves all selected messages from the current mail file to the file named in the MailFile text field in the command panel. If the file exists, the messages are appended.

MailCopyinto
Copies all selected messages from the current mail file to the file named in the MailFile text field in the command panel. If the file exists, the messages are appended. Unlike Move into Mail File, the messages are not deleted from the InTray.

Print

Sends copies of all the selected mail items to your default printer. If there are no selected items, mailtool sends copies of those items you are currently viewing.

SaveChanges
Causes all the deletions and changes you have made to the mail file to become permanent and opens your InTray for any new mail.

View>

Messages>
Displays messages you have selected.

AbbreviatedHeader
Strips unnecessary header fields from the messages you view. Specify these fields by setting the ignore variable in your .mailrc file.

FullHeader
Displays the currently selected messages with all of the message header fields.

Previous Displays previous messages in your mailbox.

Next Determines the message following the last one displayed and displays it. The message is chosen from all the messages in the current mail file.

>SortBy

DateTimeand
Sorts the messages in the mail folder by chronological order.

Sender Sorts the messages in the mail folder alphabetically by sender.

Subject Sorts the messages in the mail folder alphabetically by subject.

Edit>

Cut Deletes the selected mail messages, placing copies in the Clipboard.

Copy Copies the selected mail messages, placing copies in the Clipboard.

Delete Deletes the selected mail messages, without placing copies in the Clipboard. If no mail messages are selected, the messages currently being viewed are deleted.

Undelete>

Last Restores the last message deleted to your mail header display. This may be done until all messages deleted since the last commit are restored. This option also restores messages deleted through cut and move commands.

Fromlist Causes a command frame to appear. This frame contains a list box that has all the mail items that have been deleted since the last commit operation. You can select any number of these, and press the button on the command frame. All the selected items will be returned to the mail header window.

Find

Sender: Enter text that is in the Subject field of the message you want. Capitalization is ignored.

Subject: Enter text that is in the From field (mail address) of the message you want. Capitalization is ignored.

FindForward
After entering text for Sender: or Subject: or both, click SELECT on FindForward to locate the next message that matches the text.

FindBackward
After entering text for Sender: or Subject: or both, click SELECT on FindBackward to locate the previous message that matches the text.

SelectAll After entering text for Sender: or Subject: or both, click SELECT on SelectAll to select all messages that match the text.

Compose>
This panel button allows users to create new mail to be sent, reply to existing messages with or without including the current message, and to forward messages as needed.

New Opens a composition window without the message headers being filled in. If an unused mail message window currently exists on the screen, it will be brought forward to be used and no new window is created. If an unused mail message window current exists and is fully displayed on the screen, there will be no change in the display.

Reply> Opens a composition window with the message headers filled in appropriately and allows you to write and deliver your response. If an unused mail message window current exists on the screen, it will be brought forward to be used and no new window is created. If an unused mail message window current exists and is fully displayed on the screen, there will be no change in the display. Options to this submenu are described below:

ToSender: Opens a composition window. In the window, the address field contains the originator’s address for the selected message.

ToAll: Opens a composition window. In the window, the address field contains addresses for the person who sent the selected message as well as all the people that the selected message was sent to.

include:Tosender,
Opens a composition window. In the window, the address field contains the originator’s address for the selected message. The window also contains the selected message in the body of the new message.

Include:ToAll,
Opens a composition window. In the window, the address field contains addresses for the person who sent the selected message as well as all the people that the selected message was sent to. The window also contains the selected message in the body of the new message.

Forward> Forwards the currently selected message. Opens a composition window with the currently selected message included in the new message body.

Vacation Lets you compose a message that is automatically delivered in response to incoming messages. Use this when you can’t read your mail for a period of time and want MailTool to respond to messages for you.

The Composition Window This window has its own control panel with the following buttons.

Include>

Bracketed Pastes the currently selected messages into the body of the message you are composing. The included messages are bracketed with special lines.

Indented Pastes the currently selected messages into the body of the message you are composing. Each line of the included message is indented, using the standard indentation string.

Templates

Deliver>

QuitWindow
Mails the message you have composed and then dismisses the compose window.

CloseWindow
Mails the message you have composed and then closes the compose window to an icon.

ClearWindow
Mails the message and then clears the compose window to prepare it for re-use.

IntactLeaveMessage
Mails the message and leaves the message in the compose window.

Headers> Selecting an option affects the header of the mail message.

Add/DeleteCc:
Adds or deletes the Cc: line from the message you are composing.

Add/DeleteBcc:
Adds or deletes the Bcc: line from the message you are composing.

DeleteSubject
Adds or deletes the Subject: line from the message you are composing.

>AddCustom

>DeleteCustom

NameFinder
Displays a popup window that lets you ask for the mailing addresses of individuals in the NIS database.

Name: Type the requested name.

SoundsLike
Looks for names that sound like the one you entered. The first letter must match exactly.

Find Click SELECT to start the search.

Clear Clears the contents of the compose window. MailtoolVariables In addition to the variables recognized by mail(1), mailtool recognizes those listed below. They can be set by editing your .mailrc file. Unless otherwise noted, the default for the following variables is off.

allowreversescan
When set, allows you to step through messages in latest-first, oldest-first order if you choose. The next message depends on the order of travel.

askbcc Prompt for the Bcc: field when composing or replying.

bell The number of times to ring the bell when new mail arrives. The default is 0.

editmessagewindow
Request confirmation before the first editing operation to a message in the message window (as opposed to composing a reply). The default is not to request confirmation of the first edit.

expert Set expert mode in which no confirmation are requested.

filemenu A list of files from which to initialize the File: menu. These can be absolute pathnames, pathnames relative to the working directory for mailtool (typically your home directory), or filenames prefixed with a + , which are taken as relative to the directory specified in the folder variable (see mail (1)).

filemenusize
Specifies the maximum size of the .File: menu.

flash The number of times to flash the window or icon when new mail arrives. The default is 0.

headerlines
The number of lines in header window. The default is 10.

retrieveinterval
The interval in seconds to check for new mail. The default is 300.

moveinputfocus
Move the input focus into the compostion window for Compose and Reply. This only works for click-to-type.

popuplines The number of lines in pop-up message composition window. The default is 30.

printmail The command to use to print a message. The default is lpr -p.

trash The name of trash bin, which may be accessed just like any other folder. If set, all deleted messages are moved to the trash bin. The trash bin is emptied when you commit changes.

suppressautoretrieve
Does not automatically retrieve new mail messages. Default is to automatically retrieve new mail.

additionalfields:
A list of header fields to access via the AddCustom field in the Header menu.

templates A list of name:path pairs to access via the TemplatesInclude> menu. name appears in the menu; path is the file included when name is selected.

toolcols Default width of windows in columns. Default is 80.

FileThe.mailtool-init
The .mailtool-init file is created in your home directory when a "Save Workspace" command is invoked off of the Workspace menu. This file contains the current positions and sizes of mailtool’s View, Compose, and Header Windows (i.e., what’s currently on your screen), so on the next invocation of mailtool your mailtool windows will start-up with the same layouts. The following 3 lines show the syntax of .mailtool-init’s contents: viewwin xloc number yloc number width number height number compwin [iconic] xloc number yloc number width number height number ixloc number iyloc number deldef number basewin filedef number viewdef number editdef number compdef number repdef number The first line specifies the x and y coordinates of the top left corner of the View Window, and its width and height (all in pixels). The second line specifies the same information for the Compose Window. In addition, the iconic word, if present, specify that the Compose Window will come up as an icon in the positions specified by the ixloc and iyloc parameters. The deldef parameter specifies the menu default of the Deliver button (the number 1 for the first menu item, etc.). The third line specifies, for the Header Window, menu default items for the File, View, Edit, Compose, and Reply menus, respectively.

FILES

/var/spool/mail/∗
System mailboxes

~/.mailrc Start-up file for mail and mailtool.

~/.mailtool-init Start-up file for mailtool that contains the positions and sizes of mailtool’s View, Compose, and Header Windows.

Museum

Related Articles