
                              README.TXT File

                           Release notes for the
           Microsoft(R) IMSL(R) Mathematical & Statistical Libraries
                                Version 2.0

This document contains release notes for version 2.0 of the Microsoft
IMSL Mathematical and Statistical Libraries for MS-DOS(R). The 
information in this document is more up-to-date than the information 
in the User's Guide and in the Microsoft Advisor (online Help).

Copyright (c) 1993, an unpublished work by Visual Numerics, Inc.  All rights
reserved.  The contents of these disks are subject to the accompanying
software license agreement.  Use of the Visual Numerics products and/or
technical data by US government or any agency thereof is subject to the
Restricted Rights provisions of DFARS 252.227-7013 (c)(1)(ii) for Defense
agencies, or FAR 52.227-19 for other agencies.


================================< Contents >================================


This file has 4 parts:

      Part    Contents
      ----    --------
      1       Documentation Errata
      2       Directory Layout and Description
      3       Online Help
      4       Using Library Functions in Mixed-Mode Programming 
              Environment



=====================< Part 1: Documentation Errata >=======================

User's Guide, Page 1: System Requirements
-----------------------------------------
The computer requirements listed in System Requirements are incorrect.
The first bulleted item should instead read:

     - An IBM or 100%-compatible personal computer with an 80386 or
       higher processor running MS-DOS version 3.3 or later.


================< Part 2: Directory Layout and Description >================

The Microsoft IMSL Mathematical & Statistical Libraries is installed by
default in a separate directory structure from the Microsoft FORTRAN 5.1
Compiler.

Assuming the default destination directory name (MSIMSL51), the directory 
structure is as follows:

      C:\MSIMSL51
           |-FORTRAN
               |
               |-EXAMPLES
               |   |
               |   |-MATH
               |   |   |-SINGLE
               |   |   |-DOUBLE
               |   |
               |   |-STAT
               |       |-SINGLE
               |       |-DOUBLE
               |
               |-INCLUDE
               |
               |-HELP
               |
               |-LIB
               |
               |-SOURCE


Each directory contains the following files or types of files:

MSIMSL51
--------
This directory contains the batch file, IMSLENV.BAT, created during the
installation. This file is used to redefine several DOS environment 
variables used by the FORTRAN 5.1 Compiler. These variables will enable 
you to access the Microsoft IMSL Libraries during the compilation and 
linking of your FORTRAN programs.

MSIMSL51\FORTRAN
----------------
This directory contains product information and data files used by several
Libraries functions. The README.TXT (this file) and PACKING.LST files also 
are found in this directory. The PACKING.LST file describes the contents
of each of the installation diskettes.

MSIMSL51\FORTRAN\EXAMPLES
-------------------------
This directory contains a README file with information pertaining to all 
the example programs.

MSIMSL51\FORTRAN\EXAMPLES\MATH\SINGLE
-------------------------------------
This directory contains the source code and associated makefile for 
several example programs that utilize some of the SINGLE-precision 
mathematical functions. The provided README file describes each program 
and how to create the executable programs.

MSIMSL51\FORTRAN\EXAMPLES\MATH\DOUBLE
-------------------------------------
This directory contains the source code and associated makefile for 
several example programs that utilize some of the DOUBLE-precision 
mathematical functions. The provided README file describes each program 
and how to create the executable programs. The programs are identical to 
those utilizing the single-precision mathematical functions--the only 
difference is the use of double-precision functions.

MSIMSL51\FORTRAN\EXAMPLES\STAT\SINGLE
-------------------------------------
This directory contains the source code and associated makefile for 
several example programs that utilize some of the SINGLE-precision 
statistical functions. The provided README file describes each program 
and how to create the executable programs.

MSIMSL51\FORTRAN\EXAMPLES\STAT\DOUBLE
-------------------------------------
This directory contains the source code and associated makefile for 
several example programs that utilize some of the DOUBLE-precision 
statistical functions. The provided README file describes each program 
and how to create the executable programs. The programs are identical to 
those utilizing the single-precision statistical functions--the only 
difference is the use of double-precision functions.

MSIMSL51\FORTRAN\HELP
---------------------
This directory is created to temporarily store the IMSL Libraries online
Help files if the Microsoft FORTRAN 5.1 Help files cannot be located.
Help for the Microsoft IMSL Libraries requires that the FORTRAN 5.1
Help be installed. For additional information about Help, see Part 3 of 
this file.

MSIMSL51\FORTRAN\INCLUDE
------------------------
This directory contains C language header files of function prototype
declarations that allow the Microsoft IMSL Libraries functions to be
called from C/C++ programs. For additional information about using the
IMSL Libraries functions in a C program, see Part 4 of this file.

