Copyright: Visual Help Copyright® 1993 Firas Bushnaq


Contents

Overview

Getting started

Interface Elements

Reading messages

Manually deleting messages

Rules for deleting

Contact information

Registering Newman's Trombone


Overview

Newman's Trombone is a program for deleting unwanted mail messages, without wasting time on downloading the messages. This feature is required on several occasions. For Example:

•	Save communication time in downloading unwanted messages.

•	If you have subscribed to a distribution list, and when you want to unsubscribe the list server does not accept your unsubscribe command. Instead of wasting time in downloading all the messages, you can set Newman's Trombone to delete all the mail from this list.

•	Delete all the mail from a certain person or persons.

•	Delete all the messages which discuss a certain subject.

Getting started

Registering Newman's Trombone


Getting Started

Installing Newman's Trombone

Create a separate directory for Newma's Trombone (which will be referred as Trombone's directory), unzip TROMBONE.ZIP in the Trombone's directory. Move CSWSOCK.VBX and CMDIALOG.VBX to your WINDOWS\SYSTEM directory. Add a new program item to your desired group in the Program Manager.
group in the Program Manager.

You must have a working TCP/IP connection in order for this program to run. Any other connection will not do.

VBRUN300.DLL must be present in your WINDOWS\SYSTEM directory. It can be downloaded from most online services.

Basic uses for Newman's Trombone

In the first time you run Newman's Trombone you will be asked to enter your mail account (e.g. shahard@kagi.com) and optionally your password for getting mail (contact your Internet Service provider or your Network Administrator if you don't know this). After entering these details the program will try to connect to your mail server, by default. After a certain time, which is depends on your connection speed and the amount of messages which exists on your mail server, the messages will appear in a listbox. You will be able to select messages, read them or delete them.

See also:

Interface elements

Reading messages

Manually deleting messages


Interface Elements

Main Window

Rules Dialog

Personal Details Dialog


Main Window

•	Messages List: Here you will see a list of available messages, if you have finished the connection with your mail server.

•	Connect / Disconnect: By pressing this button, or the equivalent command under the File menu, Newman's Trombone will connect or disconnect from your mail server. Note than no other program, including your mail program, can connect to your mail server in order to get mail, while someone uses you mail account. If the program does try to do so, you might get an error which suggests that another one is using your mail account, or an error message, you should ignore these messages. This is not a limitation of Newman's Trombone, but of the POP3 protocol.

•	Delete: Deletes currently selected mail messages, if such exists.

•	View Top: By pressing this button, the headers of the selected mail messages, and the first 10 lines will be shown.

•	Read All: By pressing this button, the selected mail messages will be shown.

Menus

File Menu

•	Connect / Disconnect: Like the equivalent button.

•	Exit: Disconnects from the mail server, if needed and exits program.

Tools Menu

•	Run Mail Program: Runs the mail program, probably for downloading your mail after you've deleted the unwanted messages using Newman's Trombone. You can set the mail program file name by selecting Set Mail Program from the options menu.

•	Delete Message(s): Deletes the currently selected messages.

•	Manage Rules: Runs the rules dialog for managing rules.

•	Activate Rules: Activates rules on the messages.

Options Menu

•	Personal Details: Runs the personal details dialog which allows you to set your mail account and password.

•	Set Mail Program: Sets the file name of your mail program, for use in Tools|Run Mail Program.

•	Auto activate rules: If selected, Newman's Trombone will run the rules after it finishes to collect the needed information about the messages.

•	Auto connect to mail server: Determines whether Newman's Trombone will try to connect to the mail server when started

•	Save Password: When checked Newman's Trombone records you password in the INI file (encoded) and using this data in order to get your messages. If you do not want to take the risk of discovering your password, you will have to manually insert your password with every connection to the mail server.

•	Play Sounds: If checked, Newman's Trombone will notify you vocally on the results of every connection to the mail server.


Rules Dialog

The rules dialog can be accessed by selecting Tools|Manage Rules.

Rules dialog interface elements

•	List of Rules: Contains all the rules which are activated. Selecting an item allows you to change the behavior of the rule.

•	Rule Type: Check subject or Check sender. Determines if the rules checks the subject of the rule or its sender. If the sender option is checked, the "What to delete" field will determine the exact behavior of the rule.

•	Email address to delete: Name to delete or Subject to delete: If the rule's type is subject, this field should contain what part of the subject the program should look for (e.g. if the field contains "make money fast", the program will look for this phrase in every message subject, and if it exists, the program will delete it.). The search is not case sensitive.

If the rule's type is sender and the Check address options is checked, Newman's Trombone will look for the specified mail address in the message Sender/From field, depending in the "What to delete" field (e.g. if the email "dobziny@shani.net" will be written in this field, every mail from me will be deleted.)

