


         KMSAM 1.24 -*- KMS Area Manager     ©1994 Thomas Schwarz
         ========================================================



                               Documentation
                               =============



Introduction:
-------------

KMSAM is a GUI for editing the area  data  of  KMS,  my  famous  "Karfunkel
Mailbox  System"  and  is  based  on  MUI, the even more famous "Magic User
Interface" by Stefan Stuntz which has to be installed  on  your  system  in
order to be able to use KMSAM.

KMSAM makes you able to change every data item of a KMS message area  which
may be edited by the KMS internal command #11 "BRETTED", but on a much more
comfortable graphically nice-looking astonishingly pretty way.

KMSAM  is  designed  especially  for use with KMS and is not intended to be
used  by anything or anybody for anything else. (But surely I'm not able to
stop  you from abusing it anyway. If you abuse it, please tell me which way
you do it. I can't imagine one :-)



Call-Syntax:
------------

KMSAM [Areaname/-path]



Parameters:
-----------

Areaname/-path Optional: If you  supply  the name or complete path of a KMS
               area as argument, KMSUM directly presents the editing window
               for this  area, if  it already  exists, or lets you create a
               new one with the given name.



Description:
------------

Main Window:
++++++++++++

If KMSAM is called without parameters, you will see the main window with  a
listview on the left side and several buttons on the left and bottom of the
window. In the list there always are shown all the KMS areas of the current
level.  You  change  to  the next deeper tree-level by double clicking on a
name in the list or selecting the "Children"-button. You climb one level up
by  selecting "Parent". In the top-level there always is just one area, the
one for private mail.

With a single click on an area name you select this for further editing  by
using all the buttons on the right side of the KMSAM window.

Available buttons/actions in the main KMSAM window:

[   Up   ]        Move area one position up in the list.
[  Down  ]        Move area one position down in the list.

[  Cut   ]        Remove an area from the list and save it for later
                  reincarnation (->Paste).
[  Copy  ]        Save the data of current area for later cloning
                  (->Paste).
[ Paste  ]        If you did a "Cut" or "Copy" before, create an area
                  with the saved data at the current position in the list.

[  Sort  ]        Sort areas alphabetically.

[  Add   ]        Add new area to the list at the current position.
[ Remove ]        Say Good Bye to the current area.

[  Edit  ]        Change data of currently selected area.

You leave the program by clicking the  window  close  gadget  or  selecting
"Quit" from the pull down menu.

Editing Window:
+++++++++++++++

If you choose "Add" or "Edit" in the main window,  the  KMSAM  Area  Editor
window   is   opened.   Here   you   get  the  possibility  to  change  the
characteristics of the selected area.

I think the  meaning  of  all  the  available  string,  slider,  cycle  and
checkmark  gadgets  are  quite  self  explanatory,  if  you are familiar to
editing userdata with the KMS internal command #11  "BRETTED".  So  I  will
make  my life easy here by just saying: "Read the documentation of BRETTED"
:-)

The two available buttons do the following:

[  Use   ]        Accept changes and return to the main window.
[ Cancel ]        Leave editor window without changing anything.



Distribution:
-------------

The "Karfunkel Mailbox System (KMS)" and "KMS Area Mananger (KMSAM)" are
Copyright ©1994 by Thomas Schwarz.
All Rights Reserved.

"KMSAM" is only to be distributed as part of the KMS package.  I  mean  it.
Please refer to the KMS documentation for further distribution information.



Author information:
-------------------

It's me :-)

Thomas Schwarz
Gieshügeler Straße 26
97218 Gerbrunn
Germany

E-Mail: kmshq@bmagic.mayn.sub.de
        Thomas_Schwarz@wue.maus.de



Acknowledgements:
-----------------

                          This application uses


                        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



Copyright notices:
------------------

Unix is a registered trademark of AT&T

Amiga is a registered trademark of Commodore Business Machines, Inc.

AmigaOS is a registered trademark of Commodore Business Machines, Inc.

