###############################################################################
##                                                                           ##
##      M     M            ll     tt     ii    RRRRR                         ##
##      MM   MM            ll     tt           RR  RR                        ##
##      MMM MMM   uu  uu   ll    ttttt   ii    RR  RR    eeee     qqqqq      ##
##      MMMMMMM   uu  uu   ll     tt     ii    RRRRR    ee  ee   qq  qq      ##
##      MM M MM   uu  uu   ll     tt     ii    RR RR    eeeeee   qq  qq      ##
##      MM   MM   uu  uu   ll     tt     ii    RR  RR   ee        qqqqq      ##
##      MM   MM    uuuuu    ll     ttt    ii   RR  RR    eeee        qq      ##
##                                                                   qq      ##
##                                                                           ##
###############################################################################


MultiReq v1.20  11/1992 by Andreas Krebs (released at 12-Nov-92)


The following files and directories belong to MultiReq:

  libs
    multireq.library           10700
  fd
    multireq_lib.fd              720
  ASM
    include
      libraries
        multireq.i                 11677
        multireq_lib.i               496
    SimpleDemo.asm              7967
    SimpleDemo                  1180
    SimpleDemo.info              454
  ASM.info                     728
  C
    include
      libraries
        multireq.h                 14138
        multireq_protos.h           1563
    lib
      mr.lib.asm                  3269
      mr.lib                      2796
      makefile                     171
    Aztec_pragmas
      multireq_lib.h               951
    Lattice_pragmas
      multireq_lib.h               818
    SimpleDemo.c                4044
    SimpleDemo                  5108
    SimpleDemo.info              507
    TestProg.c                  4545
    TestGads.c                 11148
    TestIncludes.h               595
    makefile                     475
  C.info                       728
  Anleitung
    MultiReq.dok               11724
    MultiReq.dok.info            465
    Library.dok                16762
    Library.dok.info             465
    Programmierung              5907
    Programmierung.info          465
  Anleitung.info               728
  Documentation
    MultiReq.doc               10479
    MultiReq.doc.info            465
    Library.doc                15437
    Library.doc.info             465
    Programing                  5627
    Programing.info              465
  Documentation.info           728
  TestProg                    9652
  TestProg.info                454
  LiesMich                    3872
  LiesMich.info                465
  ReadMe                      3476
  ReadMe.info                  465


MultiReq is compatible to Kickstart 1.3 and Kickstart 2.0, whereby there's no   
difference between the function and the appearance of the file requester under 
the different Kickstart versions.
The current version of MultiReq has only assembler and C include files, but it
should be no problem to translate them into a different language. I was not able
to do this, cause I don't own other languages than C and assembler.


Installation:
=============
The installation of MultiReq is very simple, all you have to do is copying the
"multireq.library" into the directory LIBS: and afterwards copy the include 
files into your directory containing the other include files of your language.
If you use C, you should also copy the corresponding pragmas-file (Aztec or 
Lattice). 
If you use the linker library mr.lib instead of pragmas, you should copy this 
file into the corresponding directory. This file is only available in the 
version smallcode, smalldata for the Aztec-C Compiler 5.2. If you need another
version than you have to change the makefile in the way you like it and 
afterwards recompile the linker library. 
I was not able to create a linker library for the Lattice compiler, cause I 
don't own it, but this should be no problem for the assembler source code of the
linker library is also included.


Starting the file requester:
============================
Starting the file requester is very easy, so that the file requester can be
included into any program without problems. You only have to open the 
"multireq.library" to get access to all functions of MultiReq. The following
example routine in C opens a file requester on the Workbench screen.

OpenFileReq()
{
  struct MultiReqBase *MultiReqBase;
  struct FileReq *fr;

  if(!(MultiReqBase=OpenLibrary("multireq.library",0L)))
    return;

  InitFileReq(&fr,2L);
  if(fr)
  {
    FileRequester(fr,NULL);
    FreeFileReq(&fr);
  }

  CloseLibrary(MultiReqBase);
}

As further examples the program SimpleDemo (in C and assembler) and the program
TestProg (in C) are included as source code. This examples and the include files
"multireq.h" resp. "multireq.i" contain all further information about the 
FileReq-structure and the parameters in it. A detailed description of the 
library functions is located in the file "Library.doc" and a desciption of the
file requester is located in the file "MultiReq.doc".



If you still have questions or problems with MultiReq or simply want to mention
something to MultiReq, e.g. improvements, new library functions or things like
that, please write to: 

Andreas Krebs
Mittelweg 9
7110 Oehringen 2
Germany

Tel.: 07948/2101  (at the weekend or during holidays)
      0721/821356 (any other time)

Or write to the following Email address:

Email: s_krebs@iravcl.ira.uka.de


