 |
Index for
Section 1 |
|
 |
Alphabetical
listing for D |
|
 |
Bottom of
page |
|
dtmail(1)
CDE
NAME
dtmail - the CDE desktop mail tool
SYNOPSIS
dtmail [-hc] [-f mailfile] [-l filename] [-a file1 ... fileN]
[generic-tool-arguments]
OPTIONS
-a file1 ... fileN
Bring up a Compose window with file1 through fileN as attachments.
-c Bring up an empty Compose window
-f mailfile
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.
-l filename
Starts the compose window on a dead letter file.
DESCRIPTION
The dtmail program is a desktop mail application. 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 containing 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 the
contents of attachments in a message. dtmail also supplies a mail-
pervasive desktop environment by providing a public Tooltalk API that other
clients can use to compose and send messages.
You can use dtmail as a Post Office Protocol (POP) to connect to mail
servers offering POP services. If you choose this option, you can also
select APOP authentication (if supported by your mail server) to encrypt
your user ID and password during communications with your network mail
server.
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, and alternates. See the mailx(1)
reference page for more information.
dtmail also recognizes the variables listed below. We strongly recommend
that you use the dtmail Mailbox Options menu to modify their values to
reduce the chance of error. Unless otherwise noted, the default value 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.
apop
If apop is enabled, dtmail uses APOP authentication to encrypt your
user ID and password during communications with your network mail
server. Your network mail server must support this authentication
method. If no network mail service is selected, this variable is
ignored.
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 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 ~/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 Header
List 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 to which it is set 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.
netautomailcheck
If netautomailcheck is enabled, dtmail automatically checks your
mailbox on your network mail server for new mail according to the
parameters set in the Mail Options Message Header List dialog box
``Check for new mail'' field. If no network mail service is selected,
this variable is ignored.
netservername
The host name of your network mail server. If no network mail service
is selected, this variable is ignored.
netservice
Select network mail services.
· When set to POP, dtmailis enabled as a POP client.
· When set to NONE, the netservername, netusername, apop, and
netautomailcheck variables are ignored.
If you enable dtmail as a POP client and enter your network mail server
password in the Network Services category of the Mail Options dialog
box, the password is stored in memory instead of your ~/.mailrc file.
netusername
Your user name on your network mail server. If no network mail service
is selected, this variable is ignored.
popuplines
The default height, in rows, of the read and compose windows. This
variable can be set through the Display item in the Message View
category of the Mail Options dialog box. This option takes effect the
next time that you start dtmail.
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 (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 readers that are
not MIME-compliant 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: 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. Changes to this variable take effect the next time
you start dtmail.
MAIL COMMANDS
dtmail recognizes the following mailx(1) commands: unset, alias, group,
set, ignore, source, if, else, endif, and alternates. See the mailx(1)
reference page for more information.
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.
[Tru64 UNIX] dtmail does not recognize the user-configurable mail locking
environment variable $MAILLOCKING. If you are using NFS, you must have NFS
locking enabled on both the client and server systems.
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.
/etc/services
Includes port 110 for POP3.
/etc/inetd.conf
Includes the POP3 daemon service.
/etc/passwd
Includes a POP user to own the mailauth program.
|
Index for
Section 1 |
|
|
Alphabetical
listing for D |
|
 |
Top of
page |
|