****************************************************************************
*                                                                SHAREWARE *
*                         ReqMes V1.1 (28-Apr-93)                          *
*                 Copyright (c) 1991-1993 PLL Developments                 *
*                           All rights reserved                            *
*                         A TimeZone Release <tz>                          *
*                                                                          *
*         YOU NEED REQTOOLS.LIBRARY TO MAKE USE OF THESE PROGRAMS          *
*                                                                          *
****************************************************************************


 1   CONTENTS
 ============

This LhA Archive contains the following files:

Root Directory   - ReqMes Drawer icon

ReqMes11.info                     820 - PLL Drawer icon

Directory ReqMes11 - ReqMes + Documents

ReqMes                           3276 - ReqMes V1.1
ReqMes.doc                       8918 - ReqMes Documents V1.1
ReqMes.doc.info                   766 - Icon for ReqMes Docs

Directory ReqMes11/libs13 -  Nico François reqtools.library KS1.3 or lower

reqtools.library                39012 - Version 38.388 KS1.3

Directory ReqMes11/libs20 - Nico François reqtools.library for KS2.0

reqtools.library                38104 - Version 38.1022 KS2.0


 2   INTRODUCTION
 ================

ReqMes brings up a requester (actually a window) containing a message to the
user and wait for the user to acknowledge it. The window automagically
sizes to fit the text and it will appear immediately under the mouse. If it
is impossible to position the window exactly where requested (if the mouse
pointer is too close to the edge of the screen) then ReqMes will position
the window as close as possible to the correct location.


 3   INSTALLATION
 ================

ReqMes will run on any Amiga system with any KickStart and isn't
limited to be just a WB1.3 or WB2.0 tool.

ReqMes requires the reqtools.library Copyright (c) Nico François to be
present in your libs: directory. If your Amiga has Kickstart 2.0 or higher
in ROM, please copy the reqtools.library in the libs20 drawer to your libs:
directory. If your Amiga has KickStart 1.3 or lower, copy the
reqtools.library in the libs13 drawer to your libs: directory. In fact, you
can copy ReqMes in any directory you like, but I recommend to copy the
program into c: for the best operation.


 4   THE ARGUMENTS
 =================

You can get ReqMes command template by typing from CLI:

ReqMes ?

The following text is displayed on screen:

Usage: ReqMes [message] [-f file]

Watch the syntax! Everything between [] is optional. You could either use
[message] which is any ASCII text, or [-f file] which is a predefined ASCII
text stored on (hard)disk. This text can be easily edited with your
favourite text-editor or word-processor. As soon as you have typed the
correct number of arguments, the ReqMes requester pops up with the
appropriate message to the user and is waiting for you to select the Resume
gadget (or to press the Esc or Return key). If you don't type any arguments,
ReqMes comes up with a filerequester which allows you to select a file.
Here, you can press the Amiga (A) key and the character which is underlined
or select the gadgets to use Get, info, Volumes, etc. Alternatively you can
also use the arrow keys to select your file. Currently, you can't specify
files larger than 5000 bytes, but 5kb should be more than enough to display
your favourite messages.

