*****************************************************
*                                                   *
*  SortIcons.rexx 1.2   (c) 2000 Christoph Gutjahr  *
*                                                   *
*****************************************************


------------------------------
|  COPYRIGHT AND DISCLAIMER  |
------------------------------

 This program is FREEWARE. It may be freely distributed in any way as
 long as:

 - the two program files ("SortIcons.rexx" and "SorterStarter.rexx") and this
   text file remain unaltered and are distributed together.

 - It is not used as part of a commercial product without my express
   permission.

 Use this at your own risk. No warranties of any kind are made as to the
 functionality of this program.

------------------------------
|        REQUIREMENTS        |
------------------------------

 Any Amiga computer with at least OS 3.5

------------------------------
|        DESCRIPTION         |
------------------------------

 This program sorts the icons on the Workbench "Root" window. A grid is
 calculated, each icon is then moved to its nearest Grid position. You can
 specify a place for both "Tool"- and "Disk"-Icons (left, right, top or
 bottom border of the screen).

 You can specify if "App-" and "Drawer"-Icons should be ignored or treated
 as "Tool"- or "Disk"-Icons.

 After running the script, you can sort your icons (swap the positions of
 two icons etc.) manually and re-run the script to reposition the icons at
 the calculated grid.

 It's a bit hard to explain, just try it out! (It's quite similar to a
 WIN9x-Desktop's sort function, just better.. :)

------------------------------
|        INSTALLATION        |
------------------------------

 1. Make sure that your ARexx-Server is running (see final chapter - "The
    ARexx-Server" - if you don't know what I'm talking about)

 2. Copy the script "SortIcons.rexx" to your REXX: drawer.

 3. There are three ways to start this script:

    - Install the brilliant "T.H.E." Package. This is the recommended
      method, as T.H.E. will give you many other useful functions as well
      as an easy way to make use of this script.

    - Copy the script "SorterStarter.rexx" (along with its Icon!) to your
      "WBstartup"-drawer. This will add a new menu item to Workbench's
      "Tools"-Menu named "SortIcons".

    - run it from the shell whenever you want to sort your icons.

------------------------------
|           USAGE            |
------------------------------

 The script can then be started with:

   SYS:Rexxc/rx SortIcons.rexx

 The program understands some arguments (these arguments are optional).
 if you are using "T.H.E" or "SorterStarter.rexx" you have to edit
 these files to add/remove arguments):

   Sorticons.rexx TOOL=L/R/T/B/I DISK=L/R/T/B/I APPICON=T/D DRAWER=T/D

   TOOL=L/R/T/B/I: Where to put "TOOL"-Icons. They can be put to the left/
                   right/top/bottom border of the screen, or they can be
                   ignored ("I"). Default: TOOL=R

   DISK=L/R/T/B/I: Where to put "DISK"-Icons. They can be put to the left/
                   right/top/bottom border of the screen, or they can be
                   ignored ("I"). Default: DISK=L

   APPICON=T/D:    How to treat "App"-Icons. They can be treated as "Tool"-
                   or "Disk"-Icons. If this argument is missing, they are
                   ignored (not sorted at all).

   DRAWER=T/D:     How to treat "Drawer"-Icons. They can be treated as
                   "Tool"- or "Disk"-Icons. If this argument is missing,
                   they are ignored (not sorted at all).

 As long as the script is working, you can't access Workbench. When the
 script is finished, a requester will pop up, asking you if the icon
 positions shall be saved to disk.

------------------------------
|         THANK YOUS         |
------------------------------

 The grid-concept was thought up by Soren Forsberg. He allowed me to use
 parts of his code (thanks!)

 Thanks to Nils Goers for suggestions, error corrections and for T.H.E.

------------------------------
|           AUTHOR           |
------------------------------

 Christoph Gutjahr
 Hermannstr. 41
 12049 Berlin
 Germany

 Korodny@gmx.net

------------------------------
|      THE AREXX SERVER      |
------------------------------

 To run ARexx-programs such as "SortIcons.rexx", the ARexx-Server must be
 active. This can be achieved by different methods:

 - Double click on the "Rexxmast" Icon in your "SYS:System/" drawer. This
   will activate Rexxmast immidiately.

 - move the "Rexxmast" Icon to your "SYS:Wbstartup" drawer or add the line

     RUN >NIL: SYS:System/Rexxmast

   to your Startup-sequence. This will make the ARexx-Server active when
   your machine is booting. ARexx won't eat up mach memory or
   CPU-Ressources, so this is the recommended method.