--- doc/loncapafiles/loncapafiles.lpml	2002/04/21 23:02:58	1.117
+++ doc/loncapafiles/loncapafiles.lpml	2002/05/16 01:33:45	1.129
@@ -3,7 +3,7 @@
 <!-- loncapafiles.lpml -->
 <!-- Scott Harrison -->
 
-<!-- $Id: loncapafiles.lpml,v 1.117 2002/04/21 23:02:58 harris41 Exp $ -->
+<!-- $Id: loncapafiles.lpml,v 1.129 2002/05/16 01:33:45 harris41 Exp $ -->
 
 <!--
 
@@ -216,7 +216,7 @@ echo '**********************************
 <rpmRequires>
 <item>PreReq: LON-CAPA-setup</item>
 <item>PreReq: apache</item>
-<item>PreReq: /etc/httpd/conf/access.conf</item>
+<item>PreReq: /etc/httpd/conf/httpd.conf</item>
 </rpmRequires>
 </rpm>
 <directories>
@@ -364,6 +364,12 @@ Used by lond parent to check if children
   </description>
 </directory>
 <directory dist='default'>
+  <targetdir dist='default'>home/httpd/lib/perl/LONCAPA</targetdir>
+  <categoryname>server readonly</categoryname>
+  <description>location of HTML specific perl module fixes and additions
+  </description>
+</directory>
+<directory dist='default'>
   <targetdir dist='default'>home/httpd/lonIDs</targetdir>
   <categoryname>server standard</categoryname>
   <description>cookie jar</description>
@@ -409,13 +415,14 @@ Used by lond parent to check if children
   <description>online help documentation</description>
 </directory>
 <directory dist='default'>
-  <targetdir dist='default'>home/httpd/html/adm/help/api</targetdir>
+  <targetdir dist='default'>home/httpd/html/adm/help/lib/perl</targetdir>
   <categoryname>server readonly</categoryname>
   <description>online help documentation for the LON-CAPA programming
 interface</description>
 </directory>
 <directory dist='default'>
-  <targetdir dist='default'>home/httpd/html/adm/help/api/Apache</targetdir>
+  <targetdir dist='default'>home/httpd/html/adm/help/lib/perl/Apache
+  </targetdir>
   <categoryname>server readonly</categoryname>
   <description>online help documentation for the LON-CAPA programming
 interface, Apache (mod_perl) handlers</description>
@@ -564,25 +571,23 @@ each list element consists of only two s
 <target dist='default'>etc/httpd/conf/loncapa.conf</target>
 <categoryname>conf</categoryname>
 <description>
+<p>
 The goal of this file is to implement all LON-CAPA specific
-customization of the Apache web server.
-</description>
-</file>
-<file>
-<source>loncom/access.conf</source>
-<target dist='default'>etc/httpd/conf/access.conf</target>
-<categoryname>conf</categoryname>
-<description>
-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.
+customization of the Apache web server (most all of these values
+require manual input from the system administrator at some point).
+The values in this file, as opposed to loncapa_apache.conf, are
+meant to be machine and institution specific.
+</p>
+<p>
+For the LON-CAPA network server and perl module
+handlers, it defines machine specific settings including lonHostID, lonRole,
+lonAdmEMail, lonDefDomain, lonLoadLim, lonExpire, and lonReceipt.
+</p>
+<p>
+This file should not be viewable by regular users of the system.
+Only root and www should be able to view the contents of this file
+since lonReceipt is sensitive.
+</p>
 </description>
 <note>
 <b>configure</b>
@@ -604,6 +609,25 @@ MySQL database</td></tr>
 </note>
 </file>
 <file>
+<source>loncom/loncapa_apache.conf</source>
+<target dist='default'>etc/httpd/conf/loncapa_apache.conf</target>
+<categoryname>static conf</categoryname>
+<description>
+The goal of this file is to implement all LON-CAPA specific
+customization of the Apache web server that does not require
+user input.
+
+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 
+and internal machine settings for specific directories, socket ports,
+the www@localhost MySQL password, and browser detection logic.
+</description>
+</file>
+<file>
 <source>loncom/startup.pl</source>
 <target dist='default'>etc/httpd/conf/startup.pl</target>
 <categoryname>static conf</categoryname>
@@ -1059,6 +1083,17 @@ new user.
 <status>being updated</status>
 </file>
 <file>