KMS and KMSAM are not registered trademarks, but using them without
permission is bad for your conscience.



Disclaimer:
-----------

                          *** STANDARD DISCLAIMER ***

   This product is meant for educational purposes only.  Any  resemblance
   to real persons, living or dead is  purely  coincidental.  Void  where
   prohibited. Some assembly required. List each check separately by bank
   number. Batteries not included. Contents may settle  during  shipment.
   Use only as directed. No other warranty expressed or implied.  Do  not
   use while operating a motor vehicle or heavy equipment.  Postage  will
   be paid by addressee. Subject to CAB approval. This is not an offer to
   sell securities. Apply only to affected area. May be too  intense  for
   some viewers. Do not stamp. Use other side  for  additional  listings.
   For recreational use only. Do not disturb. All models over 18 years of
   age.   If   condition   persists,   consult   your    physician.    No
   user-serviceable parts  inside.  Freshest  if  eaten  before  date  on
   carton. Subject to change without notice. Times approximate. Simulated
   picture. No postage necessary if mailed in the United States. Breaking
   seal constitutes acceptance of agreement. For off-road  use  only.  As
   seen on TV. One size fits all. Many suitcases look alike.  Contains  a
   substantial amount of non-tobacco ingredients. Colors  may,  in  time,
   fade. We have sent the forms which seem to be right for you.  Slippery
   when wet. For office use only. Not affiliated with  the  American  Red
   Cross. Drop in any mailbox. Edited for television. Keep cool;  process
   promptly. Post office will  not  deliver  without  postage.  List  was
   current at time of printing. Return to sender, no forwarding order  on
   file,  unable  to  forward.  Not  responsible  for  direct,  indirect,
   incidental or consequential damages resulting from any  defect,  error
   or failure to  perform.  At  participating  locations  only.  Not  the
   Beatles. Penalty for private use. See label for sequence.  Substantial
   penalty for early withdrawal. Do not write below  this  line.  Falling
   rock. Lost ticket pays maximum rate.  Your  cancelled  check  is  your
   receipt. Add  toner.  Place  stamp  here.  Avoid  contact  with  skin.
   Sanitized for your protection. Be sure each item is properly endorsed.
   Sign here  without  admitting  guilt.  Slightly  higher  west  of  the
   Mississippi. Employees and their families are not eligible. Beware  of
   dog. Contestants have been briefed on some questions before the  show.
   Limited time offer, call now to insure prompt delivery.  You  must  be
   present to win. No passes accepted for this  engagement.  No  purchase
   necessary. Processed at location stamped in code  at  top  of  carton.
   Shading within a garment may occur. Use only in well-ventilated  area.
   Keep away from fire or flame. Replace with  same  type.  Approved  for
   veterans. Booths for two or more. Check here if tax  deductible.  Some
   equipment shown is optional. Price does not include taxes. No Canadian
   coins. Not recommended for children. Prerecorded for this  time  zone.
   Reproduction strictly prohibited. No solicitors. No alcohol, dogs,  or
   horses. No anchovies unless otherwise specified.  Restaurant  package,
   not for resale. List at least two alternate dates. First pull up, then
   pull down. Call toll free before digging. Driver does not carry  cash.
   Some  of  the  trademarks  mentioned  in  this  product   appear   for
   identification purposes only. Record additional transactions  on  back
   of previous stub. Decision of judges is final.

   This supersedes all previous notices.



Quote of the day:
-----------------

   "All right," said Masklin. "But you're not to fly down low again and try
  to read the signposts. Every time you do that, humans rush into the streets
                  and we get lots of shouting on the radio."
     "That's right." said the Thing. "People are bound to get excited when
      they see a ten-million-ton starship trying to fly down the street."
                              -- (Terry Pratchett, Wings)



Last words:
-----------

Perhaps you wonder why this documentation is written in English while KMS
in general is a German system? Well, I'm practising my English :-)

