                             INTRODUCTION

RANLIST  produces randomization lists and  offers a  primitive form of
interactive randomization.    RANLIST  features  both   restricted and
unrestricted randomization.   When  restricted randomization  is used,
fixed or random balance points may be chosen.

                          HOW IT WAS WRITTEN

RANLIST was written  in FLECS+,   a Fortran  preprocessor  similar  in
spirit to  ratfor.  The resulting ugly  Fortran was  polished with the
Toolpack  tools,  pol and  decs.  We wish that  we could claim that it
passed  the pfort  portability test, but   pfort runs out of steam  on
anything the size of RANLIST.

                       LEGALITIES (BRIEF)

    We want to make  this  program as widely   available  as possible.
Hence, executable code derived  from  the source provided, the  source
itself, and the accompanying  documentation  may be freely  copied and
distributed  provided  that  this   copyright section accompanies such
copies.  We encourage the distribution of this code on bulletin boards
and as shareware.

    Modifications and improvements to the code can similarly be freely
copied and distributed.  Barry Brown  would appreciate  a copy of  any
such improvements for incorporation into later versions of RANLIST.

    Source code  may be extracted    and used for  any  non-commercial
purpose.  Non-commercial means that  at most a modest distribution fee
is charged, as shareware.  We would  appreciate acknowledgment of usch
use of our code.

    Commercial use of the source code requires written permission from
the Department of Biomathematics at the above  address.  Our policy is
generally to grant  such  permission  provided appropriate   credit is
given to us in the documentation.

                             INSTALLATION

RANLIST documentation is on file ranlist.doc.  The executable code for
RANLST is on file RANLIST.EXE.

RANLIST  must associate the  file RANLST.HLP  with  Fortran unit 13 to
run.  The executable contains as  its  single argument the location of
RANLST.HLP. Suppose the  executables and  help file are both stored in
directory C:/RANLIST; the executable has file name RANLIST.EXE and the
help file is named  RANLST.HLP.  A one line  file, RANLIST.BAT  can be
used  to invoke stattab.  RANLIST.BAT should,  of course, be in one of
the directories in  the user's PATH.  The  single line  of RANLIST.BAT
is:

              C:\RANLIST\RANLIST.EXE C:\RANLIST\RANLST.HLP

                        CONTACTING THE AUTHORS

To contact the authors of RANLIST, please write to:

          Barry W. Brown
          Professor of Biomathematics
          Department of Biomathematics, Box 237
          University of Texas M. D. Anderson Cancer Center
          1515 Holcombe Boulevard
          Houston, TX 77030

or send electronic mail to:

Internet: bwb@mdaali.cancer.utexas.edu
