[LON-CAPA-cvs] cvs: loncom /publisher lonpublisher.pm

[bowersj2]

bowersj2		Thu Jul 24 22:04:51 2003 EDT

  Modified files:              
    /loncom/publisher	lonpublisher.pm 
  Log:
  Documentation updates.
  
  
Index: loncom/publisher/lonpublisher.pm
diff -u loncom/publisher/lonpublisher.pm:1.126 loncom/publisher/lonpublisher.pm:1.127
--- loncom/publisher/lonpublisher.pm:1.126	Wed Jul 23 15:17:27 2003
+++ loncom/publisher/lonpublisher.pm	Thu Jul 24 22:04:51 2003
@@ -1,7 +1,7 @@
 # The LearningOnline Network with CAPA
 # Publication Handler
 #
-# $Id: lonpublisher.pm,v 1.126 2003/07/23 19:17:27 bowersj2 Exp $
+# $Id: lonpublisher.pm,v 1.127 2003/07/25 02:04:51 bowersj2 Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -81,6 +81,26 @@
   ErrorDocument     406 /adm/unauthorized.html
   ErrorDocument     500 /adm/errorhandler
   </Location>
+
+=head1 OVERVIEW
+
+Authors can only write-access the C</~authorname/> space. They can
+copy resources into the resource area through the publication step,
+and move them back through a recover step. Authors do not have direct
+write-access to their resource space.
+
+During the publication step, several events will be
+triggered. Metadata is gathered, where a wizard manages default
+entries on a hierarchical per-directory base: The wizard imports the
+metadata (including access privileges and royalty information) from
+the most recent published resource in the current directory, and if
+that is not available, from the next directory above, etc. The Network
+keeps all previous versions of a resource and makes them available by
+an explicit version number, which is inserted between the file name
+and extension, for example C<foo.2.html>, while the most recent
+version does not carry a version number (C<foo.html>). Servers
+subscribing to a changed resource are notified that a new version is
+available.
 
 =head1 DESCRIPTION