Mailtext 2.1 (10.11.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 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 3.6 * 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 ************* 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::) and MCCHeader.c *Klaus 'kmel' Melchior* for the help with MUI customclasses and MCCHeader.c *Kai Hofmann* for the great MCC-Install installer script. *Matthias Scheler* for the bugreports and for immediately using Mailtext in IntuiNews, a great newsreader for the Universal Message System (UMS) *Andreas Baum* for inspirations and bughunting! *Frank Duerring* for the Oberon interfaces *Ole Friis* for the danish catalog translation and the bugreports *Peter Eriksson, Francis Labrie, Marcin Orlowski, Paolo Menichetti and Petter E. Stokke* for the translations into swedish, french, polish, italian and norwegian. *all registered Mailtext-Developers,* currently Bodo Schulz, Jason Weber, Jerome Fleury, Johnny Tevessen, Magnus Heino, Marcel Beck, Mathias Mischler, Michael Leun, Petter E. Stokke, Robin Vermaat, Timo Jakob, Troels Walsted Hansen, for their interest in this package. *all the other Mailtext betatesters* History ******* *MCC Mailtext v2.1 (10.11.96)* Mailtext.mcc v17.58, Mailtext.mcp v17.40 * when attribute parsing has been disabled (by matching the disable pattern), no text was copied at all, resulting in i.e. lost signatures. * now using MCC-Install 43.4 * compiled with SAS/C 6.57 * polish catalog, thanks to Marcin Orlowski *MCC Mailtext v2.0 (2.11.96)* Mailtext.mcc v17.41, Mailtext.mcp v17.28 * ported Mailtext from Modula-2 to C: - Mailtext now completely complies with the guidelines for MUI Custom Classes - now needs MUI 3.6, support for older MUI versions has been dropped. - the classes are app. 50% smaller. - compiled with SAS/C 6.56. * API did *not* change. No need to request a new developer package. *MCC Mailtext 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.