--- doc/loncapafiles/loncapafiles.lpml	2001/12/08 17:26:50	1.65
+++ doc/loncapafiles/loncapafiles.lpml	2002/02/27 02:34:53	1.103
@@ -1,5 +1,33 @@
+<!-- loncapafiles.lpml -->
 <!-- Scott Harrison -->
-<!-- Guy Albertelli -->
+
+<!-- $Id: loncapafiles.lpml,v 1.103 2002/02/27 02:34:53 harris41 Exp $ -->
+
+<!--
+
+Copyright Michigan State University Board of Trustees
+
+This file is part of the LearningOnline Network with CAPA (LON-CAPA).
+
+LON-CAPA is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+LON-CAPA is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with LON-CAPA; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+/home/httpd/html/adm/gpl.txt
+
+http://www.lon-capa.org/
+
+-->
 
 <!-- Default values must be defined before specific values. -->
 <!-- If no 'dist' attribute is specified, then it is always installed. -->
@@ -7,9 +35,34 @@
 <!-- is accepted if an alternative distribution is not requested or not -->
 <!-- defined. -->
 
-<!-- $Id: loncapafiles.lpml,v 1.65 2001/12/08 17:26:50 harris41 Exp $ -->
-
 <lpml>
+<specialnotices>
+<specialnotice dist='default'>
+!!! REDHAT 6.2 NOTICE !!!
+!!! Sometimes an incorrect /etc/hosts file is incorrectly generated !!!
+!!! This sometimes happens (bad): !!!
+!!! 127.0.0.1  computer1 localhost.localdomain localhost  !!!
+!!! Should be: !!!
+!!! 127.0.0.1  localhost.localdomain  localhost !!!
+!!! 35.2.3.80  computer1 computer1.notreal.msu.edu !!!
+</specialnotice>
+<specialnotice dist='redhat7.0 redhat7.1'>
+!!!!!!!!!  REDHAT 7.*   NOTICE   !!!!!!!!!!!!!!!!!!!!
+!!!!!!!!!  LINE IN Cookie.pm     !!!!!!!!!!!!!!!!!!!!
+!!!!!!!!!  MUST BE REPLACED DUE  !!!!!!!!!!!!!!!!!!!!
+!!!!!!!!!  TO PERL 5.6.0 ERROR   !!!!!!!!!!!!!!!!!!!!
+!!!!!!!!!                        !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+!!!! The offending line is in CGI/Cookie.pm                           !!
+!!!!                                                                  !!
+!!!! it should be changed from                                        !!
+!!!! $path   = CGI::url(-absolute=>1) unless defined $path;           !!
+!!!! to                                                               !!
+!!!! ($path = $ENV{'SCRIPT_NAME'})=~s![^/]+$!! unless $path;          !!
+!!!!                                                                  !!
+!!!! (This is just below the following line )                         !!
+!!!! # IE requires the path and domain to be present for some reason. !!
+</specialnotice>
+</specialnotices>
 <targetroot>/</targetroot>
 <sourceroot>/home/user/loncapa/</sourceroot>
 <categories>
@@ -69,6 +122,14 @@
   <chmod dist='default'>0400</chmod><chown dist='default'>www:www</chown>
   <abbreviation>graphicfile</abbreviation>
 </category>
+<category name="doc" type="runtime">
+  <chmod dist='default'>0644</chmod><chown dist='default'>root:root</chown>
+  <abbreviation>systemfile</abbreviation>
+</category>
+<category name="doc" type="development">
+  <chmod dist='default'>0644</chmod><chown dist='default'>root:root</chown>
+  <abbreviation>systemfile</abbreviation>
+</category>
 <category name="system file" type="runtime">
   <chmod dist='default'>0644</chmod><chown dist='default'>root:root</chown>
   <abbreviation>systemfile</abbreviation>
@@ -131,11 +192,10 @@ Division of Science and Mathematics Educ
   <rpmGroup>Utilities/System</rpmGroup>
   <rpmSource>LON-CAPA-base-3.1.tar.gz</rpmSource>
   <rpmAutoReqProv>no</rpmAutoReqProv>
