--- loncom/build/readme.html	2001/01/16 17:58:43	1.1
+++ loncom/build/readme.html	2001/01/17 11:20:32	1.7
@@ -1,22 +1,86 @@
 <H1>LON-CAPA Software Developer Instructions</H1>
 
+<OL>
+<LI><A HREF="#Using_CVS">Using CVS</A>
 <UL>
-<LI>Using CVS
-<UL>
-<LI>Logging in and out (cvs login; cvs logout)
-<LI>Getting files (cvs update -d)
-<LI>Updating files (cvs update -d)
-<LI>Saving files (cvs commit)
-<LI>Adding files (cvs add)
-<LI>Adding directories (cvs add/import)
-<LI>What to do when you're not sure about your files (cvs update)
-</UL>
-<LI>Viewing the software (make HTML)
-<LI>Compiling the software (make build)
-<LI>Adding/removing files from the LON-CAPA installation (doc/loncapafiles/loncapafiles.html)
-<LI>Configurable files versus non-configurable files
-<LI>Updating the non-configurable files on your machine (make install)
-<LI>Updating the configurable files on your machine (make configinstall)
-<LI>Building RPMs (make RPM)
+<LI><A HREF="#cvslog">Logging in and out (cvs login; cvs logout)</A>
+<LI><A HREF="#cvsget">Getting files (cvs update -d)</A>
+<LI><A HREF="#cvsupdate">Updating files (cvs update -d)</A>
+<LI><A HREF="#cvssave">Saving files (cvs commit)</A>
+<LI><A HREF="#cvsadd">Adding files (cvs add)</A>
+<LI><A HREF="#cvsadddir">Adding directories (cvs add/import)</A>
+<LI><A HREF="#cvsnotsure">What to do when you're not sure about your files (cvs update)</A>
 </UL>
+<LI><A HREF="#makeHTML">Viewing the software (make HTML)</A>
+<LI><A HREF="#makebuild">Compiling the software (make build)</A>
+<LI><A HREF="#loncapafiles">Adding/removing files from the LON-CAPA installation (doc/loncapafiles/loncapafiles.html)</A>
+<LI><A HREF="#configversusnonconfig">Configurable files versus non-configurable files</A>
+<LI><A HREF="#makeinstall">Updating the non-configurable files on your machine (make install)</A>
+<LI><A HREF="#makeconfiginstall">Updating the configurable files on your machine (make configinstall)</A>
+<LI><A HREF="#makeRPM">Building RPMs (make RPM)</A>
+</OL>
 
+<OL>
+<A NAME="Using_CVS">
+<LI><H2>Using CVS</H2>
+<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>Using CVS: Updating files (cvs update -d)</H3>
+<LI><A NAME="cvssave">
+    <H3>Using CVS: Saving files (cvs commit)</H3>
+<LI><A NAME="cvsadd">
+    <H3>Using CVS: Adding files (cvs add)</H3>
+<LI><A NAME="cvsadddir">
+    <H3>Using CVS: Adding directories (cvs add/import)</H3>
+<LI><A NAME="cvsnotsure">
+    <H3>Using CVS: What to do when you're not sure about your files (cvs update)</H3>
+</UL>
+<LI><A NAME="makeHTML">
+    <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">
+    <H2>Compiling the software (make build)</H2>
+<LI><A NAME="loncapafiles">
+    <H2>Adding/removing files from the LON-CAPA installation (doc/loncapafiles/loncapafiles.html)</H2>
+<LI><A NAME="configversusnonconfig">
+    <H2>Configurable files versus non-configurable files</H2>
+<LI><A NAME="makeinstall">
+    <H2>Updating the non-configurable files on your machine (make install)</H2>
+<LI><A NAME="makeconfiginstall">
+    <H2>Updating the configurable files on your machine (make configinstall)</H2>
+<LI><A NAME="makeRPM">
+    <H2>Building RPMs (make RPM)</H2>
+</OL>