@DATABASE "Time_mcc.guide" @REMARK Copyright © 1996 Kai Hofmann. All rights reserved. @INDEX "Index" @wordwrap @rem -------------------------------------------------------------------------- @Node Main "Time.mcc" Table of Contents @{" Copyright " link Copyright } - Copyright information @{" Distribution " link Distribution } - Copying conditions @{" Disclaimer " link Disclaimer } - Legal Information @{" Trademark " link Trademark } - Trademark information @{" Support/Updates " link Updates } - How to get updates and support @{" Author " link Author } - How to reach the author @{" Description " link Description } - What is Time.mcc? @{" Requirements " link Requirements } - Requirements for using Time.mcc @{" Installation " link Installation } - How to install Time.mcc @{" Developer Info " link Developer } - Information for developers @{" History " link History } - Revision history of Time.mcc @{" Known problems " link Problems } - List of known problems @{" Acknowledgments " link Acknowledgments} - Acknowledgments @{" Subclasses " link Subclasses } - Subclasses build on Time.mcc @{" Index " link Index } - Alphabetical index If you have AmigaDOS 2.0 or 2.1, you will have to scroll to the right in order to read the text. AmigaGuide for these versions of AmigaDOS is unable to wordwrap the text. @endnode @rem -------------------------------------------------------------------------- @node Copyright "Copyright" Copyright --------- This software and its documentation are copyright 1996 by Kai Hofmann. All rights reserved! - Permission for COMMERCIAL USE is only given by an extra available commercial license that must be validated! Contact me directly for this license, because it will be individually handed out per your needs! - Permission is hereby granted, without written agreement and without license, to USE this software and its documentation for any NON-COMMERCIAL purpose, provided that the above copyright notice and the following paragraph appear in all copies of this software (Non-commercial includes Giftware!). Please send me a full version of your product at no cost including free updates! Extra money is welcome (For Bank Account see @{"author" link Author} - but *ONLY* send in DM to this Bank Account!). @endnode @rem -------------------------------------------------------------------------- @node Distribution "Distribution" Distribution ------------ Permission is hereby granted, without written agreement and without license or royalty fees, to copy and distribute this software and its documentation for any purpose, provided that the above copyright notice and the following paragraphs appear in all copies of this software, to: - All who will distribute this software for free! - All free accessible INTERNET servers! - All Aminet® sites - Fred Fish for his great Amiga-Software-Library - The German SAAR AG PD-Library - Angela Schmidt's Meeting Pearls serie - All Simtel® sites and CD-ROMs - All others who do NOT take more than US$ 5.- for one disk that includes this software! IMPORTANT NOTE: This package may not be included on any further Aminet CD-ROMs unless authors contributing their software to the CD-ROM, (without mentioning distribution "NoCD") are granted a copy of the CD *completely* *free* *of* *charge*. The Meeting Pearls IV CD-ROM demonstrates that a Freebie policy is also possible with "very-low-budget" CD-ROMs (*), so Aminet should quickly re-establish the same Freebie policy it used up to Aminet CD 13. (*) Suggested retail price for MP4 is DM 14,95/US$ 12/£ 8.95. @endnode @rem -------------------------------------------------------------------------- @node Disclaimer "Disclaimer" DISCLAIMER ---------- THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "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 PROGRAM IS WITH YOU. SHOULD THE PROGRAM 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 PROGRAM 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 PROGRAM (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 PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE AUTHOR HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. @endnode @rem -------------------------------------------------------------------------- @node Trademark "Trademark" Trademark --------- DateLib is a trademark of Kai Hofmann Amiga, AmigaDOS, AmigaGuide and Workbench are registered trademarks of Amiga Technologies GmbH. Aminet is a registered trademark of Stefan Ossowskis Schatztruhe GmbH SAS/C is a registered trademark of SAS Institute Inc. All other trademarked names used herein are used for the purposes of identification and for the benefit of the trademark holder. No infringement of trademarks is intended. Trademarks remain the property of the trademark holder. @endnode @rem -------------------------------------------------------------------------- @node Updates "Support/Updates" Support/Updates --------------- - Updates will be available via Aminet® - Support will be available via the @{"authors" link Author} email address and via http://www.informatik.uni-bremen.de/~i07m/Time.html @endnode @rem -------------------------------------------------------------------------- @node Author "Author" Author ------ Kai Hofmann Arberger Heerstraße 92 28307 Bremen Germany Phone: (+49)-(0)421/480780 EMail: i07m@zfn.uni-bremen.de i07m@informatik.uni-bremen.de IRC : PowerStat@#AmigaGer WWW : http://www.informatik.uni-bremen.de/~i07m/ @endnode @rem -------------------------------------------------------------------------- @node Description "Description" Description ----------- Time is an abstract Custom Class of the @{"Magic User Interface" link MUIReadMe} © by Stefan Stuntz. It's a subclass of notify-class and only usable for developers who want to build subclasses of Time.mcc! The idea of this class was born during developing my Gregor application. Time.mcc allows an easy handling of time. It lets the developer specify a range within which the time must fall and it handles different time zones. @endnode @rem -------------------------------------------------------------------------- @node Requirements "Requirements" Requirements ------------ - @{"MUI" link MUIReadMe} 3.1+ (Version 12) - date.library 33.225+ - To use the Greek MCC-Install script you need the "Greek Workbench" © AC Software @endnode @rem -------------------------------------------------------------------------- @node Installation "Installation" Installation ------------ Please only install Time.mcc when you are a developer! Use the installer script! (The Installer must be in your system-path!) If you use an Installer prior to V42 you should set the LANGUAGE Tooltype to your language. Installer V42 and better automatically use your current locale. Please note that the installer-script is very special, because: - It features uninstallation - It is automated - It is very flexible - It is very intelligent (for an installer-script ;-) - It uses @{"WrapGuide" link WrapGuide} (if present) for the AmigaGuide® documentation if running under a pre V39 system. - It can be reused by (hopefully) all other MUI custom classes, because the authors of custom classes need to only change a few things: * The #copyright variable * The #min_mui_version and #min_mui_revision variables * The #language_mcc and #language_mcp variables * The P_CustomExists, P_CustomInstall and P_CustomUninstall procedures * The 'APPNAME' tooltype within the MCC-Install icon. @endnode @rem -------------------------------------------------------------------------- @node Developer "Developer Informations" Information for Developers -------------------------- There is no multiple inheritance for Boopsi/MUI for the moment, so we haven't any chance to create a real Time basis-class. But there is another way to have the same result (compatibility for all classes that are dealing with time). The solution is called interface inheritance like it was done with IDL for CORBA. Interface inheritance has some advantages and some disadvantages. The advantages are: - (Pseudo) multiple inheritance - The same interface for all classes dealing with Time The disadvantages are: - Every one who wants to subclass Time.mcc must include the code for Time.mcc in the new subclass. But this can be easier done by using the DateLib and/or the Amiga-OS support functions. Btw. the same happens for IDL, but by using C++ it is possible to inherite the implementation. A future release of Time.mcc will include a full skeleton C code, so that everyone can start his subclasses on this. Please note, that you can not compile Time.mcc! This is because I don't want to distribute the folowing files at the moment: date.h, datetime.h, datesys.h, date_pragmas.h These files are part of my DateLib (TM) project. A new release will be available in 1997. Please note that the supplied source is version 12.0! Btw. it would be wise to use a SetAttrs(obj, MUIA_Time_Hour, hour, MUIA_Time_Min, min, MUIA_Time_Sec, sec, TAG_DONE ); instead of single set()'s. @endnode @rem -------------------------------------------------------------------------- @node History "History" History ------- 10.02.1997 - First release on Aminet @endnode @rem -------------------------------------------------------------------------- @node Problems "Known problems" Known problems -------------- - There is a program called 'PhoneCost' written by André Schenk which installs another 'date.library' into 'Libs:'. The author was asked to move his 'date.library' to 'PROGDIR:Libs/' like it is requested by the Amiga developer references or else rename the library to phonecost.library. André Schenk never responds to emails regarding this problem! His 'date.library' is *not* documented and there is *no* interface available. Also, his library is only specific to his application. 'date.library' is a general name and so it must fullfill general needs like the original 'DateLib (TM) © 1994-1996 Kai Hofmann' did! @endnode @rem -------------------------------------------------------------------------- @node Acknowledgments "Acknowledgments" Acknowledgments are going to the following people: Rita Reichl : for correcting my English and being my inspiration Stefan Stuntz : for the Magic User Interface and for his support Klaus Melchior : for the MUI custom class support Martin Huttenloher : for MagicWB Udo Schuermann : for WrapGuide Stefan Kost : for ag2txt Eric Gerard : for his great icons @endnode @rem -------------------------------------------------------------------------- @node Subclasses "Subclasses" Subclasses ---------- The following classes are build on Time.mcc: TimeString.mcc : By Kai Hofmann http://www.informatik.uni-bremen.de/~i07m/TimeString.html Aminet:dev/mui/MCC_TimeString.lha @next Index @endnode @rem -------------------------------------------------------------------------- @node MUIReadMe "MUI" This is a custom class of the MUI - MagicUserInterface (c) Copyright 1993/94 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 @endnode @rem -------------------------------------------------------------------------- @node WrapGuide "WrapGuide" WrapGuide is Copyright 1994-1995 Udo Schuermann All rights reserved @endnode @rem -------------------------------------------------------------------------- @node Index "Index" @TOC Main @prev Software Index ----- @{" Acknowledgments " link Acknowledgments} @{" Author " link Author} @{" Copyright " link Copyright} @{" Description " link Description} @{" Developer Info " link Developer} @{" Disclaimer " link Disclaimer} @{" Distribution " link Distribution} @{" History " link History} @{" Installation " link Installation} @{" Known problems " link Problems} @{" MUI " link MUIReadMe} @{" Requirements " link Requirements} @{" Subclasses " link Subclasses} @{" Trademark " link Trademark} @{" WrapGuide " link WrapGuide} @endnode @rem --------------------------------------------------------------------------