-  <rpmdescription>This package facilitates a base installation of LON-CAPA files in their directories.\n
-The files in this package are only those directly associated with the network communication\n
-layer established through direct server-to-server communications (via lond and lonc); plus\n
-those which configure (but otherwise not constitute) external software packages like Apache\n
-and Athena-Kerberos.  For more on the LON-CAPA project, visit http://www.lon-capa.org/.</rpmdescription>
+  <rpmdescription>This package facilitates a base installation of LON-CAPA \n
+files in their directories.\n
+For more on the LON-CAPA project, visit http://www.lon-capa.org/.
+  </rpmdescription>
   <rpmpre>echo '***********************************************************************'\n
 echo 'LON-CAPA  LearningOnline with CAPA'\n
 echo 'http://www.lon-capa.org/'\n
@@ -149,12 +209,13 @@ echo 'This installation assumes an insta
 echo ' '\n
 echo 'The server computer should be currently connected to the ethernet'\n
 echo ' '\n
-echo 'The files in this package are only those directly associated with the network communication'\n
-echo 'layer established through direct server-to-server communications (via lond and lonc); plus'\n
-echo 'those which configure (but otherwise not constitute) external software packages like Apache'\n
-echo 'and Athena-Kerberos.'\n
 echo '***********************************************************************'\n
 </rpmpre>
+<rpmRequires>
+<item>PreReq: LON-CAPA-setup</item>
+<item>PreReq: apache</item>
+<item>PreReq: /etc/httpd/conf/access.conf</item>
+</rpmRequires>
 </rpm>
 <directories>
 <directory>
@@ -259,6 +320,14 @@ echo '**********************************
   </description>
 </directory>
 <directory>
+  <targetdir dist='default'>home/httpd/html/lon-status/londchld</targetdir>
+  <categoryname>server standard</categoryname>
+  <description>
+Used by lond parent to check if children are responding to USR1 signals
+(otherwise they are killed and replaced).
+  </description>
+</directory>
+<directory>
   <targetdir dist='default'>home/httpd/perl/tmp</targetdir>
   <categoryname>server standard</categoryname>
   <description>location where temporary files (for caching) are stored
@@ -326,6 +395,24 @@ echo '**********************************
   <description>online help documentation</description>
 </directory>
 <directory>
+  <targetdir dist='default'>home/httpd/html/adm/help/api</targetdir>
+  <categoryname>server readonly</categoryname>
+  <description>online help documentation for the LON-CAPA programming
+interface</description>
+</directory>
+<directory>
+  <targetdir dist='default'>home/httpd/html/adm/help/api/Apache</targetdir>
+  <categoryname>server readonly</categoryname>
+  <description>online help documentation for the LON-CAPA programming
+interface, Apache (mod_perl) handlers</description>
+</directory>
+<directory>
+  <targetdir dist='default'>home/httpd/html/adm/help/scripts</targetdir>
+  <categoryname>server readonly</categoryname>
+  <description>online help documentation for the LON-CAPA programming
+interface, Apache (mod_perl) handlers</description>
+</directory>
+<directory>
   <targetdir dist='default'>home/httpd/html/adm/lonIcons</targetdir>
   <categoryname>server readonly</categoryname>
   <description>graphic widgets</description>
@@ -409,6 +496,26 @@ LON-CAPA system.</description>
   </description>
 </directory>
 <directory>
+  <targetdir dist='default'>usr/local/bin</targetdir>
+  <categoryname>standard</categoryname>
+  <description>local binary files</description>
+</directory>
+<directory>
+  <targetdir dist='default'>usr/local/man/man1</targetdir>
+  <categoryname>standard</categoryname>
+  <description>local manual pages</description>
+</directory>
+<directory>
+  <targetdir dist='default'>usr/man/man1</targetdir>
+  <categoryname>standard</categoryname>
+  <description>manual pages</description>
+</directory>
+<directory>
+  <targetdir dist='default'>usr/man/man3</targetdir>
+  <categoryname>standard</categoryname>
+  <description>manual pages</description>
+</directory>
+<directory>
   <targetdir dist='default'>usr/sbin</targetdir>
   <categoryname>standard</categoryname>
   <description>standard linux directory for superuser executables</description>
