--- doc/loncapafiles/loncapafiles.lpml	2002/04/27 21:38:57	1.122
+++ doc/loncapafiles/loncapafiles.lpml	2002/07/12 14:07:49	1.139
@@ -3,7 +3,7 @@
 <!-- loncapafiles.lpml -->
 <!-- Scott Harrison -->
 
-<!-- $Id: loncapafiles.lpml,v 1.122 2002/04/27 21:38:57 harris41 Exp $ -->
+<!-- $Id: loncapafiles.lpml,v 1.139 2002/07/12 14:07:49 matthew 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>
@@ -407,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>
@@ -477,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>
@@ -565,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>
@@ -605,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>
@@ -616,13 +644,18 @@ well as causing the Apache module to be
 </description>
 </file>
 <file>
-<source>loncom/publisher/thesaurus.dat</source>
-<target dist='default'>home/httpd/lonTabs/thesaurus.dat</target>
-<categoryname>static conf</categoryname>
+<source>loncom/thesaurus/thesaurus.db</source>
+<target dist='default'>home/httpd/lonTabs/thesaurus.db</target>
+<categoryname>system file</categoryname>
 <description>
-Custom Thesaurus file for LON-CAPA, in the format
-word@wordID@frequency@relatedwordID:frequency,relatedwordID:frequency,...
+Thesaurus database file to be built from loncom/thesaurus/rawkey.txt
 </description>
+<build trigger='run if dependencies change'>
+loncom/thesaurus/build_thesaurus_wrapper.sh
+</build>
+<dependencies>
+rawkey.txt
+</dependencies>
 </file>
 <file>
 <source>loncom/interface/mydesk.tab</source>
@@ -641,6 +674,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>
@@ -650,6 +691,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>
@@ -738,12 +787,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;
@@ -758,8 +809,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>
@@ -1060,6 +1111,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>
@@ -1140,7 +1202,7 @@ The relevant conditions and metadata to
 </description>
 </file>
 <file>
-<source>loncom/misc/un_keyword.tab</source>
+<source>loncom/thesaurus/un_keyword.tab</source>
 <target dist='default'>home/httpd/html/res/adm/includes/un_keyword.tab</target>
 <categoryname>conf</categoryname>
 <description>
@@ -1204,6 +1266,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>
@@ -1283,7 +1354,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>
@@ -1466,6 +1538,14 @@ Produces simple LectureOnline-like stude
 </description>
 </file>
 <file>
+<source>loncom/interface/loncoursedata.pm</source>
+<target dist='default'>home/httpd/lib/perl/Apache/loncoursedata.pm</target>
+<categoryname>handler</categoryname>
+<description>
+Common functions for handling student course data (download and process)
+</description>
+</file>
+<file>
 <source>loncom/interface/loncommon.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/loncommon.pm</target>
 <categoryname>handler</categoryname>
@@ -1916,7 +1996,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 +2036,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 +2699,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 +2818,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 +2859,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>
@@ -2866,7 +2955,14 @@ commands;
 ../../../CAPA/pProj/capaSubjective.c;
 ../../../CAPA/pProj/capaRQO.c;
 ../../../CAPA/pProj/capaFormulaLexer.c;
-../../../CAPA/pProj/capaCommon.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>
@@ -2965,6 +3061,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;
@@ -2976,6 +3082,7 @@ catalog.gif;
 ccrs.gif;
 chat.gif;
 chrt.gif;
+colon.gif;
 com.gif;
 courses.gif;
 cprv.gif;
@@ -3013,6 +3120,7 @@ mrk.gif;
 n.gif;
 nav.gif;
 next.gif;
+nothumb.gif;
 o.gif;
 p.gif;
 parm.gif;
@@ -3030,6 +3138,7 @@ res.gif;
 roles.gif;
 s.gif;
 sbkm.gif;
+slash.gif;
 space.gif;
 spacer.gif;
 sprs.gif;
@@ -3078,7 +3187,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;
@@ -3179,7 +3288,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;
@@ -3214,7 +3323,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;