--- doc/loncapafiles/Attic/loncapafiles.html	2001/02/27 21:06:07	1.58
+++ doc/loncapafiles/Attic/loncapafiles.html	2001/02/27 21:30:13	1.59
@@ -191,7 +191,16 @@ browser and can only be seen be examinin
 <METAGROUP>
 <LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/access.conf" TARGET="etc/httpd/conf/access.conf" CATEGORY="conf">
 <DESCRIPTION>
-define handlers, set parameters
+This file has two major functions.
+For the Apache web server, it defines a global
+access configuration which defines what server options (Indexes", "Includes",
+"FollowSymLinks", "ExecCGI", or "MultiViews") are associated
+with specific directories ("/", "/home/httpd/html", "/home/httpd/cgi-bin",
+and "/usr/doc").  For the LON-CAPA network server and perl module
+handlers, it defines machine specific settings (lonHostID, lonRole,
+lonAdmEMail, lonDefDomain, lonLoadLim, lonExpire, and lonReceipt)
+and internal machine settings for specific directories, socket ports,
+and browser detection logic.
 </DESCRIPTION>
 <NOTE>
 <B>configure</B>
@@ -209,26 +218,30 @@ define handlers, set parameters
 <METAGROUP>
 <LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/httpd.conf" TARGET="etc/httpd/conf/httpd.conf" CATEGORY="static conf">
 <DESCRIPTION>
-main server configuration file
+This is the main server configuration file.  The settings here are
+more or less standard for the Apache web server.  Most notably (and
+importantly!), perl handling and mod_perl are enabled in this configuration
+file.
 </DESCRIPTION>
 </METAGROUP>
 <METAGROUP>
 <LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/srm.conf" TARGET="etc/httpd/conf/srm.conf" CATEGORY="static conf">
 <DESCRIPTION>
 <P>
-This file configures the "name space" of the Apache web server.  srm.conf
+This file configures the "name space" of the Apache web server.  
+<TT>srm.conf</TT>
 defines when specific perl modules should be called to handle a given
-request.  This definition is a function of the name of the perl module,
+request.  This definition is a function of both the name of the perl module,
 and a specific regular expression associated with the URL, such as
 "^/res/.*\.page".
 </P>
 <P>
 Here is an example entry:
 <PRE>
-<LocationMatch "^/res/.*\.page$>
+&lt;LocationMatch "^/res/.*\.page$&gt;
 SetHandler perl-script
 PerlHandler Apache::lonpage
-</LocationMatch>
+&lt;/LocationMatch&gt;
 </PRE>
 </P>
 </DESCRIPTION>
@@ -236,7 +249,10 @@ PerlHandler Apache::lonpage
 <METAGROUP>
 <LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/startup.pl" TARGET="etc/httpd/conf/startup.pl" CATEGORY="static conf">
 <DESCRIPTION>
-set paths to modules; invoked by <TT>access.conf</TT>
+This file provides initializations for perl handlers.  It adjusts what
+the module path space is (so as to include /home/httpd/lib/perl/Apache) as
+well as causing the Apache module to be used for every perl handler.
+<TT>startup.pl</TT> is invoked by <TT>access.conf</TT>.
 </DESCRIPTION>
 </METAGROUP>
 <METAGROUP>