README.TXT - Linux

GoPhast: Version 1.0.9.0, May 13, 2008
A Graphical User Interface for PHAST

NOTE: Any use of trade, product or firm names is for
descriptive purposes only and does not imply 
endorsement by the U.S. Government.

This version of MODFLOW-2000 is packaged for personal
computers using Microsoft Windows 2000, or XP.

A. DISTRIBUTION FILE

The following compressed is for use on Linux computers:

         GoPhast1_0_9.tar.gz

The distribution file contains:

          Compiled runfiles and source code for GoPhast and
          HelpGenerator.
          User documentation.
          Programmer's Guide
          Data files used to reproduce the examples in the User 
             documentation.
          Sample files for GoPhast.
          Project file for Help Generator to recreate the GoPhast 
             Programmer's Guide from the source code.
          Images used in the Programmer's Guide.

Web Indexer and the GoPhast testing tool are only
available for Windows.

B. EXTRACTING FILES

The distribution file is a compressed file.  The files should be 
extracted into a directory of the users choice while retaining the 
directory structure of the compressed files.  The following 
directory structure will be created.

   |
   |--bin             ; compiled executables, required dll's and project 
   |    |               files for WebIndexer, HelpGenerator and the 
   |    |               GoPhast testing tool.
   |    |     
   |    help          ; base directory for GoPhast context sensitive help
   |       |--files   ; main directory for GoPhast context sensitive help
   |--data            ; files used in recreating the examples
   |--doc             ; User's Guide
   |--guide           ; Programmer's Guide
   |                   
   |--samples         ; sample GoPhast files
   |--src             ; source code
   |    |     
   |    |--Components         ; source code for components used in GoPhast,  
   |    |                       WebIndexer,HelpGenerator and the GoPhast 
   |    |                        testing tool.
   |    |   
   |    |--GoPhast            ; GoPhast source code
   |    |--HelpGenerator      ; Help Generator source code

The user may need to create a symbolic link to the
libborqt-6.9.0-qt2.3.so file
named "libborqt-6.9-qt2.3.so"

The following command can be used to create the symbolic
link.

ln -s libborqt-6.9.0-qt2.3.so libborqt-6.9-qt2.3.so 

It is recommended that no user files are kept in the GoPhast directory
structure.  If you do plan to put files in the GoPhast directory
structure, do so only by creating subdirectories.

Included in directory GoPhast\doc are various documentation files.  Some
of them are Portable Document Format (PDF) files. The PDF files are readable
and printable on various computer platforms using Acrobat Reader from Adobe.
The Acrobat Reader is freely available from the following World Wide Web
sites:
      http://www.adobe.com/
      http://www.shareware.com/


C. COMPILING

Although executable versions of the programs are provided, the source
code is provided in the GoPhast\src directory so that the programs can
be recompiled if necessary.  The programs were compiled with Borland
Kylix version 3. No support can be provided for users generating their 
own versions of the software. 

In general, to install GoPhast, the components in the src\Components
directory must first be installed in Borland Kylix 3.  In addition the 
JEDI Code Library  must be installed (http://sourceforge.net/projects/jcl/)
Then the project file for GoPhast can be opened and compiled.

D. INSTALLING

To install GoPhast, extract the files from the distribuiton files being
sure to retain their directory structure

E. RUNNING THE SOFTWARE

GoPhast and Help Generator may be run by double-clicking on their respective
executables.