@@ -439,6 +546,15 @@ each list element consists of only two s
 </note>
 </file>
 <file>
+<source>loncom/loncapa.conf</source>
+<target dist='default'>etc/httpd/conf/loncapa.conf</target>
+<categoryname>conf</categoryname>
+<description>
+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>
@@ -457,7 +573,7 @@ and browser detection logic.
 <note>
 <b>configure</b>
 <br />
-<table cellpadding=0 cellspacing=0 border=1>
+<table cellpadding='0' cellspacing='0' border='1'>
 <tr><td><tt>lonHostID</tt></td><td>LON-internal HostID of this
 machine</td></tr>
 <tr><td><tt>lonRole</tt></td><td>Role of this machine: library,
@@ -554,6 +670,14 @@ parameter.
 </description>
 </file>
 <file>
+<source>loncom/cgi/clusterstatus.pl</source>
+<target dist='default'>home/httpd/cgi-bin/clusterstatus.pl</target>
+<categoryname>script</categoryname>
+<description>
+utility cgi script to view status of cluster
+</description>
+</file>
+<file>
 <source>loncom/cgi/graph.gif</source>
 <target dist='default'>home/httpd/cgi-bin/graph.gif</target>
 <categoryname>script</categoryname>
@@ -566,7 +690,23 @@ GDGraph-1.33 and GDTextUtils-0.80.
 </note>
 </file>
 <file>
-<source>loncom/xml/plot.gif</source>
+<source>loncom/cgi/lonversions.pl</source>
+<target dist='default'>home/httpd/cgi-bin/lonversions.pl</target>
+<categoryname>script</categoryname>
+<description>
+utility cgi script to view software versions of a remote server
+</description>
+</file>
+<file>
+<source>loncom/cgi/ping.pl</source>
+<target dist='default'>home/httpd/cgi-bin/ping.pl</target>
+<categoryname>script</categoryname>
+<description>
+cgi-script to ping other server
+</description>
+</file>
+<file>
+<source>loncom/cgi/plot.gif</source>
 <target dist='default'>home/httpd/cgi-bin/plot.gif</target>
 <categoryname>script</categoryname>
 <description>
@@ -712,7 +852,7 @@ and privileges available in the network
 <file>
 <source>loncom/hosts.tab</source>
 <target dist='default'>home/httpd/lonTabs/hosts.tab</target>
-<categoryname>conf</categoryname>
+<categoryname>static conf</categoryname>
 <description>
 List of all machines in the LON-CAPA network.  Relates <tt>lonHostID</tt> to
 <tt>lonDefDomain</tt> and <u>IP address</u>.
@@ -727,7 +867,7 @@ Spare hosts to offload session to if the
 </description>
 <note>
 <b>configure</b><br />
-<table cellpadding=0 cellspacing=0 border=1>
+<table cellpadding='0' cellspacing='0' border='1'>
 <tr><td>
 list elements are separated by newlines
 </td></tr>
@@ -749,6 +889,7 @@ Basic auth password to access /lon-statu
 <file>
 <source>loncom/smb.conf</source>
 <target dist='default'>etc/smb.conf</target>
+<target dist='redhat7.1'>etc/samba/smb.conf</target>
 <categoryname>conf</categoryname>
 <description>
 configuration file to make LON-CAPA server file space accessible to network
@@ -763,7 +904,7 @@ neighborhood
 which NTP server to contact for information (XNTP3 standard)
 </description>
 <note>
-<table cellpadding=0 cellspacing=0 border=1>
+<table cellpadding='0' cellspacing='0' border='1'>
 <tr><td>
 only one line needs to be changed to specify a server ip address
 </td></tr>
@@ -790,6 +931,32 @@ proxy server
 </description>
 </file>
 <file>