If the rule's type is sender and the Check address options is not checked, Newman's Trombone will look for the specified name in the message Sender/From field, depending in the "What to delete" field (e.g. if the name "Shahar Dobzinski" will be written in this field, every mail from me will be deleted.)

•	Check address: Determines whether Newman's Trombone should look for the email address or for the name (search for "Shahar Dobzinski" or for dobziny@shani.net).

•	Delete method: "Ask before deleting" means that whenever the rules identifies a message which should be deleted, the user will be asked whether he his certain that he wants to delete this message. if "Automatically deleting" is selected, the user will not be asked if he is sure that he wants to delete the message.

•	What to delete: If "Check original sender (From)" is selected, Newman's Trombone will look for the From header in the message for the name or email address of the sender. For example, if Adam sent  a message to Hava, and Hava redirected the message to Moses, Moses message will contain the name Adam in the message, because he was the original sender of the message and not Hava which was the last person to send this message.

If "Check last sender (Sender)" is set, Newman's Trombone will look for the Sender header. To stay with Adam, Hava and Moses example, the Sender header will contain the name Hava, because she was the actual sender of the message.

•	OK: Commit all changes which have be done since the dialog was activated.

•	Cancel: Ignore all changes which have be done since the dialog was activated.

•	New Rule: Defines a new rule. A dialog will be opened and the user will be asked to enter the name of the rule.

•	Rename Rule: Change the name of the currently selected rule.

•	Delete Rule: Delete current rule.

See Also:

Rules


Rules

Rules are Newman's Trombone way for deleting mail automatically. Whenever Newman's Trombone finishes its connection to the mail server rules are automatically activated, if the Options|Auto activate rules was set to do so.

Rules deletes messages which passes a certain condition. Examples for such condition might be:

•	Delete all mail which comes from Shahar Dobzinski.

•	Delete mail which comes from unwanted-list@mail.listserve.com, only if the user agrees to do so.

•	Delete all mail which contains, in its subject, the phrase "Don't read this".

You can activate the rules by choosing Tools|Activate Rules menu.

Rules Dialog


Personal Details Dialog

•	Mail Address: Your mail address in the form of shahard@kagi.com.

•	Password: Your password which is needed in order to get your messages in your mail server. Required only if Options|Save Password menu item is set to true.


Reading Messages

After you have connected to your mail server, and Newman's Trombone has successfully identified your messages' subject and authors, you are able to delete the unwanted mail. However, sometimes you want to be able to read the content of the message. To do this you can do one of the following:

•	View Top: With this button you will be able to read the headers of the message and the first ten lines, which hopefully will help you understand what the message is about.

•	Read All: This button shows the whole message text. Of course, this method will be most times slower than the first method

See Also

Interface Elements


Manually Deleting

You can manually delete unwanted mail messages (without using rules) by selecting the messages you would like to delete and pressing the Delete button. Shift+click or Shift+arrow key extends the selection from the previously selected item to the current item.  Ctrl+click selects or
deselects an item in the list.

See Also:

Rules for deleting


Registering
Registering Newmna's Trombone

Newman's Trombone is not a freeware product. It is a shareware product, a one which you can freely try for a limited period, and then decide whether you want to buy the product. Using this software after the limited time period is exactly like using pirated software.

You have the right to try Newman's Trombone for two weeks, and then decide whether you want to buy it. If not, you must remove Newman's Trombone from your computer. Newman's Trombone price is 25$ which can be paid in two ways:

•	Send 25$ or 80 NIS in cash directly to me:

Shahar Dobzinski
18 Hamelech Shaul street
Herzelia 46712
Israel

•	If you prefer to use credit card, check or First Virtual, use the REGISTER program, which should be in Newman's Trombone directory. To do this run this program:

REGISTER.EXE

Benefits from registering

•	The legal right to use Newman's Trombone.

•	The message which informs you that you are using the shareware version of Newman's Trombone will not be shown.

•	The user can manually delete more than 3 messages.

•	The user can use more than two rules.

Above all, it is ilegal to use Newman's Trombone for more than two weeks.


Contact Information

Newman's Trombone was written by Shahar Dobzinski.

I am very interested to know what you think about the program, so feel free to send me any comments, suggestions, why you like it / don't like it, and your general overviews on the program. Feel free to send me mail at shahard@kagi.com.

For general information about Newman's Trombone and other programs of mine, if you are interested in seeing the wordld's first virtual museum for trombones, visit:

HTTP://SHANI.NET/~DOBZINY

Remember! Newman's Trombone is not shareware. You are allowed to use it for the two weeks evaluation period only. Please register and keep the shareware concept alive.

Registering Newman's Trombone