--- loncom/build/readme.html	2001/01/17 11:06:03	1.2
+++ loncom/build/readme.html	2001/01/17 11:20:32	1.7
@@ -24,34 +24,63 @@
 <A NAME="Using_CVS">
 <LI><H2>Using CVS</H2>
 <UL>
-<UL>
 <LI><A NAME="cvslog">
     <H3>Using CVS: Logging in and out (cvs login; cvs logout)</H3>
 <LI><A NAME="cvsget">
     <H3>Using CVS: Getting files (cvs update -d)</H3>
 <LI><A NAME="cvsupdate">
-    <H3>Updating files (cvs update -d)</H3>
+    <H3>Using CVS: Updating files (cvs update -d)</H3>
 <LI><A NAME="cvssave">
-    <H3>Saving files (cvs commit)</H3>
+    <H3>Using CVS: Saving files (cvs commit)</H3>
 <LI><A NAME="cvsadd">
-    <H3>Adding files (cvs add)</H3>
+    <H3>Using CVS: Adding files (cvs add)</H3>
 <LI><A NAME="cvsadddir">
-    <H3>Adding directories (cvs add/import)</H3>
+    <H3>Using CVS: Adding directories (cvs add/import)</H3>
 <LI><A NAME="cvsnotsure">
-    <H3>What to do when you're not sure about your files (cvs update)</H3>
+    <H3>Using CVS: What to do when you're not sure about your files (cvs update)</H3>
 </UL>
 <LI><A NAME="makeHTML">
-    <H3>Viewing the software (make HTML)</H3>
+    <H2>Viewing the software (make HTML)</H2>
+<STRONG>Commands</STRONG>
+<FONT COLOR="#008800">
+<PRE>
+cd loncom/build
+rm -Rf HTML
+make HTML
+cd HTML
+<I>(look at the index.html file with a web browser such as Netscape)</I>
+</PRE>
+</FONT>
+<STRONG>General description of what happens</STRONG>
+<P>
+This is the actual make target code.
+<FONT COLOR="#880000">
+<PRE>
+<!-- LONCAPA MAKETARGET=HTML START -->
+HTML:
+        install -d HTML
+        cp ../../doc/loncapafiles/*.gif HTML
+        perl parse.pl ../../doc/loncapafiles/loncapafiles.html HTML > HTML/index.html
+<!-- LONCAPA MAKETARGET=HTML END -->
+</PRE>
+</FONT>
+What basically happens is that specially marked-up data in the LON-CAPA
+cvs repository file <TT>doc/loncapafiles.html</TT> is parsed into a more
+viewable format by <TT>loncom/build/parse.pl</TT>.  The resulting
+file gives a very well organized view of all the files, directories,
+links, ownerships, permissions, and brief documentation of what each
+file does.
+</P>
 <LI><A NAME="makebuild">
-    <H3>Compiling the software (make build)</H3>
+    <H2>Compiling the software (make build)</H2>
 <LI><A NAME="loncapafiles">
-    <H3>Adding/removing files from the LON-CAPA installation (doc/loncapafiles/loncapafiles.html)</H3>
+    <H2>Adding/removing files from the LON-CAPA installation (doc/loncapafiles/loncapafiles.html)</H2>
 <LI><A NAME="configversusnonconfig">
-    <H3>Configurable files versus non-configurable files</H3>
+    <H2>Configurable files versus non-configurable files</H2>
 <LI><A NAME="makeinstall">
-    <H3>Updating the non-configurable files on your machine (make install)</H3>
+    <H2>Updating the non-configurable files on your machine (make install)</H2>
 <LI><A NAME="makeconfiginstall">
-    <H3>Updating the configurable files on your machine (make configinstall)</H3>
+    <H2>Updating the configurable files on your machine (make configinstall)</H2>
 <LI><A NAME="makeRPM">
-    <H3>Building RPMs (make RPM)</H3>
+    <H2>Building RPMs (make RPM)</H2>
 </OL>