hgsendmail 1.0


Name

hgsendmail - a Perl script for sending, replying and forwarding mai from Harmony

Synopsis

hgsendmail [action] [GOid]

hgsendmail usually is called from Harmony, although it may also be executed form the shell. For a short description try hgsendmail -h, for more details see below.


Description

Normally, a user does not execute hgsendmail from the shell; instead, this script is called by Harmony when one of the mail functions is selected (it goes without saying, the actions reply and forward work only with a mail object selected.).
hgsendmail then launches an editor and presents a message header along with some more information, depending on what action has been selected. (More about editor and header in a second.)
The user may now compose the mail message, and when he or she has saved the message and quitted the editor, hgsendmail sends the message off via the UNIX command sendmail.
However, if the user decides not to send the message while already editing it, emptying the editor's buffer, saving it and exiting the editor aborts the command.

The general settings for hgsendmail are stored in the file hgsendmail.rc, which is supposed to be in ~/.hgmail. In this file, the user may define the editor that shall be launched for composing the messages, the signature file that is to be appenden to the messages as well as a header that shall appear in the editor. If this rc-file is missing, emacs is launched by default, and a standard header consisting of the fields "To:" and "Subject:" is provided.
If a custom header is defined in hgsendmail.rc, it should appear at the very end of that file, its beginning should be indicated by "SOH" (meaning 'start of header' ...).

Here is an example hgsendmail.rc:

#settings
EDITOR: emacs
SIGNATURE:  .sig

# The mailheader itself
SOH
To: 
Subject: 
Bcc: aschmid
Organization: Graz University of Technology, Austria
X-Mailer: Harmony


Actions

-send
... is the default action; launches the default editor, displays the default mail header and sends the composed message when editing is finished.

-reply
... replies to the messages the GOid of which is given as parameter (this action works for mail-objects only, i.e. the object must have a keyword starting with "Id = ").
The default editor is launched, the header inserted with the original's author as recipient, and the original message is cited.

-forward
... forwards the message the GOid of which is given as parameter (see -reply).
Again, the default editor is launched, an empty header and the original message (including its header) are inserted.


Author

Alfons Schmid (aschmid@iicm.edu) - July 2, 1996