+<source>doc/man/lonc.1</source>
+<target dist='default'>usr/man/man1/lonc.1</target>
+<categoryname>doc</categoryname>
+<description>man page for lonc</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../lonc > ../../doc/man/lonc.1 && echo 'manifying lonc'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/lonc
+</dependencies>
+</file>
+<file>
+<source>doc/scripts/lonc.html</source>
+<target dist='default'>home/httpd/html/adm/help/scripts/lonc.html</target>
+<categoryname>doc</categoryname>
+<description>POD-derived page for lonc</description>
+<build trigger='always run'>
+loncom/build/pod2html.sh ../lonc > ../../doc/scripts/lonc.html && echo 'pod2html lonc'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/lonc
+</dependencies>
+</file>
+<file>
 <source>loncom/lond</source>
 <target dist='default'>home/httpd/perl/lond</target>
 <categoryname>script</categoryname>
@@ -808,6 +975,32 @@ tmpput, tmpget, and ls).
 </description>
 </file>
 <file>
+<source>doc/man/lond.1</source>
+<target dist='default'>usr/man/man1/lond.1</target>
+<categoryname>doc</categoryname>
+<description>man page for lond</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../lond > ../../doc/man/lond.1 && echo 'manifying lond'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/lond
+</dependencies>
+</file>
+<file>
+<source>doc/scripts/lond.html</source>
+<target dist='default'>home/httpd/html/adm/help/scripts/lond.html</target>
+<categoryname>doc</categoryname>
+<description>POD-derived page for lond</description>
+<build trigger='always run'>
+loncom/build/pod2html.sh ../lond > ../../doc/scripts/lond.html && echo 'pod2html lond'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/lond
+</dependencies>
+</file>
+<file>
 <source>loncom/cgi/loncron.pl</source>
 <target dist='default'>home/httpd/cgi-bin/loncron.pl</target>
 <categoryname>script</categoryname>
@@ -826,6 +1019,32 @@ tmpput, tmpget, and ls).
 <description>maintain secondary database of metadata</description>
 </file>
 <file>
+<source>doc/man/lonsql.1</source>
+<target dist='default'>usr/man/man1/lonsql.1</target>
+<categoryname>doc</categoryname>
+<description>man page for lonsql</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../lonsql > ../../doc/man/lonsql.1 && echo 'manifying lonsql'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/lonsql
+</dependencies>
+</file>
+<file>
+<source>doc/scripts/lonsql.html</source>
+<target dist='default'>home/httpd/html/adm/help/scripts/lonsql.html</target>
+<categoryname>doc</categoryname>
+<description>POD-derived page for lonsql</description>
+<build trigger='always run'>
+loncom/build/pod2html.sh ../lonsql > ../../doc/scripts/lonsql.html && echo 'pod2html lonsql'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/lonsql
+</dependencies>
+</file>
+<file>
 <source>loncom/lcpasswd</source>
 <target dist='default'>home/httpd/perl/lcpasswd</target>
 <categoryname>setuid script</categoryname>
@@ -955,7 +1174,7 @@ retroactively add new parameters to alre
 <file>
 <source>loncom/publisher/copyright.tab</source>
 <target dist='default'>home/httpd/html/res/adm/includes/copyright.tab</target>
-<categoryname>conf</categoryname>
+<categoryname>static conf</categoryname>
 <description>
 Table which contains list of copyright possibilities for educational resources.
 </description>
@@ -1025,6 +1244,32 @@ Handler to upload files through browser
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__lonupload.3</source>
+<target dist='default'>usr/man/man3/Apache::lonupload.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonupload.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../publisher/lonupload.pm > ../../doc/man/Apache__lonupload.3 && echo 'manifying lonupload.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/publisher/lonupload.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonupload.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonupload.html && echo 'pod2html lonupload.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/publisher/lonupload.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/homework/essayresponse.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/essayresponse.pm</target>
 <categoryname>handler</categoryname>
@@ -1034,6 +1279,24 @@ Handler to evaluate essay (ungraded) sty
 <status>works/unverified</status>
 </file>
 <file>
