--- doc/loncapafiles/loncapafiles.lpml	2002/04/28 05:15:55	1.123
+++ doc/loncapafiles/loncapafiles.lpml	2002/06/04 05:09:13	1.133
@@ -3,7 +3,7 @@
 <!-- loncapafiles.lpml -->
 <!-- Scott Harrison -->
 
-<!-- $Id: loncapafiles.lpml,v 1.123 2002/04/28 05:15:55 harris41 Exp $ -->
+<!-- $Id: loncapafiles.lpml,v 1.133 2002/06/04 05:09:13 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>
@@ -477,7 +483,8 @@ LON-CAPA system.</description>
 <directory dist='default'>
   <targetdir dist='default'>home/httpd/html/lon-status</targetdir>
   <categoryname>server standard</categoryname>
-  <description>status reports</description>
+  <description>status reports; online logs are kept that
+are viewable over the world-wide web</description>
 </directory>
 <directory dist='default'>
   <targetdir dist='default'>home/httpd/html/res/adm/pages</targetdir>
@@ -565,25 +572,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>
@@ -605,6 +610,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>
@@ -650,6 +674,14 @@ parameter.
 </description>
 </file>
 <file>
+<source>loncom/cgi/thumbnail.gif</source>
+<target dist='default'>home/httpd/cgi-bin/thumbnail.gif</target>
+<categoryname>script</categoryname>
+<description>
+Produces a thumbnail image of the url given
+</description>
+</file>
+<file>
 <source>loncom/cgi/clusterstatus.pl</source>
 <target dist='default'>home/httpd/cgi-bin/clusterstatus.pl</target>
 <categoryname>script</categoryname>
@@ -1060,6 +1092,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 ramifications 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>
@@ -1283,7 +1326,8 @@ Handler to evaluate externally graded re
 <target dist='default'>home/httpd/lib/perl/Apache/loncapagrade.pm</target>
 <categoryname>handler</categoryname>
 <description>
-Handler to evaluate externally graded responses.
+Holds results and defines
+tag handlers needed by externalresponse.pm
 </description>
 <status>works/unverified</status>
 </file>
@@ -1916,7 +1960,7 @@ loncom/build/pod2html.sh ../../rat/lonpa
 <target dist='default'>home/httpd/lib/perl/Apache/lonuserstate.pm</target>
 <categoryname>handler</categoryname>
 <description>
-compile course into binary data structure (in loncom/rat)
+compile course into binary data structure
 </description>
 <status>works/unverified</status>
 </file>
@@ -1956,7 +2000,7 @@ echo 'pod2html lonuserstate.pm'
 <target dist='default'>home/httpd/lib/perl/Apache/lontex.pm</target>
 <categoryname>handler</categoryname>
 <description>
-Handler for tex files (somewhere in modules)
+Handler for tex files
 </description>
 <status>works/unverified</status>
 </file>
@@ -2619,7 +2663,7 @@ lonlogo_broken.mov
 <targetdir dist='default'>home/httpd/html/adm/lonIcons/</targetdir>
 <categoryname>graphic file</categoryname>
 <description>
-logos
+logos and general widget icons
 </description>
 <filenames>
 SMETE_white.gif;
@@ -2738,9 +2782,7 @@ zip_big.gif
 <targetdir dist='default'>home/httpd/html/adm/lonMisc/</targetdir>
 <categoryname>graphic file</categoryname>
 <description>
-Miscellaneous resources.  Respectively: button for catalog,
-button to set parameters in a page,
-button to do regrades, button to check on problem submissions,
+Miscellaneous resources.
 </description>
 <filenames>
 authorfeed.gif;
@@ -2781,6 +2823,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>
@@ -2972,6 +3025,16 @@ Define unit prefixing and conversion for
 <categoryname>graphic file</categoryname>
 <description>icons used for the entire LON-CAPA user interface</description>
 <filenames>
+0.gif;
+1.gif;
+2.gif;
+3.gif;
+4.gif;
+5.gif;
+6.gif;
+7.gif;
+8.gif;
+9.gif;
 a.gif;
 anot.gif;
 b.gif;
@@ -2983,6 +3046,7 @@ catalog.gif;
 ccrs.gif;
 chat.gif;
 chrt.gif;
+colon.gif;
 com.gif;
 courses.gif;
 cprv.gif;
@@ -3020,6 +3084,7 @@ mrk.gif;
 n.gif;
 nav.gif;
 next.gif;
+nothumb.gif;
 o.gif;
 p.gif;
 parm.gif;
@@ -3037,6 +3102,7 @@ res.gif;
 roles.gif;
 s.gif;
 sbkm.gif;
+slash.gif;
 space.gif;
 spacer.gif;
 sprs.gif;
@@ -3085,7 +3151,7 @@ renders the HTML (including image maps)
 </targetdir>
 <categoryname>graphic file</categoryname>
 <description>
-icons used for the bookmark portion of the LON-CAPA user interface
+icons used for directory indexing and login screen
 </description>
 <filenames>
 a.gif;
@@ -3186,7 +3252,7 @@ world2.gif
 </targetdir>
 <categoryname>graphic file</categoryname>
 <description>
-icons used for directory indexing and login screen
+icons used for the bookmark portion of the LON-CAPA user interface
 </description>
 <filenames>
 folder_anim.gif;
@@ -3221,7 +3287,7 @@ ur_corner.gif
 </targetdir>
 <categoryname>interface file</categoryname>
 <description>
-associated with the frameset scheme of displaying bookmarks
+associated with the scheme of displaying bookmarks
 </description>
 <filenames>
 bookmarkmenu_toolbar.html;