--- doc/loncapafiles/Attic/loncapafiles.html	2001/02/27 22:06:18	1.61
+++ doc/loncapafiles/Attic/loncapafiles.html	2001/02/28 15:40:29	1.62
@@ -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>
@@ -454,7 +465,7 @@ Handler for interacting with MySQL datab
 <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>
@@ -807,9 +818,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>
@@ -819,7 +836,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>