+<source>loncom/homework/externalresponse.pm</source>
+<target dist='default'>home/httpd/lib/perl/Apache/externalresponse.pm</target>
+<categoryname>handler</categoryname>
+<description>
+Handler to evaluate externally graded responses.
+</description>
+<status>works/unverified</status>
+</file>
+<file>
+<source>loncom/homework/loncapagrade.pm</source>
+<target dist='default'>home/httpd/lib/perl/Apache/loncapagrade.pm</target>
+<categoryname>handler</categoryname>
+<description>
+Handler to evaluate externally graded responses.
+</description>
+<status>works/unverified</status>
+</file>
+<file>
 <source>loncom/publisher/lonpubdir.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/lonpubdir.pm</target>
 <categoryname>handler</categoryname>
@@ -1042,6 +1305,32 @@ Handler to publish directories.
 </description>
 </file>
 <file>
+<source>doc/man/Apache__lonpubdir.3</source>
+<target dist='default'>usr/man/man3/Apache::lonpubdir.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonpubdir.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../publisher/lonpubdir.pm > ../../doc/man/Apache__lonpubdir.3 && echo 'manifying lonpubdir.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/lonnet/perl/lonnet.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonpubdir.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonpubdir.html && echo 'pod2html lonpubdir.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/publisher/lonpubdir.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/publisher/lonretrieve.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/lonretrieve.pm</target>
 <categoryname>handler</categoryname>
@@ -1051,6 +1340,32 @@ Handler to retrieve old versions from re
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__lonretrieve.3</source>
+<target dist='default'>usr/man/man3/Apache::lonretrieve.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonretrieve.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../publisher/lonretrieve.pm > ../../doc/man/Apache__lonretrieve.3 && echo 'manifying lonretrieve.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/publisher/lonretrieve.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonretrieve.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonretrieve.html && echo 'pod2html lonretrieve.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/publisher/lonretrieve.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/homework/edit.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/edit.pm</target>
 <categoryname>handler</categoryname>
@@ -1059,6 +1374,32 @@ Helper functions when in homework edit m
 </description>
 </file>
 <file>
+<source>doc/man/Apache__edit.3</source>
+<target dist='default'>usr/man/man3/Apache::edit.3</target>
+<categoryname>doc</categoryname>
+<description>man page for edit.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../homework/edit.pm > ../../doc/man/Apache__edit.3 && echo 'manifying edit.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/homework/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>
+<categoryname>doc</categoryname>
+<description>POD-derived page for edit.pm</description>
+<build trigger='always run'>
+loncom/build/pod2html.sh ../homework/edit.pm > ../../doc/api/Apache/edit.html && echo 'pod2html edit.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/homework/edit.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/interface/lonmeta.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/lonmeta.pm</target>
 <categoryname>handler</categoryname>
@@ -1097,7 +1438,8 @@ Handler for showing sequence objects of
 <target dist='default'>home/httpd/lib/perl/Apache/loncreatecourse.pm</target>
 <categoryname>handler</categoryname>
 <description>
-Creates a new course and assigns course coordinator.
+Allows domain coordinators to create new courses and assign course
+coordinators.
 </description>
 <status>works/unverified</status>
 </file>
@@ -1106,7 +1448,8 @@ Creates a new course and assigns course
 <target dist='default'>home/httpd/lib/perl/Apache/loncreateuser.pm</target>
 <categoryname>handler</categoryname>
 <description>
-Creates a new user and/or changes user privileges
+Allows users to within their own privileges create/edit users and give
+them roles. 
 </description>
 <status>works/unverified</status>
 </file>
@@ -1129,6 +1472,32 @@ user, domain, home_server, course_id.
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__loncommon.3</source>
+<target dist='default'>usr/man/man3/Apache::loncommon.3</target>
+<categoryname>doc</categoryname>
+<description>man page for loncommon.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../interface/loncommon.pm > ../../doc/man/Apache__loncommon.3 && echo 'manifying loncommon.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/interface/loncommon.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/loncommon.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/loncommon.html && echo 'pod2html loncommon.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/interface/loncommon.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/homework/grades.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/grades.pm</target>
 <categoryname>handler</categoryname>
