
                      **********************************

                          ReqTools Preference Editor

                          Release 2.5

                          (c) 1991-1994 Nico François
                              1995-1996 Magnus Holmgren

                      **********************************


The ReqTools preference editor requires Kickstart 2.0 or higher to run.
Both the Kickstart 1.3 and Kickstart 2.0 version of reqtools.library will
respond to the preference settings.


1. Options:
-----------

The ReqTools preference editor recognizes following command line options when
started from the CLI:

FROM <ReqTools preference file>  : Edit specified preference file.
SCREENFONT=<YES|NO>              : Use screen font for editor or use the
                                   standard Topaz 8 font (default YES).
PUBSCREEN <public screen name>   : Open on specified public screen.

Following tool types are recognized when started from Workbench:

CREATEICONS=<YES|NO>             : Create icons for preference files
                                   (default YES).  Note that if the editor
                                   is started from the Shell the menu item
                                   will not be checked so no icons will be
                                   created.
SCREENFONT=<YES|NO>              : Use screen font for editor or use the
                                   standard Topaz 8 font (default YES).
PUBSCREEN=<public screen name>   : Open on specified public screen.


2. The editor
-------------

This documentation is still very basic, it very shortly describes the
checkboxes and default requester settings available.

The checkboxes:
~~~~~~~~~~~~~~~
General:

 o Pop Screen To Front    : Allows you to switch off the default behaviour
                            of all ReqTools requesters popping the screen
                            they appear on to the front.

 o Use system default font: Force the use of the system default font in the
                            file, font, directory, screenmode, volume and
                            palette requesters (instead of the screen font).
                            Note that if a program uses the RT_DefaultFont
                            tag to select a specific default font this
                            font will be used.

 o Use function keys      : Allow function keys to be used as shortcuts for
                            gadgets. F1 means the leftmost gadget, F2 the
                            next, etc. This means that up to 11 gadgets can
                            have shortcuts (10 function keys, and ESC),
                            even if no underscores or similar are used.

 o Color wheel            : Add a color wheel to the palette requesters, if
                            possible. This feature requires properly
                            installed colorwheel and gradientslider gadgets
                            (part of OS 3.0 or higher).

File Requester:

 o Immediate sort         : If checked makes the file requester sort the
                            directory contents automatically.

 o Display drawers first  : Display drawers before the files in the file
                            requester.

 o Mix files and drawers  : Mix files and drawers in the file requester.
                            If none of the 'Display Drawers First' or
                            'Mix Files And Drawers' is checked files
                            will be displayed before drawers.

 o Disk activity LED      : Switch the disk activity LED in the file
                            requester on or off.

The default settings:
~~~~~~~~~~~~~~~~~~~~~
For each requester you can set the following defaults:

 o Size (% of visible height) : Default height of the requester (relative
                                to the visible height of the screen it
                                will appear on).

 o Number of visible entries  : Minimum and maximum number of entries that
                                are initially displayed.  With this you
                                can assure you won't see less or more entries
                                than the minimum or maxmimum you set when
                                the requester first appears.  You can for
                                example set the font requester to use 75% of
                                the visible screen height.  If you set the
                                maximum number of visible entries to 10 the
                                font requester will not display more than
                                10 entries no matter how high the screen is
                                it appears on.

 o Position                   : Default position of requester.

 o Offset                     : Offset (in pixels) from the default position.

Note that you are setting defaults, not all requesters will appear as you
have selected.  If a program explicitely sets a requester's position ReqTools
will make the requester appear as asked.  The defaults will be used when the
calling program doesn't set specific settings itself.


                               PROGRAM HISTORY:

*****************************************************************************
RELEASE 2.1

    First release.

*****************************************************************************
RELEASE 2.1a

    Fixed an enforcer hit that occured when using the 'Defaults for' cycle
      gadget.
    On Kickstart 3.0 the editor's window will now zip/iconify in size only.

*****************************************************************************
RELEASE 2.2

    Bumped version to match ReqTools release version.
    Added a 'Disk activity LED' checkbox to switch this new feature of
      ReqTools 2.2 on or off.
    On Kickstart 3.0 or higher scaled checkboxes will be used.

*****************************************************************************
RELEASE 2.2b

    Added a 'Use system default font' checkbox for ReqTools 2.2b or higher.

*****************************************************************************
RELEASE 2.3

    Added a 'Use function keys' checkbox for ReqTools 2.3 or higher.
    A few gadgets weren't properly updated when changing the prefs (using
      a menu item).

*****************************************************************************
RELEASE 2.4

    Fixed the bug that cause crashes on startup for 68000 users.

*****************************************************************************
RELEASE 2.5

    Added the 'Color wheel' option.

*****************************************************************************

ReqTools Preference Editor

(C) 1991-1994 Nico François
    1995-1996 Magnus Holmgren

                                   //
                       Thanks to \X/ Amiga for being the best computer ever!

