--- doc/loncapafiles/Attic/loncapafiles.html	2001/02/27 21:50:46	1.60
+++ doc/loncapafiles/Attic/loncapafiles.html	2001/03/08 19:00:23	1.71
@@ -161,7 +161,8 @@ browser and can only be seen be examinin
 <LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="home/httpd/html/adm/rat" CATEGORY="server readonly" DESCRIPTION="home of the rat">
 <LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="home/httpd/html/adm/lonIcons" CATEGORY="server readonly">
 <LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="home/httpd/html/adm/lonKaputt" CATEGORY="server readonly">
-<LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="home/httpd/lonUsers" CATEGORY="server standard" DESCRIPTION="home directories of local users">
+<LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="home/httpd/lonUsers" CATEGORY="server standard" DESCRIPTION="<BR>Home directories of local users.  There is a five-tier structure to the directories: [domain]/[firstletter]/[secondletter]/[thirdletter]/[userid].  For example, a user fredflint at MSU would have his information located in lonUsers/msu/f/r/e/fredflint.<P>Within this directory there are a variety of files which govern the scope of what a user can do within the LON-CAPA system.  A passwd file determines the type of authentication mechanism to use.  There is also are files such as roles.hist (and its database compilation, roles.db) which specify the roles and privileges for a user in the
+LON-CAPA system.">
 <LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="home/httpd/html/lon-status" CATEGORY="server standard" DESCRIPTION="status reports">
 <LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="usr/lib/perl5/site_perl/5.005" CATEGORY="standard">
 <LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="home/httpd/html/adm/MathML" CATEGORY="server readonly">
@@ -360,7 +361,17 @@ proxy server
 <METAGROUP>
 <LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/lond" TARGET="home/httpd/perl/lond" CATEGORY="script">
 <DESCRIPTION>
-remote command interpreter
+This is a remote command interpreter on a TCP LON-CAPA network layer.
+It accepts and processes incoming requests from other LON-CAPA machines
+on the network.  lond's functionality is self-contained in the sense
+that it does not reference (import, require, use) any other file
+described in this document.  There are only 15 subroutines in this
+script, however the <TT>make_new_child</TT> subroutine is quite
+complex since it parses and responds about 29 different types of 
+network requests (i.e. enc, ping, pong, ekey, load, auth, passwd,
+makeuser, home, update, unsub, sub, log, put, rolesput, get, eget,
+del, keys, dump, store, restore, querysend, queryreply, idput, idget,
+tmpput, tmpget, and ls).
 </DESCRIPTION>
 </METAGROUP>
 <METAGROUP>
@@ -445,16 +456,37 @@ Table which has hash data necessary for
 </DESCRIPTION>
 </METAGROUP>
 <METAGROUP>
-<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/metadata_database/lonsql.pm" TARGET="home/httpd/lib/perl/Apache/lonsql.pm" CATEGORY="handler">
+<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/interface/lonmeta.pm" TARGET="home/httpd/lib/perl/Apache/lonmeta.pm" CATEGORY="handler">
 <DESCRIPTION>
-Handler for interacting with MySQL database (via lonsql layer).
+Metadata display handler.
+</DESCRIPTION>
+<STATUS>works/unverified</STATUS>
+</METAGROUP>
+<METAGROUP>
+<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="rat/lonambiguous.pm" TARGET="home/httpd/lib/perl/Apache/lonambiguous.pm" CATEGORY="handler">
+<DESCRIPTION>
+Handler to resolve ambiguous file locations.
+</DESCRIPTION>
+<STATUS>works/unverified</STATUS>
+</METAGROUP>
+<METAGROUP>
+<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="rat/lonratparms.pm" TARGET="home/httpd/lib/perl/Apache/lonratparms.pm" CATEGORY="handler">
+<DESCRIPTION>
+Handler to set resource parameters inside of the RAT based on metadata.
+</DESCRIPTION>
+<STATUS>works/unverified</STATUS>
+</METAGROUP>
+<METAGROUP>
+<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="rat/lonsequence.pm" TARGET="home/httpd/lib/perl/Apache/lonsequence.pm" CATEGORY="handler">
+<DESCRIPTION>
+Handler for showing sequence objects of educational resources.
 </DESCRIPTION>
 <STATUS>works/unverified</STATUS>
 </METAGROUP>
 <METAGROUP>
 <LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/interface/loncreatecourse.pm" TARGET="home/httpd/lib/perl/Apache/loncreatecourse.pm" CATEGORY="handler">
 <DESCRIPTION>
