Copyright: carty, 1995


Internet Mail for Dana "Michelle"

"Michelle" is an email client which runs on the text editor "Dana".

You can send and receive email without bringing up any other application. All the email operations can be done in the text editor.

Features

Installation

Initial settings

Main Menu

Attention


Features

- All the operation can be done in the editor. You can send the text just you are editting and receive email into the editor.

- You can compose email when you are offline. Those email can be stored in the "OutBox" and all of them are sent using "Send All" command when you are online. This capablity is convenient for dial up users.

- Letter box management capablity. InBox, OutBox and user defined letter boxes. You can move received mail into a certain letter box using "Move" command. And the auto delivery definition enables you to deliver received mail to certain letter boxes automatically.

- Address book management capablity. You can manage multiple email addresses and address groups.

- The front-end of Michelle is written in Dana Script. You can customize it as you like.

* Binary mail sending capability is not supported. If you want, encode the binary file into plain text using some encorder utility (uuencode etc.) and paste it into the mail you are sending.


Installation

To run Michelle, set it up as follows.

1) Copy all the files in the archive package of Michelle to the directory where Dana.EXE exists. Followings are the contents of the archive of Michelle.

Michelle.DAS	Michelle script

DanaInet.DLL	Winsock API support DLL.

MailDeli.DAT	Auto delivery definition file (sample).

Inbox.DAT	Letter box definition file (sample).

Michelle.HLP	Help file for Michelle.

2) If you have defined "DANAHOME" environment variable, Move "MailDeli.DAT" and "Inbox.DAT" to the directory this environment variable indicates. (If you don't use the default settings in them, you can create these files as new.)

3) Register "Michelle.DAS" to Dana. There are two ways to register scripts on Dana: Select "Preferences" of "Tool" menu and register the script in "Addin" property page. Select "Script Jukebox" and check the "Register" to register it to certain push button.

It's better to register it as "Michelle.DAX" so that you run a executable  (pre-compiled) file, which starts quickly. "*.DAX" file is updated when the source code has been changed or Dana's version is updated. If you register scripts as "*.DAS", Dana compiles this script each time and never make "*.DAX" file.

4) Register Michelle.HLP to Dana if you want. To do this, select "Menu" property page on "Preferences" and register it.

Now, you can run Michelle.

Tips:

If you think "It is too much trouble to bring up Michelle from "Tool" menu each time", or "Dana is nothing but a email client for me" :-}, I recommend the following setting.

1) Open "Dana.DAS" (or Dana's initial residential script you defined).

2) Search the following description.

Main ()

    Select Case .DanaState

    Case STATE_INIT

        StayResident()

3) Add the following statement.

Main ()

    Select Case .DanaState

    Case STATE_INIT

        Run("Michelle.DAX")           '<- this. specifying ".DAX" is better.

        StayResident()

4) Save Dana.DAS and restart Dana. Michelle stays resident on start.


Initial settings

You can see the server setting dialog when you start Michelle for the first time. Configure the following information, which can be changed any time when you select the "Configuration" from the main menu.

Your Name	Input your name. It is embedded into "From:" header field with your mail address when you send a mail.

Your Mail Address	Input your mail address.

e.g. scott@tiger.com

Login Name(Optional)	Input the login name for your POP server. If UNIX, it should be the same as your shell account usually.

Password(Optional)	Input the password for your POP server. If your machine is in a public place, you must keep it blank. Besides, you should not specify the password anyway for a security reason.

POP Server	Input your POP server's name. If you have no idea on it, ask to the system administrator of your server.

e.g.

pop.yourcompany.com

po.yournet.net

SMTP Server	Input your SMTP server's name. In most cases, it is the same name as the POP server.

Delete Received Mail in Server

Specify if you want to delete mail in the server after you receive it.

I recommend that you don't check this parameter until you assure that the receive capability of Michelle works without problem. After you certainly received your mail, you can use "Delete Mail on Server" command.

Although I have tested Michelle in most environment as many as I can access, there might be environments where Michelle doesn't work correctly. Your mail is very precious and I can't have any insurance for it.


Main Menu