MSIMSL51\FORTRAN\LIB
--------------------
This directory contains the Microsoft IMSL Mathematical & Statistical
Libraries. Separate libraries of single-precision and double-precision
functions are provided for both mathematical and statistical functions.

MSIMSL51\FORTRAN\SOURCE
-----------------------
This directory contains the source for several of the functions that 
query the operating system for system information.


==========================< Part 3: Online Help >==========================

The online Help supplied with the Microsoft IMSL Libraries uses the
QuickHelp format utilized by the Microsoft FORTRAN 5.1 Compiler and 
requires that FORTRAN 5.1 Help be installed on your system BEFORE you 
attempt to install Help for the IMSL Libraries. The Help files included 
with the Microsoft IMSL Libraries are:

   1) F51IMSL.HLP
   2) PWB.HLP

The PWB.HLP Help file is an updated version of the same file included 
with FORTRAN 5.1. This file contains an enhanced Microsoft Advisor, with 
the Microsoft IMSL Libraries included as an additional Help topic. This
file should replace the version provided with Microsoft FORTRAN 5.1.

During the installation of the Microsoft IMSL Libraries, SETUP will 
attempt to locate the FORTRAN 5.1 Help files by searching the directory 
or directories specified by the HELPFILES environment variable.

If the environment variable is defined and the FORTRAN 5.1 Help files 
are located, SETUP will automatically copy the IMSL Libraries Help files 
to the directory containing the FORTRAN 5.1 Help files. The current 
PWB.HLP file is replaced with the updated version supplied with the 
Microsoft IMSL Libraries.

If the environment variable is not defined, or if the FORTRAN 5.1 Help 
files cannot be located, you can have SETUP install the IMSL Libraries 
Help files in a 'holding' subdirectory (FORTRAN\HELP). This subdirectory 
is created under the destination directory specified for installation of 
the Microsoft IMSL Libraries. With this option you can extract the Help 
files from the installation diskettes along with the other components of 
the IMSL Libraries without having to rerun SETUP specifically to install 
Help.

If you choose to install Help to the 'holding' directory, you should 
perform the following steps after installing the Microsoft IMSL Libraries: 

   1. Exit the Microsoft IMSL Libraries SETUP.
   2. Run the Microsoft FORTRAN 5.1 SETUP.
   3. Install Help for FORTRAN 5.1.
   4. Exit the FORTRAN 5.1 SETUP.
   5. Define the HELPFILES environment variable (using the NEW-VARS.BAT 
      file)
   6. Move the IMSL Libraries Help files from the 'holding' directory to 
      the directory containing the FORTRAN 5.1 Help files (overwriting the
      PWB.HLP file with the one provided with the IMSL Libraries)
   7. Delete the 'holding' directory.

If you choose NOT to install the Help files to the 'holding' directory, 
Help will not be installed; however, installation of all other components 
of the Microsoft IMSL Libraries will continue. After installing the IMSL
Libraries, you should perform the following steps:

   1. Exit the Microsoft IMSL Libraries SETUP.
   2. Run the Microsoft FORTRAN 5.1 SETUP.
   3. Install Help for FORTRAN 5.1.
   4. Exit the FORTRAN 5.1 SETUP.
   5. Define the HELPFILES environment variable (using the NEW-VARS.BAT 
      file)
   6. Rerun the Microsoft IMSL Libraries SETUP.
   7. Select the Custom Installation Option and, when prompted for the 
      various components to install, choose to install Help only.
   8. Exit the Microsoft IMSL Libraries SETUP


==================< Part 4: Using Library Functions in >====================
==================< Mixed-Mode Programming Environment >====================

Several C language header (.h) files are included with the Microsoft IMSL
Libraries. These header files allow the Library functions to be used in a 
mixed-mode programming environment of FORTRAN and C.

The following header files are included:

   1. MATHD.H    - Function prototypes for the double-precision 
                   mathematical functions
   2. MATHS.H    - Function prototypes for the single-precision 
                   mathematical functions
   3. STATD.H    - Function prototypes for the double-precision 
                   statistical functions
   4. STATS.H    - Function prototypes for the single-precision 
                   statistical functions
   5. MS51IMSL.H - #include statements for all 4 header files

These header files are compatible with any C program compiled using any of 
the following Microsoft 16 bit C/C++ Compilers:

   - Microsoft C/C++ Version 7.0
   - Microsoft Visual C++(TM) Version 1.0
   - Microsoft Visual C++ Version 1.5