+<source>loncom/lchtmldir</source>
+<target dist='default'>home/httpd/perl/lchtmldir</target>
+<categoryname>setuid script</categoryname>
+<description>
+Manages the file system rammifications of adding author mode to a user. 
+If necessary a public_html diretory is added, permissions and ownership are
+set according to the user's authentication mode.
+</description>
+<status>New file</status>
+</file>
+<file>
 <source>loncom/lcuserdel</source>
 <target dist='default'>home/httpd/perl/lcuserdel</target>
 <categoryname>setuid script</categoryname>
@@ -1244,14 +1279,15 @@ loncom/build/pod2man.sh ../publisher/lon
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonupload.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonupload.html
+<source>doc/lib/perl/Apache/lonupload.html</source>
+<target dist='default'>home/httpd/html/adm/help/lib/perl/Apache/lonupload.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonupload.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../publisher/lonupload.pm &gt; \
-../../doc/api/Apache/lonupload.html &amp;&amp; echo 'pod2html lonupload.pm'
+../../doc/lib/perl/Apache/lonupload.html &amp;&amp; \
+echo 'pod2html lonupload.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -1308,14 +1344,15 @@ loncom/build/pod2man.sh ../publisher/lon
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonpubdir.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonpubdir.html
+<source>doc/lib/perl/Apache/lonpubdir.html</source>
+<target dist='default'>home/httpd/html/adm/help/lib/perl/Apache/lonpubdir.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonpubdir.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../publisher/lonpubdir.pm &gt; \
-../../doc/api/Apache/lonpubdir.html &amp;&amp; echo 'pod2html lonpubdir.pm'
+../../doc/lib/perl/Apache/lonpubdir.html &amp;&amp; \
+echo 'pod2html lonpubdir.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -1346,14 +1383,16 @@ loncom/build/pod2man.sh ../publisher/lon
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonretrieve.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonretrieve.html
+<source>doc/lib/perl/Apache/lonretrieve.html</source>
+<target dist='default'>
+home/httpd/html/adm/help/lib/perl/Apache/lonretrieve.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonretrieve.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../publisher/lonretrieve.pm &gt; \
-../../doc/api/Apache/lonretrieve.html &amp;&amp; echo 'pod2html lonretrieve.pm'
+../../doc/lib/perl/Apache/lonretrieve.html &amp;&amp; \
+echo 'pod2html lonretrieve.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -1383,12 +1422,14 @@ echo 'manifying edit.pm'
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/edit.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/edit.html</target>
+<source>doc/lib/perl/Apache/edit.html</source>
+<target dist='default'>home/httpd/html/adm/help/lib/perl/Apache/edit.html
+</target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for edit.pm</description>
 <build trigger='always run'>
-loncom/build/pod2html.sh ../homework/edit.pm &gt; ../../doc/api/Apache/edit.html \
+loncom/build/pod2html.sh ../homework/edit.pm &gt; \
+../../doc/lib/perl/Apache/edit.html \
 &amp;&amp; echo 'pod2html edit.pm'
 </build>
 <status>works/unverified</status>
