--- doc/loncapafiles/loncapafiles.lpml	2001/12/13 23:36:52	1.71
+++ doc/loncapafiles/loncapafiles.lpml	2001/12/19 22:35:22	1.76
@@ -1,7 +1,7 @@
 <!-- loncapafiles.pl
 <!-- Scott Harrison -->
 
-<!-- $Id: loncapafiles.lpml,v 1.71 2001/12/13 23:36:52 harris41 Exp $ -->
+<!-- $Id: loncapafiles.lpml,v 1.76 2001/12/19 22:35:22 harris41 Exp $ -->
 
 <!--
 
@@ -372,6 +372,18 @@ 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/lonIcons</targetdir>
   <categoryname>server readonly</categoryname>
   <description>graphic widgets</description>
@@ -455,6 +467,11 @@ LON-CAPA system.</description>
   </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>
@@ -1072,6 +1089,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>system file</categoryname>
+<description>man page for lonupload.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../publisher/lonupload.pm > ../../doc/man/Apache__lonupload.3
+</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>system file</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
+</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>
@@ -1089,6 +1132,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>system file</categoryname>
+<description>man page for lonpubdir.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../publisher/lonpubdir.pm > ../../doc/man/Apache__lonpubdir.3
+</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>system file</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
+</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>
@@ -1098,6 +1167,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>system file</categoryname>
+<description>man page for lonretrieve.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../publisher/lonretrieve.pm > ../../doc/man/Apache__lonretrieve.3
+</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>system file</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
+</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>
@@ -1144,7 +1239,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>
@@ -1153,7 +1249,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>
@@ -1176,6 +1273,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>system file</categoryname>
+<description>man page for loncommon.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../interface/loncommon.pm > ../../doc/man/Apache__loncommon.3
+</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>system file</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
+</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>
@@ -1239,7 +1362,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>
@@ -1266,6 +1392,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>
@@ -1307,11 +1436,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>system file</categoryname>
+<description>man page for lonsearchcat.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../interface/lonsearchcat.pm > ../../doc/man/Apache__lonsearchcat.3
+</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>system file</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
+</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>
@@ -1320,7 +1477,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>
@@ -1339,7 +1502,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>
@@ -1353,6 +1518,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>system file</categoryname>
+<description>man page for lonparmset.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../interface/lonparmset.pm > ../../doc/man/Apache__lonparmset.3
+</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>system file</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
+</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>
@@ -1372,6 +1563,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>system file</categoryname>
+<description>man page for lonpublisher.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../publisher/lonpublisher.pm > ../../doc/man/Apache__lonpublisher.3
+</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>system file</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
+</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>
@@ -1445,6 +1662,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>system file</categoryname>
+<description>man page for lonpage.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../../rat/lonpage.pm > ../../doc/man/Apache__lonpage.3
+</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>system file</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
+</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>
@@ -1454,6 +1697,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>system file</categoryname>
+<description>man page for lonnet.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../../rat/lonuserstate.pm > ../../doc/man/Apache__lonuserstate.3
+</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>system file</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
+</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>
@@ -1595,6 +1864,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>system file</categoryname>
+<description>man page for lonacc.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../auth/lonacc.pm > ../../doc/man/Apache__lonacc.3
+</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>system file</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
+</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>
@@ -1672,6 +1967,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>system file</categoryname>
+<description>man page for lonindexer.pm</description>
+<build trigger='always run'>
+loncom/build/pod2man.sh ../interface/lonindexer.pm > ../../doc/man/Apache__lonindexer.3
+</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>system file</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
+</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>
@@ -1700,6 +2021,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>system file</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
+</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>system file</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
+</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>