--- doc/loncapafiles/loncapafiles.lpml	2002/05/04 03:25:28	1.125
+++ doc/loncapafiles/loncapafiles.lpml	2002/07/05 19:03:02	1.137
@@ -3,7 +3,7 @@
 <!-- loncapafiles.lpml -->
 <!-- Scott Harrison -->
 
-<!-- $Id: loncapafiles.lpml,v 1.125 2002/05/04 03:25:28 harris41 Exp $ -->
+<!-- $Id: loncapafiles.lpml,v 1.137 2002/07/05 19:03:02 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>
@@ -413,6 +413,10 @@ Used by lond parent to check if children
   <targetdir dist='default'>home/httpd/html/adm/help</targetdir>
   <categoryname>server readonly</categoryname>
   <description>online help documentation</description>
+  <build trigger='always run'>
+    perl loncom/build/help_graphics_converter.pl
+    perl doc/help/rebuildLabelHash.pl
+  </build>
 </directory>
 <directory dist='default'>
   <targetdir dist='default'>home/httpd/html/adm/help/lib/perl</targetdir>
@@ -483,7 +487,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>
@@ -571,25 +576,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>
@@ -611,6 +614,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>
@@ -647,6 +669,14 @@ Descriptive list of file extensions, and
 </description>
 </file>
 <file>
+<source>loncom/interface/filecategories.tab</source>
+<target dist='default'>home/httpd/lonTabs/filecategories.tab</target>
+<categoryname>static conf</categoryname>
+<description>
+Descriptive list of file extensions and broad categorization.
+</description>
+</file>
+<file>
 <source>loncom/cgi/barcode.gif</source>
 <target dist='default'>home/httpd/cgi-bin/barcode.gif</target>
 <categoryname>script</categoryname>
@@ -656,6 +686,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>
@@ -744,12 +782,14 @@ blank.library;
 blank.library.meta;
 blank.problem;
 blank.problem.meta;
-formula.problem;
-formula.problem.meta;
 numerical.problem;
 numerical.problem.meta;
+Plot.problem;
+Plot.problem.meta;
 RadioResponse.problem;
 RadioResponse.problem.meta;
+RandomLabelExample.problem;
+RandomLabelExample.problem.meta;
 SelectFromOptions-4ConceptGoups.problem;
 SelectFromOptions-4ConceptGoups.problem.meta;
 SelectFromOptions-5ConceptGoups.problem;
@@ -764,8 +804,8 @@ SelectFromOptions-Simple.problem;
 SelectFromOptions-Simple.problem.meta;
 script.library;
 script.library.meta;
-SimpleStringResponse.problem;
-SimpleStringResponse.problem.meta;
+SimpleFormula.problem;
+SimpleFormula.problem.meta;
 StringResponse.problem;
 StringResponse.problem.meta
 </filenames>
@@ -1070,7 +1110,7 @@ new user.
 <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. 
+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>
@@ -1221,6 +1261,15 @@ construction space menu.
 <status>works/unverified</status>
 </file>
 <file>
+<source>loncom/interface/lonhelp.pm</source>
+<target dist='default'>home/httpd/lib/perl/Apache/lonhelp.pm</target>
+<categoryname>handler</categoryname>
+<description>
+The .tex file help handler.
+</description>
+<status>works/unverified</status>
+</file>
+<file>
 <source>loncom/interface/lonstatistics.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/lonstatistics.pm</target>
 <categoryname>handler</categoryname>
@@ -1300,7 +1349,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>
@@ -1933,7 +1983,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>
@@ -1973,7 +2023,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>
@@ -2636,7 +2686,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;
@@ -2755,9 +2805,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;
@@ -2802,8 +2850,9 @@ tested
 <target dist='default'>home/httpd/lib/perl/LONCAPA/Configuration.pm</target>
 <categoryname>system file</categoryname>
 <description>
-perl module for parsing HTML in a way that really works and is thoroughly
-tested
+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>
@@ -2999,6 +3048,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;
@@ -3010,6 +3069,7 @@ catalog.gif;
 ccrs.gif;
 chat.gif;
 chrt.gif;
+colon.gif;
 com.gif;
 courses.gif;
 cprv.gif;
@@ -3047,6 +3107,7 @@ mrk.gif;
 n.gif;
 nav.gif;
 next.gif;
+nothumb.gif;
 o.gif;
 p.gif;
 parm.gif;
@@ -3064,6 +3125,7 @@ res.gif;
 roles.gif;
 s.gif;
 sbkm.gif;
+slash.gif;
 space.gif;
 spacer.gif;
 sprs.gif;
@@ -3112,7 +3174,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;
@@ -3213,7 +3275,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;
@@ -3248,7 +3310,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;