So, you could easily use ReqMes to display a message to the user in script
(batch) files to inform the user about something special (as a replacement
for c:Echo) or use ReqMes to display your predefined text from (hard)disk
(as a replacement for c:Type). Alternatively you can use ReqMes to display
your own menu systems (a disk compiler's dream) or to display your ANSI's
(like the PLL logo below) in a neat window on screen (well actually ASCII's,
since ReqMes doesn't know about ANSI codes). Needless to say, but you can
also Run ReqMes, to make use of the multitasking capabilities.


 [message]
 ---------

This argument let you specify the text in the ReqMes window, currently only
one line supported. Note that you can use quotes to center your text or to
use spaces.

Example:

ReqMes "This program allocates approximately 2 GigaBytes of memory!"

or

ReqMes "  Red Limbo Squad  "


 [-f file]
 ---------

Let you specify an ASCII text stored on (hard)disk. The space between -f and
file is essential. Note that you can't specify files larger than 5000 bytes.
If you do however, an appropriate error message will be generated. If ReqMes
can't find the file specified after the -f option, again, an appropriate
error message will be generated. Hey, you can't open a requester (text) that
is larger than your current screen, if you do, things will get very ugly.

Example:

ReqMes -f s:startup-sequence

or

ReqMes -f df0:s/Menu


 5   ACKNOWLEDGEMENTS
 ====================

ReqTools is Copyright (c) 1991-1993 Nico François. Thanks to Nico François
for the wonderful reqtools.library. Personal regards to RLS for such a
talented musician, Turbo-Ties for his many disk-swaps & software
distribution, Mega-Byte (or is it Giga-Byte?) for his A4000 (Giga)
MegaBytes, EuroSoft and ThC for the nice chat.

If you have any suggestions, bug reports or questions, please
contact PLL Developments at one of the electronic mail addresses below.


 6   REVISION HISTORY
 ====================

        V1.0 12-Feb-91 Internal
             - Used req.library (Fox & Dawson)
             - SimpleRequest() will crash if file > 5000 Bytes

        V1.1 28-Apr-93 Internal
             - Now pops up with reqtools.library (Nico François)
             - FileRequester implemented as goodie
             - 5000 byte check is still there for rtEZRequest()
             - Initial Release

                     ______________  __________  ____
 _________________  /            \ \ \________/ /   /\   __________________
 \_______________/ /_________    /\ \  ______  /.  / /   \________________/
   _____________   \__/   /_/  ./ /  \ \____/ //  / /      ______________
   \___________/     /        // /\   \      /   / /       \____________/
     _________      /   ______/ /\ \.  \____/__ /_/_______   __________
     \_______/     /   /\_____\/  \ \\         \         /\  \________/
       _____      /___/ /          \ \__________\_______/ /    ______
       \___/      \___\/            \/__________/_______\/     \____/
_______  ______     _____  __  __________          ______    _________ _____
\__/\_ \ \____/\  /\\___/\/ /  \____/\__ \    /\   \____/\/\/ __  _  /\\_  /
  / / \ \___ / / / /__ / / /   __  / /_ \ \/\/  \  ___ / /  \/ / / \/ /__\/
 / /  / / _/ \/\/ / _/ \/ /   / / / / /_/ /   /\ \/ _/ \/ /\ \/ /   \/__ \
/ /__/ / /_/\ \  / /_/\/ /_/\/ /_/ / / \_/ /\/  \ \/_/\/ /  \ \/_______/ /
\/ \__/\____/  \/\____/\____/\____/\/    \/      \____/\/   /\__________/
                                                            \/

>-  --  --- - --- ---- -*€°¬¯¬°€* JUSTICE EUROPEAN HEADQUARTERS *€°¬¯¬°€*--<
> ___    ______    ___________ _________ ___  ________   ____    ___       <
>|~.~\  /~  | ~\  /  ~/~ _   ~\~       \\~ .|/   _ ~  \  \ ~ \  |~  |      <
>|    \/   :|   \/  /// /_\___/__     __/___|  .| \___/___\  .\ |:  |      <
>|   .  .  ||\_    _/_____~ .\   |  :|  |  :|  ||  ___/~  /\  .\||  |  ___ <
>|   |\/|   |  |: | /   \_\  \\  |  ||  |  ||   |_/  ~\  /__\  \\   |_/   |<
>|___|  |___|  |__| \_________/  |___|  |___|\________/__________\________|<
>                                                                          <
> *   SySøP: tHC/JuSTice *        Running On:        -( 250 Mb ønl¡nE )-   <
> *CøSySøP: sAl-øNe/TRSi *          A2000            -( UsR DhST 16k8 )-   <
>                              9 Megs 32 Bit ram     -( /X 2.33 ReG.  )-   <
>  _  øNly AmiGa            GVP 68030/68882 40 MHZ   -(0/1 Dayz WarEZ!)-   <
>  \\ _  Makes It                                   -( PrøGrammers CøNf )- <
>   \X/     pøssible!       Node1: +31-10-4779507       -(AnsI CøNf )-     <
>                           Node2: +31-10-SøøN       -( Great /X CøNf )-   <
>       _________ ___          ____    __________________  ________        <
>      |.~  __  ~\   |         \  .\  /    _~  .\ ~ _    \/ ~ _   ~\       <
>      |   |__|   |  |       ___\  .\ |  || \___/ .|_\___/// /_\___/       <
>      |  . _____/.  |  ___ /~ ~/\  \\|  :|  __|    _|___/_____~ .\        <
>      |  ||     |:  |_/~ ~|   /__\   \   |_/  ~\  |_/   \   \_\  \\       <
>      |___|     |_________|___________\________/________/_________/       <
>                                                                          <
>- -*€°¬¯¬°€* JUSTICE EUROPEAN HEADQUARTERS *€°¬¯¬°€*- --- --- - --- -- - -<
