--- doc/loncapafiles/Attic/loncapafiles.html 2000/12/12 16:55:46 1.35
+++ doc/loncapafiles/Attic/loncapafiles.html 2001/05/03 21:30:05 1.89
@@ -27,7 +27,7 @@ The format of these tags is:
Here are examples of all the different types of LONCAPA make/build tags.
-
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler">
+
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler">
<LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="home/httpd/lib/perl/Apache" CATEGORY="writeable by server">
<LONCAPA TYPE=OWNERSHIP DIST="redhat6.2" CATEGORY="setuid" CHMOD="6755" CHOWN="root:root">
<LONCAPA TYPE=RPM NAME="Vendor" VALUE="Laboratory for Instructional Technology Education, Division of Science and Mathematics Education, Michigan State University.">
@@ -52,19 +52,19 @@ The NAME tags associated with TYPE=RPM a
Data can also be attached to any LON-CAPA tag. This is especially important for files. This is shown by these three examples:
<METAGROUP>
-
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler">
+
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler">
<DESCRIPTION>
Handler for TeX files
</DESCRIPTION>
</METAGROUP>
<METAGROUP>
-
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/tth.so" TARGET="usr/lib/perl5/site_perl/5.005/tth.so" CATEGORY="system file">
+
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="modules/TexConvert/tthperl/tth.so" TARGET="usr/lib/perl5/site_perl/5.005/tth.so" CATEGORY="system file">
<DESCRIPTION>
shared library file for dynamic loading and unloading of TeX-to-HTML functionality
</DESCRIPTION>
<BUILD>
-
loncom/modules/TexConvert/tthperl/commands
+
modules/TexConvert/tthperl/commands
</BUILD>
<DEPENDENCIES>
../tthdynamic/tthfunc.c
@@ -160,7 +160,10 @@ browser and can only be seen be examinin
-
+
+
+
@@ -190,7 +193,16 @@ browser and can only be seen be examinin
-define handlers, set parameters
+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.
configure
@@ -208,25 +220,65 @@ define handlers, set parameters
-main server configuration file
+This is the main server configuration file. The settings here are
+more or less standard for the Apache web server. Most notably (and
+importantly!), perl handling and mod_perl are enabled in this configuration
+file.
-name space configuration
+
+This file configures the "name space" of the Apache web server.
+srm.conf
+defines when specific perl modules should be called to handle a given
+request. This definition is a function of both the name of the perl module,
+and a specific regular expression associated with the URL, such as
+"^/res/.*\.page".
+
+
+Here is an example entry:
+
+<LocationMatch "^/res/.*\.page$>
+SetHandler perl-script
+PerlHandler Apache::lonpage
+</LocationMatch>
+
+
-set paths to modules; invoked by access.conf
+This file provides initializations for perl handlers. It adjusts what
+the module path space is (so as to include /home/httpd/lib/perl/Apache) as
+well as causing the Apache module to be used for every perl handler.
+startup.pl is invoked by access.conf.
-Descriptive list of file extensions, and extension groupings
+Descriptive list of file extensions, and extension groupings.
+
+
+
+
+
+Default spreadsheet for individual assessment.
+
+
+
+
+
+Default spreadsheet for assessment of students.
+
+
+
+
+
+Default spreadsheet for assessment of a class.
@@ -268,7 +320,7 @@ each list element consists of only one v
-
+
Basic auth password to access /lon-status and /server-status
@@ -320,6 +372,12 @@ Example:
server ntp.msu.edu
+
+
+Batch script for updating SQL metadata database.
+
+
+
proxy server
@@ -328,7 +386,17 @@ proxy server
-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 make_new_child 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).
@@ -381,6 +449,12 @@ resources, directories and underlying su
+
+
+The relevant conditions and metadata to attach to LectureOnline-specific tags.
+
+
+
File which contains words which should not be keywords used to specify resource
@@ -407,6 +481,221 @@ Table which has hash data necessary for
+
+
+Handler to upload files through browser into construction space.
+
+works/unverified
+
+
+
+
+Handler to evaluate essay (ungraded) style responses.
+
+works/unverified
+
+
+
+
+Handler to publish directories.
+
+works/unverified
+
+
+
+
+Handler to retrieve old versions from resource space.
+
+works/unverified
+
+
+
+
+Helper functions when in homework edit mode.
+
+works/unverified
+
+
+
+
+Metadata display handler.
+
+works/unverified
+
+
+
+
+Handler to resolve ambiguous file locations.
+
+works/unverified
+
+
+
+
+Handler to set resource parameters inside of the RAT based on metadata.
+
+works/unverified
+
+
+
+
+Handler for showing sequence objects of educational resources.
+
+works/unverified
+
+
+
+
+Creates a new course and assigns course coordinator.
+
+works/unverified
+
+
+
+
+Creates a new user and/or changes user privileges
+
+works/unverified
+
+
+
+
+Produces simple LectureOnline-like student assessment performance chart
+
+works/unverified
+
+
+
+
+Makes a table out of the previous attempts. Inputs result_from_symbread,
+user, domain, home_server, course_id
+
+works/unverified
+
+
+
+
+Handles the viewing of grades.
+
+
+
+
+
+Coordinates the response to clicking an image.
+
+
+
+
+
+Handles tags associated with showing a list of options.
+
+
+
+
+
+Handles tags associated with output. Seems to relate to due dates of the
+assignment.
+
+
+
+
+
+Used for debugging and testing the LON-CAPA system.
+
+
+
+
+
+Handles multiple-choice style responses.
+
+
+
+
+
+Handles processing of assignments.
+
+
+
+
+
+Handles communication.
+
+
+
+
+
+Handles errors.
+
+
+
+
+
+Handles evaluation.
+
+
+
+
+
+Handles feedback from students to instructors and system administrators.
+
+
+
+
+
+Unknown function.
+
+
+
+
+
+Handles navigational maps.
+
+
+
+
+
+Handles user preferences associated with customizing the online LON-CAPA
+educational environment.
+
+
+
+
+
+Handles the production of printable files and resources.
+
+
+
+
+
+Handles a searchable catalogue.
+
+
+
+
+
+Handler to drop and add students in courses.
+
+
+
+
+
+Routines for messaging.
+
+
+
+
+
+This handler coordinates the delivery of hints to students working on LON-CAPA
+problems and assignments.
+
+
+
+
+
+Spreadsheet/Grades Display Handler
+
+
+
Handler to resolve ambiguous file locations
@@ -444,6 +733,12 @@ Builds up frame set and loads in the rig
+
+
+Homework remote control.
+
+
+
This will take annotations and then plug them into a page
@@ -476,13 +771,13 @@ compile course into binary data structur
-
+
-Handler for tex files (somewhere in loncom/modules)
+Handler for tex files (somewhere in modules)
-
+
Access to tth/ttm
@@ -550,7 +845,10 @@ handles request to the CAPA homework pro
-access to for a LON-CAPA user session
+(This module, like loncacc.pm also authenticates with cookies.)
+lonacc.pm 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.
@@ -562,7 +860,16 @@ access handler for file transfers
-access to construction area
+This module provides access to an educational resource construction area.
+This module is invoked by the URL-related pattern syntax
+LocationMatch "^/priv.*" or LocationMatch "^/\~.*".
+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,
+for the "priv"-type access, the resource is delivered by the
+lonconstruct module).
@@ -592,9 +899,15 @@ replication
-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.
-
+
@@ -604,7 +917,16 @@ cross server filesystem browser
-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.
@@ -645,6 +967,12 @@ frameset
+
+
+Parameter input window.
+
+
+
javascript
@@ -656,6 +984,12 @@ javascript
bumper
+
+
+
+A blank page with very minimal HTML structural elements.
+
+
@@ -770,6 +1104,35 @@ sutd.gif
+
+
+icons to indicate an unexpected result
+
+
+lonconstruct.gif
+lonlogo_broken.gif
+lonlogo_broken_tsp.gif
+
+
+
+
+
+icon to indicate an unexpected result
+
+
+
+
+
+icon to indicate an unexpected result
+
+
+
+
+
+icon to indicate an unexpected result
+
+
+
logos
@@ -780,19 +1143,33 @@ lonlogo.gif
lonlogos.gif
+
+
+
+miscellaneous resources
+
+
+cat_button.gif
+
+
-
+
perl module for invoking functions specific to Tex-to-HTML conversion
+
+Has the same dependencies and build process as tth.so.
+Currently, only the tth.so file specifications invoke
+the build process however.
+
-
+
shared library file for dynamic loading and unloading
-loncom/modules/TexConvert/tthperl/commands
+modules/TexConvert/tthperl/commands
../tthdynamic/tthfunc.c
@@ -804,12 +1181,22 @@ loncom/modules/TexConvert/tthperl/comman
perl module for invoking functions specific to CAPA
+
+Has the same dependencies and build process as capa.so.
+Currently, only the capa.so file specifications invoke
+the build process however.
+
bootstrap file associated with dynamic loading of this module on multiple architectures
+
+Has the same dependencies and build process as capa.so.
+Currently, only the capa.so file specifications invoke
+the build process however.
+
@@ -820,9 +1207,9 @@ shared library file for dynamic loading
loncom/homework/caparesponse/commands
-capa_wrap.c
caparesponse.c
-capa.pm
+caparesponse.pm
+[ALWAYS_RUN_BUILD_COMMAND]
@@ -876,11 +1263,23 @@ Encryption Routines according to Data En
+
+
+used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run()
+
+
+
used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run()
+
+
+
+Define unit prefixing and conversion for CAPA problem handling.
+
+
@@ -908,6 +1307,7 @@ j.gif
k.gif
l.gif
ledblink.gif
+ledgreen.gif
ledoff.gif
ledon.gif
ledsend.gif
@@ -942,13 +1342,13 @@ image maps for the LON-CAPA remote contr
-
+
welcoming page to the LON-CAPA system upon login
-
+
renders the HTML (including image maps) for the LON-CAPA remote control
@@ -1046,24 +1446,24 @@ world2.gif
icons used for directory indexing and login screen
-button_close.gif
-button_edit.gif
-button_preview.gif
-folder_closed.gif
-folder_closed_pressed.gif
+folder_anim.gif
+folder_close.gif
+folder_drag.gif
folder_new.gif
-folder_opened.gif
-folder_opened_pressed.gif
+folder_open.gif
folder_pointer_closed.gif
folder_pointer_opened.gif
-folder_spacer.gif
+folder_static.gif
folder_trash.gif
+folder_trash_hover.gif
left_bar.gif
link.gif
-link_pressed.gif
+link_anim.gif
+link_drag.gif
ll_corner.gif
lower_bar.gif
lr_corner.gif
+pix.gif
right_bar.gif
toolbar_bg.gif
ul_corner.gif
@@ -1077,22 +1477,9 @@ ur_corner.gif
associated with the frameset scheme of displaying bookmarks
-aaloader.html
-bookmarkmenu_bb.html
-bookmarkmenu_left.html
-bookmarkmenu_ll.html
-bookmarkmenu_lr.html
-bookmarkmenu_right.html
bookmarkmenu_toolbar.html
-bookmarkmenu_ul.html
-bookmarkmenu_ur.html
-bookmarkmenu_uu.html
-bookmarkpal.html
-bookmarkpal_old.html
-bookmarkpal_v2.html
-bookmarkpal_v2_backup.html
-index.html
-loading_bookmarks.html
+blank.html
+closechildren.html
@@ -1133,7 +1520,7 @@ makes verification report using loncapav
-
+
file that specifies periodic processes to run for the LON-CAPA machine