added -lstc++ info, convert more plain text to html

diff --git a/docs/download.html b/docs/download.html
index 79b34e4990f86d7b9b288db2c0dffacacc0aa39c..78c43bbb5ae3001fe65fabac72e2e29086bcfc79 100644 (file)
--- a/docs/download.html
+++ b/docs/download.html
@@ -71,7 +71,7 @@ util/         - handly utility functions
 widgets-mesa/  - Mesa widgets for Xt/Motif (obsolete)
 widgets-sgi/   - SGI OpenGL widgets for Xt/Motif
 
-and if you downloaded and unpacked the demos:
+and if you downloaded and unpacked the MesaDemos.X.Y archive:
 
 src-glut/      - source code for GLUT toolkit
 demos/         - GLUT demos

diff --git a/docs/install.html b/docs/install.html
index 1dedfa19c454f51bb6c22d906689798c9aa8ed18..f126097bba2313be28a27804c6c74c46b2f4ebd9 100644 (file)
--- a/docs/install.html
+++ b/docs/install.html
@@ -57,26 +57,52 @@ package)
 <a name="new">
 <H2>NEW-STYLE compilation and installation</H2>
 
-<pre>
-0) If you've downloaded Mesa via CVS there will not be a "configure"
+<p>
+<b> 0.</b> If you've downloaded Mesa via CVS there will not be a "configure"
    script.  You'll have to run the "bootstrap" script first.  This script
    may not work on any OS other than Linux.  You'll need these programs
    to run the bootstrap script:
+</p>
 
+<pre>
        autoconf 2.50
        automake 1.4-p2
        libtool 1.4
+</pre>
 
+<p>
+<b>1.</b> Run the configure script
+</p>
 
-1) Run the configure script
-
+<pre>
        ./configure [options]
+</pre>
 
+<p>
 For Linux, it is recommended that you use:
+</p>
+<pre>
        ./configure --prefix=/usr
+</pre>
+
 So that the headers and libs are located according to the Linux/OpenGL
 standard spec at http://oss.sgi.com/projects/ogl-sample/ABI/
-
+</p>
+<p>
+For Red Hat 8.0, Mandrake 9.1 and other Linux distros, you may have to use
+the following:
+</p>
+<pre>
+       export LDFLAGS="-lstdc++" ; ./configure --prefix=/usr
+    or
+        setenv LDFLAGS -lstdc++ ; ./configure --prefix=/usr
+</pre>
+<p>
+This works around a problem when building the GLU library.  It needs to
+be linked with the C++ runtime library, but libtool (for some reason)
+doesn't do this.
+</p>
+<pre>
 Possible options are:
 
 --prefix=DIR
@@ -185,47 +211,69 @@ Possible options are:
        
 --x-libraries=DIR
        Search for the X library files in DIR.
+</pre>
 
+<p>
 User specific compiler options can be set using the shell variable
 CFLAGS. For instance,
+</p>
+<pre>
        CFLAGS="-g -O2" ./configure
+</pre>
+<p>
 (on some systems: env CFLAGS="-g -O2" ./configure)
 sets the compiler flags to "-g -O2".
-
+</p>
+<p>
 For more options run "./configure --help" and read INSTALL.GNU.
+</p>
 
-2) To build the Mesa libraries run:
-
+<p>
+<b>2.</b> To build the Mesa libraries run:
+</p>
+<pre>
        make
-
-When finished, libGL.so will be in src/.libs/, libGLU.so will be in
+</pre>
+<p>
+When finished, libGL.so will be in src/.libs/ and libGLU.so will be in
 si-glu/.libs/, etc.
-
+</p>
+<p>
 Optionally, you can strip the libraries using
-
+</p>
+<pre>
        make strip
-       
+</pre>
+<p>
 Now make sure that you have the permissions to install Mesa in the 
 specified directories, for example, by becoming super user ("su")
 Then run:
-
+</p>
+<pre>
        make install
-
+</pre>
+<p>
 Mesa is now installed.
 Please don't move the installed files but rerun all installation
 steps if you want to use other directories.
+</p>
 
-
-3) To test whether Mesa works properly you might want to run the Mesa demos:
-
+<p>
+<b>3.</b>To test whether Mesa works properly you might want to run the
+Mesa demos:
+</p>
+<pre>
        make check
-       
+</pre>
+<p>
 Builds all demos.
-
+</p>
+<pre>
        make exec
-
-Builds and executes all demos. 
 </pre>
+<p>
+Builds and executes all demos. 
+</p>
 
 
 <a name="old">
@@ -242,9 +290,10 @@ first copy the top-level <code>Makefile.X11</code> file over
 </p>
 
 <p>
-First, just type <code>make</code> alone.
+Just type <code>make</code> alone.
 You'll see a list of supported system configurations.
-Choose one and type <code>make</code> <em>config</em>.
+Choose one and type <code>make</code> <em>config</em>
+(for example <code>make linux-x86</code>).
 The Mesa libraries and demo programs will be compiled.
 </p>