@@ -1192,7 +1561,10 @@ Handles processing of assignments.
 <source>loncom/interface/loncommunicate.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/loncommunicate.pm</target>
 <categoryname>handler</categoryname>
-<description>Handles communication.</description>
+<description>
+Will be the access handler to email sending, as well as the planned
+chatrooms, etc.
+</description>
 <status>works/unverified</status>
 </file>
 <file>
@@ -1219,6 +1591,9 @@ Handles evaluation.
 <categoryname>handler</categoryname>
 <description>
 Handles feedback from students to instructors and system administrators.
+Provides a screenshot of the current
+resource, as well as previous attempts if the resource was a homework.
+Used by lonmsg.pm.
 </description>
 <status>works/unverified</status>
 </file>
@@ -1260,11 +1635,39 @@ Handles a searchable catalogue.
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__lonsearchcat.3</source>
+<target dist='default'>usr/man/man3/Apache::lonsearchcat.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonsearchcat.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../interface/lonsearchcat.pm > ../../doc/man/Apache__lonsearchcat.3 && echo 'manifying lonsearchcat.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/interface/lonsearchcat.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonsearchcat.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonsearchcat.html && echo 'pod2html lonsearchcat.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/interface/lonsearchcat.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/interface/londropadd.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/londropadd.pm</target>
 <categoryname>handler</categoryname>
 <description>
-Handler to drop and add students in courses.
+Allows course coordinators to upload courselists in different formats, and
+automatically create users (if they do not exist already), assign them the
+role of student in a course, and add them to the classlist.
 </description>
 <status>works/unverified</status>
 </file>
@@ -1273,7 +1676,13 @@ Handler to drop and add students in cour
 <target dist='default'>home/httpd/lib/perl/Apache/lonmsg.pm</target>
 <categoryname>handler</categoryname>
 <description>
-Routines for messaging.
+lonmsg.pm has several functions to send and receive internal messages.
+author_res_msg - send message to resource author.
+user_crit_msg - send a critical message to a user. A critical message
+will require acknowledgment by the recipient and the sender will be notified.
+user_crit_received - routine to trigger acknowledgment.
+statuschange - change the status of a message (read, replied, forwarded, etc).
+The handler also displays messages, has routines to reply, etc.
 </description>
 <status>works/unverified</status>
 </file>
@@ -1292,7 +1701,9 @@ problems and assignments.
 <target dist='default'>home/httpd/lib/perl/Apache/lonspreadsheet.pm</target>
 <categoryname>handler</categoryname>
 <description>
-Spreadsheet/Grades Display Handler
+Spreadsheets are completely web-based.
+They exist on the level of a whole course, a student, and individual
+assessments.
 </description>
 <status>works/unverified</status>
 </file>
@@ -1306,6 +1717,32 @@ Handler to resolve ambiguous file locati
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__lonparmset.3</source>
+<target dist='default'>usr/man/man3/Apache::lonparmset.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonparmset.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../interface/lonparmset.pm > ../../doc/man/Apache__lonparmset.3 && echo 'manifying lonparmset.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/interface/lonparmset.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonparmset.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonparmset.html && echo 'pod2html lonparmset.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/interface/lonparmset.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/publisher/lonconstruct.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/lonconstruct.pm</target>
 <categoryname>handler</categoryname>
@@ -1325,6 +1762,32 @@ Publishes an LON-CAPA educational resour
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__lonpublisher.3</source>
+<target dist='default'>usr/man/man3/Apache::lonpublisher.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonpublisher.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../publisher/lonpublisher.pm > ../../doc/man/Apache__lonpublisher.3 && echo 'manifying lonpublisher.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/publisher/lonpublisher.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonpublisher.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonpublisher.html && echo 'pod2html lonpublisher.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/publisher/lonpublisher.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/interface/lonmenu.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/lonmenu.pm</target>
 <categoryname>handler</categoryname>