@@ -1483,14 +1524,15 @@ loncom/build/pod2man.sh ../interface/lon
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/loncommon.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/loncommon.html
+<source>doc/lib/perl/Apache/loncommon.html</source>
+<target dist='default'>home/httpd/html/adm/help/lib/perl/Apache/loncommon.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for loncommon.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../interface/loncommon.pm &gt; \
-../../doc/api/Apache/loncommon.html &amp;&amp; echo 'pod2html loncommon.pm'
+../../doc/lib/perl/Apache/loncommon.html &amp;&amp; \
+echo 'pod2html loncommon.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -1649,14 +1691,16 @@ loncom/build/pod2man.sh ../interface/lon
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonsearchcat.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonsearchcat.html
+<source>doc/lib/perl/Apache/lonsearchcat.html</source>
+<target dist='default'>
+home/httpd/html/adm/help/lib/perl/Apache/lonsearchcat.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonsearchcat.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../interface/lonsearchcat.pm &gt; \
-../../doc/api/Apache/lonsearchcat.html &amp;&amp; echo 'pod2html lonsearchcat.pm'
+../../doc/lib/perl/Apache/lonsearchcat.html &amp;&amp; \
+echo 'pod2html lonsearchcat.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -1734,14 +1778,15 @@ loncom/build/pod2man.sh ../interface/lon
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonparmset.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonparmset.html
+<source>doc/lib/perl/Apache/lonparmset.html</source>
+<target dist='default'>home/httpd/html/adm/help/lib/perl/Apache/lonparmset.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonparmset.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../interface/lonparmset.pm &gt; \
-../../doc/api/Apache/lonparmset.html &amp;&amp; echo 'pod2html lonparmset.pm'
+../../doc/lib/perl/Apache/lonparmset.html &amp;&amp; \
+echo 'pod2html lonparmset.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -1782,14 +1827,16 @@ loncom/build/pod2man.sh ../publisher/lon
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonpublisher.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonpublisher.html
+<source>doc/lib/perl/Apache/lonpublisher.html</source>
+<target dist='default'>
+home/httpd/html/adm/help/lib/perl/Apache/lonpublisher.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonpublisher.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../publisher/lonpublisher.pm &gt; \
-../../doc/api/Apache/lonpublisher.html &amp;&amp; echo 'pod2html lonpublisher.pm'
+../../doc/lib/perl/Apache/lonpublisher.html &amp;&amp; \
+echo 'pod2html lonpublisher.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -1884,14 +1931,14 @@ loncom/build/pod2man.sh ../../rat/lonpag
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonpage.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonpage.html
+<source>doc/lib/perl/Apache/lonpage.html</source>
+<target dist='default'>home/httpd/html/adm/help/lib/perl/Apache/lonpage.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonnet.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../../rat/lonpage.pm &gt; \
-../../doc/api/Apache/lonpage.html &amp;&amp; echo 'pod2html lonpage.pm'
+../../doc/lib/perl/Apache/lonpage.html &amp;&amp; echo 'pod2html lonpage.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -1922,14 +1969,16 @@ loncom/build/pod2man.sh ../../rat/lonuse
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonuserstate.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonuserstate.html
+<source>doc/lib/perl/Apache/lonuserstate.html</source>
+<target dist='default'>
+home/httpd/html/adm/help/lib/perl/Apache/lonuserstate.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonuserstate.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../../rat/lonuserstate.pm &gt; \
-../../doc/api/Apache/lonuserstate.html &amp;&amp; echo 'pod2html lonuserstate.pm'
+../../doc/lib/perl/Apache/lonuserstate.html &amp;&amp; \
+echo 'pod2html lonuserstate.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -2112,13 +2161,14 @@ loncom/build/pod2man.sh ../auth/lonacc.p
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonacc.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonacc.html</target>
+<source>doc/lib/perl/Apache/lonacc.html</source>
+<target dist='default'>
+home/httpd/html/adm/help/lib/perl/Apache/lonacc.html</target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonacc.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../auth/lonacc.pm &gt; \
-../../doc/api/Apache/lonacc.html &amp;&amp; echo 'pod2html lonacc.pm'
+../../doc/lib/perl/Apache/lonacc.html &amp;&amp; echo 'pod2html lonacc.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -2149,14 +2199,14 @@ loncom/build/pod2man.sh ../auth/lonracc.
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonracc.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonracc.html
+<source>doc/lib/perl/Apache/lonracc.html</source>
+<target dist='default'>home/httpd/html/adm/help/lib/perl/Apache/lonracc.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonracc.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../auth/lonracc.pm &gt; \
-../../doc/api/Apache/lonracc.html &amp;&amp; echo 'pod2html lonracc.pm'
+../../doc/lib/perl/Apache/lonracc.html &amp;&amp; echo 'pod2html lonracc.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -2196,14 +2246,14 @@ loncom/build/pod2man.sh ../auth/loncacc.
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/loncacc.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/loncacc.html
+<source>doc/lib/perl/Apache/loncacc.html</source>
+<target dist='default'>home/httpd/html/adm/help/lib/perl/Apache/loncacc.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for loncacc.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../auth/loncacc.pm &gt; \
-../../doc/api/Apache/loncacc.html &amp;&amp; echo 'pod2html loncacc.pm'
+../../doc/lib/perl/Apache/loncacc.html &amp;&amp; echo 'pod2html loncacc.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -2266,14 +2316,14 @@ loncom/build/pod2man.sh ../auth/lonroles
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonroles.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonroles.html
+<source>doc/lib/perl/Apache/lonroles.html</source>
+<target dist='default'>home/httpd/html/adm/help/lib/perl/Apache/lonroles.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonroles.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../auth/lonroles.pm &gt; \
-../../doc/api/Apache/lonroles.html &amp;&amp; echo 'pod2html lonroles.pm'
+../../doc/lib/perl/Apache/lonroles.html &amp;&amp; echo 'pod2html lonroles.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -2304,14 +2354,15 @@ loncom/build/pod2man.sh ../interface/lon
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonindexer.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonindexer.html
+<source>doc/lib/perl/Apache/lonindexer.html</source>
+<target dist='default'>home/httpd/html/adm/help/lib/perl/Apache/lonindexer.html
 </target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonindexer.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../interface/lonindexer.pm &gt; \
