 |
Index for Section 1 |
|
 |
Alphabetical listing for D |
|
dtmail(1)
CDE
NAME
dtmail - the desktop mailtool
SYNOPSIS
dtmail [ -hc ] [ -f mailfile ] [ -a file1 ... fileN ] [ generic-tool-
arguments ]
DESCRIPTION
The dtmail program is a mail application for use on the desktop. It
provides an easy-to-use interface for viewing, filing, composing and
sending electronic mail folders and mail messages.
dtmail provides a GUI-based interface for manipulating electronic mail
messages that can have attachments. Use the interface to compose a
message, view a message or a folder holding messages, load new mail, copy
or move messages from one folder to another, delete messages, reply to
messages, add and delete attachments to a message when composing, and view
contents of attachments in a message. dtmail also provides a mail-
pervasive desktop environment by providing a public Tooltalk API. Other
clients can use the Tooltalk API to compose and send messages.
OPTIONS
-a file1 ...fileN
Bring up a Compose window with file1 through fileN as
attachments.
-c Bring up an empty Compose window
-f filename
Specify the mail file to be loaded in at startup time.
Ordinarily, the mail file pointed to by the environment variable
MAIL is read in as the user's inbox. Use of this option
overrides the use of the MAIL variable.
-h Display help for command line options.
RESOURCES
dtmail provides the following resources:
Dtmail*Message_List*doubleClickInterval
The double click time out (in milliseconds) for the scrolling
message header list. Default is 400 milliseconds.
Dtmail*Message_List*background
Color to use for the scrolling message header list background.
Default is system dependent.
Dtmail*Message_List*foreground
Color to use for the scrolling message header list foreground.
Default is system dependent.
Dtmail*Message_List*fontList
The list of fonts to use in the scrolling message header list.
The list must contain two fonts. The first must be tagged
"plain" and is the font used to render the header text. The
second must be tagged "attach" and is used to render the
attachment indicator. Default is to use system-dependent fixed-
width fonts.
Dtmail*Work_Area*Text*background
Color to use for the View and Compose window text background.
Default is system dependent.
Dtmail*Work_Area*Text*foreground
Color to use for the View and Compose window text foreground.
Default is system dependent.
Dtmail*Work_Area*Text*fontList
The list of fonts to use in the View and Compose windows. Font
tag "plain". Default is to use a system-dependent variable-width
font.
MAIL VARIABLES
dtmail recognizes the following mailx(1) commands: unset, alias, group,
set, ignore, source, if, else, endif, alternates. See man page for
mailx(1) for more information. dtmail also recognizes the variables listed
below. They can be set by editing your .mailrc file; however, since most of
the variables are accessible through the dtmail Options menu, we strongly
recommend that you modify them there to reduce the chance of error. Unless
otherwise noted, the default for the following variables is off.
additionalfields
A list of header fields to access via the Format menu. This
variable can be set through the Custom Fields, Header Field, and
Default Value portions of the Compose Window category in the Mail
Options dialog box.
bell The number of times to ring the bell when new mail arrives. This
variable can be set through the Signal New Mail portion in the
Message Header List category of the Mail Options dialog box. The
default is 0.
cachedfilemenusize
Specifies the maximum number of entries that are appended to the
Move and Copy To menus. The default is 10.
cdenotooltalklock
When set, network aware mail file locking is disabled. This
variable can be set using the "Use network aware mail file
locking" check box under the Advanced category of Mail Options
dialog box. By default, cdenotooltalklock is not set.
composeinterval
The interval in seconds for saving to the dead.letter file.
Default is every 600 seconds (10 minutes).
deaddir The folder in which the dead letter file will be saved. The
default is ~/dead_letter.
dontautosave
Setting this variable means dtmail will not automatically save
changes made to your mailbox.
dontdisplaycachedfiles
Specifies whether to append filenames to the Move and Copy To
menus.
dontlogmessages
Controls whether or not the Log Message item is selected in the
File Menu in the Compose window. The default is to log messages.
This variable can be set through the Log all sent messages item
in the Message Filing category of the Mail Options dialog box.
If the Log all sent messages item is selected but there is no log
file specified in the Mailbox for sent messages item, dtmail will
log all messages to a file called *L~/sent.mail.
expert Set expert mode in which minimal confirmations are requested.
This variable can be set through the Show confirmation notices
check box in the Advanced category of the Mail Options dialog
box.
filemenu2 A list of files from which to initialize the Move and Copy To
menus. These can be absolute pathnames or pathnames relative to
the directory specified in the folder variable. This variable
can be set through the Move Menu and Copy To Menu scrolling list
in the Message Filing category of the Mail Options dialog box.
filemenusize
Specifies the maximum number of entries in the Move and Copy To
menus. The default is 10.
flash The number of times to flash the window or icon when new mail
arrives. This variable can be accessed through the Signal New
Mail portion of the Message Header List category of the Mail
Options Dialog. The default is 0.
folder The directory for saving mail files. This variable can be set
through the Start Looking In item in the Mail Filing category of
the Mail Options Dialog box.
headerlines
The number of lines to display at a time in the scrolling header
list. This variable can be set through the Display item in the
Message View category of the Mail Options dialog box. The
default is 15.
hideattachments
Hide the attachments pane in the Compose Message window by
default. This variable can be set through the Show Attachment
List item in the Compose Window category of the Mail Options
dialog box. The default is to show the attachment pane
(hideattachments is off).
inactivityinterval
The number of seconds between keystrokes before a new mail is
incorporated or an auto save is considered. The default idle
interval is 30 seconds.
indentprefix
When indentprefix is set, the string that it is set to is used to
mark indented lines from included messages. The default
indentprefix is "> ". This variable can be set through the
Indent String item in the Compose Window category of the Mail
Options dialog box.
keepdeleted
Don't purge the mailbox of deleted messages when closing
(exiting) dtmail. The default is to ask the user if they would
like to purge the mailbox on exit. This variable can be set in
the Destroy Deleted Messages portion in the Message Header List
category of the Mail Options dialog box. See quietdelete.
quietdelete
Don't ask for confirmation when purging the mailbox of deleted
messages when exiting dtmail. This variable can be set in the
Destroy Deleted Messages portion in the Message Header List
category of the Mail Options dialog box. See keepdeleted.
record The mail file in which to record outgoing messages. You can
control recording of outgoing mail on a per message basis by the
Log Message item in the Compose window's File menu. The
dontlogmessages variable controls whether or not this item is
selected by default. The record variable may be set through the
Mailbox for Sent Messages item in the Message Filing category of
the Mail Options Dialog box. If record is not set and the user
chooses to log a message then the message will be saved in
~/sent.mail.
retrieveinterval
The interval in seconds that dtmail waits to check for new mail
in your inbox. This variable can be set through the Check for
New Mail Every item in the Message Header List category of the
Mail Options Dialog box. The default is 300 seconds.
saveinterval
The length of time, in seconds, between saving the state of the
mail box to disk. Default is 1800 seconds (30 minutes). This
variable can be set using the Update Mailbox State item in the
Advanced category of the Mail Options dialog box. The
dontautosave variable turns off the saveinterval variable. Add
set dontautosave to your .mailrc file to turn off autosaving.
saveinterval cannot be set through the dtmail GUI interface, so
you must edit your .mailrc file directly.
showmsgnum
Show message numbers in the scrolling list of message headers.
This variable can be set using the Display message numbers item
in the Message Header List category of the Mail Options dialog
box. Default is to not show message numbers. showto Show the
"To" field of mail messages in the Header Window if the mail is
from the same user that is reading mail (e.g. you). This
variable is set using the Show To: recipient when mail is from me
item in the Message Header List category of the Mail Options
dialog box.
signature Specifies a string consisting of a path and file name. The file
contains text that will be included by default into the Compose
window.
strictmime
Use strict MIME character encoding for outgoing mail. In this
case all lines longer than 72 characters are broken with a
newline (and a trailing "=" is appended to the line), and all
trailing spaces are encoded (appearing as "=20"). Any time
character encoding takes place all "=" must be protected and are
therefore are encoded as "=3d". Note that 8 bit characters are
always encoded, even if strictmime is not specified. If you
typically send mail to users of non MIME compliant readers you
may want to consider not specifying strictmime. This variable
can be set by selecting the Use strict MIME character encoding
item in the Advanced category of the Mail Options dialog box. The
default is to use more relaxed character encoding (i.e., don't
break long lines and don't protect trailing spaces).
templates A list of name:path pairs to access via the Templates item in the
Format menu of the Compose window. name appears in the menu;
path is the file included when name is selected. This variable
can be accessed in the Template category of the Mail Options
dialog.
toolcols Default width of the primary windows (in columns). This variable
can be set through the Display item in the Message View category
of the Mail Options dialog box.
MAIL COMMANDS
dtmail recognizes the following mailx(1) commands: unset, alias, group,
set, ignore, source, if , else, endif, alternates.
ignore [header-field...]
Suppress displaying of the specified header fields. Examples of
header fields to ignore are Status and Received. The suppressed
fields are also ignored when the message is printed. This
variable can be accessed through the Abbreviated Header item in
the Message View category of the Mail Options dialog box.
ENVIRONMENT
The following are environment variables taken from the execution
environment and are not alterable within dtmail.
HOME=directory
The user's home directory.
MAIL=filename
The name of the initial mailbox file to read (in lieu of the
standard system mailbox). The default is system dependent. See
FILES section.
MAILRC=filename
The name of the start-up file. Default is $HOME/.mailrc.
FILES
/var/spool/mail/*
/usr/share/lib/Mail.rc
System setup file that is read in before ~/.mailrc.
~/.mailrc Start-up file for mail and mailtool.
/usr/dt/bin/dtmail
Executable for the desktop Mailer.
/usr/dt/app-defaults/<LANG>/Dtmail
Application defaults for the desktop Mailer.