------------------------------------------------------------------------------ TransAmiga Mailreader 1.0 ------------------------------------------------------------------------------ 4/96 Helmut Steeg 1. Contents ----------- 1. Contents 2. Legal Stuff 3. Why should I install that crap? 4. Installation 5. Personalize the Mailreader 6. Author 7. known bugs 8. Thanks, Acknowledgements 2. Legal Stuff -------------- I take no warranty for any damage, which is caused by using of this program. If you use the mailreader, you do this at your own risk. (It never caused any incidents, crashes or reboots, btw *grin*) You are free to copy, up- or download the archive to any place you want. The program is mailware, this means if you use this program, send me Net- or email to any of the adresses in paragraph 6. There are no other obligations for the program, but i'm glad about anything, that arrives here. *grin* If you are not able to accept this points, delete the archive or the files. 3. Why should I install that crap? ---------------------------------- The mailreader is a little script for TransAmiga, which takes Messages directly from the MailManager. It does not care about the format of the Messagebase, as this is a thing, which takes MailManager care of. If you use this program, you have some advantages, but also some dis- advantages. The advantages are: - You do not have to use plain or indexed Messagebases in MM anymore. The handling of the single Messages is done all by MM. - rescanning of areas by MM is not necessary anymore, if a user writes a message in Transamiga. the reason is the same as above.. :-) - You need in TransAmiga only one Messagearea, which has to be known by MM. This area is used for Feedback to the Sysop, should have a high level in MM, so that it can't be exported to every downlink you have (if you are a node) - You have a nice, little graphical userinterface for reading messages :-) Here are some disadvantages: - When MM is im- or exporting Messages, you have to forbid the use of the mailreader (it simply hangs, as soon as it checks the Rexx-Port of MM. And it does that very early.). So, while MM is busy, make sure, that noone is in the messages. - MM has to run all the time. (it does that on my system, so it's not a disadvantage to me, but to be honest, i don't know the setup of your system, so it may be a disadvantage to you.) 4. Installation --------------- - decrunch the archive into RAM: or wherever you want. - copy the scropt 'TA_MAILREADER.TRANS' to BBS:REXX/ - copy the language-definition files to BBS:Configs/ - copy the directory mailreader to DOORS: or BBS:Extras/ - add the following line in BBS:Configs/Message.rx U Mailreader 0 -------- TA_Mailreader.trans - check the path-definitions in the script and make sure, everything is in place. (see paragraph 5) - change your menues :-) 5. Personalize the Mailreader ----------------------------- You can change some default-pathes in the script. They are: textpath="DOORS:Mailreader/text/" the mailreader searches in the given directory for any textfiles, which is loaded. (Set the variable to the directory, where you placed the directory mailreader) savepath="DOORS:MailReader/User/" In this path will be the settings of the users searched for (or saved, when the mailreader is ended) AREADEF="DOORS:MailReader/Area-Definitions" In this file are the areas, in which you can use an aliasname. languagedef="BBS:Configs/MailReader.LANG" this is the filename of the language-definitions. If you want to use the english language, place the name of the english file here. langlist.* This variable contains the names of the directories, where the Textfiles are stored. !! WARNING: this variable is not used for user-interaction at the moment. It is used for textfiles, so it's better, to keep it at the moment, as they are set. !! userlanguage=2 This variable sets the predefined language for the user. The settings use the names defined in langlist. German Sysops leave it as it is, english sysops set it to 3 for best results :-) defaultarea="AMIGA" This is the default area, in which the mailreader will start at the first login. The mailreader saves the area, in which the user is, when he quits, so it will start in this area again. defaultsort=0 This variable is not used at the moment, but is already there for the next version. It will be used for sorting the messages in a later version. It can be sort by date, subject and author. defaultgui=0 You can activate the graphical userinterface by default, if you set this to 1. When this variable is 0, it will start in ASCII-Mode, else the GUI will be used. if the user has ANSI disabled, it will fallback to ASCII canwritenm=0 Set this variable to 1, if you want the user be able to have access to the netmailarea(s). Be careful with this, as there is (right now) no check for areafix-messages or a namecheck. Set this to 0, when you want the user to have absolutely NO access to the netmails. userlevel=1 This is the userlevel for the areas of MM. You can give it the same access as your downlinks or a higher or anything else :-) aliasuse=0 Aliasuse defines, if a user can write msgs with his aliasname. The Variable will be set by the script, when the current areatag is found in the file in AREADEF. If not, it will be set to 0. Change it results in nothing :-) 6. Auhtor --------- Yes, that's me :-) If you want to send me a flame, a bugreport, an idea or something else, mail it to one of the addresses below. Fido: 2:246/2010.0 TrekNet: 37:107/330.0 AmigaNet: 39:173/210.10 VNet: 46:9497/600.0 ShortNet: 500:557/0.0 Internet: Helmut.Steeg@tuebingen.netsurf.de 7. known bugs ------------- There is ONE Bug, which occurs only in ASCII-Mode. If an user in ASCII-mode gives a not-existing message-number, MM opens a requester with a error-message. This results in a deadlock for the user. you can prevent this error by iconifying MM, or clicking the OK-Gadget in the requester. 8. Thanks, Acknowledgements --------------------------- - Sami Radwan for TransAmiga - Pino Aliberti for MailManager - my mother for me ;-)