-../../doc/api/Apache/lonindexer.html &amp;&amp; echo 'pod2html lonindexer.pm'
+../../doc/lib/perl/Apache/lonindexer.html &amp;&amp; \
+echo 'pod2html lonindexer.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -2361,13 +2412,14 @@ loncom/build/pod2man.sh ../lonnet/perl/l
 </dependencies>
 </file>
 <file>
-<source>doc/api/Apache/lonnet.html</source>
-<target dist='default'>home/httpd/html/adm/help/api/Apache/lonnet.html</target>
+<source>doc/lib/perl/Apache/lonnet.html</source>
+<target dist='default'>home/httpd/html/adm/help/lib/perl/Apache/lonnet.html
+</target>
 <categoryname>doc</categoryname>
 <description>POD-derived page for lonnet.pm</description>
 <build trigger='always run'>
 loncom/build/pod2html.sh ../lonnet/perl/lonnet.pm &gt; \
-../../doc/api/Apache/lonnet.html &amp;&amp; echo 'pod2html lonnet.pm'
+../../doc/lib/perl/Apache/lonnet.html &amp;&amp; echo 'pod2html lonnet.pm'
 </build>
 <status>works/unverified</status>
 <dependencies>
@@ -2763,6 +2815,17 @@ tested
 <status>works/unverified</status>
 </file>
 <file>
+<source>loncom/configuration/Configuration.pm</source>
+<target dist='default'>home/httpd/lib/perl/LONCAPA/Configuration.pm</target>
+<categoryname>system file</categoryname>
+<description>
+Configuration file reader (looks in /etc/httpd/conf/); accepts
+a list of *.conf files to inspect for PerlSetVar key/value
+entries.
+</description>
+<status>works/unverified</status>
+</file>
+<file>
 <source>modules/TexConvert/tthperl/tth.so</source>
 <target dist='default'>usr/lib/perl5/site_perl/5.005/tth.so</target>
 <target dist='redhat7 redhat7.1'>usr/lib/perl5/site_perl/5.6.0/tth.so</target>
@@ -2829,7 +2892,33 @@ loncom/homework/caparesponse/commands
 </build>
 <dependencies>
 caparesponse.c;
-caparesponse.pm
+caparesponse.pm;
+README;
+Makefile.PL;
+capa.i;
+commands;
+../../../CAPA/pProj/capaGrammarDef.y;
+../../../CAPA/pProj/capaFormula.y;
+../../../CAPA/pProj/capaLexerDef.flex;
+../../../CAPA/pProj/capaFunction.c;
+../../../CAPA/pProj/capaParserUtils.c;
+../../../CAPA/pProj/capaMapExpr.c;
+../../../CAPA/pProj/capaUnit.c;
+../../../CAPA/pProj/com.c;
+../../../CAPA/pProj/linpack.c;
+../../../CAPA/pProj/ranlib.c;
+../../../CAPA/pProj/capaCgiUtils.c;
+../../../CAPA/pProj/capaSubjective.c;
+../../../CAPA/pProj/capaRQO.c;
+../../../CAPA/pProj/capaFormulaLexer.c;
+../../../CAPA/pProj/capaCommon.c;
+../../../CAPA/pProj/capaCommon.h;
+../../../CAPA/pProj/ranlib.h;
+../../../CAPA/pProj/capaCGI.h;
+../../../CAPA/pProj/capaFunction.h;
+../../../CAPA/pProj/capaRQO.h;
+../../../CAPA/pProj/capaParser.h;
+../../../CAPA/pProj/lex_debug.h
 </dependencies>
 </file>
 <fileglob>
@@ -3037,7 +3126,8 @@ renders the HTML (including image maps)
 <fileglob>
 <glob>*.gif</glob>
 <sourcedir>loncom/html/res/adm/pages/indexericons/</sourcedir>
-<targetdir dist='default'>home/httpd/html/res/adm/pages/indexericons/</targetdir>
+<targetdir dist='default'>home/httpd/html/res/adm/pages/indexericons/
+</targetdir>
 <categoryname>graphic file</categoryname>
 <description>
 icons used for the bookmark portion of the LON-CAPA user interface
@@ -3223,8 +3313,8 @@ echo 'manifying check-rpms'
 <categoryname>doc</categoryname>
 <description>POD-derived page for check-rpms</description>
 <build trigger='always run'>
-loncom/build/pod2html.sh check-rpms &gt; ../../doc/scripts/check-rpms.html &amp;&amp; \
-echo 'pod2html checkrpms'
+loncom/build/pod2html.sh check-rpms &gt; ../../doc/scripts/check-rpms.html \
+&amp;&amp; echo 'pod2html checkrpms'
 </build>
 <status>works/unverified</status>
 <dependencies>