Mailtext 1.0 (05-Jun-96) by Olaf Peters A MUI customclass package especially for displaying mail messages. *NOTE*: Mailtext is GiftWare, if you use it regularly you have to send a gift of your choice to the *Note Author::. Overview ******** What is Mailtext? Mailtext is a Custom Class for the Magic User Interface (MUI) by Stefan Stuntz. It is meant as a replacement for MUI's Floattext-Class when displaying electronic messages (eMail, News). In e-messages, you will often find words enclosed i.e. by '*' oder '_' like this: *bold*, _underlined_. By using Mailtext instead of MUI's Floattext-Class the text enclosed by these attributecharacters will be printed with the appropriated textstyle, so * *text* will be printed boldface * /text/ will be printed italics * _text_ will be underlined * #text# will be printed in another color. The processing of attributecharacters will be disabled if Mailtext recognises uuencoded files, signatures, PGP-Signatures, -Keys and -Messages. Mailtext may also highlight quoted textpassages, in the following example, the line starting with '>' will be printed in another color: > This is a quote. This is normal text If you are using MUI v3.3 or above, most features of Mailtext may be configured to fit your needs. See *Note Configuration:: for details. Copyright ********* Mailtext is copyright (C) 1996 by Olaf Peters. Permission is granted to make and distribute verbatim copies of this package provided the copyright notice and this permission notice are preserved on all copies. Mailtext is distributed as GiftWare, so if you use it regularly i.e. for reading your email and newsmessages in a newsreader that uses Mailtext, you should consider to send a small donation to the *Note Author:: in order to honor the work that has been put into this package. None of the programs nor the source code (or parts of it) may be included or used in commercial programs (including Shareware) unless by written agreement with the author, Olaf Peters. *No Warranty* No Warranty of any kind is given that the programs described in this document is 100% reliable. You are using this material at your own risk. The author *cannot* be made responsible for any damage which is caused by using these programs. *Distribution:* This package is freely distributable. It may be transfered to one of any medium used for distributing free software. This includes public domain series, CD-ROMs, FTP servers and mailboxes. There is no limit to the fee taken for these media like disks, streamer tapes, CDROMs or for copying. It must only be clear that this fee is taken to cover the costs for media and copying - not for the software. Limitations to the fee have proved to be senseless in past because the fee was not lowered but the files were removed from the original medias. If you want to distribute this program you *must* use the original distribution archive. Don't blame me for any inconveniences caused by modified distribution archives. Although the author does not restrict the costs of distribution he wants to tell his opinion about this topic: * This software package should be available for everybody free of any fee where possible. * If you purchased this software the normal way from a Public domain distributor on a disk and you have payed more than 5,-DM or US $5,- for it you have definitely overpayed. You should look for a cheaper source of Public-Domain software as soon as possible. *Limitations of Usage:* *None* of the programs *nor* the source code (or parts of it) may be used on any machine which is used on research, development, construction, testing or production of weapons or other military applications. This also includes any machine which is used for training persons for *any* of the above mentioned purposes. Author ====== Send gifts, bugreports, featurerequest etc. pp. here: * SnailMail: Olaf Peters Kulmer Str. 7 28237 Bremen Germany * E-Mail: op@hb2.maus.de (no mail larger than 16 KB, please!) olf@informatik.uni-bremen.de (send large mail to this address!) * Voice: +49 421 6918020 * WorldWideWeb: http://www.informatik.uni-bremen.de/~olf/ http://www.biba.uni-bremen.de/users/olf/ Installation ************ What you need to use the Mailtext package: * a minimum of Kickstart and Workbench 2.04 * a minimum of MUI 2.3, although MUI 3.3 or above is recommended for the use of the preferences plugin Mailtext.mcp * Crawling.mcc by Klaus Melchior for Mailtext.mcp (this is optional, Mailtext.mcp will also work without). For installation you should use the supplied installer script which will setup all you need to use the Mailtext package. Configuration ************* If you are using MUI 3.3 or above, most features of Mailtext may be configured to fit your needs using the supplied Mailtext.mcp, a plugin module for the MUI Preferences system. The plugin makes use of MUIs Bubblehelp system, so I will not explain the features here, just one note: An important thing to know when configuring Mailtext are what is meant with "introducing char" and "terminating char", so please have a look at the following example (let + be an attributecharacter '*', '/', '_' or '#'): +Text+ ^ ^ | | | +- the terminating char | +- the introducing char With this is mind, it should be pretty easy to configure Mailtext to your needs. Developers ********** If you consider using Mailtext in one of your own programs, please have a look at the *Note Copyright:: first. You are really welcome to use Mailtext in your own projects, but the needed headerfiles for C, Oberon and Modula-2 are *only* available on request, as I would like to know which applications are using the class. For requesting the developer package, have a look at *Note Author:: to find out about ways to contact me. Thanks ****** The author would like to thank the following people: *Stefan Stuntz* for that wonderful environment called "Magic User Interface" (*Note MUI::) *Matthias Scheler* for the bugreports and for using Mailtext in IntuiNews, a great newsreader for the Universal Message System (UMS) *Andreas Baum* for inspirations and bughunting! *Klaus 'kmel' Melchior* for the help with MUI customclasses *Frank Duerring* for the Oberon interfaces *Kai Hofmann* for the great MCC-Install installer script. *Ole Friis* for the danish catalog translation and the bugreports *Peter Eriksson, Francis Labrie, Paolo Menichetti and Petter E. Stokke* for the translations into swedish, french, italian and norwegian. *all the other Mailtext betatesters* History ******* *v1.0 (05.06.96)* Mailtext.mcc v10.196, Mailtext.mcp v14.2 * first public release. Future ****** Currently no features are on my ToDo list for Mailtext. Feel free to contact me, if you would like something to be implemented. MUI *** This application uses MUI - MagicUserInterface (c) Copyright 1993-96 by Stefan Stuntz MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called "muiXXusr.lha" (XX means the latest version number) on your local bulletin boards or on public domain disks. If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY Concept index ************* * Menu: * Address: Author. * Author: Author. * Bugreports: Author. * Configuration: Configuration. * Copyright: Copyright. * Developers: Developers. * eMail: Author. * Future: Future. * History: History. * Installation: Installation. * MagicUserInterface: MUI. * Mail: Author. * MUI: MUI. * Overview: Overview. * Requirements: Installation. * Revision history: History. * Thanks: Thanks. * WorldWideWeb: Author. * WWW: Author.