476 lines
20 KiB
Plaintext
476 lines
20 KiB
Plaintext
<!-- $XConsortium: mail.sgm /main/12 1996/10/30 18:20:57 rws $ -->
|
|
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
|
|
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
|
|
<!-- (c) Copyright 1995 International Business Machines Corp. -->
|
|
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
|
|
<!-- (c) Copyright 1995 Novell, Inc. -->
|
|
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
|
|
<!-- (c) Copyright 1995 Hitachi. -->
|
|
<refentry id="CDEMX.MAN27.rsml.1">
|
|
<refmeta><refentrytitle>dtmail</refentrytitle><manvolnum>user cmd</manvolnum>
|
|
</refmeta>
|
|
<refnamediv><refname><command>dtmail</command></refname><refpurpose>the desktop
|
|
mailer</refpurpose></refnamediv>
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis>
|
|
<command>dtmail</command><arg choice="opt">−h</arg><arg choice="opt">−c</arg><arg choice="opt">−f<replaceable>mailfile</replaceable></arg><group><arg>−a <replaceable>file1</replaceable></arg><arg>...<replaceable>fileN</replaceable></arg></group>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1>
|
|
<title>DESCRIPTION</title>
|
|
<para>The <emphasis>Dtmail</emphasis> program is a mailer for use on the desktop.
|
|
It provides an easy-to-use interface for viewing, filing, composing and
|
|
sending electronic mail containers and mail messages.</para>
|
|
<para>The Mailer 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 container holding messages, load new mail, copy
|
|
or move messages from one container to another, delete messages, reply to
|
|
messages, add and delete attachments to a message when composing, and view
|
|
contents of attachments in a message. The Mailer 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.</para>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>OPTIONS</title>
|
|
<variablelist>
|
|
<varlistentry><term>−a file1 ... fileN</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Bring up a Compose window with  file1  through  fileN 
|
|
as attachments.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>−c</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Bring up an empty Compose window</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>−f filename</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>This specifies the mail file to be loaded in at start up time. Ordinarily,
|
|
the mailfile 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.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>−h</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Display help for command line options</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>RESOURCES</title>
|
|
<para>The Mailer provides the following resources:</para>
|
|
<variablelist>
|
|
<varlistentry><term>Dtmail*Message_List*doubleClickInterval</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>The double click time out (in milliseconds) for the scrolling message
|
|
header list. Default is 400 milliseconds.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Dtmail*Message_List*background</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Color to use for the scrolling message header list background. Default
|
|
is system dependent.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Dtmail*Message_List*foreground</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Color to use for the scrolling message header list foreground. Default
|
|
is system dependent.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Dtmail*Message_List*fontList</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Dtmail*Work_Area*Text*background</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Color to use for the View and Compose window text background. Default
|
|
is system dependent.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Dtmail*Work_Area*Text*foreground</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Color to use for the View and Compose window text foreground. Default
|
|
is system dependent.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Dtmail*Work_Area*Text*fontList</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>MAIL VARIABLES</title>
|
|
<para>In addition to the variables recognized by <Filename MoreInfo="RefEntry">mailx</Filename>(1), <command>dtmail</command> recognizes those listed below. They can be set by editing
|
|
your <Filename>.mailrc</Filename> file; however, since most of the variables
|
|
are accessible through the Mailer 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 <emphasis>off.</emphasis></para>
|
|
<variablelist>
|
|
<varlistentry><term>additionalfields</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>A list of header fields to access via the <literal>Format</literal>
|
|
menu. This variable can be accessed through the <literal>Custom Fields:</literal>, <literal>Header Field:</literal>, and <literal>Default Value:</literal> portions of the Compose Window
|
|
category in the Mail Options dialog.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>bell</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>The number of times to ring the bell when new mail arrives. This variable
|
|
can be accessed through the <symbol role="Message">Signal</symbol> <literal>New Mail</literal> portion in the Message
|
|
Header List category of the Mail Options dialog. The default is 0.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>composeinterval</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>The interval in seconds for checkpointing to dead.letter. Default is
|
|
every 600 seconds (10 minutes).</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>dontlogmessages</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>This variable controls whether or not the <literal>Log Message</literal> item is selected in the File Menu in the Compose window.
|
|
The default is to log messages. This variable can be accessed through the <literal>Log all sent messages</literal> item in the Message Filing category of the Mail Options dialog.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>expert</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Set expert mode in which minimal confirmations are requested. This variable
|
|
can be accessed through the <literal>Show confirmation notices</literal> check box in the Advanced category of
|
|
the Mail Options dialog. <!--filemenu2 supersedes filemenu. dtmail does not
|
|
support filemenu--><!--.TP--><!--.B filemenu--></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>filemenu2</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>A list of files from which to initialize the <literal>Move</literal>,
|
|
and <literal>Copy To</literal> menus. These can be absolute
|
|
pathnames or pathnames relative to the directory specified in the <emphasis>folder</emphasis> variable. This variable can be accessed through the <literal>Move Menu</literal> and <literal>Copy To Menu:</literal> scrolling list in
|
|
the Message Filing category of the Mail Options dialog.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>filemenusize</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Specifies the maximum number of entries in the <literal>Move</literal>,
|
|
and <literal>Copy To</literal> menus. The default is 10.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>flash</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>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.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>folder</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>The directory for saving mail files. This variable can be accessed
|
|
through the <literal>Start Looking In</literal> item in the Mail Filing category of the Mail Options Dialog.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>headerlines</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>The number of lines to display at a time in the scrolling header list.
|
|
This variable can be accessed through the <symbol role="Message">Display</symbol>
|
|
item in the Message View category of the Mail Options dialog. The default
|
|
is 15.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>hideattachments</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Hide the attachments pane in the Compose Message window by default.
|
|
This variable can be accessed through the <literal>Show Attachment List</literal> item in the Compose Window category
|
|
of the Mail Options dialog. The default is to show the attachment pane.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>indentprefix</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>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 accessed through the <literal>Indent String</literal> item in the Compose Window category of
|
|
the Mail Options dialog. <!-- [ 8/11/94 dipol ]--><!-- Don't think we support
|
|
this anymore--><!-- .B popuplines--><!-- The number of lines in the View Message
|
|
and Compose Message--><!-- Windows.--><!-- This variable can be accessed through
|
|
the Mail Tool--><!-- Property Sheet in the Message Window category as--><!--
|
|
.B Display--><!-- __ Lines of Text. The default is 30.--><!-- .TP--><!--
|
|
.B printmail--><!-- The command to use to print a message. This variable
|
|
can--><!-- be accessed through the Mail Tool Property Sheet in the--><!--
|
|
Message Window category as--><!-- .B Print Script.--><!-- The default is \fBlp
|
|
-s\fP.--></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>keepdeleted</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Don't purge the mailbox of deleted messages when closing (exiting) dtmail.
|
|
Default is to ask the user if they would like to purge the mailbox on exit.
|
|
This variable can be set in the <literal>Destroy Deleted Messages</literal> portion in the Message Header List
|
|
category of the Mail Options dialog. See <literal>quietdelete</literal>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>quietdelete</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Don't ask for confirmation when purging the mailbox of deleted messages
|
|
when exiting dtmail. This variable can be set in the <literal>Destroy Deleted Messages</literal> portion in the Message Header
|
|
List category of the Mail Options dialog. See <literal>keepdeleted</literal>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>record</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>The mail file in which to record outgoing messages. You can control
|
|
recording of outgoing mail on a per message basis by the <literal>Log Message</literal> item in the Compose window's File menu. The <emphasis>dontlogmessages</emphasis> variable controls whether or not this item is selected by default.
|
|
The <emphasis>record</emphasis> variable may be set through the <literal>Mailbox for Sent Messages:</literal> item in the Message Filing category of the Mail Options
|
|
Dialog. If <emphasis>record</emphasis> is not set and the user chooses to
|
|
log a message then the message will be saved in ~/sent.mail.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>retrieveinterval</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>The interval in seconds to check for new mail. This variable can be
|
|
accessed through the <literal>Check for New Mail Every:</literal>
|
|
item in the Message Header List category of the Mail Options Dialog. The default
|
|
is 300 seconds.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>saveinterval</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>The interval (in seconds) at which to checkpoint the state of the mail
|
|
box to disk. Default is 1800 seconds (30 minutes). This variable can be set
|
|
using the <literal>Update Mailbox State</literal> item in the Advanced category of the Mail Options dialog. <!--.TP--><!--.B
|
|
save--><!--Save contents of each Compose Message window in a dead.letter file
|
|
until the--><!--message is delivered successfully. If a Compose Message window
|
|
is quit, and--><!--a new one is brought up, the new window will reuse the
|
|
dead.letter from the--><!--previous window. The first dead.letter file is
|
|
called dead.letter, the--><!--second one is called dead.letter.1, the third
|
|
dead.letter.2, and so on.--><!--The default is--><!--.I on.--><!--.TP--></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>showmsgnum</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Show message numbers in the scrolling list of message headers. This
|
|
variable can be set using the <literal>Display message numbers</literal> item in the Message Header List
|
|
category of the Mail Options dialog. Default is to not show message numbers. <literal>showto</literal> Show the "To" field of mail messages in the Header Window
|
|
if the mail is from the same user that is reading mail (eg. you). This variable
|
|
is accessed using the <literal>Show To: recipient when mail is</literal> item in the Message Header List category of the Mail Options
|
|
dialog. <!--.B sortfilemenu--><!--Sort the--><!--.B Move, Copy,--><!--and--><!--.B
|
|
Load--><!--menus alphabetically.--><!--.TP--><!--.B suppressautoretrieve--><!--Do
|
|
not automatically retrieve new mail messages.--><!--This variable can be accessed
|
|
through the Mail Tool--><!--Property Sheet in the Header Window category as--><!--the
|
|
Automatically display headers check box.--><!--Default is to automatically
|
|
retrieve new mail.--></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>strictmime</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>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 <literal>Use strict MIME character encoding</literal> item in the Advanced category of the Mail Options dialog.
|
|
The default is to use more relaxed character encoding (ie don't break long
|
|
lines and don't protect trailing spaces).</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>templates</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>A list of <emphasis>name:path</emphasis> pairs to access via the <literal>Templates</literal> item in the <literal>Format</literal> menu of the Compose
|
|
window. <symbol role="Variable">name</symbol> appears in the menu; <emphasis>path</emphasis> is the file included when name is selected. This variable
|
|
can be accessed in the Template category of the Mail Options dialog.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>toolcols</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Default width of the primary windows (in columns). This variable can
|
|
be accessed through the item in the Message View category of the Mail Options
|
|
dialog. <!--.B trash--><!--The name of the trash bin, which may be accessed
|
|
--><!--just like any other mail file.--><!--If set, all deleted messages are
|
|
moved to the trash bin. --><!--The trash bin is emptied when you commit changes.
|
|
This--><!--option degrades the performance of--><!--.B dtmail--><!--and
|
|
is not recommended.--></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>MAIL COMMANDS</title>
|
|
<para>In addition to the commands recognized by <Filename MoreInfo="RefEntry">mailx</Filename>(1)
|
|
in the <emphasis>.mailrc</emphasis> file, <command>dtmail</command> also recognizes
|
|
the following commands.</para>
|
|
<variablelist>
|
|
<varlistentry><term>ignore [header-field...]</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Suppress displaying of the specified header fields. Examples of header
|
|
fields to ignore are Status and Received. The 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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>PRINTING</title>
|
|
<para>You can print messages using command invocation by selecting the
|
|
message or messages to be printed and then activating the <literal>Print...</literal> command in the <literal>Message</literal> pulldown menu in the <command>dtmail</command> menu bar or the <literal>Print...</literal> command in the
|
|
<literal>Mailer - Messages</literal> popup menu that is displayed on
|
|
<literal>BMenu Down</literal> events in the message list.</para>
|
|
<para>In addition, you can use the <literal>Print</literal> command button
|
|
located at the bottom of the message headers list to print the currently
|
|
selected messages. In this case, the print job is started using the print
|
|
setup context from the last print command without displaying any of the print
|
|
setup dialogs.</para>
|
|
<para>Alternatively, you can print messages using Drag and Drop invocation.
|
|
</para>
|
|
<para>Messages containing attachments are printed with summary lines in place
|
|
of the attachment. You must print attachments individually in separate
|
|
print job invocations.</para>
|
|
<para>You can choose to print multiple messages either as a single print
|
|
job or as separate print jobs. If you print multiple messages in
|
|
a single print job, you can choose to separate the messages using
|
|
a blank line or a page break.</para>
|
|
<para>To print a mailboxes, use CDE Drag and Drop to drag the icon for the
|
|
mailbox from the File Manager to the printer icon in
|
|
the desktop.</para>
|
|
<para>When you invoke printing, whether by command invocation or by
|
|
drag and drop, <command>dtmail</command> displays a Print Setup window that
|
|
allows you to set a number of generic and printer-specific printing
|
|
options. For example, you can send the output to a file
|
|
or a printer. In the case of printed output, you can specify how many copies
|
|
you want. You can also access another window to set options specific to
|
|
the printer/spooler you are using. For example, you can select paper size,
|
|
orientation, a banner page title, one- or two-sided printing, and email notification
|
|
on completion of the print job.</para>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>ENVIRONMENT VARIABLES</title>
|
|
<para>The following are environment variables taken from the execution environment
|
|
and are not alterable within <command>dtmail</command>.</para>
|
|
<variablelist>
|
|
<varlistentry><term>HOME= directory</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>The user's home directory.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>MAIL= filename</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>The name of the initial mailbox file to read (in lieu of the standard
|
|
system mailbox). The default is system dependent.
|
|
See FILE section.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>MAILRC= filename</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>The name of the start-up file.
|
|
Default is
|
|
$HOME/.mailrc.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>FILES</title>
|
|
<variablelist>
|
|
<varlistentry><term>/var/mail/* (Sun)</term>
|
|
<listitem>
|
|
<para></para>
|
|
<!-- ex-TP-->
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>/var/spool/mail/* (IBM)</term>
|
|
<listitem>
|
|
<para></para>
|
|
<!-- ex-TP-->
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>/usr/mail* (HP)</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>System mailboxes</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>/etc/mail/mailx.rc</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>System setup file that is read in before ~/.mailrc.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>~/.mailrc</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Start-up file for
|
|
<command>mail</command> and
|
|
<command>dtmail</command>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>/usr/dt/bin/dtmail</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Executable for the desktop Mailer.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>/usr/dt/app-defaults/<LANG>/Dtmail</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Application defaults for the desktop Mailer.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 01:31:55-->
|
|
<?Pub *0000022737>
|