INSTALLING THE SOFTWARE The software is distributed as a Unix tar archive. To obtain the files, create an empty directory and change to it, download the tar archive for the desired version by anonymous ftp or via your Web browser to a file of the form 'bnn.YYYY-MM-DD.tar', and then issue the Unix command tar xf bnn.YYYY-MM-DD.tar If you got the archive in compressed form, as 'bnn.YYYY-MM-DD.tar.Z', you must use the command "uncompress bnn.YYYY-MM-DD.tar.Z" before doing the above. The following instructions cover what to do next for the current version; you should read the old documentation if for some reason you are installing an older version. The tar command should create sub-directories 'util', 'mc', 'net', 'bvg', 'examples', and 'doc', and place a large number of files in these sub-directories. It should also place the file 'README' in the current directory. If all this seems to have worked, you can remove the file 'bnn.YYYY-MM-DD.tar'. The directory 'doc' contains links to all the documentation files. The file 'manual' contains all the introductory documentation (including this) as a simple text file; the same information is also contained in several .doc files. Other .doc files contain more detailed information. Files of the form release.YYYY-MM-DD.doc contain information on current and past releases. These may be of interest if you are upgrading from an older version of the software. You can read these text files directly, or if you have a Web browser, you can access them via 'index.html', as described in Guide.doc. You will probably be able to compile the programs as described below without making having to change anything. However, it is possible that you will want to use a different C compiler, or set certain compilation options, in which case you will need to modify the 'Makefile' and 'xxx.make' files in the various directories. Also, the 'util' directory contains a file of 100,000 natural random bytes, which are used in combination with pseudo-random numbers. This file is accessed by many of the programs, using a path name that by default points into this 'util' directory. If you plan on moving this file elsewhere, you will need to change the compilation command for rand.c at the end of 'util/util.make'. Once you have made any required changes, you can compile the programs by issuing the following commands cd util make cd .. cd mc make cd .. cd net make cd .. cd bvg make cd .. The last three commands can be omitted if you have no interest in the demonstration of sampling from a bivariate Gaussian distribution. Note that common modules will be compiled over again for each directory where they are used; this is intentional. It is possible that these compilation commands will fail for some reason, in which case you'll have to figure out what's wrong and fix it. Note that for the makes to work correctly, the programs MUST be kept in separate 'util', 'mc', 'net', and 'bvg' sub-directories, with these names. Once the above make commands have been successful, you should put the directories 'util', 'mc', 'net', and perhaps 'bvg' in your search path. How this is done depends on the shell program you are using; consult a local expert if you don't know how. Subsequent instructions assume that this has been done.