SettingsWindow.mcc 1.01 (03.01.1999) Documentation
**************************************************

This might be the last release of SettingsWindow.mcc. I stopped developing
for AmigaOS to focus on my (new) favourite OS, the BeOS. That's why I
decided to include the source code - more as a bad example than as a
useful source of information. ;-)


Copyright
*********

SettingsWindow.mcc (c) 1997-98 Ingo Weinhold

SettingsWindow.mcc is copyrighted by Ingo Weinhold, but it may be freely
distributed as long as the package stays unmodified.
The package consists of:

* the SettingsWindow-Demo and its source code SettingsWindow-Demo.c
* MCC_SettingsWindow.doc - the autodoc file
* SettingsWindow_mcc.h - the C include file
* SettingsWindow_mcc.doc - this documentation
* SettingsWindow.mcc - the MUI customclass
* SettingsWindow_mcc.catalog files
* SettingsWindow_mcc.cd - the catalog descriptor
* SettingsWindow_mcc_empty.cd - the empty catalog translation
* SettingsWindow_mcc.ct files
* the SettingsWindow.mcc sources


Developers are strongly encouraged to use this software in their
applications, as it is meant for that purpose.
Using this software still requires

* including a SettingsWindow.mcc copyright notice
  (a half line is absolutely enough),
* an information where to get the latest version of the original archive
  (e.g. Aminet dev/mui).

(Informing me what program SettingsWindow.mcc is used for would make me
happy.)

If you consider distributing the SettingsWindow class as part of your
software, you are allowed to include at least

* SettingsWindow.mcc,
* all SettingsWindow_mcc.catalog files.
* the ato.readme and Farsi.readme created by the ATO (Amiga Translators'
  Organization)

As mentioned above the complete SettingsWindow.mcc sources are included.
You are allowed to take parts of them to reuse it in your own projects.
No conditions are attached to this, but I would like you to contact/inform
me.

The cataloges and cataloge translations (except the German ;-) were created
by the ATO - read the ato.readme (in the archive's root directory) for more
information. Persian native users should take a look into Farsia.readme.


The Author
**********

SettingsWindow.mcc was written by Ingo Weinhold.

snailmail: Ingo Weinhold
           Haeckelstr. 40
           14471 Potsdam
           Germany

email:     bonefish@cs.tu-berlin.de


Disclaimer
**********

You use SettingsWindow.mcc at your own risk. The author doesn't guarrantee
that this software works correctly and doesn't cause damages. No liability
and responsibility is assumed.


Description
***********

SettingsWindow.mcc is a custom class of the Magic User Interface (c) by
Stefan Stuntz.
It is a subclass of Window.mui that allows you to easily manage your
programs settings. There is a notification mechanism similar to that of MUI
to react on changing settings. A row of buttons and a menu let the user have
the standard save, use, load functions.


Requirements
************

* MUI 3.3 or newer


Installation
************

* copy the contents of the directories SettingsWindow/Demos/ ,
  SettingsWindow/Libs/ , SettingsWindow/Docs/ and SettingsWindow/Developer/
  to the corresponding directories in MUI:

* copy the contents of the directories SettingsWindow/Locale/ to LOCALE:


History
*******

V0.10

* first working beta version

V0.20

* English documentation added.
* Localization, German catalog
* "Restore" menu item added.

V0.30

* Attributes MUIA_SettingsWindow_TestButton and MUIA_SettingsWindow_TestMode
  added to feature an optional "Test" button.
* Some comments added to the Demo source.
* The demo program now takes care if the Asl requester is still opened when
  the user tries to quit the application.

V0.40 (first release)

* Support of (N)Lists added.
* Type SWIT_COMPLEX added.
* Examples for lists added.
* Bug handling the value 0/NULL/FALSE of simple types fixed.

V1.00 (probably the final and last version)

* The menus are now more style guide conform.
* Localized the menu shortcuts.
* Method MUIM_SettingsWindow_Defaults and attribute
  MUIA_SettingsWindow_UseDefaults added.
* Included complete sources.

V1.01 (Some improvements by Kai Hofmann <hofmann@hofmann-int.de>)

* Added MCC-Install for easier installation
* Added archiv-drawer icon
* Arranged/Exchanged icons


Future
******

* maybe support of listtrees


Thanks to...
************

* Stefan Stuntz for the Magic user Interface

* Stephan Aßmus for the nice drawer and demo icons
  and for correcting the English documents

* the ATO (Amiga Translators's Organization) for their :-) translations.