-Creates a new course and assigns course coordinator
+Creates a new course and assigns course coordinator.
 </DESCRIPTION>
 <STATUS>works/unverified</STATUS>
 </METAGROUP>
@@ -753,7 +785,10 @@ handles request to the CAPA homework pro
 <METAGROUP>
 <LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/auth/lonacc.pm" TARGET="home/httpd/lib/perl/Apache/lonacc.pm" CATEGORY="handler">
 <DESCRIPTION>
-access to for a LON-CAPA user session
+(This module, like loncacc.pm also authenticates with cookies.)  
+<TT>lonacc.pm</TT> coordinates access to a wide range of administrative-type
+functions (e.g. roles, logout, annotations, and bookmarks) as well
+as coordinating access to educational resources.
 </DESCRIPTION>
 </METAGROUP>
 <METAGROUP>
@@ -767,12 +802,14 @@ access handler for file transfers
 <DESCRIPTION>
 This module provides access to an educational resource construction area.
 This module is invoked by the URL-related pattern syntax
-<TT>LocationMatch "^/priv.*"</TT>.  Authentication of user identity
-is coordinated through cookies (hence the abbreviation; "cacc" corresponds
-to "cookie-based access").  If the cookie handle is invalid, then
+<TT>LocationMatch "^/priv.*"</TT> or <TT>LocationMatch "^/\~.*"</TT>.
+Authentication of user identity
+is coordinated through cookies.  The abbreviation "cacc" corresponds
+to "construction-space access").  If the cookie handle is invalid, then
 this module returns a forbidden status and makes appropriate log entries.
-If the cookie handle is valid, status is determined to be okay (and
-the resource is delivered by the <TT>lonconstruct</TT> module).
+If the cookie handle is valid, status is determined to be okay (and,
+for the "priv"-type access, the resource is delivered by the
+<TT>lonconstruct</TT> module).
 </DESCRIPTION>
 </METAGROUP>
 <METAGROUP>
@@ -802,9 +839,15 @@ replication
 <METAGROUP>
 <LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/auth/lonroles.pm" TARGET="home/httpd/lib/perl/Apache/lonroles.pm" CATEGORY="handler">
 <DESCRIPTION>
-roles picking
+This perl handling module reads in the available roles available
+for a LON-CAPA user (different courses, different privileges, etc)
+and produces a form-element HTML page which allows the user to select
+which role he wishes to exercise in the LON-CAPA system.  For instance,
+a user may want to select between being a student in a thermodynamics
+physics course or a teaching assistant for an introductory calculus
+class.
 </DESCRIPTION>
-</METAGROUP> 
+</METGROUP> 
 <METAGROUP>
 <LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/interface/lonindexer.pm" TARGET="home/httpd/lib/perl/Apache/lonindexer.pm" CATEGORY="handler">
 <DESCRIPTION>
@@ -814,7 +857,16 @@ cross server filesystem browser
 <METAGROUP>
 <LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/lonnet/perl/lonnet.pm" TARGET="home/httpd/lib/perl/Apache/lonnet.pm" CATEGORY="handler">
 <DESCRIPTION>
-interface to lonc
+This file is an interface to the lonc processes of the LON-CAPA network
+as well as set of elaborated functions for handling information necessary
+for navigating through a given cluster of LON-CAPA machines within a domain.
+There are over 40 specialized functions in this module which handle
+the reading and transmission of metadata, user information
+(ids, names, environments, roles, logs), file information (storage, reading,
+directories, extensions, replication, embedded styles and descriptors),
+educational resources (course descriptions, section names and numbers),
+url hashing (to assign roles on a url basis), and translating abbreviated
+symbols to and from more descriptive phrases or explanations.
 </DESCRIPTION>
 </METAGROUP> 
 <METAGROUP>