Index: openacs-4/packages/acs-core-docs/www/acs-admin.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/acs-admin.html,v diff -u -N -r1.3 -r1.4 --- openacs-4/packages/acs-core-docs/www/acs-admin.html 2 Feb 2002 03:47:32 -0000 1.3 +++ openacs-4/packages/acs-core-docs/www/acs-admin.html 3 Mar 2002 01:27:08 -0000 1.4 @@ -6,7 +6,7 @@ - + @@ -38,16 +38,13 @@
Mat Kovach is graciously maintaining an AOLServer distribution that - includes all the patches and modules needed to run OpenACS 4. These + includes all the patches and modules needed to run OpenACS 4.5. These instructions will describe how to install using his source distribution. He also has binaries for SuSE 7.3 and OpenBSD 2.8 (and perhaps more to come), currently located at uptime.openacs.org. @@ -358,13 +358,13 @@
20.15 Package file structure must follow a specified -convention. Please see the design +convention. Please see the design document for what we do currently.
- ArsDigita ACS 4.0 Installation Guide + OpenACS 4.5 Installation Guide
OpenACS 3.x Installation Guide @@ -84,9 +84,9 @@
When processing a DML statement, Oracle coerces empty strings into null. (This coercion does not occur in the @@ -566,7 +566,7 @@ release the database handle.
@@ -579,7 +579,7 @@
@@ -619,7 +619,7 @@ loop and flush the database handle) and continue statements (which continue to the next row of the loop).
db_1row statement-name sql [ -bind bind_set_id | -bind bind_value_list ] \ @@ -636,7 +636,7 @@
db_0or1row statement-name sql [ -bind bind_set_id | -bind bind_value_list ] \ @@ -646,7 +646,7 @@ sets variables to column values and returns 1. If no rows are returned, returns 0. If more than one row is returned, throws an error.
db_nextval sequence-name @@ -659,7 +659,7 @@
db_register_pooled_sequence sequence-name pool-size @@ -669,7 +669,7 @@
db_string statement-name sql [ -default default ] [ -bind bind_set_id | -bind bind_value_list ] @@ -683,7 +683,7 @@
db_list statement-name sql [ -bind bind_set_id | -bind bind_value_list ] @@ -695,7 +695,7 @@
db_list_of_lists statement-name sql [ -bind bind_set_id | -bind bind_value_list ] @@ -707,7 +707,7 @@
db_dml statement-name sql \ @@ -745,9 +745,9 @@
@@ -762,14 +762,14 @@
db_release_unused_handles
Releases any allocated, unused database handles.
db_transaction code_block [ on_error { code_block } ] @@ -814,7 +814,7 @@
db_resultrows
@@ -825,7 +825,7 @@
db_with_handle var code_block @@ -855,7 +855,7 @@
db_nullify_empty_string string @@ -912,9 +912,9 @@
- - rmello@cc.usu.edu - + + rmello at fslc.usu.edu + vinod@kurup.com Index: openacs-4/packages/acs-core-docs/www/db-api.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/db-api.html,v diff -u -N -r1.3 -r1.4 --- openacs-4/packages/acs-core-docs/www/db-api.html 2 Feb 2002 03:47:32 -0000 1.3 +++ openacs-4/packages/acs-core-docs/www/db-api.html 3 Mar 2002 01:27:08 -0000 1.4 @@ -2,12 +2,12 @@ -The Database Access API +The OpenACS Database Access API - + @@ -23,7 +23,7 @@
By Pete Su and Jon Salz. Modified @@ -518,7 +518,7 @@
db_nextval sequence-name
@@ -658,7 +658,7 @@
db_string statement-name sql [ -default default ] [ -bind bind_set_id | -bind bind_value_list ] @@ -689,7 +689,7 @@
db_list statement-name sql [ -bind bind_set_id | -bind bind_value_list ] @@ -703,7 +703,7 @@
db_list_of_lists statement-name sql [ -bind bind_set_id | -bind bind_value_list ] @@ -715,7 +715,7 @@
db_dml statement-name sql \ @@ -753,9 +753,9 @@
@@ -770,14 +770,14 @@
db_release_unused_handles
Releases any allocated, unused database handles.
db_transaction code_block [ on_error { code_block } ] @@ -822,7 +822,7 @@
db_resultrows @@ -833,7 +833,7 @@
db_with_handle var code_block @@ -866,7 +866,7 @@
Table of Contents
ArsDigita created a good documentation ground for us to build upon. Some sections of the documentation however, lack details @@ -74,7 +74,7 @@ In order to separate content and presentation, all OpenACS documentation will be marked up to conform to the DocBook XML DTD - + This enables us to publish in a variety of formats and relieves each contributor of the burden of presentation, freeing him to focus on content and sharing knowledge. @@ -97,7 +97,7 @@ list of elements and use more exotic features in your documents. The list is made up of SGML-elements but basically the same elements are valid in the XML DTD as long as you remember to: - +
@@ -173,7 +173,7 @@ The documentation for each package will make up a little "book" that is structured like this - examples are emphasized: - +
@@ -205,13 +205,13 @@- + Given that your job starts at the sect1-level, all your documents should open with a <sect1>-tag and end with the corresponding </sect1>.
- + You need to feed every <sect1> two attributes. The first attribute, id, is standard and can be used with all elements. It comes in very handy when interlinking between documents (more about this when talking about links in the section called “Links”). @@ -220,7 +220,7 @@ sect1's will turn into filenames when the book is parsed into HTML.
- + The other attribute is xreflabel. The value of this is the text that will appear as the link when referring to this sect1.
@@ -238,7 +238,7 @@ </sect1>
- + Inside this container your document will be split up into <sect2>'s, each with the same requirements - id and xreflabel @@ -253,7 +253,7 @@
- + For displaying a snippet of code, a filename or anything else you just want to appear as a part of a sentence, we will use the tag <computeroutput>. @@ -269,7 +269,7 @@
- + Linking falls into two different categories: inside the book you're making and outside:
-Check out how I link to a subsection of the Developer's Guide:
+Check out how I link to a subsection of the Developer's Guide:Put this in your XML: @@ -331,7 +331,7 @@
- + If you're hyper-linking out of the documentation, it works almost the same way as HTML - the tag is just a little different @@ -365,7 +365,7 @@
- + To insert a graphic we use the elements <mediaobject>, <imageobject>, @@ -398,7 +398,7 @@
- + Here's how you make the DocBook equivalent of the three usual HTML-lists:
- + DocBook supports several types of tables, but in most cases, the <informaltable> is enough: @@ -534,7 +534,7 @@
- + Our documentation uses two flavors of emphasis - italics and bold type. DocBook uses one - <emphasis>.
@@ -663,7 +663,7 @@- Under OpenACS 4, parameters are set at two levels: at the global level by + Under OpenACS 4.5, parameters are set at two levels: at the global level by the OpenACS-admin, and at the subsite level by a sub-admin. In this section, list and discuss both levels of parameters.
@@ -358,9 +358,9 @@($Id$)
+Table of Contents
Table of Contents
@@ -41,19 +40,19 @@One of the major design features of OpenACS 4 is the explicit representation +
One of the major design features of OpenACS 4.5 is the explicit representation of object identity. The reason I say "explicit representation" is because the concept of object identity has been around forever. It is inherent to our problem domain. Consider the example of 3.x style scoping. The 3.x data models use the triple (user_id, group_id, -scope) to identify an object. In the 4.0 data model this +scope) to identify an object. In the 4.5 data model this object is explicitly represented by a single party_id.
Another good example of this is can be found in the user groups data model. The 3.x user groups data model contains another example of an implied identity. Every mapping between a user and a group could have an arbitrary number of attached values (user_group_member_fields, etc.). In this case it is the pair (group_id, user_id) that implicitly refers to an -object (the person's membership in a group). In the 4.0 data model this +object (the person's membership in a group). In the 4.5 data model this object identity is made explicit by adding an integer primary key to the table that maps users to groups.
Coming from a purely relational world, this might seem slightly weird at @@ -75,15 +75,15 @@
NOTE: We've not yet tested - OpenACS 4 under Oracle 9i
+ OpenACS 4.5 under Oracle 9iNOTE: This document assumes that you'll be installing Oracle on the same box as AOLServer. For more @@ -1610,9 +1610,9 @@
By Pete Su and Bryan Quinn @@ -102,7 +102,7 @@ or 4 different areas.
- Here is how an OpenACS 4 server is laid out: + Here is how an OpenACS 4.5 server is laid out:
@@ -170,7 +170,7 @@ sends to our server to the right page in the appropriate package. While we are at it, this tool may as well also automate package installation, depedency checking, upgrades, and package - removal. In OpenACS 4, this tool is called APM. + removal. In OpenACS 4.5, this tool is called APM.@@ -205,7 +205,7 @@The following sections will show you how to make a package for the Notes application. In addition, they will discuss some new site - management features in OpenACS 4 that take advantage of the APM's package + management features in OpenACS 4.5 that take advantage of the APM's package instance model. The two most important of these are subsites, and the site map tool, which can be used to map applications to one or more arbitrary URLs in a running site. @@ -557,7 +557,7 @@ directory that APM created will be empty except for the notes.info file. At this point, create a file called ROOT/packages/notes/sql/notes-create.sql and put the add - the data model that we created before to + the data model that we created before to this file. You should also create a file called ROOT/packages/notes/sql/notes-drop.sql that drops the data model.
@@ -635,7 +635,7 @@ also hard to map mulitiple URLs to the same place in the file system.- In OpenACS 4, administrators can define an arbitrary mapping between the + In OpenACS 4.5, administrators can define an arbitrary mapping between the URLs the user types and the actual file in the file system that is served. This mapping is called the site map and entries in the site map are called site nodes. Each site node maps a URL to an @@ -650,7 +650,7 @@ of many indepdendent applications that actually run on a single shared code base. The request-processor document shows you how OpenACS figures out which instance of your application was - requested by the user at any given time. The page development tutorial shows you how to use this + requested by the user at any given time. The page development tutorial shows you how to use this information in your user interface.
@@ -681,7 +681,7 @@ yet written Notes application at various places in the site. In a later document, we'll see how to write your applicationn so that the code can detect from where in the site it was invoked. This is the key - to supporting subsites. + to supporting subsites.
@@ -714,8 +714,8 @@($Id$)@@ -732,15 +732,15 @@- OpenACS 4 Data Models and the Object System� +OpenACS 4.5 Data Models and the Object System� Up �The Request Processor
- - rmello@cc.usu.edu - + + rmello at fslc.usu.edu + vinod@kurup.com Index: openacs-4/packages/acs-core-docs/www/parties.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/parties.html,v diff -u -N -r1.3 -r1.4 --- openacs-4/packages/acs-core-docs/www/parties.html 2 Feb 2002 03:47:32 -0000 1.3 +++ openacs-4/packages/acs-core-docs/www/parties.html 3 Mar 2002 01:27:08 -0000 1.4 @@ -2,19 +2,19 @@ -Parties in OpenACS 4 +Parties in OpenACS 4.5 - + @@ -309,9 +309,9 @@
- - rmello@cc.usu.edu - + + rmello at fslc.usu.edu + vinod@kurup.com Index: openacs-4/packages/acs-core-docs/www/psgml-mode.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/psgml-mode.html,v diff -u -N -r1.3 -r1.4 --- openacs-4/packages/acs-core-docs/www/psgml-mode.html 2 Feb 2002 03:47:32 -0000 1.3 +++ openacs-4/packages/acs-core-docs/www/psgml-mode.html 3 Mar 2002 01:27:08 -0000 1.4 @@ -221,9 +221,9 @@
- - rmello@cc.usu.edu - + + rmello at fslc.usu.edu + vinod@kurup.com Index: openacs-4/packages/acs-core-docs/www/release-notes.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/release-notes.html,v diff -u -N -r1.4 -r1.5 --- openacs-4/packages/acs-core-docs/www/release-notes.html 2 Feb 2002 03:47:32 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/release-notes.html 3 Mar 2002 01:27:08 -0000 1.5 @@ -2,19 +2,19 @@ -OpenACS 4.2-beta Release Notes +OpenACS 4.5 Release Notes - +Table of Contents
- +