@database Voodoo.guide @rem $Id: Voodoo.guide 1.276 1996/11/09 02:43:07 oahvenla Exp oahvenla $ @author "Osma Ahvenlampi" @(c) "Osma Ahvenlampi" @smartwrap @index "Index" @node Main "Voodoo User Documentation" @{b}VOODOO - THE MULTIMEDIA E-MAILER@{ub} Copyright © 1995, 1996 Osma Ahvenlampi, All Rights Reserved. @{i}Any sufficiently advanced technology is indistinguishable from magic. - Arthur C. Clarke@{ui} @{b}TABLE OF CONTENTS@{ub} @{" I " link "Introduction"} Introduction @{" II " link "Legal"} Legal Information @{" III " link "Installation"} Installation @{" IV " link "Offline"} Offline use @{" V " link "Starting"} Starting up @{" VI " link "Configuration"} Configuration @{" VII " link "MessageWindow"} Main interface @{" IIX " link "MainMenus"} Menus @{" IX " link "ComposeWindow"} Built-in editor @{" X " link "ARexx"} ARexx command set @{b}APPENDICES@{ub} @{" A " link "Registering"} Registering Voodoo @{b}Important!@{ub} @{" B " link "Contact"} Contact information @{" C " link "README/MAIN"} Release notes readme @{" D " link "HISTORY/MAIN"} Version history @{" E " link "Glossary"} Glossary @{" F " link "FAQ"} Common questions & problems @{b}Please read this!@{ub} @{" G " link "ClassAct"} About ClassAct @{" H " link "SECURITY/MAIN"} Security notes @{" I " link "Standards"} Related standards @{" J " link "Index"} Index @{lindent 4}@{i}This document was designed for AmigaGuide V40. It will not display correctly on earlier versions of the AmigaGuide parser.@{ui}@{lindent 0} @endnode @node "Introduction" "Introduction to Voodoo" @{b}INTRODUCTION TO VOODOO@{ub} You have in your hands a demo version of the premiere Amiga E-Mail software. Voodoo is a multithreaded, easy to use E-Mail reader. It provides an attractive and easy to use interface to reading and writing Internet mail, including advanced features such as attaching varying types of documents to plain text messages, with the Multipurpose Internet Mail Extensions (@{"MIME" link "Glossary"}). Using the @{"Datatype" link "Glossary"} system introduced in AmigaOS 3.0, it can display many kind of data, such as text, graphics, even animation. Voodoo does not handle the receiving or sending of E-Mail. This is because the requirements of these actions are different depending on the type of the user's Internet connection, and programs specifically designed for that purpose can do the job better. Voodoo will happily co-exist with programs such as AmiPOP, Sabot, and INetUtils. Because of this reason, Voodoo no more requires AS225 than AmiTCP. It will work just as well with MLink, a UUCP system, or any other type of network, as long as the mail itself is in the standard Internet (@{"RFC-822" link "Glossary"}) format. Voodoo is a shareware program. If you like Voodoo, and decide to continue its use beyong a 30 day evaluation period, you should @{"register" link "Registering"} it to support the continuing development. @{b}SYSTEM REQUIREMENTS@{ub} · @{lindent 3}AmigaOS Release 3.0 (V39) or newer.@{lindent 0} · @{lindent 3}At least 2MB of RAM.@{lindent 0} · @{lindent 3}Hard drive recommended.@{lindent 0} · @{lindent 3}Some kind of an Internet connection.@{lindent 0} @{b}PROGRAM FEATURES@{ub} · @{lindent 3}Fully multithreaded. View and write several messages at once.@{lindent 0} · @{lindent 3}Integrated MIME support allows easy attachment of any type of files, making true multimedia E-Mail possible.@{lindent 0} · @{lindent 3}Works with any TCP/IP stack or UUCP system.@{lindent 0} · @{lindent 3}Compliant to a number of E-Mail related RFCs (822, 1521, 1522, 1806, 2015 and others).@{lindent 0} · @{lindent 3}Uses external message delivery programs to adapt to any kind of system.@{lindent 0} · @{lindent 3}Extensive @{"ARexx interface" link "ARexx"} allows the use of any text editor.@{lindent 0} · @{lindent 3}Easy to use, font sensitive interface using the ClassAct gadget system.@{lindent 0} · @{lindent 3}Extensive on-line help.@{lindent 0} · @{lindent 3}Forerunner in E-Mail encryption: one of the first mailers to support @{"PGP/MIME" link "PGP"} (RFC 2015) (requires PGP installed).@{lindent 0} · @{lindent 3}Can internally display a multitude of data formats with the help of the AmigaOS 3.0 Datatype subsystem.@{lindent 0} · @{lindent 3}Opens on any public screen.@{lindent 0} · @{lindent 3}Localised, with translations to Finnish, French, Greek (ELOT 928 character set), Icelandish and Italian. English as the built-in language.@{lindent 0} · @{lindent 3}Fast-to-use icon speedbar for common operations.@{lindent 0} · @{lindent 3}Built-in addressbook.@{lindent 0} · @{lindent 3}Unlimited number of folders.@{lindent 0} · @{lindent 3}Thoroughly tested by a small team of experienced Amiga users during an extensive beta testing period.@{lindent 0} · @{lindent 3}Supports Workbench drag&drop@{lindent 0} · @{lindent 3}@{"Secure AmigaGuide display" link "AGV41"}, utilizing amigaguide.datatype V41.@{lindent 0} @{b}LIMITATIONS OF THE DEMO VERSION OF VOODOO@{ub} · @{lindent 3}No external addressbook interface.@{lindent 0} · @{lindent 3}A maximum of one attached file when sending messages.@{lindent 0} · @{lindent 3}Can not automatically import new mail to folders other than the primary.@{lindent 0} · @{lindent 3}ARexx interface restricted to the most basic commands only.@{lindent 0} · @{lindent 3}Only one, global, spool file. Registered version has a private spool file for every folder in addition to that global spool file.@{lindent 0} · @{lindent 3}Message delivery done in Voodoo main process (stopping Voodoo for the duration).@{lindent 0} · @{lindent 3}Expires after 30 days.@{lindent 0} · @{lindent 3}Can only decrypt PGP/MIME encrypted messages.@{lindent 0} @{b}UPCOMING FEATURES IN REGISTERED VERSIONS@{ub} · @{lindent 3}Attach files to messages while using an external editor.@{lindent 0} · @{lindent 3}Mail processing and automatic folder selection.@{lindent 0} · @{lindent 3}User macros.@{lindent 0} · @{lindent 3}Iconify single windows.@{lindent 0} · @{lindent 3}Use external viewers for files not understood by datatypes.@{lindent 0} · @{lindent 3}Optionally replace the built-in addressbook with an interface to a database program of your choice.@{lindent 0} · @{lindent 3}X-Face/NeXT-Face support.@{lindent 0} @endnode @node "Legal" "Legal information on Voodoo" @{b}VOODOO LEGAL INFORMATION@{ub} @{b}COPYRIGHT@{ub} Voodoo Amiga Emailer, and all files included in the distribution are, unless otherwise noted, @{b}Copyright © 1995, 1996 by Osma Ahvenlampi. All rights reserved.@{ub} The @{"ClassAct" link "ClassAct"} gadget system is Copyright © 1995, 1996 Phantom Development. @{b}DISCLAIMER@{ub} This software is provided "as is". No warranties are made, either expressed or implied, with respect to reliability, quality, performance, or operation of this software. The use of this program is at your own risk. The author assumes no responsibility or liability for any damage or losses resulting form the use of this software. @{b}LICENSE@{ub} This license does not apply to parts of the distribution not covered by the Voodoo copyright. For the license of these parts, refer to the respective documentation. @{b}USE@{ub} The use of Voodoo for evaluation purposes for up to 30 days is permitted. Use beyond this evalution period requires a @{"registration" link "Registering"}. Unauthorized use of the registered version, called Serious Voodoo, is prohibited. @{b}DISTRIBUTION@{ub} Distribution of Voodoo is permitted on a limited basis as described by this license. Permission to distribute copies of the evaluation version of Voodoo on disk is granted provided no money is charged beyond the cost of the storage media. Commercial distributors of freely distributable software are explicitly NOT allowed to distribute Voodoo. Permission to distribute Voodoo electronically on computer networks and bulleting board systems is granted provided that no money is charged explicitly for accessing or downloading the archive. Distribution on magazine cover disks and similar media requires that a copy of the issue is sent to the @{"author" link "Contact"}. Contact me before placing Voodoo on a cover disk. Distribution of Voodoo that violates this license is prohibited without the prior written permission of the @{"author" link "Contact"}. @{b}ACKNOWLEDGEMENTS@{ub} @{"ClassAct" link "ClassAct"} gadgets are Copyright ©1995, 1996 by Phantom Development, written by Chris Aldi, Timothy Aston, Gregory Block, and Osma Ahvenlampi. The programs AmiPOP and Sabot were written by Scott Ellis. Other included utilities are by Dan J. Fraser, Sami Itkonen and Josef Faulkner. Translations provided by Yannick Koehler, Giacomo Magnini, Manos Konstantiniadis, Sigurbjörn Birkir Lárusson, Dr. Peter Kittel, Cesar Talon, Edmund Vermeulen, Fernando Nunes and Thomas Andersson. Icons by Dennis Sibera, based on originals by Timothy Aston, Seth Harman, Osma Ahvenlampi and Dan J. Fraser. Invaluable assistance with many routines and in pointing out RFCs from Michael B. Smith. Thanks to all Voodoo beta testers for finding the bugs. @endnode @node "Installation" "Installation of Voodoo" @{b}INSTALLATION@{ub} This manual documents installation on the probably most common setup, a SLIP/PPP dial-up connection using either AS225 or AmiTCP communication stacks. Installation on a system connected using MLink is very similar. Installations on systems permanently connected with either a leased line or by Ethernet differ somewhat in the configuration of the E-Mail delivery and receiver programs. Basic Voodoo installation is covered by the standard Installer script. This script will install the required shared gadget classes and Voodoo itself. This, plus a minor amount of configuration, should be sufficient for systems that have already been configured to use some other mail reading software. On systems that have not been configured to send or receive E-Mail this installation step is somewhat more involved. While I have tried to make the installation straightforward, be warned that the configuration of E-Mail is not necessarily a simple thing. Please, take the time to read this part of the manual before attempting the installation. @{b}RECEIVING MAIL@{ub} @{b}ON DIAL-UP CONNECTIONS@{ub} For a @{"dial-up" link "Glossary"} connection, the usual method of receiving E-Mail is through the @{"POP" link "Glossary"} E-Mail retrieval protocol. Mail is actually received and stored on the Internet Service Provider's E-Mail server machine, where you can retrieve it using a small program designed for this purpose. Voodoo has been tested with, and in fact used by the author with the AmiPOP utility by Scott Ellis. This program will, between intervals of a couple of minutes, connect to the mail server and check for new mail. When new E-Mail has been received, AmiPOP will download it to a file called the @{"spool file" link "Glossary"}, where it will be accessible by Voodoo. Setting up AmiPOP is fairly simple. It is configured with a set of tooltypes or command line arguments, specifying the name of the mail server machine to connect to, your account name and password on that machine, and the directory where the spool file should be written. The spool file AmiPOP creates will be named after the account name. To find out the address of your POP server, ask your local adminstrators. AmiPOP should be started at the same time with the TCP/IP stack. For a normal dial-up setup, this would mean that you can start it manually after the connection has been established, or by adding a line to the "startnet" script by which the TCP/IP stack itself starts. On some configurations, AmiPOP could be started during the system boot by putting it in the WBStartup drawer of the Workbench partition. @{b}ON PERMANENT CONNECTIONS@{ub} On a @{"permanently" link "Glossary"} connected system, there is another option besides using @{"POP" link "Glossary"} E-Mail retrieval. You could run a @{"SMTP" link "Glossary"} "daemon" on your own system, thus removing the middle step of a POP E-Mail server. Because setting up a E-Mail daemon is somewhat more complex, you should refer to the documentation of the program in question to see how it should be installed. Voodoo has been tested with SMTPd from the InetUtils package, written by Michael B. Smith. I am told that the Demon Internet uses SMTP for mail delivery even on dial-up accounts. Thus, Demon users should consider themselves "permanently connected" while reading these instructions. @{b}SENDING MAIL@{ub} @{b}ON DIAL-UP CONNECTIONS@{ub} Sending E-Mail is accomplished using a "mail delivery agent", a program that takes a file consisting of a single E-Mail message, and delivering it either to the receiver machine prompted by the To: and Cc: headers of the message, or to a E-Mail server in the middle that will take care of sending the message forward. Voodoo has been tested with SMTPpost from the InetUtils package. Installing SMTPpost involves making a configuration file or a set of environment variables describing the system, plus where and how mail should be delivered. See @{"installing SMTPpost" link "SMTPpost"} for hints on installing the program. @{b}ON PERMANENT CONNECTIONS@{ub} The method of E-Mail delivery on a permanent Internet connection is very similar to the dial-up connection. However, the use of a E-Mail daemon can remove the overhead of actual E-Mail delivery from the user invoked "sendmail" program to the daemon background process, thus making the appearance of E-Mail delivery faster. In addition, in some problem situations mail delivery can take a very long time, which makes it better to offload this task to the daemon. Again, SMTPd from the InetUtils package has been tested with Voodoo and found a satisfactory solution. @endnode @node "SMTPpost" "Installing INetUtils SMTPpost" @{b}BASIC SMTPPOST INSTALLATION@{ub} Many people have had problems installing the SMTPpost mail delivery agent. This document attempts to clarify some points of the procedure. If you already have SMTPpost installed, you can skip this. You should also read the INetUtils documentation for more information on the subject, this is just a introduction and is not intended to replace the official documentation. First of all, the package this document deal with is the INetUtils 1.4 release, available on Aminet as: IU-14-as225.lha comm/net 387K+AS225r2 SMTP/NNTP utilities v1.4 INetUtils IU-14-amitcp.lha comm/tcp 392K+AmiTCP SMTP/NNTP utilities v1.4 INetUtils The only program in this package essential to Voodoo is the SMTPpost, although using the SMTPd mail daemon can be useful under certain circumstances also. Where ever you place the SMTPpost program, use the fully qualified path to it when configuring Voodoo. For example, you could use "INET:c/SMTPpost <%s >NIL:", if you placed SMTPpost in the INET:c directory. SMTPpost is configured with a set of environment variables or keywords in a configuration file. I will explain the essential keywords below. These can be set either with "SetEnv ", or by placing them, one per line, into the config file UULib:Config or S:UUConfig, or INET:Config for I-Net 225 users. If you choose to use environment variables, remember that to retain the values after a reboot, you have to copy them from ENV: to ENVARC:. @{b}SMTPPOST KEYWORDS@{ub} @{b}HOSTNAME@{ub} @{lindent 20}The fully qualified domain name of your machine. For example, `neppari.cs.hut.fi'.@{lindent 0} @{b}NODENAME@{ub} @{lindent 20}The name of your machine. For example, `neppari'.@{lindent 0} @{b}USER@{ub} @{lindent 20}Your user name (login account name).@{lindent 0} @{b}SMTPSMARTERHOST@{ub} @{lindent 20}The mail server of your Internet provider. Ask your provider for this address. It could be the same as your POP host address.@{lindent 0} @{b}SMTPMAILDIR@{ub} @{lindent 20}The directory where local mail is delivered. Each user has a file in this directory. One possible value for this would be `MAIL:local'.@{lindent 0} @{b}SMTPSPOOLDIR@{ub} @{lindent 20}The directory where mail that could not be immediately delivered is spooled to. Note that unless you are running SMTPd also, mail placed in this directory will never get out of your system. A possible value is `MAIL:spool'.@{lindent 0} @{b}LOGFILE@{ub} @{lindent 20}The file to which delivered mails are logged to. A possible value is `MAIL:logfile'. Use this option if you are encountering problems with SMTPpost, since the log file will contain more verbose diagnostics.@{lindent 0} @{b}SMTPROUTE@{ub} @{lindent 20}While this can be left to the default value, a possible setting for the generic system is `SmarterHost'. This is likely to avoid some possible delivery problems that might happen with the default setting, and shorten the delay to get the message sent onwards.@{lindent 0} @endnode @node "Offline" "Using Voodoo as an offline mailer" @{b}USING VOODOO WHEN OFFLINE@{ub} Since Voodoo does not use the TCP/IP stack on itself, the only requirement for offline use is that the mail delivery agent can be configured to, instead of immediately trying to deliver the message, queue it in a spool directory and deliver later, when connected. This is possible to achieve in many ways. Possibly the simplest, yet most effective way is using a combination of SMTPpost and SMTPd. The recommended configuration of this InetUtils pair is to set SMTPd to start in your network startup script, and to make SMTPpost always queue the messages to SMTPd spool directory. The latter can be achieved by adding the InetUtils configuration variable `SMTPALWAYSQUEUE' with a value of `YES', or by adding a the `-Q' option to the SMTPpost command line in Voodoo settings. Note that this will mean that messages won't be sent immediately even when online. Instead, SMTPd will try sending them after a small delay, by default four minutes, and then retry every two minutes until the delivery succeeds. This delay can be configured with the `SMTPDELAY' variable, the default of which is 120 seconds. Please see also the @{"Installing InetUtils SMTPpost" link "SMTPpost"} notes for further information about installing this software. There are other ways to achieve this offline capability. For example, both the Amiga PutMail and just SMTPpost (without using SMTPd) have been used as offline delivery programs with Voodoo, by assisting them with script files. Some of these script files are included in the Voodoo distribution, in the `Rexx' and `S' subdirectories. More information about these scripts is in the scripts themselves. If you plan to use PutMail with Voodoo, please note that it does not support Cc and Bcc headers, thus delivering messages only to the person whose address is on the To line. This is NOT a Voodoo bug, but missing functionality in PutMail. @endnode @node "Starting" "Starting up Voodoo" @{b}STARTING VOODOO@{ub} Starting up Voodoo is done by simply double clicking the Voodoo icon. When Voodoo is first started, you will have to configure it. The command line options or tooltypes Voodoo accepts are as follows: @{b}FOLDER@{ub} @{lindent 20}Name of the folder to open. Defaults to primary folder.@{lindent 0} @{b}PUBSCREEN@{ub} @{lindent 20}Name of the public screen to use. Defaults to the default public screen (usually Workbench).@{lindent 0} @{b}SETTINGS@{ub} @{lindent 20}The settings file to load. Defaults to Voodoo.prefs in HOME:, PROGDIR:, or ENVARC:, in that order.@{lindent 0} @{b}PORTNAME@{ub} @{lindent 20}The name of the ARexx port to use. If this port already exists, Voodoo will send a message to it instead of starting again.@{lindent 0} @{b}MAIL@{ub} @{lindent 20}This switch will make Voodoo start a message editor instead of opening a folder. It can be used to for instance send mail from a Web browser.@{lindent 0} @{b}TO, CC, SUBJECT@{ub} @{lindent 20}With the MAIL option, these three keywords specify those headers for the message.@{lindent 0} @{b}SCREENTOFRONT@{ub} @{lindent 20}Pop Voodoo screen to front on startup.@{lindent 0} @{b}ADDRESS@{ub} @{lindent 20}Override E-Mail address from preferences.@{lindent 0} @{b}REALNAME@{ub} @{lindent 20}Override real name from preferences.@{lindent 0} @{b}SPOOLFILE@{ub} @{lindent 20}Override spool file from preferences.@{lindent 0} @{b}REPLYTO@{ub} @{lindent 20}Override Reply-To address from preferences.@{lindent 0} When starting up, Voodoo will automatically open the folder defined as the primary (INBOX) folder. All new E-Mail will by default be put in this folder. It will also attempt to get new E-Mail from the configured spool file. It will open the main interface consisting of a so-called message window, which consists of the list of messages in the folder, and the currently displayed message. This interface is described in more detail in message window. If you are a former user of AmigaElm, see @{"importing mailboxes" link "Importing"} for instructions on how to import your old folders to Voodoo. @endnode @node "Importing" "Importing mailboxes from other readers" @{b}IMPORTING MESSAGES TO VOODOO@{ub} If you are an old E-Mail user, you will probably have mail folders from another mail reader. Most likely these folders are in the UNIX mailbox format, concatenated into a single file. Voodoo uses another kind of scheme of storing messages, storing each message in a separate file in a single directory. This approach was chosen for performance reasons, since deleting files is significantly faster than removing messages from the middle of a large file. The single file folder format is understood by Voodoo, because it is the format of the incoming @{"spool file" link "Glossary"}. The registered version, Serious Voodoo, has a menu command (@{"Import mail" link "MenuImport"}) for importing this kind of a spool file into any folder. This version will also understand a mailbox file of this type being dropped on the message window. Importing messages with the demo version of Voodoo is done by juggling the configuration: · @{lindent 3}Create a new folder (@{"Creating folders" link "FolderPrefs"}).@{lindent 0} · @{lindent 3}Set this folder as the primary folder. (@{"Folder settings" link "PageFolderPrefs"}).@{lindent 0} · @{lindent 3}Make a copy of the folder you wish to import.@{lindent 0} · @{lindent 3}Set the @{"spool file" link "PageFolderPrefs"} to this copy.@{lindent 0} · @{lindent 3}Exit preferences, open the new folder, and choose @{"Get new mail" link "MenuGetMail"}.@{lindent 0} @endnode @node "Configuration" "Configuring Voodoo" @next "MessageWindow" @{b}CONFIGURING VOODOO@{ub} Many attributes of Voodoo operation are configurable to the user's preference. These configuration options are described in detail in the documentation of the configuration windows in question: @{" Global settings " link "GlobalPrefs"} The configuration parameters of Voodoo @{" Addressbook " link "Addressbook"} The built in addressbook @{" Folder settings " link "FolderPrefs"} The folders for varying types of E-Mail The global settings will be saved in an IFF format preference file named Voodoo.prefs, by default in the directory where Voodoo itself resides. When started, Voodoo will look for this file first in the directory it resides in, and then in ENVARC:. If not found in either location, it will start up with the default settings and prompt you to configure it. The addressbook and folder settings will be saved in the ASCII files Voodoo.aliases and Voodoo.folders, respectively, in the same directory. @endnode @node "GlobalPrefs" "Global Voodoo Configuration" @toc "Configuration" @next "Addressbook" @{b}CONFIGURABLE PARAMETERS@{ub} The configuration window of Voodoo is divided into pages, according grouped by the type of the parameters in question. @{" User " link "PageUserPrefs"} Personal information @{" Folder " link "PageFolderPrefs"} Important folder configuration @{" Display " link "PageDisplayPrefs"} Settings affecting the display look @{" Fonts " link "PageFontsPrefs"} Fonts used in Voodoo @{" Program " link "PageProgramPrefs"} External programs and related parameters These settings will not take effect before you press the OK button. If you change any of the settings that affect the GUI of Voodoo, specifically most of the parameters on the Display page, Voodoo will recreate its interface after you close the configuration window by pressing OK. Closing the window by clicking on the close gadget will cancel changes, as if you clicked on the Cancel button. @endnode @node "PageUserPrefs" "Personal user information settings" @toc "GlobalPrefs" @{b}USER SETTINGS@{ub} This page contains the information that Voodoo has to know about you to make it possible for you send E-Mail. @{b}E-Mail address@{ub} - @{lindent 24}Your complete E-Mail address. This will be used when sending messages, so make sure it is correct, or replying to you will fail miserably. A correct setting varies between systems, but it is generally something of the form username@domain.com or Firstname.Lastname@domain.edu. Generally it should be username@hostname.domain.com only if your own machine is permanently connected and you are running an SMTP daemon.@{lindent 0} @{b}Reply-To@{ub} - @{lindent 24}If you wish, you can add some other address to messages using the Reply-To field by putting that address here.@{lindent 0} @{b}Real name@{ub} - @{lindent 24}Your real name, again put in each outgoing message. The From header Voodoo uses is of the type "Real Name ".@{lindent 0} @{b}Organization@{ub} - @{lindent 24}The contents of the Organization header line. If left blank, no Organization header is inserted in the messages.@{lindent 0} @{b}Quote prefix@{ub} - @{lindent 24}The text that should be prepended before a line of quoted text in replies. Leaving this to the default of "> " is advised.@{lindent 0} @{b}Quote attribution@{ub} - @{lindent 24}The text inserted before a quote when replying to messages. Some escape sequences in the string are replaced with information about the message being replied to: %0 From %1 Subject %2 To %3 Date %4 Message-ID %5 From (name only) %6 From (address only) \\n new line @{lindent 0} @{b}Signature file@{ub} - @{lindent 24}The file that has the signature you wish to append to messages. By courtesy, it is advised that the signature be less than 4 lines and a maximum 76 columns wide. However, Voodoo will not restrict the size of the signature. Signatures are customarily separated from message body by a line with two hyphenation characters and a space ("-- ") on them. If this line is not found in the signature, Voodoo will add one automatically.@{lindent 0} @endnode @node "PageFolderPrefs" "Folder settings of primary importance" @toc "GlobalPrefs" @{b}FOLDER SETTINGS@{ub} This page has the parameters important for Voodoo to know how to handle new mail. @{b}Folder directory@{ub} - @{lindent 24}The directory where folders will be placed be default. This is automatically filled in with the directory of the initial folder. A folder is not required to reside in this directory.@{lindent 0} @{b}Primary folder@{ub} - @{lindent 24}New mail that does not match the attributes of mail specifically meant for other folders will be placed here. In the default configuration, this is the only existing folder.@{lindent 0} @{b}Sent mail folder@{ub} - @{lindent 24}If this is set, copies of all messages you send will be placed in this folder.@{lindent 0} @{b}Default save folder@{ub} - @{lindent 24}The name of the default folder to save messages to when moving them out of the primary folder.@{lindent 0} @{b}Move read messages to save folder on exit@{ub} - @{lindent 24}If this is set, read messages will be moved to the folder defined above when closing the primary folder.@{lindent 0} @{b}Configure folders@{ub} - @{lindent 24}This button will open the separate folder config window where you can add new folders.@{lindent 0} @{b}Spool file@{ub} - @{lindent 24}The @{"spool file" link "Glossary"} in which new mail arrives. When getting new mail, Voodoo will read the contents of this file and move the messages in it to the appropriate folders (by default into the primary folder), emptying the spool file.@{lindent 0} @{b}Expunge deleted messages on close@{ub} - @{lindent 24}If checked, Voodoo will expunge all messages that are marked as deleted when closing a folder. This means that the message is deleted from disk and is lost.@{lindent 0} @{b}Skip deleted messages@{ub} - @{lindent 24}If set, the "next" and "previous" functions will skip over messages with the deleted flag set.@{lindent 0} @{b}Auto save delay@{ub} - @{lindent 24}Seconds of inactivity before automatic save of the folder status. If 0, automatic saving is disabled. You should never disable this setting.@{lindent 0} @endnode @node "PageDisplayPrefs" "Settings affecting the Voodoo GUI" @toc "GlobalPrefs" @{b}DISPLAY SETTINGS@{ub} This page contains the configuration parameters that directly affect the user interface of Voodoo. See also the @{"Fonts page" link "PageFontsPrefs"} for the setting of fonts used within Voodoo. @{b}Public screen@{ub} - @{lindent 24}The screen on which Voodoo should open its interface. If left blank, the interface will open on the current default public screen, by default the Workbench screen. This setting can be overridden with the command line argument or tooltype PUBSCREEN. See the @{"FAQ" link "FAQ"} for the reason why Voodoo does not create public screens itself.@{lindent 0} @{b}Backfill pattern@{ub} - @{lindent 24}The picture you wish to use as a backdrop texture in all windows. This picture is loaded through the datatypes, and can thus be of any format supported by your installed datatypes.@{lindent 0} @{b}Date format in index@{ub} - @{lindent 24}The format of the date used in folder index. This string is subject to Locale date substitution formatting. For example, %d will be replaced with the day, %m with the month, and %y with the year of the message. The maximum length of the formatted string is 12 characters.@{lindent 0} @{b}Editor cursor blink rate@{ub} - @{lindent 24}The rate of cursor blinks per second in the built-in message editor. If set to 0, the cursor will not blink at all.@{lindent 0} @{b}Number of lines in header list@{ub} - @{lindent 24}The number of headers displayed at once in the message headers listview. While this listview does not have a scroll bar, it is drag-scrollable and responds to the cursor keys while control is held down.@{lindent 0} @{b}Show icon text@{ub} - @{lindent 24}If set, Voodoo's speedbars will display a label under each of the button icons.@{lindent 0} @{b}Clone WB colors@{ub} - @{lindent 24}Without this option, Voodoo will allocate a set of pens that match the default MagicWB palette to use with the speedbar icons. If you use a palette different from the MagicWB palette, but designed to look good with MagicWB color scheme icons, you may wish to use this option to make Voodoo use that palette as well.@{lindent 0} @endnode @node "PageFontsPrefs" "Fonts used in Voodoo" @toc "GlobalPrefs" @{b}FONTS SETTINGS@{ub} Voodoo uses several fonts for different parts of the interface. All of these fonts may be configured here. Without a configuration file available, Voodoo will attempt to guess a suitable font from the system settings. @{b}Interface font@{ub} - @{lindent 24}The font used by the Voodoo GUI when no other font specifically matches the purpose.@{lindent 0} @{b}Message font@{ub } - @{lindent 24}The font used by the message display, unless the message data explicitly asks for some other font, as may be the case with some MIME messages.@{lindent 0} @{b}Index font@{ub} - @{lindent 24}The font used by the folder index listview on top of the message window.@{lindent 0} @{b}Editor font@{ub} - @{lindent 24}The font used in the built-in editor of Voodoo.@{lindent 0} @{b}Icon font@{ub} - @{lindent 24}The font used for icon labels in the speedbars.@{lindent 0} @endnode @node "PageProgramPrefs" "External programs and related settings" @toc "GlobalPrefs" @{b}PROGRAM SETTINGS@{ub} This page contains the settings necessary for support of external programs. In addition, some other settings not of primary internal importance are here. @{b}Mailer@{ub} - @{lindent 24}The command line used when sending a message. %s will be replaced by the name of the temporary file, and is required. Serious Voodoo will run this command asynchronously in the background, while the demo version will stop Voodoo for the duration of delivery. Do not use "run" in this command, as that would break the order of events during the delivery and make Voodoo clean up temporary files too early.@{lindent 0} @{b}PGP path@{ub} - @{lindent 24}The command line for executing Pretty Good Privacy. Voodoo will append the options necessary for each function to the end of this line. Since Voodoo saves sent messages encrypted, if you wish to be able to read them, add the +encrypttoself option to this command line. If you wish to not use PGP, leave this option empty. Voodoo won't do anything when it finds a PGP/MIME message if you do that.@{lindent 0} @{b}External editor@{ub} - @{lindent 24}The command line with which the external editor should be started, if you choose to use one instead of the built-in editor. %s will be replaced by the name of the temporary file that holds the message text, and is required on the line. The editor will be run asynchronously to Voodoo, so no "Run" is necessary. The editor has to support sending ARexx commands back to Voodoo to control the sending of the message. If the checkbox is left unchecked, Voodoo will use its built-in editor. See the ARexx command @{"SEND" link "ARexxSEND"} for information on how to send a message from an external editor.@{lindent 0} @{b}POP Rexx port@{ub} - @{lindent 24}If your POP utility has an ARexx port that accepts a 'GETMAIL' command, put that port name here. Voodoo will request the program to get new mail when you use the 'Get new mail' menu option.@{lindent 0} @{b}Visible headers@{ub} - @{lindent 24}A ; delimited list of AmigaDOS patterns that match the headers displayed in the message window header listview. The headers are shown in the order they appear on this list. For example, you could use "From;Subject;Date;To;Cc;Reply-To;~(Received)".@{lindent 0} @{b}Wrap lines at column@{ub} - @{lindent 24}If set to higher than 0 (actually 20), plaintext messages will be word wrapped at that column before sending.@{lindent 0} @{b}Use Quoted-Printable Encoding@{ub} - @{lindent 24}Because the original SMTP protocol defines E-Mail to consist of only 7 bit ASCII text, and common implementations require relatively short lines, the transfer of certain kinds of text can not be guaranteed if attempted to transfer as-is. Because of this reason, the MIME extensions define an encoding that changes 8 bit characters into a 7 bit form, thus letting them be transferred over E-Mail. However, this encoding makes the messages look somewhat hard to read if the receiver's E-Mail software can not decode Quoted-Printable encoding. For this reason, the use of this encoding is optional.@{lindent 0} @endnode @node "Addressbook" "Built-in addressbook" @toc "Configuration" @{b}THE VOODOO ADDRESSBOOK@{ub} Voodoo includes a simple addressbook that lets you use a nick name instead of the E-Mail address of people you send or receive E-Mail with. When sending messages, you may type the nick name of a person, and Voodoo will automatically expand it to the full E-Mail address. Similarly, when receiving E-Mail, Voodoo will show in the message index the nick name of the person who sent the message instead of the E-Mail address. Configuring the addressbook is very simple. Just click on the button labeled New, type the nick name in the Name string gadget, and the E-Mail address in the gadget labeled for it, and the person is added into the addressbook. If you wish to modify an entry in the addressbook, simply select that entry from the listview and edit it in the string gadgets. Similarly, if you wish to delete an entry, select it and press the button labeled Del. Changes in the addressbook are immediate and will be saved to disk when you close the window. In Serious Voodoo, the address book will also contain two toggle settings to enable signing and encrypting messages to a certain user. If you wish to enable either of these functions, check the option. Voodoo will then automatically attach a PGP signature and/or encrypt the message using PGP when you send E-Mail to that person. For encryption to work, you will naturally need to have the person's PGP public key on your PGP key ring. Voodoo will refer to the key using the address configured in the address book. @endnode @node "FolderPrefs" "Folder configuration" @toc "Configuration" @{b}VOODOO FOLDER CONFIGURATION@{ub} Voodoo can group messages in separate folders according to the sender or content of the message. You may also move messages from one folder to another by hand. To Voodoo, a folder is a directory with messages in separate files. This is an important distinction from many other E-Mail programs, which keep each folder in a single file. While this means that the number of files is smaller, the clear advantage of keeping each message in a separate file is that maintenance of very large folders will still be fast. Adding and maintaining folders is done in this window. If you wish to add a new folder, click on the button labeled New and select the directory for it. Do not have two folders using the same directory, and do not use the same directory for anything else. There should be nothing else in the directory besides the messages Voodoo will save in it. In Serious Voodoo, you can set a folder-private spool file for every folder separately. This spool file will be scanned when getting new mail in that folder. This will allow for example reading the mail from several accounts easily within Voodoo while still keeping every account separate. It also makes it possible to use a mail processing utility to preprocess incoming mail and place it to folders as it is received. If you wish to change a folder's name or directory, select it from the listview. If you wish to delete a folder, click on the button labeled Del. While this make Voodoo forget the folder's existence, the directory and the messages will not be deleted. This you will have to do manually. If you wish to enter the folder back in the Voodoo folder list, the old messages will still be available, if you don't delete the directory. The changes in the folder list are immediately visible elsewhere in Voodoo, and will be saved to disk when you close the window. You may change the space ratio allocated to the folder index and the message display in the currently selected folder by moving the slider. The folder's window will automatically update to reflect the change. The other elements of this window display statistics about the currently selected folder. See also @{"Global Prefs: Folders" link "PageFolderPrefs"} for more configuration options concerning folders in Voodoo. @endnode @node "MessageWindow" "The message window interface" @prev "Configuration" @next "MainMenus" @{b}THE VOODOO INTERFACE@{ub} The message window is Voodoo's primary user interface. Within this window, you can read messages and arrange them into folders. This interface consists of the the following main parts: @{b}MESSAGE LIST@{ub} The listview at the top lists the messages in the folder. It is divided into four columns. The first column displays the status of the message using small icons, and the other columns show the sender, date and subject of the message, respectively. @{b}SPEEDBAR@{ub} The speedbar below the message listview has buttons for the most often used functions and for selecting each of the parts of a multipart message. The functions on the speedbar are, in order: @{b}Quit@{ub} - @{lindent 24}Close all folders and quit Voodoo. If an internal editor window or any configuration window is open, a verification requester will pop up first.@{lindent 0} @{b}Iconify@{ub} - @{lindent 24}Close all open Voodoo windows and put an icon on the WB.@{lindent 0} @{b}Open folder@{ub} - @{lindent 24}Open another folder. A requester listing all the folders will pop up.@{lindent 0} @{b}Previous message@{ub} - @{lindent 24}Select the message before the currently selected one.@{lindent 0} @{b}Next message@{ub} - @{lindent 24}Select the message next to the currently selected one.@{lindent 0} @{b}New mail@{ub} - @{lindent 24}Start composing a new message. Depending on your configuration, the internal editor or an external editor of your choice will open.@{lindent 0} @{b}Reply@{ub} - @{lindent 24}Reply to the currently selected message, quoting the message text.@{lindent 0} @{b}Delete@{ub} - @{lindent 24}Mark the currently selected message deleted.@{lindent 0} The rest of the speedbar lists the parts of the currently selected message. For each part, there is an icon representing the content of the message. If all the buttons on the speedbar do not fit in the window, you can scroll the speedbar by the following method: · @{lindent 3}Hold down either shift key.@{lindent 0} · @{lindent 3}With the pointer over the speedbar, press and hold the left mouse button.@{lindent 0} · @{lindent 3}To scroll right, drag mouse to the right. To scroll left, drag to left.@{lindent 0} @{b}ENCRYPTION STATUS@{ub} In the rightmost edge of the speedbar may be two icons: a quill and a padlock. These signify that the message was signed and/or encrypted. @{b}HEADER VIEW@{ub} This listview displays the most important headers of a message. While there is no scrollbar, you can scroll it by pressing down the left mouse button within the listview and moving the mouse out of the listview area. The headers listed here are, in order: From, Subject, Date, To, Cc, Reply-To, Content-Type, Sender, and Message-Id. @{b}MESSAGE VIEW@{ub} This main area of the window will display the message itself through the AmigaOS datatype subsystem. Thus, it can be text, graphics, or even an icon for a sound sample. Besides the scroll bars in window borders and the keyboard control, most datatypes support some kind of scrolling by mouse. Try pressing down the left mouse button over the message view and dragging to any direction. @{b}KEYBOARD CONTROL@{ub} If the @{"Expert Keyboard" link "MenuExpertKeys"} mode is turned on, all @{"menu" link "MainMenus"} shortcuts in the message window are available even without pressing down the right Amiga key. In addition, the currently selected message can be scrolled around using the arrow keys, space and backspace. @endnode @node "ChooseFolder" "Choosing a folder" @{b}CHOOSING A FOLDER@{ub} With this window you can choose a folder to which the selected action should be performed. Two examples of the use of this window are opening a folder and saving a message into a folder. You can cancel the action by closing the window from the close gadget or by pressing the ESC key. Selecting a folder is done by clicking on the name or by choosing the line with cursor keys and pressing ENTER. @endnode @node "MainMenus" "Voodoo menus description" @next "ComposeWindow" @{b}VOODOO MENUS@{ub} All functions of Voodoo are available through the pull down menus. In the @{"message window" link "MessageWindow"}, menu shortcuts are usable even without holding down the right Amiga key. Project @{" Open folder... " link "MenuOpenFolder"} Open another folder @{" Close folder " link "MenuCloseFolder"} Close this folder @{" Expunge deleted " link "MenuExpunge"} Expunge messages marked as deleted @{" Save folder " link "MenuSaveFolder"} Save folder without expunging messages @{" Get new mail " link "MenuGetMail"} Get new mail from the spool file @{" Import mail... " link "MenuImport"} Import mail to this folder @{" Sort " link "MenuSort"} Sort messages in folder @{" By number " link "MenuSort"} In physical order @{" By date " link "MenuSort"} By the Date header @{" By author " link "MenuSort"} By the From header @{" By subject " link "MenuSort"} By the Subject header @{" Print message " link "MenuPrint"} Print current message @{" About " link "Introduction"} Open the program information window @{" Send a bugreport " link "MenuBugreport"} Send a bug report to the author @{" Iconify " link "MenuIconify"} Close all open windows and iconify @{" Quit " link "MenuQuit"} Close all folders and quit Message @{" Next " link "MenuNextMessage"} Select next message in folder @{" Previous " link "MenuPreviousMessage"} Select previous message in folder @{" Copy " link "MenuCopy"} Copy message to clipboard @{" Send mail... " link "MenuSend"} Begin a new message @{" Reply... " link "MenuReply"} Reply to the current message @{" Followup... " link "MenuFollowup"} Followup to the current message @{" Forward... " link "MenuForward"} Forward this message to someone else @{" Remember Address " link "MenuRememberAddress"} File this address into addressbook @{" Save in file... " link "MenuSaveInFile"} Save this message into a file @{" Save in folder... " link "MenuSaveInFolder"} Save this message in another folder @{" UUdecode " link "MenuUUdecode"} Run the UUdecoder on this message @{" Delete " link "MenuDelete"} Mark this message deleted @{" Undelete " link "MenuUndelete"} Clear deleted status on this message @{" Mark unread " link "MenuMarkUnread"} Mark this message unread @{" Rescan headers " link "MenuRescan"} Rescan headers of the message Settings @{" Global... " link "MenuGlobalSettings"} Open main preferences window @{" Addressbook... " link "MenuAddressbook"} Open addressbook editor @{" Folder... " link "MenuFolderSettings"} Open folder list editor @{" Display headers " link "MenuDisplayHeaders"} Toggle display of major headers in message @{" Smart word wrapping " link "MenuSmartWrap"} Toggle smart message word wrapping @{" Expert keyboard " link "MenuExpertKeys"} Toggle expert keyboard mode @{" Load settings... " link "MenuLoadSettings"} Load a settings file @{" Save settings " link "MenuSaveSettings"} Save current settings @{" Save settings as... " link "MenuSaveSettings"} Save current settings with a new name @{b}EDITOR MENUS@{ub} The message editor window has its own menus. Editing @{" Undo " link "MenuEditing"} Undo last change @{" Cut " link "MenuEditing"} Cut marked block @{" Copy " link "MenuEditing"} Copy marked block @{" Paste " link "MenuEditing"} Paste into cursor position @{" Erase " link "MenuEditing"} Erase marked block @{" Attach file... " link "MenuAttach"} Attach a file into message @{" Delete... " link "MenuAttach"} Remove attachment @{" Load text... " link "MenuLoadSave"} Load text to editor @{" Save text... " link "MenuLoadSave"} Save text from editor @{" Send message " link "MenuSendComposed"} Send message and close editor @{" Cancel... " link "MenuCancelCompose"} Cancel editing and destroy message @endnode @node "MenuOpenFolder" "Voodoo menus" @toc "MainMenus" @{b}OPEN FOLDER@{ub} This command opens the @{"folder selection window" link "ChooseFolder"}. After selecting a folder in that window, it will be opened, or if it already is open, brought to front. @endnode @node "MenuCloseFolder" "Voodoo menus" @toc "MainMenus" @{b}CLOSE FOLDER@{ub} The current folder will be closed. Depending on the @{"Expunge deleted messages" link "PageFolderPrefs"}, messages marked for deletion may automatically be expunged from the folder. @endnode @node "MenuExpunge" "Voodoo menus" @toc "MainMenus" @{b}EXPUNGE@{ub} The messages in the current folder that are marked for deletion will be expunged from the folder and deleted from disk. @endnode @node "MenuSaveFolder" "Voodoo menus" @toc "MainMenus" @{b}SAVE FOLDER@{ub} The status of the current folder will be saved to disk, messages marked for deletion will NOT be expunged. @endnode @node "MenuGetMail" "Voodoo menus" @toc "MainMenus" @{b}GET NEW MAIL@{ub} This command will scan the Voodoo incoming messages spool file for new messages and move them to Voodoo folders. In the demo version all mail is placed in the primary folder. In Serious Voodoo, also the private spool file of the selected folder is scanned. Before looking at the spool file, Voodoo will send an ARexx command to the POP utility (if any) to download all new mail. @endnode @node "MenuImport" "Voodoo menus" @toc "MainMenus" @{b}IMPORT MAIL@{ub} This function only available in the Serious Voodoo requests for a spool file or UNIX mailbox format folder to import to the current folder. Unlike a normal spool file, This file will not be truncated after the messages have been copied to the folder. @endnode @node "MenuSort" "Voodoo menus" @toc "MainMenus" @{b}SORT MESSAGES@{ub} Voodoo can sort messages in a folder based on four keys. The keys are: Physical order @{lindent 20}The order in which the messages were originally saved in the folder, the default order.@{lindent 0} By date @{lindent 20}The age of the messages, as specified by the message Date header.@{lindent 0} By author @{lindent 20}The name of the author, from the From header.@{lindent 0} By subject @{lindent 20}The Subject header.@{lindent 0} @endnode @node "MenuPrint" "Voodoo menus" @toc "MainMenus" @{b}PRINT MESSAGE@{ub} Print the currently selected message. @endnode @node "MenuBugreport" "Voodoo menus" @toc "MainMenus" @{b}SEND A BUG REPORT@{ub} This menu item will open a message composition window with a preformatted bug report form for you to fill in. By using this function to report problems, Voodoo will automatically add relevant information about your system to the message. @endnode @node "MenuIconify" "Voodoo menus" @toc "MainMenus" @{b}ICONIFY@{ub} The command will close Voodoo windows and put up an icon on the Workbench. Doubleclicking on the icon will reopen the windows in the positions they were before iconifying. Note that if no public screen is specified, that is Voodoo is told to use the default pubscreen, the windows may open on different screen. @endnode @node "MenuQuit" "Voodoo menus" @toc "MainMenus" @{b}QUIT@{ub} Close all folders, possibly expunging messages marked as deleted, and quit Voodoo. If any configuration window or a message editor window is open, you will be asked for confirmation before taking this action. @endnode @node "MenuNextMessage" "Voodoo menus" @toc "MainMenus" @{b}NEXT MESSAGE@{ub} Select the next message in the folder, or the first message if none is selected. If @{"Skip deleted messages" link "PageFolderPrefs"} is selected, messages that are marked for deletion are skipped. @endnode @node "MenuPreviousMessage" "Voodoo menus" @toc "MainMenus" @{b}PREVIOUS MESSAGE@{ub} Select the previous message in the folder, or the last message if none is selected. If @{"Skip deleted messages" link "PageFolderPrefs"} is selected, messages that are marked for deletion are skipped. @endnode @node "MenuCopy" "Voodoo menus" @toc "MainMenus" @{b}COPY@{ub} Copy the text or other data currently shown into the clipboard. Because of datatype restrictions, it is not possible to select the part that gets copied. @endnode @node "MenuSend" "Voodoo menus" @toc "MainMenus" @{b}SEND MESSAGE@{ub} Bring up a message editor for sending a new message. @endnode @node "MenuReply" "Voodoo menus" @toc "MainMenus" @{b}REPLY@{ub} Bring up a message editor for replying to the currently selected message. The message recipient is preset according to the From or Reply-To header, and the message text is quoted. @endnode @node "MenuFollowup" "Voodoo menus" @toc "MainMenus" @{b}FOLLOWUP@{ub} Bring up a message editor for sending a followup to the currently selected message. The message recipients are preset according to the From, Reply-To and Cc headers, and the message text is quoted. @endnode @node "MenuForward" "Voodoo menus" @toc "MainMenus" @{b}FORWARD@{ub} Bring up a message editor for forwarding the currently selected message to a third party. The message is inserted to the editor. @endnode @node "MenuRememberAddress" "Voodoo menus" @toc "MainMenus" @{b}REMEMBER ADDRESS@{ub} Put the address of the sender of current message into the addressbook. @endnode @node "MenuSaveInFile" "Voodoo menus" @toc "MainMenus" @{b}SAVE IN FILE@{ub} Save the current message to a file. There are two modes for saving messages: Whole message @{lindent 20}The complete message, including headers, with multipart messages retaining encoding.@{lindent 0} Current part @{lindent 20}The currently selected part. If @{"Display headers" link "MenuDisplayHeaders"} is set, the headers matching the @{"pattern" link "PageProgramPrefs"} are included in a text part (as show in the window), binary parts are saved as-is.@{lindent 0} @endnode @node "MenuSaveInFolder" "Voodoo menus" @toc "MainMenus" @{b}SAVE IN FOLDER@{ub} Move the currently selected message into another folder. The @{"folder selection window" link "ChooseFolder"} will pop up, prompting for the folder to save into. The message will be marked as deleted in the current folder. @endnode @node "MenuAllParts" "Voodoo menus" @toc "MainMenus" @{b}SAVE ALL ATTACHMENTS@{ub} Save all attachments of the current message in to files. This is a shortcut for using @{"Save in file" link "MenuSaveInFile"} for all attachments in the message. Note that not all parts are necessarily considered attachments; only those with a file name in either Content-Disposition or Content-Type header will be saved. @endnode @node "MenuDelete" "Voodoo menus" @toc "MainMenus" @{b}MARK FOR DELETION@{ub} Mark the currently selected message as deleted. The message will not actually be expunged before you select the @{"expunge" link "MenuExpunge"} menu item or close the folder (in the latter case, only if @{"automatic expunge" link "PageFolderPrefs"} is turned on. This command will also select the next message. @endnode @node "MenuUndelete" "Voodoo menus" @toc "MainMenus" @{b}UNMARK FOR DELETION@{ub} Clear the deleted status from the currently selected message. See @{"delete" link "MenuDelete"}. This command will also select the next message. @endnode @node "MenuMarkUnread" "Voodoo menus" @toc "MainMenus" @{b}MARK UNREAD@{ub} Mark the message unread. This function is mostly useful to mark message in the primary folder so that they will not be moved on exit. @endnode @node "MenuRescan" "Voodoo menus" @toc "MainMenus" @{b}RESCAN HEADERS@{ub} Rescan the headers of the selected message. If for some reason the message list does not correctly reflect the headers of the message, this command can be used to make Voodoo re-read the headers for its folder index. @endnode @node "MenuUUdecode" "Voodoo menus" @toc "MainMenus" @{b}UUDECODE MESSAGE@{ub} In addition to displaying MIME messages internally, Voodoo can detect when a message contains an UUencoded file. When Voodoo finds such a file, you can decode it with this command. @endnode @node "MenuGlobalSettings" "Voodoo menus" @toc "MainMenus" @{b}GLOBAL SETTINGS@{ub} Bring up the @{"global settings" link "GlobalPrefs"} window. @endnode @node "MenuAddressBook" "Voodoo menus" @toc "MainMenus" @{b}ADDRESSBOOK@{ub} Bring up the @{"addressbook" link "AddressBook"} maintenance window. @endnode @node "MenuFolderSettings" "Voodoo menus" @toc "MainMenus" @{b}FOLDER SETTINGS@{ub} Bring up the @{"folder maintenance" link "FolderPrefs"} window. @endnode @node "MenuDisplayHeaders" "Voodoo menus" @toc "MainMenus" @{b}DISPLAY HEADERS@{ub} Toggle headers on and off in the main message view. If turned on, some headers (configured in @{"visible headers" link "PageProgramPrefs"}) will be shown in the message view if the selected message part is plain text. @endnode @node "MenuSmartWrap" "Voodoo menus" @toc "MainMenus" @{b}SMART WORD WRAPPING@{ub} Toggle smart word wrapping on and off in the main message view. If this setting is on, Voodoo will strip newlines inside paragraphs when selecting a plain text message for display, and instruct the text datatype to word wrap it according to window width. This option works best when using a proportional font in the message display. If you use a non-proportional font such as Topaz or Courier, you should probably leave this option off and use an 80 columns wide window. @endnode @node "MenuExpertKeys" "Voodoo menus" @toc "MainMenus" @{b}EXPERT KEYBOARD@{ub} By setting this mode, Voodoo will recognise the menu shortcut command keys without having to press the Right Amiga qualifier key. In addition, this expert mode distinguishes between shifted and non-shifted shortcuts, taking specific action for some of them. For example, the Reply command will quote the message being replied to, if you press it with either shift key held down. @endnode @node "MenuLoadSettings" "Voodoo menus" @toc "MainMenus" @{b}LOAD SETTINGS@{ub} Load a new settings file, including new folder configuration. @endnode @node "MenuSaveSettings" "Voodoo menus" @toc "MainMenus" @{b}SAVE SETTINGS@{ub} Save current configuration in a settings file. On startup, Voodoo searches for a settings file named Voodoo.prefs first in the program directory and then in ENVARC:. @endnode @node "MenuEditing" "Voodoo menus" @toc "MainMenus" @{b}EDITING FUNCTIONS@{ub} The message editor has the basic editing functions: Undo @{lindent 20}Paste back last major edit@{lindent 0} Cut @{lindent 20}Cut currently marked block to clipboard@{lindent 0} Copy @{lindent 20}Copy currently marked block to clipboard@{lindent 0} Paste @{lindent 20}Paste block from clipboard to current pointer position@{lindent 0} Erase @{lindent 20}Erase currently marked block@{lindent 0} @endnode @node "MenuAttach" "Voodoo menus" @toc "MainMenus" @{b}ATTACHING FILES@{ub} Voodoo can attach files to messages using the MIME extensions. These two functions are used to attach a file to the message, and to delete an attached file. Attach file... @{lindent 20}Bring up a file requester in which you can select the file you wish to attach.@{lindent 0} Delete... @{lindent 20}If you are viewing an attachment (by having selected it from the speedbar), this function will ask if you want to remove it from the message. If you are viewing the first text part, you will have the option of clearing the text.@{lindent 0} @endnode @node "MenuLoadSave" "Voodoo menus" @toc "MainMenus" @{b}LOAD/SAVE TEXT@{ub} These basic file operation functions let you save the text of an unfinished message to a file and load it back at later timer to continue the message. @endnode @node "MenuSendComposed" "Voodoo menus" @toc "MainMenus" @{b}SEND MESSAGE@{ub} Finish editing the message and send it to the recipient(s). @endnode @node "MenuCancelCompose" "Voodoo menus" @toc "MainMenus" @{b}CANCEL MESSAGE@{ub} Cancel the message, discarding any written text. @endnode @node "ComposeWindow" "The Voodoo built-in editor" @prev "MainMenus" @{b}THE BUILT-IN EDITOR@{ub} Voodoo's built-in editor is specifically designed to make it easy to compose E-Mail messages and attach external files to them. The elements of the editor interface are: @{b}SPEEDBAR@{ub} The speedbar at the top has, much like the @{"message window" link "MessageWindow"} speedbar, buttons for the common operations while editing messages. The functions are as follows: @{b}Delete message@{ub} - @{lindent 24}Cancel and destroy the message, or remove the currently viewed attachment.@{lindent 0} @{b}Attach file@{ub} - @{lindent 24}Attach a file to the message.@{lindent 0} @{b}Send message@{ub} - @{lindent 24}Send the message to the people listed in the To and Cc gadgets.@{lindent 0} The rest of the speedbar represent the parts of the message. Every message will have a plain text part in the beginning, but the parts following that can be of any type. When attaching a file, Voodoo will ask the AmigaOS Datatype subsystem what format the file is, and use a matching MIME Content-Type. If the file is a "binary" format, that is, not a readable text format, it will be base64 encoded to a 7 bit format so that it can be sent over E-Mail. This encoding is much like uuencode, but is a part of the MIME standard. If all the buttons on the speedbar do not fit in the window, you can scroll the speedbar by the following method: · @{lindent 3}Hold down either shift key.@{lindent 0} · @{lindent 3}With the pointer over the speedbar, press and hold the left mouse button.@{lindent 0} · @{lindent 3}To scroll right, drag mouse to the right. To scroll left, drag to left.@{lindent 0} @{b}ENCRYPTION STATUS@{ub} In Serious Voodoo, there are two small toggle buttons for enabling PGP signing and encryption to the right of the speedbar. By clicking on the upper one (which display a quill to reflect this), the message will be signed to authenticate its origin. The lower button, which will display a padlock when clicked on, will tell Voodoo to encrypt the message for the recipient(s). Please note that Voodoo has no simple (that is, quick) way of knowing beforehand whether the PGP keyring contained a public key for all the recipients of the message, and that PGP will not return an error if this is not the case. This means that if you try to encrypt a message for several people, and don't have the public key of some of them, the message will still be encrypted, and won't be readable by these people. @{b}HEADER GADGETS@{ub} These three gadgets represent the contents of the respective E-Mail headers. In the To gadget, type in the address or nick name of the person(s) you wish to send the message to. If you use a nick name, and the matching address is found in the Voodoo addressbook, it will be expanded automatically. If you wish to send a message to several people, separate the addresses from each other using comma (,). Cc, as in carbon copy, lists the people you wish to send a copy of the message to. This field is operationally like the To field, but the semantics differ in that the people listed in To are the primary recipients of the message, and the people listed in Cc are just to receive a copy for interest. Both of the address gadgets also have pop up buttons for selecting an address from the built-in addressbook. In the Subject gadget, enter the subject of the message. Additional headers can be typed to the beginning of the message, separated from the message body by one empty line. @{b}EDITOR FIELD@{ub} The rest of the editor window consists of a textfield in which you can freely type in your message. The lines will automatically wrap when reaching the right border. If you so wish, Voodoo can also send the messages with each paragraph consisting of a single long line, or wrap the paragraphs to lines of a preset maximum columns. You can add extra headers to a message simply by typing these headers at the beginning of the message, followed by an empty line. You can mark a block of text by pressing down the left mouse button in the beginning of the text and dragging the pointer to the end of the block. The keyboard controls are the normal Amiga Style Guide conformant ones. Shift, control and alt keys modify the function of backspace, delete and function keys. Other keyboard commands are: @{b}ramiga e@{ub} Erase all text @{b}ramiga z@{ub} Undoes last erase or cut @{b}ramiga u@{ub} Undoes last erase or cut @{b}ramiga x@{ub} Cuts marked text, placing it on the clipboard @{b}ramiga c@{ub} Copies marked text to clipboard @{b}ramiga v@{ub} Pastes text from the clipboard @{b}ramiga a@{ub} Mark all text @{b}control x@{ub} Delete line @endnode @node "ChooseAddress" "Choosing an address" @{b}CHOOSING AN ADDRESS@{ub} By pressing the To or Cc pop up buttons in the message editor, this window will open, and you can select the address to which the message should be sent. Don't forget that you can use the addressbook also simply by typing the nick name of the person you want to send a message to and pressing enter. Voodoo will automatically look up the address of the person and replace the name in the address gadget. @endnode @node "ARexx" "Voodoo ARexx host command set" @next "Registering" @{b}VOODOO AREXX INTERFACE@{ub} Voodoo features an extensive @{"ARexx" link "Glossary"} command set that allows not only the full configuration of Voodoo through ARexx, but also interfacing Voodoo to any Amiga text editor with ARexx capability. All features available through the Voodoo GUI are also available through the ARexx interface. The next pages will document all the commands available in Voodoo. @{b}Note:@{ub} The ARexx port of Voodoo is one of the things under heaviest development at the moment. This basic command set reflects the features available in the evaluation version. A more extensive interface with user macros is planned for Serious Voodoo. @{"ABOUT" link "ARexxABOUT"} @{"ACTIVATE" link "ARexxACTIVATE"} @{"CLOSE" link "ARexxCLOSE"} @{"DEACTIVATE" link "ARexxDEACTIVATE"} @{"GETMAIL" link "ARexxGETMAIL"} @{"LOOKUP" link "ARexxLOOKUP"} @{"MAIL" link "ARexxMAIL"} @{"OPEN" link "ARexxOPEN"} @{"SEND" link "ARexxSEND"} @{"QUIT" link "ARexxQUIT"} @endnode @node "ARexxABOUT" "Voodoo ARexx host command set" @toc "ARexx" @{b}Usage:@{ub} ABOUT [CLOSE] @{b}Template:@{ub} CLOSE/S Open an about window. · CLOSE @{lindent 4}means that instead of opening an about window, Voodoo should close all of them, if any are open.@{lindent 0} @endnode @node "ARexxACTIVATE" "Voodoo ARexx host command set" @toc "ARexx" @{b}Usage:@{ub} ACTIVATE Uniconify Voodoo. If Voodoo was in iconified state, all windows will be reopened. @endnode @node "ARexxCLOSE" "Voodoo ARexx host command set" @toc "ARexx" @{b}Usage:@{ub} CLOSE folder @{b}Template:@{ub} FOLDER/A Close an open folder. @endnode @node "ARexxDEACTIVATE" "Voodoo ARexx host command set" @toc "ARexx" @{b}Usage:@{ub} DEACTIVATE Close all open Voodoo windows and iconify. @endnode @node "ARexxGETMAIL" "Voodoo ARexx host command set" @toc "ARexx" @{b}Usage:@{ub} GETMAIL Get new mail from the spool file. @endnode @node "ARexxLOOKUP" "Voodoo ARexx host command set" @toc "ARexx" @{b}Usage:@{ub} LOOKUP [ADDRESS address] [NAME name] @{b}Template:@{ub} ADDRESS/K,NAME/K @{b}Results:@{ub} Name or address in RESULT or non-zero RC Look up an address from the built-in database. @endnode @node "ARexxMAIL" "Voodoo ARexx host command set" @toc "ARexx" @{b}Usage:@{ub} MAIL to [CC cc] [subject] @{b}Template:@{ub} TO/A,CC/K,SUBJECT Start writing an email. Voodoo will open an editor window or start the external editor, based on current preferences. @endnode @node "ARexxOPEN" "Voodoo ARexx host command set" @toc "ARexx" @{b}Usage:@{ub} OPEN folder @{b}Template:@{ub} FOLDER/A Open a folder. @endnode @node "ARexxSEND" "Voodoo ARexx host command set" @toc "ARexx" @{b}Usage:@{ub} SEND file @{b}Template:@{ub} FILE/A,ENCRYPT/S,SIGN/S Send the message in the file specified. When Voodoo uses an external editor, it makes a temporary file and writes to it the basic headers and your signature, and starts the editor in a background process to let you write the message. When you have finished writing the message, save the file and send this command to Voodoo, using the full name of this file as the argument. This will tell Voodoo that you are finished and the message can now be sent. · ENCRYPT @{lindent 4}specifies that the message should be PGP encrypted for the receivers before sending.@{lindent 0} · SIGN @{lindent 4}means that the message should be PGP signed before sending.@{lindent 0} @endnode @node "ARexxQUIT" "Voodoo ARexx host command set" @toc "ARexx" @{b}Usage:@{ub} QUIT [FORCE] @{b}Template:@{ub} FORCE/S Quit Voodoo. If FORCE is defined, bypass confirmation. @endnode @node "PGP" "Regarding PGP" @{b}ABOUT PGP@{ub} The privacy of electronic mail is practically nonexistant. On their way to the receiver, messages pass through several systems, and can be read on any of those systems with little effort. Because of this, sensitive information should never be sent in unencrypted E-Mail. Pretty Good Privacy (PGP) is a program originally written by Philip Zimmermann, designed to enable people to easily encrypt messages securely before sending through channels where the content of the message could easily be eavesdropped. Why should you use PGP? The question could just as well be, why not? Would you send your credit card number on a postcard? That's essentially what you're doing if you send it by unencrypted E-Mail. Do you want to make it easy for any stranger to read your letters? By using PGP, you not only make it hard, but actually impossible by today's standards, and the standards of foreseeable future. Unauthorized reading of a PGP encypted message would require hundreds, if not thousands of years of calculations on the best computers that exist today. The best place to find PGP, as well as more background information about it, is the International PGP Home Page, . Serious Voodoo will make the day to day use of PGP simpler than it has ever been by encoding the messages in PGP/MIME format, described in RFC 2015. To use this feature, you only need to check that option for the receiver's addressbook entry. Serious Voodoo was tested with PGP 2.6.3i, the latest available international PGP version. It should work with PGP versions 2.6.2, 2.6.2i, 2.6.3, 2.6.3i and later. To find out more about the PGP/MIME format, refer to the unofficial PGP/MIME home page, , or read the RFC itself. @endnode @node "Registering" "Registering Voodoo" @prev "ARexx" @{b}REGISTERING@{ub} Voodoo is not free software. I have spent much time programming it, always trying to make is as good as possible. I hope you like what you have seen and want to continue using Voodoo. If you do, please register it. By registering your copy, you support a dedicated Amiga developer and provide encouragement for me to continue enhancing Voodoo. Consider that I might have opted to not make this program at all, or make it for some other platform. Hopefully, you will feel that supporting my efforts is worth the quite reasonable price I ask for Voodoo. So, what do you get for registering? Besides the obvious warm and fuzzy feeling of having done something good, in return, I will send you a personalised keyfile for the "professional" version, Serious Voodoo, which is available at . Check out the @{"introduction" link "Introduction"} to see what features that version will have that this demo does not. Serious Voodoo is still under development and new versions are made available often. Upgrades to new versions of Serious Voodoo are free. @{b}HOW TO REGISTER@{ub} At the moment, you can register Voodoo at three possible sites. For details on these, see @{"Finland" link "CentralReg"} To register directly with the author. @{"North America" link "NAmericaReg"} To register in USA and Canada. @{"Central Europe" link "GermanReg"} To register in Germany, Austria or Switzerland. To register, print out the included @{"registration form" link "REGISTER/MAIN"}, fill it, and mail to the to the registration site you wish to use. If you have a @{"PGP key" link "PGP"}, include its ID and fingerprint on the registration form, and E-Mail the key itself to me, and I will send you the key file in an encrypted message. I can send the keyfile unencrypted, if you do not wish to use PGP, but an encrypted message is naturally preferable. The personalised keyfile is, after all, an investment which you would not want to end up in the wrong hands. The registration fee of Voodoo is @{b}150 Finnish marks (FIM), 35 US dollars (USD), 23 British pounds (UKP), 50 German marks (DEM) or 240 Swedish kronas (SEK)@{ub}. The other prices are slightly higher than FIM because of my exchange costs. This will entitle you to a keyfile to Serious Voodoo, sent via E-Mail. If you wish to instead receive the program and keyfile on a floppy disk, add an additional 15 FIM, 3 USD, 2 UKP, 5 DEM or 25 SEK. If you are registering with me directly, see @{"payment methods" link "CentralReg"} on the central registration info page. Otherwise, refer to the page of the registration site of your choice for more details. User clubs can organize group registrations. The prices are: Copies Price for each 5 130 FIM 30 USD 20 UKP 43 DEM 205 SEK 10 100 FIM 25 USD 16 UKP 35 DEM 170 SEK 20 or more 85 FIM 20 USD 13 UKP 28 DEM 140 SEK For group registrations, I will also accept the payment as an equivalent sum in other major currencies. Please contact me beforehand for the form of payment. If you send cash, please remember that I can not accept coins, and thus you will have to round the price upwards. @endnode @node "Contact" "Contact information" @{b}CONTACT INFORMATION FOR VOODOO@{ub} @{b}AUTHOR@{ub} Osma Ahvenlampi Rekipellontie 2 F 55 00940 Helsinki Finland @{b}REGIONAL REGISTRATION SITES@{ub} @{b}Worldwide@{ub} @{"Central" link "CentralReg"} @{b}North America@{ub} @{"United States and Canada" link "NAmericaReg"} @{b}Central Europe@{ub} @{"Germany, Austria, Switzerland" link "GermanReg"} @{b}WEB SITE@{ub} @{b}FTP SITE@{ub} @{b}MAILING LIST@{ub} voodoo@warped.com To subscribe, send a message to majordomo@warped.com with the text "subscribe voodoo" in the message body. @endnode @node "CentralReg" "Direct registration with the author" @{b}REGISTERING VOODOO DIRECTLY@{ub} In case you wish to register Voodoo directly with me, send your registration form to: Osma Ahvenlampi Rekipellontie 2 F 55 00940 Helsinki Finland The registration fee of Voodoo is @{b}150 Finnish marks (FIM), 35 US dollars (USD), 23 British pounds (UKP), 50 German marks (DEM) or 240 Swedish kronas (SEK)@{ub}. The other prices are slightly higher than FIM because of my exchange costs. This will entitle you to a keyfile to Serious Voodoo, sent via E-Mail. If you wish to instead receive the program and keyfile on a floppy disk, add an additional 15 FIM, 3 USD, 2 UKP, 5 DEM or 25 SEK. The possible methods of payment are: @{b}Money transfer@{ub} @{lindent 20}Transfer the fee to my account (Europayment/payment order): Merita Bank Ltd, branch Pukinmäki Eskolantie 1 00720 Helsinki Account: 233618-64791 SWIFT: MRITFIHH Please include a copy of the receipt with your registration form. This is to enable me to keep track of from who a registration fee is from, since your name might not make it back to me from the bank.@{lindent 0} @{b}Postal money order@{ub} @{lindent 20}I'm not sure how well this works from outside Europe, but inside Europe it works pretty well. E-Mail me the registration form, and I will send you the keyfile upon receiving the money.@{lindent 0} @{b}Cash@{ub} @{lindent 20}Please make sure that the money is disguised and not visible from outside the envelope by enclosing it within one or two sheets of paper. @{i}DO NOT SEND COINS.@{ui}@{lindent 0} @{b}EuroCheque@{ub} @{lindent 20}Write it to Finnish marks (FIM). Do not forget to write your card number on the back of the cheque, or I will not be able to cash it.@{lindent 0} @{b}DO NOT SEND PRIVATE CHECKS.@{ub} The cost of cashing them is prohibitive, if even possible at all. Don't forget to send your @{"PGP key" link "PGP"} to me if you have one! @endnode @node "GermanReg" "Registration for German-speaking countries" Die Registrierung von Voodoo für Deutschland, Schweiz und Oesterreich erfolgt bei den untenstehenden Adressen. Bitte beachten Sie, dass es in jedem Land eine eigene Bankverbindung gibt. Fuer groesstmoeglichste Sicherheit empfiehlt sich die Verschluesslung mit PGP. Die entsprechenden Programme bekommen Sie unter International PGP Home Page, . Senden Sie mir nach Einzahlung der Registrierungsgebühr, eine kurze Email, am besten zusammen mit Ihrem PGP Public Key Block. Bitte senden Sie mir kein Bargeld oder Cheques sondern ueberweisen Sie die Registrierungsgebuehr an eine der folgenden Banken: Die Registrierung wird schnellstmoeglichst vorgenommen und Sie erhalten den Key mit EMail. Die Zusendung kann mehrere Wochen dauern, auf jedenfall werden wir Ihnen eine Bestätigung der Registrierung zukommen lassen. Email: Domenig@amiga.vol.at @{b}Fuer User in Deutschland: DM 50.--@{ub} Domenig Weyermann Churerstr. 15 A - 6800 Feldkirch Bankverbindung: Bayerische Bodenseebank Raiffeisen eG 8990 Lindau-Insel Bankleitzahl 733 698 21 Konto Nummer 433 870 @{b}Fuer User in Oesterreich: Ats. 350.-@{ub} Domenig Weyermann Churerstr. 15 A - 6800 Feldkirch Bankverbindung: Postsparkasse PSK Bankleitzahl 60000 Konto Nummer 77.121.747 @{b}Fuer User in der Schweiz: sFr. 42.--@{ub} Domenig Weyermann Postfach 101 CH - 9469 Haag Bankverbindung: Migros Bank Zug Konto Nummer 16718,9638/04 Postcheque Konto 80-533-6 Bankkonto nicht vergessen Wünschen Sie, dass Ihnen das Keyfile auf Diskette zugesandt wird, erhöht sich der Preis wie folgt: DM 5.-- / Ats. 40.-- / sFr. 4.-- @endnode @node "NAmericaReg" "Registering Voodoo in North America" The registration fee for Voodoo is $35.00 plus $5.00 handling in the U.S. and Canada. ($10 handling for Mexico) Registering Voodoo in North America can be accomplished by mailing the payment in US Dollars to the address below. The payment can be in the form of a postal money order, a certified check, or credit card (Visa, Master Card, American Express or Discover). For credit card sales, any credit card used must be in the name of the registrant. Your credit card order can be faxed or e-mailed as an iff. Your registration must be signed and include your voice phone number and credit card expiration date. The address we are to send your copy of Voodoo to must be the same as your credit card billing address! Be sure to print out, complete, and include the signed @{"registration form" link "NAREGISTER/MAIN"} for North America. Your keyfile and disk will be mailed to you upon guaranteed receipt of your funds. Due to the nature of Voodoo's method of distribution and "keyfile protection" all sales are final. Although we will provide limited phone support for the installation of Voodoo, a mail program is but one part of a total Internet connection. We can not support diagnose or trouble shoot other programs, system settings, and environment variables, etc. as necessary for a successful e-mail connection. Due to restrictions on the commercial use of PGP it is not practical for us to e-mail encrypted keyfiles. Money order or certified check are considered guaranteed on day of receipt. Credit cards will be considered received after 1 day. Mail to: Voodoo Registration The Lively Computer 8314 Parkway La Mesa, CA. 91942 E-Mail: tlively@connectnet.com FAX: 1-619-589-5230 @endnode @node "Glossary" "Terms used in this manual" @{b}GLOSSARY@{ub} ARexx @{lindent 20}A widely used scripting and interprocess communication language, based on the REXX programming language invented by IBM. ARexx makes it easy to use two or more programs co-operatively to perform a task.@{lindent 0} ASCII @{lindent 20}American Standard Code for Information Interchange. The standard 7 bit character set of 128 alphanumeric characters and control codes, including the basic English alphabet.@{lindent 0} Datatypes @{lindent 20}A powerful part of the AmigaOS 3.0, the datatype subsystem makes it possible for applications to access any type of data in a similar manner. Instead of having to be able to decode JPEGs and GIFs by itself, the application can siply ask the operating system whether it recognises the file format, and retrieve the decoded data. Datatypes can also display the contents of a file by itself. For example, Voodoo uses the datatypes to display all mail by simply creating a datatype gadget out of the message and attaching it to the message window.@{lindent 0} Dial-Up @{lindent 20}The kind of an Internet connection where you call your Internet Service Provider using a modem. Opposite to a permanent connection, such as an Ethernet connection on an Internet-connected local area network.@{lindent 0} ISO-8859-1 @{lindent 20}(ISO Latin 1) An 8 bit character set with additional characters for Western European languages, extension to ASCII. Defined by the International Standards Organisation, this is the de-facto standard on the Internet. Default character set on Amiga.@{lindent 0} MIME @{lindent 20}Multipurpose Internet Mail Extensions. An extension standard designed for Internet E-Mail to allow easy transfer of information of non-ASCII representation, such as audio, images, or other binary data. In addition, MIME defines methods of encoding text that is not guaranteed to transfer through SMTP servers intact, such as lines longer than 80 columns or 8 bit characters (such as äöéù£ß).@{lindent 0} PGP @{lindent 20}Pretty Good Privacy. An encryption program based on public key cryptography, designed for encrypting messages to other people. Unencrypted email can very easily be saved and read by unauthorized people while in transit between systems on the Internet. Encrypting the messages will ensure privacy. PGP is freely available and widely used on the net. See also @{"regarding PGP" link "PGP"}.@{lindent 0} POP @{lindent 20}Post Office Protocol (version 3). A protocol designed for downloading mail messages from a mail server. Because this protocol requires an action from the receiver, it is suitable for dial-up connections that are not reachable from the Internet all the time.@{lindent 0} RFC @{lindent 20}Request For Comment, the method of publishing Internet documentation, such as new protocol standards. A list of E-Mail related RFCs is in the @{"Standards appendix" link "Standards"}.@{lindent 0} SMTP @{lindent 20}Simple Mail Transfer Protocol. The backbone of Internet E-Mail, this protocol is used to send messages to other systems. Machines connected to Internet and configured to receive mail directly run an SMTP "daemon" that the sender's SMTP delivery program can connect when it wishes to send a message.@{lindent 0} Spool file @{lindent 20}A file for temporary storage of data that is waiting for further action. In the case of Voodoo, a spool file contains incoming messages that are not yet read by Voodoo and moved to the mail folders. New messages are put into the spool file by the POP or SMTP program running on the machine.@{lindent 0} @endnode @node "FAQ" "Frequently asked questions about Voodoo" @{b}COMMON QUESTIONS AND PROBLEMS@{ub} @{b}Does Voodoo need MUI?@{ub} No. Voodoo uses the @{"ClassAct" link "ClassAct"} GUI toolkit, which is free to the users of applications utilizing it. If you are a programmer and want to learn more about ClassAct, send mail to caldi@nai.net or take a look at . @{b}How do I import my AmigaElm/PINE/etc folders to Voodoo?@{ub} Instructions for this are provided in the chapter @{"Importing folders" link "Importing"}. The registered version, Serious Voodoo, has extra support for making this procedure simpler. @{b}How do I use my AmigaElm/PINE alias file with Voodoo?@{ub} An ARexx script by Dan J. Fraser for converting the file to the format used by Voodoo is included in the Contrib directory of the Voodoo distribution archive. Sami Itkonen converted this script to read a PINE addressbook file, and this version is included in the same place. @{b}Why isn't ----- on the speedbar?@{ub} Three possibilities. Either I don't think it's necessary to have it there, in which case enough people requesting it can change my mind, or I just haven't though of it, or I don't have an icon for it. In the last case, why don't you make one? ;) @{b}I'm trying to use an external editor, but it doesn't work.@{ub} Voodoo runs the editor as an asynchronous process so that you could keep reading other messages while still writing the message. Because of this, it can not automatically send the message when you exit the editor. When you finish the editing and wish to send the message, send Voodoo the ARexx command @{"SEND" link "ARexxSEND"} with the path and name of the temporary file as an argument. This will tell Voodoo to build the final message adding necessary header on it, file the message to the folder for sent mail, and run the message delivery agent. @{b}What's the name all about?@{ub} Basically, it's just a cool name, and it keeps me from calling Voodoo MagicMail or something stupid like that. ;) Unfortunately, lately voodoo has been just about the only thing that has kept my Amiga going, too, and I hope Voodoo will pay for a new machine so that I can concentrate on what I like, writing cool applications, instead of fighting stupid hardware problems. You can help with that by registering Voodoo. @{b}I use MagicMenu. When I press the right mouse button in the editor, the system freezes. What's up?@{ub} @{b}The system locks up if I resize the message editor window.@{ub} This is a combination problem in the OS, the textfield.gadget Voodoo uses, and MagicMenu. What happens is that MagicMenu locks the screen's layers so that it could draw the menus without other programs messing up the display, and textfield.gadget does the same in input.device context. Boom, things lock up. The deadlock should automatically release in 10 seconds, though. A fix, NewObtainGIRPort, patches the routine textfield.gadget uses here. See the Contrib directory of Voodoo distribution. @{b}Why doesn't Voodoo create its own public screens?@{ub} Because I strongly feel that it is not every application's job to duplicate a function that ought to be in the OS and act as public screen managers. That's a lot of useless reinventing of the wheel, if you ask me. The other reason is that there is this absolutely wonderful utility called ScreenWizard that handles public screens exactly like they ought to have been handled by the OS from the start (except it doesn't make WB work on any/all pubscreens, but that isn't ScreenWizard's fault), if not better. If you don't have ScreenWizard, you should be ashamed of yourself! The good news is that the situation is easily rectified. You can find ScreenWizard on Aminet as util/cdity/scrwiz11.lha. Go get it right now, before you do anything else. You won't regret it. This is a subject I repeatedly get mail on. However, it is also a closed subject as far as I'm concerned. No amount of mail can make me reinvent this particular wheel, so I would appreciate it if you wouldn't even bother mailing me about it, since I really try to reply all mail I get, and this subject is just waste of time for both of us. For once, please try to accept that a programmer might know better than you what is good for your system. I'm not one to dictate decisions for other people for no good reason. @{b}Does Voodoo read USENET news? Will it do so in the future?@{ub} No, and very likely no. I don't want to mess with the NNTP protocol, which I consider very messy indeed. If enough people tell me they will buy an IMAP (Interactive Mail Access Protocol) version of Voodoo, I'll do that. IMAP is a way to keep mail folders on a central server and use the reader from a client machine somewhere else. It's ideal if you want to read mail from many machines and not care what machine you're using. It can also be used for news with a suitable IMAP server. @{b}When I try to install Voodoo, the Installer fails with an "Unable to compile script" error.@{ub} Most likely some misbehaving application installation has copied an obsolete version of the Commodore Installer utility to your hard drive. The Amiga Technologies Installer V43, which works with the script, is available on Aminet as util/misc/Installer-43_3.lha. @{b}People I send messages to complain that they see a lot of things like =20, =E4, and so on in my messages. What is Voodoo doing?@{ub} The Simple Mail Transfer Protocol, SMTP, was defined as a 7 bit transport path, and thus can not reliably transfer binary data or text that contains non-ASCII characters such as diacritics or umlauts. In addition, many mail gateways are known to change TABs to spaces, cut off long lines, and do other nasty things to messages. To overcome this problem, a Quoted-Printable encoding method was defined in the MIME specification. This encoding changes the problem characters into escape sequences that start with = which is followed by a hexadecimal value. Of course, this brings out another problem, since not all mail reading software knows about MIME, and fails to decode quoted-printable into readable form. For this reason, Voodoo allows you to specify whether quoted-printable should be used or not. This is set in the global settings, @{"program preferences" link "PageProgramPrefs"}. @{b}Voodoo doesn't send to people whose address is on the Cc line.@{ub} Strictly speaking, Voodoo does not send messages to ANYONE. Instead, it creates an RFC-822 message file, and runs an external delivery program whose responsibility it is to deliver the message to the address(es) listed on the To, Cc and Bcc headers of the message. One of these programs, popular because it is "easy" to configure, is Amiga PutMail. However, this program does not support Cc or Bcc headers, and thus messages are not delivered to the addresses listed on the Cc line in Voodoo's message editor. @{b}Voodoo does not read the contents of the spool file, even though I have messages there.@{ub} Most likely, the syntax of the contents of that file is incorrect. Voodoo expects to find the file in what is called the UNIX "mailbox" format, containing RFC-822 syntax messages separated from each other by a leading line that looks something like the following: From someone@somewhere.org Tue, 21 May 1996 18:45:00 This line is expected to be followed by a valid RFC-822 syntax header, which most often would be a Received header, although this is not a requirement. However, in certain misconfigured mail servers, the next line could instead be ANOTHER "From" line, this time quoted, as follows: >From someone Tue, 21 May 1996 18:44:23 Since this is not a valid message separator, nor a valid RFC-822 syntax header, Voodoo will not recognise the start of the message, and will continue reading over the message, looking for a proper start-of-message indicator. It will then finally reach the end of the file, having found no messages with the correct syntax. You should tell the adminstrators of your mail server to correct this problem. @{b}Sound attachments don't play correctly. For example, a WAV attachment only plays for a second or two.@{ub} This appears to be a problem with sound.datatype version 39, which did not support double buffering. Most third party sound subdatatypes, such as the WAV datatype require sound.datatype V40 or better for proper operation. @{b}Animation attachments don't play correctly or crash the system.@{ub} The animation and anim datatypes of AmigaOS V40 (Release 3.1) are quite buggy and apparently can cause memory corruption. There is no known fix at this point. @{b}If I save a message to file, I can't use it before selecting another message!@{ub} Voodoo attempts to conserve memory and disk space by using hard links between files instead of duplicate files where-ever possible. In particular, this happens when saving message bodies or attachments to RAM: disk, as the temporary files containing those are in the T: directory. Badly written applications, most notably LhA, unfortunately get confused with hard links and fail to access the file in the correct directory. When selecting another message, the temp files are deleted, and what used to be a link to the temp file becomes the file itself. This is a bug in the other application, not in Voodoo. While soft links are not fully supported under AmigaDOS, hard links are, and should under all circumstances be treated exactly like the actual file or directory they link to. @endnode @node "ClassAct" "About the ClassAct GUI Toolkit" @prev "Introduction" @next "Legal" @{b}CLASSACT@{ub} @{b}Voodoo uses the ClassAct GUI toolkit.@{ub} ClassAct is a set of BOOPSI gadget and image classes, designed to speed up and simplify the development of GUI applications. Free to users of the applications, ClassAct is available as shareware and commercial licenses for Amiga developers. The license includes the development kit, support, and distribution rights to the shared ClassAct class libraries. For more information, refer to or send mail to . @endnode @node "AGV41" "Secure AmigaGuide" @prev "Introduction" @next "Legal" @{b}SECURE AMIGAGUIDE@{ub} Voodoo utilizes the AGA_Secure feature of amigaguide.datatype version 41 to safely display AmigaGuide documents, without risk of inadvertent execution of ARexx or Shell commands embedded within the document. Because this feature is not available in versions 39 and 40 of amigaguide.datatype, and because these versions contain a bug that makes them display AmigaGuide documents wrong when used within Voodoo (or any program that won't use the full window for the AmigaGuide view), Voodoo will not display AmigaGuide documents when used on a system that does not have version 41 or later of amigaguide.datatype installed. The security risk in question here are the AmigaGuide commands ONOPEN and ONCLOSE, which execute an ARexx command upon entering or closing the document, and the special LINK commands RX, RXS and SYSTEM, which execute ARexx or Shell commands when the link button is selected. Version 41 of amigaguide.datatype recognises the AGA_Secure attribute that will make it ignore these commands. When this was written, version 41 of amigaguide.datatype was not yet publicly available. I was told that Amiga Technologies may distribute a patch file for upgrading versions 39 and 40 of the datatype to version 41. If you can not find this patch, contact Amiga Technologies for information about getting this AmigaGuide security bugfix. @endnode @node "Standards" "Related Internet Standards" @{b}INTERNET STANDARDS RELATED TO VOODOO@{ub} Internet Standards are documented in the form of Requests For Comments (or RFCs). These documents are each assigned an archive number, and categorized as standards, informational documents, and so on. The complete RFC archives are available on many large FTP sites on the Internet, with the central repository at rs.internic.net. Since E-Mail is a very important part of Internet, it is not surprising that it is covered by a large number of RFCs. Here, I attempt to list some of these documents, and how they relate to Voodoo. Any comments and additions to this list are most welcome. RFC-821 @{lindent 15}The Simple Mail Transfer Protocol (SMTP), the basic method of message transfer between Internet host systems. While mail is usually sent using SMTP, Voodoo does not implement SMTP by itself. Instead, it calls an external program to do that. The advantage of this is flexibility; you are not restricted to one SMTP implementation. In fact, you are not even required to use SMTP at all, if something else is more suitable for you!@{lindent 0} RFC-822 @{lindent 15}Standard for the format of ARPA Internet text messages, or the Internet E-Mail file format. This documents the format of the files Voodoo deals with, and what kind of messages Voodoo should create.@{lindent 0} RFC-1421 @{lindent 15}Privacy Enhanced Messages (PEM) is an earlier standard of message encryption and authentication. Voodoo does not support this standard because no free implementation of the encryption algorithms used in PEM is available, and because the free Pretty Good Privacy (PGP) encryption program has become a very popular.@{lindent 0} RFC-1521 @{lindent 15}Multipurpose Internet Mail Extensions, or MIME documents an method of embedding messages in different formats, character sets, or representations within the RFC-822 files. This is the building block for attaching binary files to E-Mail messages.@{lindent 0} RFC-1522 @{lindent 15}Message header extensions for non-ASCII text. RFC-822 restricts the character set used in E-Mail messages to the 7 bit ASCII printable characters. While RFC-1521 defines encoding methods that allow the use of non-ASCII characters in the message body, this standard documents a way to do the same for message headers.@{lindent 0} RFC-1725 @{lindent 15}Post Office Protocol version 3 is a common method of transferring mail from Internet hosts to the client workstations that are not connected to Internet on a permanent basis, and thus can not receive mail using SMTP. As with SMTP itself, Voodoo does not use POP internally, but can be used with several available POP tools.@{lindent 0} RFC-1730 @{lindent 15}Interactive Message Access Protocol version 4 is a standard for accessing remotely stored messages (which can be E-Mail or something else, such as Usenet News) from client workstations. Voodoo does not at this point support IMAP4 or other remote access protocols.@{lindent 0} RFC-1806 @{lindent 15}The Content-Disposition header. Extends MIME by defining a standard way of transmitting the original file name of attached binary files, and the preferred display method. While Voodoo does use this header, it treats the "inline" and "attachment" disposition-types identically.@{lindent 0} RFC-1847 @{lindent 15}Security Multiparts for MIME is the basic framework upon which the encryption support in Voodoo is built on. The actual documentation of the PGP encryption Voodoo supports is PGP/MIME, described further in RFC-2015. This RFC documents the message format on which PGP/MIME builds on.@{lindent 0} RFC-1848 @{lindent 15}MIME Object Security Services (MOSS) is another method of message encryption and authentication built on top of the framework defined by RFC-1847. MOSS uses the algorithms defined in RFC-1421, and again due to the unavailability of any free implementations, is not supported by Voodoo.@{lindent 0} RFC-2015 @{lindent 15}PGP/MIME describes the format of MIME messages Voodoo uses for sending PGP encrypted and/or signed messages. While this Standards Track document was published October 1996, Voodoo supported the format several months before that.@{lindent 0} @endnode @node "Index" "Voodoo user manual index" @{b}VOODOO DOCUMENTATION INDEX@{ub} @{"ABOUT" link "ARexxABOUT"} Voodoo ARexx host command set @{"Acknowledgements" link "Legal"} Legal information on Voodoo @{"ACTIVATE" link "ARexxACTIVATE"} Voodoo ARexx host command set @{"addressbook" link "Addressbook"} Built-in addressbook @{"aliases" link "Configuration"} Configuring Voodoo @{"AmigaGuide" link "AGV41"} Secure AmigaGuide @{"AmiPOP" link "Installation"} Installation of Voodoo @{"AmiPOP" link "Introduction"} Introduction to Voodoo @{"AmiTCP" link "Introduction"} Introduction to Voodoo @{"AS225" link "Introduction"} Introduction to Voodoo @{"Backfill pattern" link "PageDisplayPrefs"} Settings affecting the Voodoo GUI @{"ClassAct" link "ClassAct"} About the ClassAct toolkit @{"configuration" link "Configuration"} Configuring Voodoo @{"Copyright" link "Legal"} Legal information on Voodoo @{"Date format" link "PageDisplayPrefs"} Settings affecting the Voodoo GUI @{"DEACTIVATE" link "ARexxDEACTIVATE"} Voodoo ARexx host command set @{"Default save folder" link "PageFolderPrefs"} Folder settings of primary importance @{"Disclaimer" link "Legal"} Legal information on Voodoo @{"Distribution" link "Legal"} Legal information on Voodoo @{"Editor cursor blink rate" link "PageDisplayPrefs"} Settings affecting the Voodoo GUI @{"Editor font" link "PageFontsPrefs"} Fonts used in Voodoo @{"Expert keyboard" link "MenuExpertKeys"} Expert keyboard mode @{"Expunge deleted" link "PageFolderPrefs"} Folder settings of primary importance @{"Features" link "Introduction"} Introduction to Voodoo @{"Folder directory" link "PageFolderPrefs"} Folder settings of primary importance @{"folder" link "FolderPrefs"} Folder configuration @{"GETMAIL" link "ARexxGETMAIL"} Voodoo ARexx host command set @{"Glossary" link "Glossary"} Terms used in this manual @{"Header gadgets" link "ComposeWindow"} The Voodoo built-in editor @{"Header listview" link "MessageWindow"} The message window interface @{"Icon font" link "PageFontsPrefs"} Fonts used in Voodoo @{"Importing messages" link "Importing"} Importing from other readers @{"Index font" link "PageFontsPrefs"} Fonts used in Voodoo @{"INetUtils" link "Introduction"} Introduction to Voodoo @{"INetUtils" link "SMTPpost"} Installing INetUtils SMTPpost @{"Installation" link "Installation"} Installation of Voodoo @{"Interface font" link "PageFontsPrefs"} Fonts used in Voodoo @{"Introduction" link "Introduction"} Introduction to Voodoo @{"Keyboard" link "MessageWindow"} The message window interface @{"keyfile" link "Registering"} Registering Voodoo @{"license" link "Legal"} Legal information on Voodoo @{"Limitations, demo" link "Introduction"} Introduction to Voodoo @{"LOOKUP" link "ARexxLOOKUP"} Voodoo ARexx host command set @{"Mail address" link "PageUserPrefs"} Personal user information settings @{"MAIL" link "ARexxMAIL"} Voodoo ARexx host command set @{"Message font" link "PageFontsPrefs"} Fonts used in Voodoo @{"Message listview" link "MessageWindow"} The message window interface @{"Message view" link "MessageWindow"} The message window interface @{"Move read messages" link "PageFolderPrefs"} Folder settings of primary importance @{"Number of lines in header list" link "PageDisplayPrefs"} Settings affecting the Voodoo GUI @{"Organization" link "PageUserPrefs"} Personal user information settings @{"PGP" link "PGP"} Regarding PGP @{"POP" link "Installation"} Installation of Voodoo @{"Primary folder" link "PageFolderPrefs"} Folder settings of primary importance @{"Public screen" link "PageDisplayPrefs"} Settings affecting the Voodoo GUI @{"QUIT" link "ARexxQUIT"} Voodoo ARexx host command set @{"Quote attribution" link "PageUserPrefs"} Personal user information settings @{"Quote prefix" link "PageUserPrefs"} Personal user information settings @{"Real name" link "PageUserPrefs"} Personal user information settings @{"Registering" link "Registering"} Registering Voodoo @{"Reply" link "PageUserPrefs"} Personal user information settings @{"Requirements" link "Introduction"} Introduction to Voodoo @{"Sabot" link "Introduction"} Introduction to Voodoo @{"SEND" link "ARexxSEND"} Voodoo ARexx host command set @{"Sent mail folder" link "PageFolderPrefs"} Folder settings of primary importance @{"Serious Voodoo" link "Registering"} Registering Voodoo @{"Settings, User" link "PageUserPrefs"} Personal user information settings @{"Show icon text" link "PageDisplayPrefs"} Settings affecting the Voodoo GUI @{"Signature file" link "PageUserPrefs"} Personal user information settings @{"Skip deleted" link "PageFolderPrefs"} Folder settings of primary importance @{"SMTPd" link "Installation"} Installation of Voodoo @{"SMTPpost" link "SMTPpost"} Installing INetUtils SMTPpost @{"speedbar" link "ComposeWindow"} The Voodoo built-in editor @{"speedbar" link "MessageWindow"} The message window interface @{"Spool file" link "PageFolderPrefs"} Folder settings of primary importance @{"Starting" link "Starting"} Starting up Voodoo @{"textfield" link "ComposeWindow"} The Voodoo built-in editor @{"Use Quoted" link "PageProgramPrefs"} External programs and related settings @{"Visible headers" link "PageProgramPrefs"} External programs and related settings @{"Voodoo" link "Configuration"} Configuring Voodoo @{"Voodoo" link "Configuration"} Configuring Voodoo @{"Wrap lines" link "PageProgramPrefs"} External programs and related settings @endnode