updated

LDP/howto/docbook/LinuxGL-QuakeWorld-mini-HOWTO.sgml

@@ -19,8 +19,8 @@
 
    <revhistory>
       <revision>
-         <revnumber>v1.0</revnumber>
-         <date>Aug 19, 2000</date>
+         <revnumber>v1.1</revnumber>
+         <date>Aug 28, 2000</date>
          <authorinitials>rbe</authorinitials>
       </revision>
    </revhistory>
@@ -61,8 +61,19 @@
    <para>
     <ulink url="http://www.comptechnews.com/~reaster/linux-glxqw.txt">http://www.comptechnews.com/~reaster/linux-glxqw.txt</ulink>
    </para>
+
+   <para>
+	If you'd like a ready to compile distribution of QuakeWorld that
+	has this HOWTO's procedures performed on it already, then you
+	can download it at:
+   </para>
+
+   <para>
+    <ulink url="http://www.comptechnews.com/~reaster/index.html#games">http://www.comptechnews.com/~reaster/index.html#games</ulink>
+   </para>
   </sect2>
 
+
   <sect2 id="copyright">
    <title>Copyright Information</title>
 
@@ -220,8 +231,17 @@ QuakeWorld clients come in several flavors:
      </para>
 	
      <para>
-	Depending on your setup, you might not need to actually install the
-	Mesa libs, but if you want to:
+	Depending on your setup, you might not need to actually install Mesa.
+	If you are going to install Mesa, be aware that Mesa will install over
+	the libGL.* files you already have in /usr/lib.  Those libGL.* files
+	are likely to be your hardware accelerated versions.  Installing Mesa
+	will also overwrite the glx include files in /usr/X11R6/include/GL.
+	Therefore, before you install Mesa, make a backup of /usr/lib/libGL.*
+	and /usr/X11R6/include/GL/glx*.h.
+	</para>
+	
+	<para>
+	To install it:
         <screen>
 
 	make install
@@ -230,17 +250,44 @@ QuakeWorld clients come in several flavors:
        
      <para>
 	After you install the full Mesa package, you might need to reinstall
-	your hardware accelerated libGL files.  By installing the Mesa libs,
-	you will get the libGLU* files and the full Mesa include files
-	installed on your system.  XFree86 4.0.1 appeared to be lacking
-	libGLU* and some of the header/include files of Mesa.
-     </para>
-       
+	your hardware accelerated libGL files or restore the backup suggested
+	above.  You also need to restore the glx include files.  You can
+	restore the glx include files either by restoring the files that
+	you backed up as suggested above, or if you have the source to X
+	still lying around, then you can copy the include files from
+	the source: cp xc/include/GL/*.h /usr/X11R6/include/GL
+	</para>
+
+	<para>
+	By installing the Mesa libs, you will get the libGLU* files and
+	associated include files installed on your system.  XFree86 4.0.1
+	appeared to be lacking libGLU* and its include files.  GLU, the
+	OpenGL Utility library is a standard part of a normal OpenGL
+	installation that is missing from XFree86 4 and may not come with
+	vendor-specific OpenGL drivers either.
+	</para>
+	
      <para>
 	XFree86 4.0.1 appears to have included only the core of Mesa 3.3,
 	which at the time was/is a development version of MesaGL.  The
 	direct rendering infrusture (DRI) of XFree86 is based on Mesa code.
      </para>
+
+     <para>
+	If you happen to have an Nvidia card and are interested in a
+	complete HOWTO for installing the Nvidia drivers and an
+	assortment of OpenGL libraries (GLU, glut, Qt, OpenGL man pages),
+	then see the NVIDIA-OpenGL-Configuration_miniHOWTO at:
+	</para>
+	
+	<para>
+	<ulink url="http://www.comptechnews.com/~reaster/nvgl.txt">http://www.comptechnews.com/~reaster/nvgl.txt</ulink>
+	</para>
+	
+	<para>
+	You can check the LDP for it also.
+     </para>
+
  </listitem>
 	
  <listitem>
@@ -643,7 +690,13 @@ QuakeWorld clients come in several flavors:
 	directories you like/have - ctf, Fortress etc - to your new
 	quakeworld directory.
      </para>
+</listitem>
 
+<listitem>
+	<para>
+	Running the game.
+	</para>
+	
      <para>
 	You might want to run it like this from XQF:
 	<command>glqwcl.glx -width 1280 -height 1024</command>
@@ -741,6 +794,35 @@ QuakeWorld clients come in several flavors:
     </variablelist>
    </para>
 
+	<para>
+	Light effects.
+	</para>
+
+	<para>	
+		At the console, you can try turning on and off the flashblend function
+		and see which lighting effects you prefer:
+	<screen>
+			
+		gl_flashblend 0
+		gl_flashblend 1		
+	</screen>
+		
+	</para>
+		
+	<para>
+		When it is on (1), you may notice colored light effects around flags
+		and special items.  In this mode, you may NOT see flashes from
+		weapons and light on the walls from rockets.  The exact effects of
+		toggling flashblend may depend on your specific OpenGL installation.
+	</para>
+
+	<para>		
+		When it is off (0), there may not be any COLORED light, but otherwise
+		all light effects work.  Flags and special items have a glow around
+		them and light up surrounding surfaces.  Weapons flash when fired and
+		rockets light up everything around them as they travel.
+	</para>
+
  </listitem>
 
  <listitem>