home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 May / PCO_5_97.ISO / FilesBBS / OS2 / MOSAIC.ARJ / MOSAIC.ZIP / xfree86 / doc / Mosaic / README < prev    next >
Encoding:
Text File  |  1995-11-28  |  4.4 KB  |  121 lines
  1. NCSA Mosaic for the X Window System Version 2.6
  2. ===============================================
  3.  
  4. Welcome to NCSA Mosaic for the X Window System 2.6!
  5.  
  6. This README details installation steps.
  7.  
  8. More complete information and documentation on NCSA Mosaic is
  9. available online, via NCSA Mosaic.
  10.  
  11.  
  12. Binaries
  13. --------
  14.  
  15. NCSA Mosaic is known to compile on the following platforms:
  16.  
  17.   SGI (IRIX 4.0.x and 5.x) 
  18.   IBM (AIX 3.2.4)
  19.   Sun (SunOS 4.1.3, 5.3, and 5.4 (Solaris))
  20.   DECstation 5000-200 (Ultrix 4.x)
  21.   DEC Alpha (OSF/1 1.3 and 3.0)
  22.   Hewlett Packard (HP/UX 7.x, 8.x, 9.x)
  23.   Pentium (Linux 1.1.94)
  24.  
  25. Binaries for these platforms (and possibly others) are available on
  26. ftp.ncsa.uiuc.edu in /Mosaic/Unix/binaries/
  27.  
  28. If you have to make nontrivial changes to NCSA Mosaic to get it to
  29. compile on a particular platform, please send a set of context diffs
  30. (e.g., 'diff -c oldfile newfile') to mosaic-x@ncsa.uiuc.edu.
  31.  
  32.  
  33. Installation Instructions
  34. -------------------------
  35.  
  36. Simply examine the toplevel Makefile, change the appropriate
  37. customizable options, and type 'make'.  
  38.  
  39. The final result is a single independent executable, src/Mosaic.
  40.  
  41. (The Makefile.[sun,dec,ibm,alpha,etc.] files are the Makefiles we use
  42. locally for compilation on various platforms; they will almost
  43. certainly NOT WORK for you without modification.  We recommend you
  44. start with the stock Makefile and make modifications as necessary to
  45. avoid confusion.)
  46.  
  47. There is one tricky thing:
  48.  
  49. -- You have the option of compiling in support for NCSA HDF, a
  50.    platform-independent hierarchical scientific data format, and NCSA
  51.    DTM, a network-based message-passing protocol useful for exchanging
  52.    scientific data between applications.  If you compile one of them
  53.    in, you should compile both of them in.  
  54.  
  55.    If you don't already know what HDF and DTM are and want to compile
  56.    Mosaic quickly, forget about them for the time being -- you can
  57.    always recompile later.
  58.  
  59.    The DTM library is in subdirectory libdtm.  The HDF library must be
  60.    obtained separately from ftp.ncsa.uiuc.edu in /HDF; get version
  61.    4.0b1 or later.  Set the various options in the Makefile to point
  62.    to all the right places, and you should be set.
  63.  
  64.    NOTE: Nothing less than 4.0b1 will work.
  65.  
  66. After You Have Compiled
  67. -----------------------
  68.  
  69. If you do not normally run Motif on your system (e.g., if you run Sun
  70. OpenWindows instead), then you may get a whole bunch of run-time
  71. errors about translations when you start Mosaic.
  72.  
  73. If this happens, copy the file XKeysymDB (included in this directory)
  74. to /usr/lib/X11.  (If you compile Mosaic yourself, you may need to
  75. place this file elsewhere, depending on your X configuration.)  See
  76. the FAQ list online for more information.
  77.  
  78.  
  79. X Defaults
  80. ----------
  81.  
  82. NCSA Mosaic includes sets of fallback X resources that provide
  83. reasonable screen display properties for three configurations: color,
  84. monochrome, and color SGI.  (Color SGI has its own configuration since
  85. SGI systems commonly use a gamma correction factor of 1.7, which makes
  86. their screens brighter than usual.)
  87.  
  88. If you compile NCSA Mosaic out of the box, or if you download a binary
  89. from ftp.ncsa.uiuc.edu, the default resources will be for a color
  90. display (or, if you compile on an SGI, the default will be for color
  91. SGI).  See the Makefile for information on how to have monochrome
  92. resources by default.  On the command line, the flags '-mono' and
  93. '-color' allow you to switch resource configurations at runtime.
  94.  
  95. For your convenience, three corresponding X app-defaults files are
  96. included in this distribution: app-defaults.color,
  97. app-defaults.color-sgi, and app-defaults.mono.
  98.  
  99.  
  100. Bug Reports and Comments
  101. ------------------------
  102.  
  103. Bug reports and other comments can be sent to mosaic-x@ncsa.uiuc.edu.
  104.  
  105. If you find NCSA Mosaic useful or particularly interesting, please
  106. also send us a note -- continued development of this project partially
  107. depends on user feedback and support.
  108.  
  109.  
  110. --
  111. =============================================================================
  112. Scott Powers    spowers@ncsa.uiuc.edu \        The N.C.S.A. X Mosaic
  113. Kristin Buxton  kbuxton@uiuc.edu       \         Development Team
  114. Dan Pape        dpape@ncsa.uiuc.edu     > 
  115. Tommy Reilly    tpreilly@uiuc.edu      /  Comments? Suggestions? Problems?
  116. Brian Swetland  swetland@uiuc.edu     /       mosaic-x@ncsa.uiuc.edu
  117. =============================================================================
  118.  
  119. Software Development Group
  120. National Center for Supercomputing Applications
  121.