@@ -1398,6 +1861,32 @@ bundles pages into one page
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__lonpage.3</source>
+<target dist='default'>usr/man/man3/Apache::lonpage.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonpage.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../../rat/lonpage.pm > ../../doc/man/Apache__lonpage.3 && echo 'manifying lonpage.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../rat/lonpage.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonpage.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonpage.html && echo 'pod2html lonpage.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../rat/lonpage.pm
+</dependencies>
+</file>
+<file>
 <source>rat/lonuserstate.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/lonuserstate.pm</target>
 <categoryname>handler</categoryname>
@@ -1407,6 +1896,32 @@ compile course into binary data structur
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__lonuserstate.3</source>
+<target dist='default'>usr/man/man3/Apache::lonuserstate.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonnet.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../../rat/lonuserstate.pm > ../../doc/man/Apache__lonuserstate.3 && echo 'manifying lonuserstate.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../rat/lonuserstate.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonuserstate.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonuserstate.html && echo 'pod2html lonuserstate.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../rat/lonuserstate.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/xml/lontex.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/lontex.pm</target>
 <categoryname>handler</categoryname>
@@ -1434,6 +1949,15 @@ XML Parsing Module
 <status>works/unverified</status>
 </file>
 <file>
+<source>loncom/xml/lonplot.pm</source>
+<target dist='default'>home/httpd/lib/perl/Apache/lonplot.pm</target>
+<categoryname>handler</categoryname>
+<description>
+XML-based plotter of graphs
+</description>
+<status>works/unverified</status>
+</file>
+<file>
 <source>loncom/xml/style.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/style.pm</target>
 <categoryname>handler</categoryname>
@@ -1486,8 +2010,8 @@ image.
 <description>
 handles requests for output, evaluation, and alteration of a homework resource
 </description>
-</file>
 <status>works/unverified</status>
+</file>
 <file>
 <source>loncom/homework/inputtags.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/inputtags.pm</target>
@@ -1548,6 +2072,32 @@ as coordinating access to educational re
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__lonacc.3</source>
+<target dist='default'>usr/man/man3/Apache::lonacc.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonacc.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../auth/lonacc.pm > ../../doc/man/Apache__lonacc.3 && echo 'manifying lonacc.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/auth/lonacc.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonacc.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonacc.html && echo 'pod2html lonacc.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/auth/lonacc.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/auth/lonracc.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/lonracc.pm</target>
 <categoryname>handler</categoryname>
@@ -1557,6 +2107,32 @@ access handler for file transfers
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__lonracc.3</source>
+<target dist='default'>usr/man/man3/Apache::lonracc.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonracc.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../auth/lonracc.pm > ../../doc/man/Apache__lonracc.3 && echo 'manifying lonracc.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/auth/lonracc.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonracc.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonracc.html && echo 'pod2html lonracc.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/auth/lonracc.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/auth/loncacc.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/loncacc.pm</target>
 <categoryname>handler</categoryname>
@@ -1575,6 +2151,32 @@ for the "priv"-type access, the resource
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__loncacc.3</source>
+<target dist='default'>usr/man/man3/Apache::loncacc.3</target>
+<categoryname>doc</categoryname>
+<description>man page for loncacc.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../auth/loncacc.pm > ../../doc/man/Apache__loncacc.3 && echo 'manifying loncacc.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/auth/loncacc.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/loncacc.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/loncacc.html && echo 'pod2html loncacc.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/auth/loncacc.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/auth/lonauth.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/lonauth.pm</target>
 <categoryname>handler</categoryname>
@@ -1616,6 +2218,32 @@ class.
 </description>
 </file>
 <file>
+<source>doc/man/Apache__lonroles.3</source>
+<target dist='default'>usr/man/man3/Apache::lonroles.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonroles.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../auth/lonroles.pm > ../../doc/man/Apache__lonroles.3 && echo 'manifying lonroles.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/auth/lonroles.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonroles.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonroles.html && echo 'pod2html lonroles.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/auth/lonroles.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/interface/lonindexer.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/lonindexer.pm</target>
 <categoryname>handler</categoryname>
