This is a SOCKSified version of NCSA Mosaic 2.0. It is designed to
run on hosts behind a firewall to gain full access of a regular
Mosaic program. No direct IP accessibility to the Internet is
required on the client hosts, but it does require a SOCKS server,
which must run on a host that can directly connect to the client
hosts as well as the Internet.

To build the program, you must have a SOCKS library from a CSTC
release of the SOCKS package, which is avialble through anonymous
ftp from host ftp.nec.com in directory pub/security/socks.cstc.
The SOCKS server is included in the package, so are SOCKSified
clients of finger, telnet, and ftp. You may need these to make
rMosaic fully functional.

The adaptation was done by Ying-Da Lee <ylee@syl.dl.nec.com>
of C&C Software Technology Center (CSTC), NEC Systems Lab.
Comments, questions, and problem reports regarding thie version
of Mosaic should be sent to him, not NCSA staff.

--------------------------------------------------------------------------------

NCSA Mosaic for the X Window System Version 2.0
===============================================

Welcome to NCSA Mosaic for the X Window System 2.0!

This README details installation steps.  

README-2.0 details major differences and new features in Mosaic 2.0.

More complete information and documentation on NCSA Mosaic is
available online, via NCSA Mosaic.


Binaries
--------

NCSA Mosaic is known to compile on the following platforms:

  SGI (IRIX 4.0.2) 
  IBM (AIX 3.2 with IBM X11R5)
  Sun 4 (SunOS 4.1.3 with stock X11R4 and Motif 1.1).

Binaries for these platforms (and possibly others) are available on
ftp.ncsa.uiuc.edu in /Mosaic/Mosaic-binaries.

Rumor has it that Mosaic will compile on systems like:

  DECstation 5000-200 (Ultrix).
  DEC Alpha (OSF/1).
  Hewlett Packard HP/UX 7.x, 8.x, 9.x.
  Dell SVR4
  Sun Solaris 2.x
  SCO Open Desktop
  ...lots others...
  
If you have to make nontrivial changes to NCSA Mosaic to get it to
compile on a particular platform, please send a set of context diffs
(e.g., 'diff -c oldfile newfile') to mosaic-x@ncsa.uiuc.edu.


Installation Instructions
-------------------------

Simply examine the toplevel Makefile, change the appropriate
customizable options, and type 'make'.  

The final result is a single independent executable, src/Mosaic.

(The Makefile.[sun,dec,ibm,alpha,etc.] files are the Makefiles we use
locally for compilation on various platforms; they will almost
certainly NOT WORK for you without modification.  We recommend you
start with the stock Makefile and make modifications as necessary to
avoid confusion.)

There is one tricky thing:

-- You have the option of compiling in support for NCSA HDF, a
   platform-independent hierarchical scientific data format, and NCSA
   DTM, a network-based message-passing protocol useful for exchanging
   scientific data between applications.  If you compile one of them
   in, you should compile both of them in.  

   If you don't already know what HDF and DTM are and want to compile
   Mosaic quickly, forget about them for the time being -- you can
   always recompile later.

   The DTM library is in subdirectory libdtm.  The HDF library must be
   obtained separately from ftp.ncsa.uiuc.edu in /HDF; get version
   3.3r1 or later.  Set the various options in the Makefile to point
   to all the right places, and you should be set.


After You Have Compiled
-----------------------

If you do not normally run Motif on your system (e.g., if you run Sun
OpenWindows instead), then you may get a whole bunch of run-time
errors about translations when you start Mosaic.

If this happens, copy the file XKeysymDB (included in this directory)
to /usr/lib/X11.  (If you compile Mosaic yourself, you may need to
place this file elsewhere, depending on your X configuration.)  See
the FAQ list online for more information.


X Defaults
----------

NCSA Mosaic includes sets of fallback X resources that provide
reasonable screen display properties for three configurations: color,
monochrome, and color SGI.  (Color SGI has its own configuration since
SGI systems commonly use a gamma correction factor of 1.7, which makes
their screens brighter than usual.)

If you compile NCSA Mosaic out of the box, or if you download a binary
from ftp.ncsa.uiuc.edu, the default resources will be for a color
display (or, if you compile on an SGI, the default will be for color
SGI).  See the Makefile for information on how to have monochrome
resources by default.  On the command line, the flags '-mono' and
'-color' allow you to switch resource configurations at runtime.

For your convenience, three corresponding X app-defaults files are
included in this distribution: app-defaults.color,
app-defaults.color-sgi, and app-defaults.mono.


Bug Reports and Comments
------------------------

Bug reports and other comments can be sent to mosaic-x@ncsa.uiuc.edu.

If you find NCSA Mosaic useful or particularly interesting, please
also send us a note -- continued development of this project partially
depends on user feedback and support.


Cheers,

Marc Andreessen and Eric Bina
Software Development Group
National Center for Supercomputing Applications
University of Illinois at Urbana-Champaign
marca@ncsa.uiuc.edu, ebina@ncsa.uiuc.edu
