This file documents Spot, a FidoNet tosser/editor for Amiga computers. Copyright (C) 1993 Nico François ______ __ / ____/ _/ /_ / /___ ______ ______ / __/ /___ // __ // __ / / / ___/ // /_/ // /_/ / / /_ /_____// ____//_____/ /___/ / / /_/ Spot 1.1 A FidoNet tosser/editor for the Amiga Preface ******* Spot is offered to you under the concepts of ShareWare. You can use it for an evaluation period of up to 30 days without paying any charge. If you are going to use Spot after the evaluation period, you should register. See License and the `README' file for more information. Introduction ************ This manual is a description of Spot, a FidoNet-compatible tosser, scanner and editor for Amiga points. To use Spot you will need a good mailer. TrapDoor is suggested. Spot has been developed for use with TrapDoor and supports/uses many of TrapDoor's unique features. If you are new to FidoNet, please read the file `FidoNet.man' that is included in the TrapDoor distribution. Spot requires Workbench 2.0 or higher to run. It uses many 2.04 features and has been designed to be as user-friendly possible. Spot requires `reqtools.library' version 38 or higher to run. When message base crunching is used Spot also requires `powerpacker.library' version 35 or higher. Both these libraries are also (C) Nico François and are included in the distribution archive. Spot supports `traplist.library' (C) Martin J. Laubach and Maximilian Hantsch. `traplist.library' is not included but can be found in the TrapDoor archive. Although Spot is not really a cat, the following ode... :-) Ode to Spot by Lt. Cmdr. Data (`Schisms') Felus Catus. Is your taxonomic nomenclature An endothermic quadruped, carnivorous by nature? Your visual, olfactory, and auditory senses Control your hunting skills and natural defenses. I find myself intrigued by your sub vocal oscillations. A singular development of cat communications That obviates your basic hedonistic predilection For a rhythmic stroking of your fur to demonstrate affection. A tail is quite essential for your acrobatic talents. You would not be so agile if you lacked its counterbalance. And when not being utilized to aid in locomotion, It often serves to illustrate the state of your emotions. Oh Spot, the complex levels of behavior you display Connote a fairly well developed cognitive array. And though you are not sentient, Spot, and do not comprehend, I none the less consider you a true and valued friend. Features ******** * Requires Kickstart 2.04 or higher. * Supports new 3.0 features (newlook menus, memory pools,...). * Fully localized (Workbench 2.1 or higher). * Style Guide compliant. * Supports all current and future monitor modes. * Completely font-sensitive, user may select which fonts to use. * Keyboard short-cuts for most menus and gadgets. * All settings can be easily changed from within Spot. * Fast importing/exporting. * Automatically creates new areas for you, no tedious work. * Special fast message base format with only a few files per area. * Optional - fully transparent - message base crunching. * Message list with powerful functions (e.g. search body text). * Message thread linking based on subject and MSGID kludge. * Excellent support for multiple character sets (LATIN-1, IBM,...). * Built-in, fully asynchronous, Fido file request. * Multi-bossing and multi-domain capable. * Userlist editor. Every domain has its own userlist. * ARexx port. * Clock Some of these features are only available in the registered version. Installation ************ Use the appropriate installation icon in the `Install' drawer. Installation uses Commodore's installer utility and should be a doddle. Spot requires `MAIL:' to be assigned to some directory on your harddisk. This directory will be used to store the configuration files and the message base. `MAIL:' is also requires by most other FidoNet software, so if you have already installed TrapDoor for example this will already be assigned properly. When you start Spot for the first time it will ask you for your name and FidoNet address and will create default preferences for you. Menus ***** Project Menu ============ Import... --------- Keyboard short-cut: none (areas window: I for Import button) Start import. Spot will look in your inbound directory (see General) for mail packets and mail bundles. Spot will automatically unpack the bundles and will toss all messages in the packets into the appropriate echo or netmail area. During import Spot will put reply links, mark messages for you, do optional dupe checking,... When you are multi-bossing Spot will examine TrapDoor's filenote to find out what unpacker to use. Note that it is possible to close the import console window with Control \ or Esc as well as with the close gadget. Export... --------- Keyboard short-cut: Right-Amiga X (areas window: X for Export button) Export all message you have written to your boss system. Spot will create a bundle containing all the echo mail you've written in your outbound directory (see General). Netmail will be put in a packet, unless the `Pack netmail' switch is used (see System) in which case netmail will be added to the echomail bundle (check with your boss to see if his tosser supports this). Maintenance... -------------- Keyboard short-cut: none (areas window: M for Maintenance button) Delete messages in areas according to you settings (see Areas). Spot will report how many messages are deleted in each area. You should do a maintenance regularly, otherwise your message base will quickly fill up your disk. Note that maintenance may delete unread mail. If you want to keep unread mail use the `Keep unread' button in the requester that pops up. Optimize... ----------- Keyboard short-cut: none (areas window: O for Optimize button) Optimizes the message base. This function may take some time. Spot will reorganize each area, making sure the disk usage is minimal and the message base is as efficiently organized as possible. You should optimize your message base on a regular basis. When your message base is optimized Spot will look at your current message base crunching setting and will crunch or decrunch the entire message base accordingly. Poll... ------- Keyboard short-cut: none (areas window: P for Poll button) Call your boss node. Spot will execute the poll command (see General). If there is unexported mail left in an area Spot will tell you about this and offer you the possibility to export it before polling. If you are multi-bossing Spot will put up a requester asking you which boss to poll. File Request... --------------- Keyboard short-cut: none (areas window: F for File Request button) Brings up the Fido file requester (not AmigaDOS file requester). Enter the node address from which you would like to request in the `Node' gadget. Enter the file names in the string gadget below the listview. To delete a file just edit it (click on it), clear the string gadget and press enter. Note that the file requester is completely asynchronous, you may continue to use Spot. This is very useful for browsing some messages listing new file arrivals at your BBS. A recommended utility to go with the file requester is PowerSnap, this will allow you to 'snap' files from the message display into the file requester. Toggle Workbench ---------------- Keyboard short-cut: none Open or close the Workbench screen. This is only possible if no other programs have windows open on the Workbench. Useful if you haven't got much memory left. Iconify ------- Keyboard short-cut: Right-Amiga \ (areas window: C for Iconify button) Iconify Spot on the Workbench as an AppIcon. Double-click Spot's icon or use Spot's hotkey (see General) to uniconify it. If you have changed the settings Spot will tell you about this and give you the possibility to either abort the iconify, iconify or save the settings before iconifying. Spot allows you to iconify it on startup. Simple pass the `ICONIFY' argument from the shell or put the `ICONIFY' tooltype in Spot's icon. If you intend to drag Spot into your WbStartup you should also set the `DONOTWAIT' tooltype. Spot will recognize the following additional tooltypes: `ICONXPOS', `ICONYPOS' and `ICONNAME'. You can use these to set the position and the name of the iconified Spot's icon. About... -------- Keyboard short-cut: none Show some general info about Spot. Quit ---- Keyboard short-cut: Right-Amiga Q (areas window: Q for Quit button) Quit Spot. If you have changed the settings Spot will tell you about this and give you the possiblity to either abort quitting, quit anyway or save the settings first. Move Menu ========= Area List... ------------ Keyboard short-cut: F1 Go to the area list window (see Area List Window). Message List... --------------- Keyboard short-cut: F2 Go to the message list window (see Message List Window). Messages... ----------- Keyboard short-cut: F3 Go to the message window (see Message Window). Next Message ------------ Keyboard short-cut: Arrow Right Go to the next message in the current area. Previous Message ---------------- Keyboard short-cut: Arrow Left Go to the previous message in the current area. Next Reply ---------- Keyboard short-cut: Alt Arrow Right Go to the next message in the reply thread the current message is part of. Spot will link messages on subject or on ^aMSGID kludge. Previous Reply -------------- Keyboard short-cut: Alt Arrow Left Go to the previous message in the reply thread the current message is part of. Next Marked ----------- Keyboard short-cut: Ctrl Arrow Right Go to the next marked message. Messages can be marked in the message list (see Message List Window). Previous Marked --------------- Keyboard short-cut: Ctrl Arrow Left Go to the previous marked message. Messages can be marked in the message list (see Message List Window). Last Message ------------ Keyboard short-cut: Shift Arrow Right Go to the last message in the current area. First Message ------------- Keyboard short-cut: Shift Arrow Left Go to the first message in the current area. Next Unread ----------- Keyboard short-cut: TAB Go to the next unread message in the current area. Previous Unread --------------- Keyboard short-cut: Shift TAB Go to the previous unread message in the current area. Next Unreplied -------------- Keyboard short-cut: Alt TAB Go to the next unreplied message in the current area. An unreplied message is a message directed to you and which you did not reply to (yet). Previous Unreplied ------------------ Keyboard short-cut: Shift Alt TAB Go to the previous unreplied message in the current area. An unreplied message is a message directed to you and which you did not reply to (yet). Goto Message... --------------- Keyboard short-cut: Right-Amiga G Go to a specific message. You will be prompted for the message number you would like to jump to. Next Area --------- Keyboard short-cut: Right-Amiga N Go to the next area in the area list. Previous Area ------------- Keyboard short-cut: none Go to the previous area in the area list. Area With Unread Mail --------------------- Keyboard short-cut: Right-Amiga U Go to the next area in the area list with unread mail left. Area With Imported Mail ----------------------- Keyboard short-cut: Right-Amiga I Go to the next area in the area list with unread mail from the last import left. Area With Mail For You ---------------------- Keyboard short-cut: Right-Amiga Y Go to the next area in the area list with unread mail for you left. Message Menu ============ Write... -------- Keyboard short-cut: Right-Amiga W (messages or message list window: W for Write button or Shift-Ins on keypad) Write a message in the current area. Spot will start your favorite editor (see General) so you can type in your message. After saving your message and quitting your editor Spot will put up the message header window (see Message Header Window) to allow you to fill in the message header (destination address, subject, flags,...). Reply... -------- Keyboard short-cut: Right-Amiga R (messages window: R for Reply button) Reply to the current message. Spot will start your favorite editor (see General) with the quoted message. The reply will be preceded with the current area's reply header (see Reply Headers...). You may edit this quoted reply as you wish. After saving your reply and quitting your editor Spot will put up the message header window (see Message Header Window) with the addressee and the subject already filled in (you may change these if you wish). Matrix Reply... --------------- Keyboard short-cut: Right-Amiga M Reply to the current message in netmail. The reply is sent as private netmail to the writer of the original message. The reply will be preceded with the current area's reply header (see Reply Headers...). Cross Reply... -------------- Keyboard short-cut: Right-Amiga C Reply to the current message, but post the reply in another area. Spot will put up a requester asking you which area you would like to write the reply in. The reply will be preceded with your cross-reply header (see Cross-Reply Header...). Forward... ---------- Keyboard short-cut: Right-Amiga F Forward, or re-post a message in another area. Spot will put up a requester asking you which area you would like to forward this message to. The message will be preceded with your forward header (see Forward Header...). Edit... ------- Keyboard short-cut: Right-Amiga E Edit the current message. If you try to edit a message not written by you or one that has already been exported Spot will warn you about this. Editing exported mail is no use since the un-edited version is already on its way around the world. Edit Header... -------------- Keyboard short-cut: Right-Amiga H Edit the header of the current message (see Message Header Window). Delete... --------- Keyboard short-cut: Shift Del (*no* confirmation requester) Delete the current message or all selected messages. Using the menu will put up a confirmation requester, the Shift Del keyboard short-cut (also works on keypad) does an immediate delete without confirmation. The Shift Del keyboard short-cut only works from the messages window. Save... ------- Keyboard short-cut: Right-Amiga S Save the current message or all selected messages to an ASCII file. If the file you save to already exists you are given the option to overwrite the file or append the message to it. Print... -------- Keyboard short-cut: Right-Amiga P Print the current message or all selected messages using your system printer preferences. Add to Userlist... ------------------ Keyboard short-cut: Right-Amiga + Add the writer of the current message to your userlist. If the writer is already in the list Spot will tell you so. If not you are asked if you would like to enter an optional nickname and/or comment for this user. See Userlist... for more information. Info... ------- Keyboard short-cut: Right-Amiga ? Toggle Keep Flag ---------------- Keyboard short-cut: Right-Amiga K Toggle Unreplied Flag --------------------- Keyboard short-cut: Right-Amiga - Settings Menu ============= General... ---------- Keyboard short-cut: F6 Brings up the general settings editor (see General). System... --------- Keyboard short-cut: F7 Brings up the system settings editor (see System). Areas... -------- Keyboard short-cut: F8 Brings up the areas settings editor (see Areas). GUI... ------ Keyboard short-cut: F9 Brings up the GUI settings editor (see GUI). Userlist... ----------- Keyboard short-cut: F10 Brings up the userlist editor (see Userlist). ARexx... -------- Keyboard short-cut: Shift F6 Brings up the ARexx commands editor (see ARexx). Origins... ---------- Keyboard short-cut: none Brings up the origins editor. This editor allows you to enter several origins to be used in echomail areas. Use the `Add...' button to add a new origin. The `File...' button allows you to get the contents of a file into the string gadget. The `Delete' button will delete the current origin. The `Up' and `Down' buttons allow you to change the position of the current origin. Origins can be grouped together. The `Add group' and `Delete group' buttons can be used to add and remove origin groups. The `Rename group' button allows you to give another name to an already existing group. Use cycle gadget at the top of the window to select the current group. Press `Ok' to accept the changes you made, `Cancel' otherwise. Note that if you delete an origin the area that was using this origin will be left origin-less. You will have to reselect an origin for those areas. An origin may be up to 54 characters long. Spot will make sure the origin line doesn't get longer than 80 characters and may truncate your origin when writing a message. Reply Headers... ---------------- Keyboard short-cut: none Brings up the reply headers editor. This editor allows you to enter several reply headers to be used when you reply in netmail or echomail areas. Use the `Add...' button to add a new origin. The `File...' button allows you to get the contents of a file into the string gadget. The `Delete' button will delete the current reply header. The `Up' and `Down' buttons allow you to change the position of the current reply header. Press `Ok' to accept the changes you made, `Cancel' otherwise. Note that if you delete a reply header the area that was using this header will be left reply header-less. You will have to reselect a reply header for those areas. Below the listview is a WYSIWYG display of the reply header you are editing using the message font (see GUI). A reply header may be up to 255 characters long. It can contain the following control codes: * %d - date of original message * %D - localized date of original message * %t - time original message was written * %N - full name of message writer * %n - first name of message writer * %o - origin-address of message writer * %s - subject of original message * %A - full name of addressee original message * %a - first name of addressee of original message * \n - new line If %a, %A, %n or %N are followed by some text enclosed in two '~'s this text will be used if the message was directed to or written by yourself. For example: "Look what %n~I~ wrote to %a~me~:" The localized date is for use on Workbench 2.1 or higher. It is very useful to be used in reply headers for local areas. If locale.library is not available %D will be identical to %d. For the advanced Spot user there is a possibility to use a localized date in your local areas without using Spot in your local language (some people don't like this). Simply use the system Locale preference editor to select your language and save this setting as `MAIL:SpotDate.locale' (use `Save As...'). Spot will try to read this file on startup and use this as your locale for the %D formatting code. Signatures... ------------- Keyboard short-cut: none Brings up the signatures editor. This editor allows you to enter several signatures to be used in your netmail or echomail areas. Use the `Add...' button to add a new signature. The `File...' button allows you to get the contents of a file into the string gadget. The `Delete' button will delete the current signature. The `Up' and `Down' buttons allow you to change the position of the current signature. Press `Ok' to accept the changes you made, `Cancel' otherwise. Note that if you delete a signature the area that was using this signature will be left signature-less. You will have to reselect a signature for those areas. Below the listview is a WYSIWYG display of the signature you are editing using the message font (see GUI). A signature may be up to 255 characters long. Tag Lines... ------------ Keyboard short-cut: none Brings up the tag lines editor. This editor allows you to enter tag lines origins to be used when you write messages. Use the `Add...' button to add a new tag line. The `File...' button allows you to get the contents of a file into the string gadget. The `Delete' button will delete the current tag line. The `Up' and `Down' buttons allow you to change the position of the current tag line. Tag lines can be grouped together. The `Add group' and `Delete group' buttons can be used to add and remove origin tag line groups. The `Rename group' button allows you to give another name to an already existing group. Use cycle gadget at the top of the window to select the current group. When adding a new group you may make it a file group. This special type of group will get its tag lines from a file, allowing you to build a list of hundreds or even thousands of tag lines. To make a group a file group simply press the `File...' gadget in the `Add group' requester after typing in a name for the group. You will be presented with a file requester. Use this to select a tag line file. This tag line file must have the following format: This is a tag line. %% This is another tag line. %% This is a multi line tag line. %% This is the last tag line in this file. So simply separate your tag lines with a `%%'. In a file group you can't add any tag lines with the GUI. The `File...' button will act differently, it will allow you to change the file this group gets its tag lines from. Press `Ok' to accept the changes you made, `Cancel' otherwise. Note that if you delete a tag line the area that was using this tag line will be left tagline-less. You will have to reselect a tag line for those areas. A tag line may be up to 255 characters long. Tag lines in a file are of unlimited length. Forward Header... ----------------- Keyboard short-cut: none Brings up the forward header editor. This editor allows you to enter the forward header used when you forward a message from one area to another. The file gadget next to the string gadget allows you to get the contents of a file into the string gadget. Press `Ok' to accept the changes you made, `Cancel' otherwise. Below the string gadget is a WYSIWYG display of the forward header using the message font (see GUI). The forward header may be up to 255 characters long. It can contain the following control codes: * %A - net name of area message is forwarded from * %a - user name of area message is forwarded from * %d - date of original message * %D - localized date of original message * %t - time original message was written * %N - full name of message writer * %n - first name of message writer * %o - origin-address of message writer * %s - subject of original message * \n - new line If %n or %N are immediately followed by some text enclosed in two '~'s this text will be used if the message was written by yourself. For example: "Message from %n~me~ in area %a:" Cross-Reply Header... --------------------- Keyboard short-cut: none Brings up the cross-reply header editor. This editor allows you to enter the cross-reply header used when you reply a message from one area into another area. The file gadget next to the string gadget allows you to get the contents of a file into the string gadget. Press `Ok' to accept the changes you made, `Cancel' otherwise. Below the string gadget is a WYSIWYG display of the cross-reply header using the message font (see GUI). The cross-reply header may be up to 255 characters long. It can contain the same control codes as the forward header (see Forward Header...). Reflow Text ----------- Keyboard short-cut: none When this switch is on Spot will reflow the text you entered in your editor (see General). This means that Spot will remove the newlines at the end of every line and will reflow your text into paragraphs. This will allow for much better displaying and quoting by Spot and other mail editors. It is strongly advised you leave this option switched on. In fact, you should never switch this off unless you have a specific reason to do so. Spot tries to be smart when reflowing your message. It will not reflow when certain non-common characters are used (to leave ascii drawings as they are) and will recognize (and not reflow) uuencoded or PGP encrypted data. Spot allows you to disable reflow manually. Simply enclose the section of your message you don't want to be reflowed between two `\reflow' lines. The `\reflow' lines will be automatically removed by Spot. Show Kludges ------------ Keyboard short-cut: none Most fidonet messages contain kludges (control lines beginning with ^a). With this switch you can specify if you would like to see them or if you would like Spot to hide them for you. If you save or print a message (see Save... and Print...) this switch will decide wether kludges lines are included. Show SEEN-BYs ------------- Keyboard short-cut: none With this switch you tell Spot if it has to show or hide the SEEN-BY lines in echo mail areas. You would normally leave this off so Spot will not bother you with these lines. If you save or print a message (see Save... and Print...) this switch will decide wether SEEN-BY lines are included. No Re: ------ Keyboard short-cut: none When this switch is on Spot will filter out the `Re:'s that are generated by most mail editors when replying to a message. It will not show `Re:'s in the message header or message list. When replying to a message the subject will be kept the same, so no `Re:' will be added. Quote Kludges ------------- Keyboard short-cut: none With this switch you specify wether kludges should be included when you quote a message. You would normally leave this switch off. Show Net Names -------------- Keyboard short-cut: none Spot normally shows the user names of areas in its main areas window. With this switch you can tell Spot to show the net names. This is useful if you need the net name of an area for de-areafixing for example. IBMPC codepage 865 ------------------ Keyboard short-cut: none Use IBM PC font codepage 865 (Nordic) instead of the default codepage 850 (International). Save Settings... ---------------- Keyboard short-cut: none Save the settings to `MAIL:Spot.prefs', `MAIL:Spot.areas' and `MAIL:Userlist_'. The current size of all list requesters and the Fido file requester will also be saved. ARexx Menu ========== Execute Script... ----------------- Keyboard short-cut: none Execute an ARexx script. Brings up the file requester in the `REXX:' directory and allows you to select an ARexx script that should be executed. User items ---------- Keyboard short-cut: Right-Amiga 1 through Right-Amiga 0 Up to 40 user-definable items can be added to the ARexx menu. The first ten will have keyboard short-cuts. These items can be configured from the ARexx settings editor (see ARexx). Area List Window **************** The area list window is the window Spot will show at startup. In the listview on the right you'll be shown a list of all areas. Spot will show the area user name, the import and export flags, the number of messages in the area, the number of unread messages and the number of unread messages to you. The last two are of course optional and will only be shown when there is actually unread mail left. The import flag (I) will be shown if there is mail arrived in the area from the last import. The export flag (E) will be shown if there is unexported mail left in the area. When Show Net Names is switched on Spot will show the net or tag name of the area in brackets after the user name. Double-click on an area to jump to the message window. The buttons on the left perform the same action as the menu items by the same name. Message List Window ******************* The message list shows you a list of all messages in the current area. For each message the writer (from), the addressee (to) and the subject is shown. Before each message two flags are displayed, the export flag (E) shows a message that needs to be exported and the keep flag (K) shows that a message has the keep flag set. Messages marked with an asterisk (*) are messages you haven't read yet. Messages printed in inverse are messages to you you haven't replied to yet (or switched off the unreplied flag manually, see Toggle Unreplied Flag). By clicking on a message you are able to mark it. All marked messages can be saved, deleted and printed. You can also go to the message window and move between all marked messages (see Next Marked and Previous Marked. The current message will be highlighted. The current message is the message you either last read in the area or the first unread message in the area. It is the message that will be shown when you go to the message window. The `Areas...' and `Messages...' buttons on the left can be used to jump to the area list or message window respectively. Pressing the `All' button will mark all messages in the area, `Unread' will mark all unread messages (and will clear all other marked messages) and `None' will simply clear all marked messages. The `Include...' and `Exclude...' buttons bring up a window to allow you to include or exclude messages by using a pattern filter (see Include-Exclude Window). The `Delete...', `Save...' and `Print...' buttons allow you to delete, save or print several messages in one go. The `Flags...' buttons brings up a window for you to set or clear certain flags of all marked messages (see Flags Window). Include/Exclude Window ====================== The include or exclude window offers you a very powerful means of selecting specific messages. With the `Search' cycle gadget you may select if you wish to search all messages, all read messages or all unread messages. The `Search string' is the string that will be searched for. This string may contain any valid AmigaDOS pattern (like `#?'). When the `Case sensitive' checkbox is ticked the string comparison will be case sensitive. The `To', `From', `Subject' and `Body text' checkboxes define which fields should be searched. Note that the search string is automatically surrounded by two `#?' wildcards for the body text search. Press the `Include' or `Exclude' button to start the search. When body text is searched Spot will put up a progress requester, since this may take a while. The `Cancel' button exits the window without searching. Flags Window ============ The flags window holds a cycle gadget for each message flag you can change. These cycle gadgets have three states: `Don't change', `Set flag' and `Clear flag'. The label should explain what these different states do. Press `Ok' to change the flags of all marked messages, `Cancel' to leave without changing any flags. Message Window ************** The message window shows the current message in the current area. At the top of the screen the message header information is displayed. Spot will show the writer (`From'), the addressee (`To') and the subject (`Subj'). The address of the writer and in netmail of the addressee is also shown, as well as the message date. The date below the message date is the import or export date. If no date is shown there this message hasn't been exported yet. At the bottom of the screen there are several buttons to write and reply messages, to move to the next/previous message/reply and to jump to the other two main windows. Message Header Window ********************* The message header window is the window used to fill in all fields of the message header. The `From', `To' and `Subject' string gadgets are used to fill in the fields of the same name. When you type the nickname of a user in your userlist Spot will automatically replace this by his or her full name and will fill in the destination address for you (in netmail). Next to the `To' gadget is a popup gadget to bring up a list requester with all users from your userlist. In netmail the `Normal', `Hold' and `Crash' radio buttons set the type of the netmail. The `Private' flag will default to on in netmail areas, and to off in echomail areas. When the `Kill/Sent' flag is set a message will be deleted just after exporting it. The `File Attach' gadget allows you to attach a file to your netmail. `Receipt Req' and `Audit Req' can be used to set the two FidoNet flags of the same name, but almost no software supports these. The `Reflow' gadget can be used to switch reflow temporarily off, useful if you just realized the message you have just written needs reflow to be turned off. Spot will remember for each message if you wrote it with reflow on or off, so when you edit it later this checkbox will be set accordingly. In echomail areas the message header window will also contain an `Origin' string gadget (with a popup gadget). This gadget allows you to type in or choose an origin that will be used in the message you are writing. In netmail areas a `BBS' text display will appear, but only if you have a nodelist installed and configured. This gadget will show the name of the destination BBS and of the sysop. The `Edit...' button can be used to jump back to the editor to edit your message further. Useful if you just realized you forgot something. When your boss requires you to use a fakenet and you write a message in a netmail area Spot will provide you with a cycle gadget to set your originating address. The default is to use the full 4D address, but you can select your fakenet address. This may be needed for areafixing for example. When a string gadget is active you can access the keyboard short-cuts by pressing the Right-Amiga key together with the short-cut key. The keyboard shortcut for a popup gadget next to a string gadget (like the one next to the `To' gadget) is Shift-Down when the string gadget is active. Settings Editors **************** General ======= Edit general settings. The `Editor' string gadget allows you to set the editor command that should be executed by Spot to edit a message. Put a `%s' in this command string to specify where Spot should insert the name of the temporary file. Tick the `WB to front' checkbox if you would like Spot to pop the Workbench screen to the front before executing the editor command. This is useful if your editor opens on the Workbench screen. When the `Check date' checkbox is ticked Spot will check the date of the temporary file to see if you have actually changed it. If not Spot will automatically cancel whatever operation called up the editor. Note that this feature can only be used if your editor does *not* run asynchronously. The `Dupe checking' cycle gadget tells Spot what to do with dupes (duplicate messages). If your boss is dupe-free you can disable dupe checking. If not you can select between killing any possible dupes or importing them into the BAD area. Note that there is *no* dupe checking in netmail areas. When the `Keep to you' checkbox is ticked Spot will automatically set the keep flag on all messages it imports that are addressed to you. The `Spot to front' hotkey string is a standard commodity.library hotkey description. Using this hotkey will pop up the Spot screen uniconifying Spot if needed. Default hotkey is Left-Amiga - Right-Amiga - S. Spot has the ability to do transparent message base crunching. This means it can automatically crunch a message before storing it in the message base. This will save quite a bit of room on your harddisk. The only penalty is speed, importing will be somewhat slower since Spot will have to crunch each message it imports. Message base crunching can be configured with the `Crunch buffer' cycle gadget. The larger the speedup buffer the faster the crunching will go. Efficiency is the same for all buffer sizes. The `Areas' path tells Spot where to store the message base files. Each area will consist of 4 files. Normally this is set to a subdirectory of the `MAIL:' directory. The `Inbound' and `Outbound' path should be set to the same path as your in your mailer config. The `Work' path is the drawer used to create temporary files and to unpack mail bundles. Default path is `T:' which is normally in RAM. If you have a nodelist installed and have compiled it with TrapList you can set the `Nodelist' gadget to the nodelist directory. Spot will use this when showing message info, when adding users to the userlist and in the message header window. Leave the path empty to disable nodelist support. The `FAttach' path is the default path the file attach requester will open in. Leave the path empty to disable this. The `Save' path is the default path the save requester will open in. Leave the path empty to use the current directory. The `Log file' is the file Spot will use to log certain actions. Currently only importing is logged. Leave this gadget empty to disable logging. System ====== Edit your system configuration. The easiest field to fill is probably `Name'. Don't use high ASCII in your name, this is not allowed in FidoNet. The `Address' listview shows a list of all your different addresses. Use the `Add...' button to add an address (you will also be prompted for the domain name). The `Delete...' will delete the currently selected address. Note that adding and deleting an address corresponds to adding and deleting a netmail area for this address. The `Fakenet' integer gadget allows you to set the fakenet for the currently selected address. This is only needed if your boss does not support full 4D addressing. Ask your boss what value you should enter here. The `Domain' string gadget display shows the domain name of the currently selected address. The `Domain in MSGID' and `Domain in origin' checkboxes allow you to switch the inclusion of the domain in the ^aMSGID kludge and the origin line on or off. The `BBS Name' gadget allows you to enter the name of the BBS of your boss for the currently selected address. The `Packer' and `Unpacker' gadgets are used to configure the archiver used to pack and unpack your mail bundles. You must of course use the same archiver as your boss. The packer and unpacker commands are executed with a stack of 8000 bytes. If you need more stack space use an AmigaDOS script. The `Pack netmail' checkbox allows you to switch netmail packing on or off. Note that this switch is global, it is either on for all your bosses or off for all your bosses. Check with your boss if his tosser supports this. The `Poll' string gadget is used to set the command to be executed when you want to poll the boss of the currently selected address. The poll command is executed with a stack of 8000 bytes. If you need more stack space use an AmigaDOS script. *Important*: only supply one (1) poll command per boss. So if your boss supplies both FidoNet and AmigaNet leave the poll command of the AmigaNet address empty. Use the `Asynchronous' checkbox to switch asynchronous polling on or off. Useful if you wish to continue to use Spot while waiting for your boss to answer your call. Areas ===== Edit the settings of all areas. The `Areas' listview shows a list of all your current netmail and echo mail areas. The netmail areas are automatically added and deleted from the System window. The `DEFAULT AREA' is the area used as a model for all newly created areas, so configure this area to your favorite settings. The TAB key can be used to activate the string gadget beneath the listview. Here you may give the area any name you want (username). The `Add...' button is used to manually add an area to the list. You will be asked after the net name (or tag name) of the area you wish to add. This name should be the exact FidoNet name of the area. You may rename the area to your liking later. The `Delete...' button deletes an area. All mail in the area will be lost! Use the `Up' and `Down' buttons to move the current area up or down. The `Sort by name' buttons will sort all areas alphabetically. Note that the netmail areas, the BAD area and the DEFAULT area will always stay at the top of the list. The `Keep' cycle gadget is used to set the maintenance setting for this area. You may select to keep all message in an area, delete mail older than a certain amount of days or keep a certain absolute amount of messages in an area. Tick the `Read Only' checkbox for read only areas. You will not be allowed to write in this area by Spot. The `Alias' string gadget can be used to choose an alias Spot should use instead of your name in this area. This can also be useful to use your name with high ASCII in areas that allow this. Use the `Address' cycle gadget to set your address for this area. The `Export to' gadget can be used to export this area to a different address. This allows you to for example pack all FidoNet and AmigaNet mail together in one mail bundle by setting all AmigaNet areas to export to your FidoNet boss (your boss must support this of course). Spot has very extensive character set support. The `Charset' gadget can be used to select a default character set to be used when reading messages. Use the `Write' gadget to select a charset to be used when you write a message in the selected area. Spot will translate to this character set from LATIN-1 (the Amiga's character set). Spot currently supports the following character sets: `LATIN-1' Amiga character set (ISO 8859-1). `IBMPC' IBM PC character set. `SWEDISH' 7-bit Swedish character set. When this character set is set as default, Spot will try to intelligently switch between SWEDISH and DEFAULT for messages without ^aCHARSET or ^aCHRS kludge. `ASCII' 7-bit ASCII, all high ASCII will be converted to 7-bit ASCII by Spot. `DEFAULT' Character set that tries to make the best of a message with high ASCII and no ^aCHARSET or ^aCHRS kludge. It will translate most LATIN-1 and most IBMPC high ascii characters correctly. The `Origin', `Reply' and `Signature' text displays show the current origin, reply and signature. The popup gadget next to the text displays allows you to select these for each area. When selecting an origin you are also given the possibility of picking the origin randomly (from all groups or from a specific origin group). The `Tag Lines' cycle gadget allows you to switch taglines on or off. Choosing `All' will pick a tag line randomly from all groups. You may also set this gadget to a specific group tag lines should be picked from. GUI === Edit interface settings. The `Display mode' gadget allows you to pick a display mode for the Spot screen from the list of all available monitor modes. Spot's screen depth can be set to 4 or 8 colors. Scrolling will of course be slower in 8 colors. Autoscrolling of Spot's screen can also be switched on or off from the screenmode requester. With the `Screen font', `Text font' and `Message font' gadgets you can customize Spot to your liking with your favorite fonts. The screen font is obviously used for the screen, the text font for places where a fixed font is needed (like the import window), and the message font is the font used to display the messages (and related things). The `Palette...' button will bring up a palette requester that allows you to change the screen colors, `Get Workbench palette...' copies the Workbench color palette. Kludge and quote color can be set using the `Kludge color' and `Quote color' palette gadgets. When the `Bold quotes' checkbox is ticked quotes will be printed in bold type. The `Clock' cycle gadget allows you to switch the clock off or select your favorite clock format. Userlist ======== Edit the userlist. Spot maintains a userlist for each domain. Use the `Domain' gadget to select the domain to edit the userlist from. The `Users' listview shows a list of all users in the list. Use `Add' to add a new user to the userlist, `Delete...' to delete a user. The `Up' and `Down' buttons allow you to move users up and down in the list. `Sort by name' will sort all users in the current list alphabetically. Individual user settings can be set using the `Name', `Nickname', `Address' and `Comment' gadgets. The `Nickname' is very useful in the message header window (see Message Header Window). ARexx ===== Edit the ARexx menu items. The `Items' listview shows the current menu items in the ARexx menu. Use `Add' to add a new item to the menu, `Delete...' to delete an item. The `Up' and `Down' buttons allow you to move items up and down in the list. `Sort by name' will sort all items alphabetically. Use the `Name' string gadget to set the text that will appear in the menu. The `Script' string gadget is the actual script that is sent to ARexx. With `Output' you may select an output console different from the default one. ARexx Commands ************** The ARexx port of Spot is called `SPOT'. Spot will check if `REXX:Startup.spot' exists on startup. If it does it will execute this ARexx script. General commands ================ All these commands will return 10 when an error occurred, 5 for a warning and 0 if all went ok. Don't forget the `options results' command in your scripts if you intend to use results passed in the RESULT variable. `beep' Flash the Spot screen. `editareas' Open the areas settings editor (see Areas). `editarexx' Open the ARexx commands editor (see ARexx). `editforward' Open the forward header window (see Forward Header...). `editgeneral' Open the general settings editor (see General). `editgui' Open the GUI settings editor (see GUI). `editorigin' Open the origins editor (see Origins...). `editreply' Open the reply headers editor (see Reply Headers...). `editsignature' Open the signatures editor (see Signatures...). `editsystem' Open the system settings editor (see System). `edittaglines' Open the tag lines editor (see Tag Lines...). `edituserlist' Open the userlist settings editor (see Userlist). `export QUIET/S,CLOSEWIN/S' Export all unexported mail (see Export...). The `QUIET' switch tells Spot to not open a console to report progress on the exporting. With the `CLOSEWIN' switch the console window will be closed immediately after exporting. `filerequest' Open Fido file requester (see File Request...). `getareaname' Returns the name of the current area in RESULT. `getareausername' Returns the username of the current area in RESULT. `getdatearrived' Return the date the current message arrived at your system (or was exported from your system). Return code will be 5 if message has not been exported yet. Date will be returned in the format `day.month.year'. `getdatewritten' Return the date the current message was written. Date will be returned in the format `day.month.year'. `getfrom' Returns the writer of the current message in RESULT. `getfromaddress' Returns the address of the writer of the current message in RESULT. `getmessagenum' Returns the number of the current message in RESULT. Useful in conjunction with `gotomessage' to jump back to this message. `getnumareas' Returns the number of areas in RESULT. `getnummsgs' Returns the number of messages in the current area in RESULT. `getnumselected' Returns the number of selected messages in the message list window in RESULT. `getsubject' Returns the subject of the current message in RESULT. `getto' Returns the addressee of the current message in RESULT. `gettoaddress' Returns the address of the addressee of the current message in RESULT (only in netmail areas, will return 5 otherwise). `iconify NOREQ/S' Iconify Spot (see Iconify). Use the `NOREQ' switch to skip the possible confirmation requester asking you to save the settings. `import QUIET/S,CLOSEWIN/S' Import mail from inbound directory (see Import...). The `QUIET' switch tells Spot to not open a console to report progress on the importing. With the `CLOSEWIN' switch the console window will be closed immediately after importing. `isarealist' `isiconified' `ismessagelist' `ismessages' Test current state of Spot. Command will return 5 if Spot is currently in a different state, 0 otherwise. `lockgui' Lock GUI. Disable all user input. Be sure to match this with an `unlockgui' (use of ARexx `onerror' is strongly recommended)! `maintenance QUIET/S,CLOSEWIN/S,NOREQ/S,KEEPUNREAD/S' Perform a maintenance (see Maintenance...). Use the `NOREQ' switch to skip the confirmation requester and `KEEPUNREAD' to keep unread mail in that case. When the `QUIET' switch is used Spot will not open a console to report progress on the maintenance. With the `CLOSEWIN' switch the console window will be closed immediately after the maintenance. `optimize QUIET/S,CLOSEWIN/S,NOREQ/S' Optimize message base (see Optimize...). Use the `NOREQ' switch to skip the confirmation requester. When the `QUIET' switch is used Spot will not open a console to report progress on the optimizing. With the `CLOSEWIN' switch the console window will be closed immediately after optimizing. `poll NODE/K,NOREQ/S,QUIET/S,WAIT/S' Poll your boss node (see Poll...). The `NOREQ' switch will supress the requester asking you if you want to export (Spot will always export). Use the `QUIET' switch to supress the export console window. Use `WAIT' to override anynchronous polling and to only return when the polling command has completed. The `NODE' keyword allows you to specify a node to poll. You may pass the bbs name or the fido address of your boss. `purgebuffers' Purge all possible buffers, so Spot will use as little memory as possible. `quitspot NOREQ/S' Quit Spot. Use the `NOREQ' switch to skip the possible confirmation requester asking you to save the settings. `savesettings NOREQ/S' Save settings (see Save Settings...). Use the `NOREQ' switch to skip the confirmation requester. `spot2front' Bring Spot screen to the front. `toggleworkbench' Toggle the Workbench screen between open and closed state. `uniconify' Uniconify Spot. `unlockgui' Unlock GUI. Enable all user input again (see `lockgui'). `wb2front' Bring Workbench screen to the front. Move commands ============= All these commands will return 10 when an error occurred, 5 for a warning (not in the correct window for example) and 0 if all went ok. `arealist' Go to the area list window (see Area List Window). `firstarea' Go to the first area. `firstmessage KEEP/S,NOKEEP/S,UNREAD/S,READ/S,UNREPLIED/S,EXPORT/S,NOEXPORT/S' Go to the first message in the current area, or to the first message with a certain flag set. Returns 2 when you are already on the first message with the flag you specify set. `foryouarea' Go to the next area in the area list with unread mail for you left. This command will return 2 when there is no more unread mail for you. `gotoarea NAME/A' Go to a specific area. You may pass the username or the net name of the area. This command will return 2 when the area is not found. `gotomessage TO/N' Go to a specific message (see Goto Message...). If no number is passed the normal number requester will appear. `importedarea' Go to the next area in the area list with unread mail from the last import left. This command will return 2 when there is no more imported mail. `lastmessage' Go to the last message in the current area. Returns 2 when you are already on the last message. `messages' Go to the message window (see Message Window). `messagelist' Go to the message list window (see Message List Window). `nextarea' Go to the next area in the area list. `nextmarked' Go to the next marked message in the current area (see Next Marked). `nextmessage' Go to the next message in the current area. `nextreply' Go to the next message in the reply thread (see Next Reply). `nextunread' Go to the next unread message in the current area. `nextunreplied' Go to the next unreplied message in the current area. `prevarea' Go to the previous area in the area list. `prevmarked' Go to the previous marked message in the current area (see Next Marked). `prevmessage' Go to the previous message in the current area. `prevreply' Go to the previous message in the reply thread (see Previous Reply). `prevunread' Go to the previous unread message in the current area. `prevunreplied' Go to the previous unreplied message in the current area. `unreadarea' Go to the next area in the area list with unread mail left. This command will return 2 when there is no more unread mail. Message commands ================ `adduserlist NOREQ/S' Add writer of current message to the userlist (see Add to Userlist...). When user was already in the list the return code will be 2. Use the `NOREQ' switch to supress the nickname requester or any other requester. `clearflags KEEP/S,UNREAD/S,UNREPLIED/S,EXPORT/S' Clear flags of current message or all selected messages. `crossreply' Cross-reply to the current message (see Cross Reply...). `deletemessage NOREQ/S' Delete the current message or all selected messages (see Delete...). Use the `NOREQ' switch to skip the confirmation requester. `edit TO/K,TOADDR/K,FROM/K,FROMADDR/K,SUBJECT/K,FILE/K,REFLOW/K,NOSIG/S,NOEDIT/S,NOGUI/S,NOREQ/S' Edit the current message (see Edit...). See `write' below for an explanation of the options. The `NOREQ' option will supress the confirmation requester that will appear when the message has been imported or exported already. `editheader' Edit the current message header (see Edit Header...). `exclude STRING/A,CASE/S,FROM/S,TO/S,SUBJECT/S,TEXT/S,UNREAD/S,READ/S,NOGUI/S,NOREQ/S' Exclude specific messages from the message list (see Include-Exclude Window). Use the `NOREQ' switch to supress the requester telling you how many messages have been excluded and the `NOGUI' switch to start excluding without first opening the GUI window. `excludeflag KEEP/S,NOKEEP/S,UNREAD/S,READ/S,UNREPLIED/S,EXPORT/S,NOEXPORT/S,ALL/S' Exclude messages from the message list with specific flags set or not set. When the `ALL' switch is used all messages will be excluded. `forward' Forward the current message to another area (see Forward...). `getmessageflags' Get flags of current message (also works from message list). Result will contain a longword with one or several of the following bits set: Private 1 Crash 2 Unread 4 Export 8 File Attach 16 Kill/Sent 128 Hold 512 Receipt Req 4096 Audit Req 16384 Unreplied 65536 Keep 131072 For You 524288 Marked 2097152 `include STRING/A,CASE/S,FROM/S,TO/S,SUBJECT/S,TEXT/S,UNREAD/S,READ/S,NOGUI/S,NOREQ/S' Include messages in the message list (see Include-Exclude Window). Use the `NOREQ' switch to supress the requester telling you how many messages have been included and the `NOGUI' switch to start including without first opening the GUI window. `includeflag KEEP/S,NOKEEP/S,UNREAD/S,READ/S,UNREPLIED/S,EXPORT/S,NOEXPORT/S,ALL/S' Include messages in the message list with specific flags set or not set. When the `ALL' switch is used all messages will be marked. `matrixreply TO/K,TOADDR/K,FROM/K,FROMADDR/K,SUBJECT/K,ORIGIN/K,FILE/K,REFLOW/K,NOSIG/S,NOEDIT/S,NOGUI/S' Reply to the current message in netmail (see Matrix Reply...). See `write' below for an explanation of the options. `messageinfo' Show information about current message (see Info...). `printmessage' Print current message or all selected messages (see Print...). `reply TO/K,TOADDR/K,FROM/K,FROMADDR/K,SUBJECT/K,ORIGIN/K,FILE/K,REFLOW/K,NOSIG/S,NOEDIT/S,NOGUI/S' Reply to the current message (see Reply...). See `write' below for an explanation of the options. `saveascii TO,OVERWRITE/S,NOHEADER/S,NOTEARLINE/S,NOORIGIN/S' Save current message or all selected messages as ASCII (see Save...). If you don't specify a filename the file requester will appear. The `OVERWRITE' switch will tell Spot to overwrite the file if it already exists, otherwise the message (or messages) will be appended to the file. The `NOHEADER' switch tells Spot not to put the normal header in front of the saved body text. With the `NOTEARLINE' switch Spot will stop saving just before the tearline, with the `NOORIGIN' just before the origin line. `setflags KEEP/S,UNREAD/S,UNREPLIED/S,EXPORT/S' Set flags of current message or all selected messages. `togglekeep' Toggle keep flag of current message (see Toggle Keep Flag). `toggleunreply' Toggle unreplied flag of current message (see Toggle Unreplied Flag). `write TO/K,TOADDR/K,FROM/K,FROMADDR/K,SUBJECT/K,ORIGIN/K,FILE/K,REFLOW/K,NOSIG/S,NOEDIT/S,NOGUI/S' Write a new message in the current area (see Write...). The `TO' and `TOADDR' (netmail only) arguments allow you to specify the addressee. `FROM', `SUBJECT' and `ORIGIN' can be used to use an alias, set a subject and an origin. If really needed you may use the `FROMADDR' switch to set a different address. Use `FILE' to select a file for the body text. Use `REFLOW=ON' or `REFLOW=OFF' to force reflow on or off, otherwise the default reflow setting will be used. `NOSIG' will skip the adding of your signature to the end of the file. `NOEDIT' will skip the editor and `NOGUI' the message header window. Requester commands ================== Note that a string passed to `PROMPT' may contain carriage returns (ASCII 13, '0d'x in ARexx). These will be converted to newlines (ASCII 10) by Spot, so you can use multi-line prompt text. `progressopen TITLE/K/A,PROMPT/K' `progressupdate REQ/N/A,CURRENT/N/A,TOTAL/N/A,PROMPT/K' `progressclose REQ/N/A' These three commands allow you to put up a progress requester. Very useful for scripts which will take a while to execute. `progressopen' will return a number in result. Pass this number to `progressupdate' and `progressclose' (`REQ' argument). `TITLE' is the window title of the progress requester, `PROMPT' is the optional text that will appear below the progress indicator box. This text can be updated with the `progressupdate' command. The `CURRENT' and `TOTAL' arguments must hold the current number of processed items and the total we are working towards. `progressupdate' will return 5 if the user pressed `Stop'. It is your responsability to check this and stop your ARexx script. Note that currently only one progress requester at a time is supported. If you try to put up a second one Spot will silently ignore your request. Your script will continue, but without a progress requester. `requestfile TITLE/K,PATH/K,FILE/K,PATTERN/K' Get a file and path from the user. This command will bring up a file requester on the Spot screen (or on the Workbench screen if Spot is iconified). Using the `PATH' and/or `FILE' keywords it is possible to specify an initial path and/or filename. The `PATTERN' keyword can be used to set a match pattern for files that will appear in the file requester. Use `TITLE' to set the window title of the file requester. `requestnotify PROMPT/A' Notify the user with a requester. Put up a requester with a single `Ok' response to notify the user of something. The prompt text may contain newlines (ASCII code 10), it will be split over several lines in that case. `requestnumber TITLE/K,PROMPT/K,DEFAULT/K/N,INVISIBLE/S' Get a number from the user. Put up a requester to get an integer number from the user. Use `TITLE' to set the window title of the number requester and `PROMPT' to set a prompt text (may contain newlines). A default number to appear in the requester can be set with the `DEFAULT' keyword. The `INVISIBLE' keyword is very useful for asking passwords as the user will not see what he types. `requestpath TITLE/K,PATH/K' Get a path from the user. This command will bring up a directory requester on the Spot screen (or on the Workbench screen if Spot is iconified). Using the `PATH' keyword it is possible to specify an initial path. Use `TITLE' to set the window title of the file requester. The returned path will always end in either `:' or `/'. `requestresponse TITLE/K,PROMPT/A,GADGETS' Let the user choose between two options (Ok and Cancel). Put up a requester with an `Ok' and a `Cancel' response. The prompt text may contain newlines, it will be split over several lines in that case. ARexx return code will be 0 in case the user pressed `Ok', 5 if he or she pressed `Cancel'. The `GADGETS' switch allows you to offer the user several choices. Seperate all possible choices by a `|', for example "Accept|Forget it". The return code from `requestresponse' will be different when `GADGETS' is used! When the requester is cancelled 0 is returned, the leftmost response will return 1, the next one 2, and so on.... `requeststring TITLE/K,PROMPT/K,DEFAULT/K,INVISIBLE/S' Get some text from the user. Put up a requester to get a text string from the user. Use `TITLE' to set the window title of the string requester and `PROMPT' to set a prompt text (may contain newlines). A default string to appear in the requester can be set with the `DEFAULT' keyword. The `INVISIBLE' keyword is very useful for asking passwords as the user will not see what he types. Legal Stuff *********** License ======= This license applies to the product called "Spot", a program for the Amiga computer, published by Nico François under the concepts of ShareWare, and the accompanying documentation, example files and anything else that comes with the original distribution. The terms "Program" and "Spot" below, refer to this product. The licensee is addressed as "you". * You may copy and distribute verbatim copies of the program's executable code and documentation as you receive it, in any medium, provided that you conspicuously and appropriately publish only the original, unmodified program, with all copyright notices and disclaimers of warranty intact and including all the accompanying documentation, example files and anything else that came with the original. * You may not copy and/or distribute this program without the accompanying documentation and other additional files that came with the original. You may not copy and/or distribute modified versions of this program. * You may not copy, modify, sublicense, distribute or transfer the program except as expressly provided under this license. Any attempt otherwise to copy, modify, sublicense, distribute or transfer the program is void, and will automatically terminate your rights to use the program under this license. However, parties who have received copies, or rights to use copies, from you under this license will not have their licenses terminated so long as such parties remain in full compliance. * By copying, distributing and/or using the program you indicate your acceptance of this license to do so, and all its terms and conditions. * Each time you redistribute the program, the recipient automatically receives a license from the original licensor to copy, distribute and/or use the program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. * You may not disassemble, decompile, re-source or otherwise reverse engineer the program. * You may use the programs for a period of up to 30 days for evaluation. After that, you have to register. * If you wish to incorporate parts of the programs into other programs, write to the author to ask for permission. * You agree to cease distributing the program and data involved if requested to do so by the author. * You may charge a fee to recover distribution costs. The fee for diskette distribution may not be more than the cost to obtain a public domain diskette from Fred Fish. No Warranty =========== THERE IS NO WARRANTY FOR THE PROGRAMS, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAMS "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAMS IS WITH YOU. SHOULD THE PROGRAMS PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAMS AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAMS (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAMS TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Disclaimer ========== No warranty, either express or implied, is made with respect to the fitness or merchantability of Spot. Nico François (referred to as "the author"), reserves the right to not develop any future versions of Spot. The author will try to make a good faith attempt at correcting any problems if any are discovered, but is in no way required, nor bound to correct them. The author neither assumes nor accepts any responsibility for the use or misuse of these programs. He will also not be held liable for damages or any compensation beyond the original registration fee due to loss of profit or any other damages arising out of the use, or inability to use this program. The author will not be liable for any damage arising from the failure of this program to perform as described, or any destruction of other programs or data residing on a system attempting to run the programs. The user of this program uses it at his or her own risk. How To Register *************** 1. Print out the "Spot Software Registration Form". The registration form can be found in the Spot distribution archive as `Registration.form'). You can use the `Print_Registration_Form' icon to print it out easily. 2. Please print or write LEGIBLY... a. Fill in your name and mailing address. b. Your fidonet address (not required, if present you will be automatically notified when your copy is shipping). c. Your private voice telephone number (not compulsory). If possible, use the form "+32-(16)-123456", where 32 is the country code and 16 is the area code. 3. Tick... a. Decide how to transfer the money. Cash (at your own risk), a postal money order, a wire bank transfer or a EuroCheck (only in BEF!) are suggested. Foreign checks are *NOT* accepted! b. Decide what way you would like to get keyfile. 4. Send the registration form to a Spot registration site, currently AUGFl. __ / / Amiga Users ______ __ __ ______ ______ / / Group Flanders vzw. / __ // / / / / __ // ____// / Laukensstraat 16 / __ // /_/ / / /_/ // __/ / /_ B-3210 Lubbeek - Belgium /_/ /_//_____/ _\\__ //_/ /___/ FidoNet: 2:292/603 /_____/ Bank account: 001-2371807-39 ASLK, Gebroeders Van Tiltstraat 2, B-3220 Holsbeek - Belgium 5. Wait for your key to be delivered. Thank you for registering! You should receive your key within 8 days after the arrival of your registration fee. But please allow up to eight weeks for delivery, due to unforseen circumstances. Acknowledgements **************** The following names are either trademarks or the efforts of the person and/or company listed: * Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc. * ARexx by William S. Hawes, Wishful Thinking Development Corp. * Fido and FidoNet are trademarks of Tom Jennings, Fido Software. * TrapDoor is a registered trademark of Maximilian Hantsch and Martin Laubach. * TrapList and traplist.library by Maximilian Hantsch and Martin Laubach. A special thank you to the following people for alpha and beta testing (in random order): Marc Duponcheel, Alex Van Boxel, Lieven Lema, Peter Stuer, Wim Peeters, Wim Van Goethem, Johan Van Houtven, François Helsen, Tom De Mulder, Bart Van Assche, Rudi Bracke, Olivier Toebosch, Marc Van Heucke, David Nouls, Herman Stevens, Jan Stevens, Christophe De Vocht, Tom Maes, Roger Nordin, Stefan Johannesdal, Per-Anders Josefsson, Johan Billing, Pontus Hagland, Nikolai Waldman, Roger Andersson, Mathias Korsbäck, Magnus Holmgren, Stefan Zeiger and Maurizio Fabiani. Spot was translated by the following people: Peter Stuer (Dutch translation), Lieven Lema (French translation), Roger Nordin (Swedish translation), Stefan Zeiger (German translation), Maurizio Fabiani (Italian translation), Michael Berg (Danish translation) and Pedro Aguiar (Portugues translation). Spot's icon was created by Johan De Roover. License agreement and legal mumbo jumbo largely stolen from TrapDoor manual. Program History *************** Version 1.0 =========== First release. Version 1.1 =========== Bug fix: excluding messages from the message list did not update number of selected messages in title bar correctly. Bug fix: jumping to another area from the message list did not mark the current message in the new area. Current message number in message window is now enclosed in square brackets. When pressing HELP the guide file is now shown asynchronously. This allows you to continue to use Spot while browsing through the guide file. When creating a new address in the System window the packer and unpacker string of the current address are automatically copied to the new address. The `Show Kludges' menu item now has a keyboard short-cut (Right-Amiga ^). No longer opens and closes the backdrop window when switching between area list, message list and message window. This improves performance. When forwarding a message it will no longer be reflowed to 76 characters. The reflowing will only occur if you actually use the `Edit...' button, otherwise the message is forwarded exactly as it is. Danish catalog and install script included. Thanks to Michael Berg for the translation. Added automatic reflow-disabling for PGP messages. Spot will no longer attempt to reflow the text between `----BEGIN PGP' and `----END PGP'. Nifty new feature: manual reflow disabling. Spot will switch reflowing off (or back on) when it encounters a `\reflow' followed by a newline. Simply surround the text you do not want to reflow with `\reflow'. The `\reflow' lines will be automatically removed from the message. Bug fix: changing the resolution or the message font from the area list could cause some enforcer hits and a corrupt display. Bug fix: empty packets (zero length) could cause Spot to crash. Spot now ignores all empty packets and bundles. All file requesters should now properly fall back to the text font when a proportional screen font is used. Writing a message to yourself will now properly set the `for you' flag. Can be useful when writing messages from ARexx scripts. Spot no longer uses `ExamineFH()', but uses `Examine()' instead. At least one person was having problems with `Couldn't examine packet!' errors. This should fix that. Fixed double short-cut in `Userlist...' window. Including from the message list will now only search items that are not included yet. Exclude will only look at selected items. Note that the count that is reported now corresponds to the actual number of items that were included or excluded. Tweaked dupe checking to handle mail that may bounce back from your boss. Bug fix: `include', `exclude', `setflags', `clearflags', `includeflag' and `excludeflag' could cause problems when used in empty areas. Quirk fix: memory usage for userlist was much too high. Eliminated more than 400 bytes of overhead per user. Deleting the last message (not the final) in an area will cause Spot's screen to flash. Useful when deleting several messages with Shift Delete. When returning to the area list Spot will now make sure the current area is visible. Bug fix: editing a imported or exported message no longer incorrectly sets the export flag for the current area. Bug fix: if after using `Exclude...' no messages were selected, the buttons that needed to be ghosted were not always immediately ghosted. Bug fix: when writing a message from ARexx with the NOGUI option Spot would not pick a random origin if needed. Bug fix: exporting from the message list window failed to update the message list. New `FROMADDR' switch for `write', `edit', `reply' and `matrixreply' ARexx commands. Enhanced the PGP ARexx scripts. The subject will now also be hidden when a message is encrypted. Decrypted messages will be put in the message base in place of the encrypted message. The from address is now also correct. ARexx commands `firstmessage' and `lastmessage' now return 2 when you already are on the first or last message. Alt with the up and down cursor keys in the message list can now be used to move the current message around. Use Shift to page, Control to jump to the start or end. ARexx commands `firstmessage', `lastmessage', `nextmessage', `prevmessage', `gotomessage' and `getmessagenum' now also work from the message list. When `lockgui' is used the scroller gadget will now be ghosted. New ARexx command: `getmessageflags'. After using `Include...' Spot will now make sure the first marked message is visible. Bug fix: initials for names with trailing spaces were incorrect. Screen mode requester in GUI window will now allow you to open Spot's screen in 4 or in 8 colors. Autoscrolling for the screen can be switched on or off. `requestresponse' now has an additional `GADGETS' switch. This allows you to offer the user several choices. Note that the return code from `requestresponse' will be totally different when `GADGETS' is used! This had to be done for backwards compatibility. Fixed small problem of 'Ö' not being recognized as an alphabetic character. You may now change the domain name of an address (in the system window). Added support for fakenets. Quite a few people complained about this. Silly me thinking fakenets where so stoneage Spot should not support them :-) Minor bug fix: when no log file was used Spot failed to report in the import window how many messages were received for you. Layout engine improved to handle expanding listviews. This improves the look of the areas editor window with certain font settings. Made list requester fully resizable. When you save the settings the size of the list requester will also be saved. Spot will remember the size for the areas list requester, the user list requester, the poll list requester and all text list requesters separately. Made Fido file requester window fully resizeable as well. Last size will be saved as default when you save the settings. Fido file requester will now automatically set the node to the boss of the current message writer if called from the message window. In the message list the node will be set to your boss node for the current area. Added text gadget to Fido file requester to show the current node's name and sysop. Only available if you have a nodelist installed of course. During import the size in kilobytes of a packet is now printed to the import console. When multi-bossing Spot will add a popup gadget next to the node gadget in the Fido file requester. This gadget will pop up a list of your bosses, so you can easily select one of these to freq from. Added safety requester to the message header window `Cancel' button. Some people seemed to hit 'the wrong key' a bit too often ;) Portugues catalog included. Thanks to Pedro Aguiar for the translation. Spot will flash the screen when you use `Unread' in the message list window and there are no unread messages in the current area. Three new ARexx commands: `progressopen', `progressupdate' and `progressclose'. Allow you to put up a progress requester with optional text. Had some reports of Spot giving automatically created areas incorrect an incorrect address (0:292/603.10 instead of 2:292/603.10 for example). This problem is most probably caused by a buggy tosser. I changed Spot anyway to sniff this problem out and to fix this on the fly. Bug fix: the `edit' ARexx command with the FILE switch caused the message's kludges and origin/tear line to disappear. Bug fix: Spot will no longer allow you to enter area names with a `*' or `"' in them. This would lead to an invalid areas file otherwise. Added new switch in `Settings' menu: `IBMPC CodePage 865'. Checking this item will cause Spot to use the IBM PC codepage 865 font instead of codepage 850. Requested by several Danish Spot users. Changed format of `.spf' file. Spot will still read the old format but will only write the new format. This is done to eliminate the need to re-open the file when messages are deleted or added. Should also fix the `Fatal Error In Area' error some people were occasionally getting. Bug fix: a changed signature, reply text or origin of an area would not be saved correctly when you used the `Save' button in the quit requester. Only happened if you only changed area settings and no other ones (phew... :-). New ARexx command: `getnumselected'. Returns the number of selected messages in the message list window. Bug fix: writing in the 'ASCII' charset could cause problems with corrupt packets when you used high ascii. When you are reading messages the screen title will now show the number of unread messages next to the number of total messages in the current area. Bug fix: Spot would sometimes open its screen with the wrong screen font after being iconified. Bug fix: if Spot could not find its icon it would give an error when you tried to iconify it. Spot will use the default tool icon in iconified state now in this case. ARexx command `saveascii' has three new switches: `NOHEADER', `NOTEARLINE' and `NOORIGIN'. ARexx command `poll' now accepts the following arguments: `NODE', `NOREQ', `QUIET' and `WAIT'. Keyboard shortcut for popup gadgets next to string gadgets added: Shift Down when string gadget is active. New ARexx commands: `getdatewritten' and `getdatearrived'. Maintenance now has the possibility to keep unread mail, instead of deleting it. The `maintenance' ARexx command has a new `KEEPUNREAD' switch to make it possible to use this feature from ARexx. Release 26.7.93 Bug fix: after putting Spot in 8 colors, changing the palette and saving the settings Spot would fail to start up again (`Couldn't open screen!' error). Three new tooltypes: `ICONXPOS', `ICONYPOS' and `ICONNAME'. Spot's palette handling is now fully AGA aware. Note that the current ReqTools palette requester does not support AGA yet (but that will change :-). Getting the palette from your Workbench works in full 24-bit resolution now. Author Info *********** Nico François Corbielaan 13 B-3060 Bertem Belgium Internet: nico@pandora.augfl.be FidoNet : 2:292/603.10 AmigaNet: 39:120/102.10 "And the lake sings, And the dogs don't, They are quiet for Adda Lee" - Frank Black