@@ -1625,6 +2253,32 @@ cross server filesystem browser
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__lonindexer.3</source>
+<target dist='default'>usr/man/man3/Apache::lonindexer.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonindexer.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../interface/lonindexer.pm > ../../doc/man/Apache__lonindexer.3 && echo 'manifying lonindexer.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/interface/lonindexer.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonindexer.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonindexer.html && echo 'pod2html lonindexer.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/interface/lonindexer.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/interface/groupsort.pm</source>
 <target dist='default'>home/httpd/lib/perl/Apache/groupsort.pm</target>
 <categoryname>handler</categoryname>
@@ -1653,6 +2307,32 @@ symbols to and from more descriptive phr
 <status>works/unverified</status>
 </file>
 <file>
+<source>doc/man/Apache__lonnet.3</source>
+<target dist='default'>usr/man/man3/Apache::lonnet.3</target>
+<categoryname>doc</categoryname>
+<description>man page for lonnet.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../lonnet/perl/lonnet.pm > ../../doc/man/Apache__lonnet.3 && echo 'manifying lonnet.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/lonnet/perl/lonnet.pm
+</dependencies>
+</file>
+<file>
+<source>doc/api/Apache/lonnet.html</source>
+<target dist='default'>home/httpd/html/adm/help/api/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 > ../../doc/api/Apache/lonnet.html && echo 'pod2html lonnet.pm'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/lonnet/perl/lonnet.pm
+</dependencies>
+</file>
+<file>
 <source>loncom/html/index.html</source>
 <target dist='default'>home/httpd/html/index.html</target>
 <categoryname>interface file</categoryname>
@@ -1882,6 +2562,7 @@ lonlogo_broken.mov
 logos
 </description>
 <filenames>
+SMETE_white.gif;
 arrow_up.gif;
 cab.gif;
 cab_big.gif;
@@ -1987,7 +2668,11 @@ button to set parameters in a page,
 button to do regrades, button to check on problem submissions,
 </description>
 <filenames>
+authorfeed.gif;
+bomb.gif;
 cat_button.gif;
+chat.gif;
+feedback.gif;
 pprm_button.gif;
 pgrd_button.gif;
 subm_button.gif
@@ -2029,7 +2714,7 @@ modules/TexConvert/tthperl/commands
 <status>works/unverified</status>
 <dependencies>
 ../tthdynamic/tthfunc.c;
-../tthdynamic/ttmfunc.c
+../ttmdynamic/ttmfunc.c
 </dependencies>
 </file>
 <file>
@@ -2228,6 +2913,7 @@ p.gif;
 parm.gif;
 pgrd.gif;
 pparm.gif;
+pref.gif;
 prev.gif;
 prt.gif;
 q.gif;
@@ -2438,6 +3124,41 @@ javascript for handling client-side inte
 </description>
 </file>
 <file>
+<source>loncom/build/check-rpms</source>
+<target dist='default'>usr/local/bin/check-rpms</target>
+<categoryname>root script</categoryname>
+<description>
+compare installed rpms with up-to-date distribution
+</description>
+<status>tested/documented/beta</status>
+</file>
+<file>
+<source>doc/man/check-rpms.1</source>
+<target dist='default'>usr/local/man/man1/check-rpms.1</target>
+<categoryname>doc</categoryname>
+<description>man page for check-rpms</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh check-rpms > ../../doc/man/check-rpms.1 && echo 'manifying check-rpms'
+</build>
+<status>beta</status>
+<dependencies>
+../../loncom/build/check-rpms
+</dependencies>
+</file>
+<file>
+<source>doc/scripts/check-rpms.html</source>
+<target dist='default'>home/httpd/html/adm/help/scripts/check-rpms.html</target>
+<categoryname>doc</categoryname>
+<description>POD-derived page for check-rpms</description>
+<build trigger='always run'>
+loncom/build/pod2html.sh check-rpms > ../../doc/scripts/check-rpms.html && echo 'pod2html checkrpms'
+</build>
+<status>works/unverified</status>
+<dependencies>
+../../loncom/build/check-rpms
+</dependencies>
+</file>
+<file>
 <source>loncom/build/loncapaverifypackages</source>
 <target dist='default'>usr/sbin/loncapaverifypackages</target>
 <categoryname>script</categoryname>