You can bring up the main menu for Michelle hitting Ctrl+Shift+Enter key, or clicking right mouse button with keeping Ctrl key pushed.

If you want to change this key bind to the other, edit Michelle.DAS directly.

Move

Delete

Receive

Receive All

Send

Send All

Reply

InBox

OutBox

UserBox

Delete Mail on Server

Sweep Letter Box

Today's Received Mail

Auto Delivery Define

Edit Signature

Address Book

Configurations

Exit Michelle


Move

Moves this mail to a certain folder. If you move it to "Trash Box", it is deleted when Michelle is quitting.

You can select this command when you have received mail on the current edit window.


Delete

Deletes the mail on the current window.

You can select this command when you have received mail on the current edit window.


Receive

Receives unread mail.


Receive All

Receives mail including already read.


Send

Sends a text on the current edit window as email. After you specify Subject, To, Cc and Bcc and hit enter key, a dialog box prompts you "Send it right now?". If you select "No", this mail is saved into Outbox and you can send it later by "Send All" command.


Send All

Sends all the mail in Outbox. The sent mail is moved to "Sentbox".


Reply

Opens a return mail window for the mail you have on the current edit window. Original mail is pasted into the return mail with "> " sitation symbol. If you don't want site all the mail, delete it as you like.

After composing, you can send it right away by "Send" command or save it. Saved mail is in Outbox which you can send by "Send All" command.


InBox

You can select and open one of the received mail.


OutBox

You can see a list of the subject of mail to be sent.

"SentBox" is the letter box into which the sent mail is moved. You can select mail from "SentBox" and send again. If you don't want all the sent mail any more, select "Empty" command.

"Send Log" is the records of sending mail which contains date, time, to-address and subject information. You can clear it and save again when you don't want the information any more.


UserBox

You can see the user defined letter boxes and the "Trash Box". By "Edit UserBox" command, you can define certain letter boxes as you like.


Delete Mail on Server

Deletes all mail which is already read on the server. About unread mail, you are asked if it is okay to delete.


Sweep Letter Box

Soon or later, you will find your letter box has been fullfilled by useless mail.

You can clean up them using this command. You are prompted if it is OK to delete with the information about the subject and the sender for each mail.


Today's Received Mail

List up all the mail you received by last "Receive" or "Receive All" command.


Auto Delivery Define

You can edit the definition file for auto delivery of received mail. It defines that when a paticular string is found in a specified header, it is delivered to a specified letter box.

Note that any name of letter box can be specified even if it is not defined in user letter box definition.

e.g. (<Tab> means an actual tab code, 0x09)

# If carty@kagi.com is found in From: header field,

# it is delivered to "Dana_Related" letter box.

From<Tab>carty@kagi.com<Tab>Dana_Related


Edit Signature

Opens signature file to edit. Edit and save it.

This signature is appended automatically at the end of mail being sent.


Address Book

Paste certain addresses onto the caret position. You can also maintain the address book which can be used when you are sending mail.


Configurations

Change the initial settings.


Exit Michelle

Exit Michelle mode.


Attention

Michelle is an add-in application which can run only on the text editor Dana. You need Dana to run it. But DanaInet.DLL is quite a DLL and independent from Dana actually. You can use it as a general mail handling library in C, VB or whatever language. BUT NO REFERENCE MANUAL SORRY.

Michelle is a free software. You can modify and redistribute it without any restriction. But please put your name into the source code with some descriptions for the version.


Address Book

You can register certain mail addresses in the address book. Selecting an address in the left list box, you can see the selected address in the upper text box. (Of course you can input an address in the text box directly.)

Then push "Add" button to add the address to the right list box. "All" button add all the addresses which can be seen in the left list box.

The addresses in the right list box is input into To:, Cc: or Bcc: field when you are sending mail.

"Del" delete an address which is selected in the right list box. "Reset" deletes all addresses which are seen in the right list box.

As the default address group, you can see "Usual" group in the down left combo box. Pushing "New Grp", you can create new address groups and delete certain address groups as well. (Usual group cannot be deleted.)

Pushing "New Addr", you can add new addresses into the address group currently selected.