Index: openacs-4/packages/acs-core-docs/www/xml/index.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/index.xml,v diff -u -r1.19.2.1 -r1.19.2.2 --- openacs-4/packages/acs-core-docs/www/xml/index.xml 14 Nov 2003 20:10:07 -0000 1.19.2.1 +++ openacs-4/packages/acs-core-docs/www/xml/index.xml 17 Nov 2003 16:38:09 -0000 1.19.2.2 @@ -312,7 +312,7 @@ The OpenACS Core, which comprises all the other packages that ship with the kernel and are most frequently needed by users, such as - templating, bboard, and user + templating, forums, and user registration/management. The packages tend to be developed and distributed with the kernel. Index: openacs-4/packages/acs-core-docs/www/xml/openacs.xsl =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/openacs.xsl,v diff -u -r1.12 -r1.12.2.1 --- openacs-4/packages/acs-core-docs/www/xml/openacs.xsl 11 Nov 2003 10:28:28 -0000 1.12 +++ openacs-4/packages/acs-core-docs/www/xml/openacs.xsl 17 Nov 2003 16:38:09 -0000 1.12.2.1 @@ -8,7 +8,7 @@ --> - + Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/db-api.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/db-api.xml,v diff -u -r1.8 -r1.8.2.1 --- openacs-4/packages/acs-core-docs/www/xml/developers-guide/db-api.xml 20 Aug 2003 16:20:18 -0000 1.8 +++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/db-api.xml 17 Nov 2003 16:38:09 -0000 1.8.2.1 @@ -8,9 +8,7 @@ The OpenACS Database Access API - By Pete Su and - Jon Salz. Modified - by Roberto Mello. + By Pete Su and Jon Salz. Modified by Roberto Mello. Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/packages.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/packages.xml,v diff -u -r1.6 -r1.6.2.1 --- openacs-4/packages/acs-core-docs/www/xml/developers-guide/packages.xml 20 Aug 2003 16:20:18 -0000 1.6 +++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/packages.xml 17 Nov 2003 16:38:09 -0000 1.6.2.1 @@ -46,19 +46,19 @@ core tcl libraries here www/ admin/ - bboard/ - site wide admin for bboard + forums/ + site wide admin for forums intranet/ site wide admin for intranet ... and so on for all modules ... - bboard/ - pages for bboard + forums/ + pages for forums admin/ - other admin pages for bboard + other admin pages for forums intranet/ - pages for bboard + pages for intranet admin/ other admin pages for intranet doc/ @@ -115,8 +115,8 @@ acs-test-harness/ acs-util/ acs-workflow/ - bboard/ - bboard.info + forums/ + forums.info sql/ oracle/ oracle data model @@ -143,7 +143,7 @@ Note that a major reorganization has happened here. The diagram only - expands the structure of the bboard/ package directory, + expands the structure of the forums/ package directory, but all the others are basically the same. Each package encapsulates all of its data model, library code, logic, adminstration pages and user pages in a single part of the file tree. This organization has @@ -347,9 +347,9 @@ files. In Oracle this can be done by including @@ filename in the creation or drop scripts. See the - Oracle SQL*Plus documentation for examples. In - PostgreSQL the same is acomplished by including \i. + url="http://www.orafaq.com/faqplus.htm#AT"> + Oracle FAQ for examples. In + PostgreSQL the same is acomplished by including \i filename. sql/<database>/*.sql @@ -436,9 +436,9 @@ Administration UI The administration UI is used to administer the instances of - the package. For example, the bboard administration UI is + the package. For example, the forums administration UI is used to create new forums, moderate postings, and create new - categories for bboard postings. + categories for forums postings. www/admin/* @@ -552,7 +552,7 @@ distinguish it from all the others. It is used as a database key to keep track of the package and as the name of the directory in the file system where all the files related to your package will live. Example - package keys in the current system include: bboard, + package keys in the current system include: forums, acs-kernel and so on. For the example application, we will use the package key notes. @@ -586,7 +586,7 @@ Generally we think of packages as either being applications, meaning that the package is meant primarily for use by end-users, or services meaning that the package is meant to be a reusable - library of code, to be used by other packages. bboard is + library of code, to be used by other packages. forums is a good example of an application, while acs-templating is a good example of a service. Our example is an application, so pick that. @@ -687,7 +687,7 @@ this point, you should add your package files to your CVS repository. I'll assume that you have set up your development repository according to the standards described in - these instructions. If so, then you just do this: + this appendix. If so, then you just do this: @@ -710,7 +710,7 @@ Now you can start developing the package. In addition to writing code, - you should also consider the tasks outlined in the package submission guidelines. + you should also consider the tasks outlined in the package development tutorial. @@ -840,7 +840,7 @@ - Package submission guidelines + package development tutorial ($Id$) Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/permissions.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/permissions.xml,v diff -u -r1.7 -r1.7.2.1 --- openacs-4/packages/acs-core-docs/www/xml/developers-guide/permissions.xml 20 Aug 2003 16:20:18 -0000 1.7 +++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/permissions.xml 17 Nov 2003 16:38:09 -0000 1.7.2.1 @@ -9,7 +9,7 @@ -By Pete Su +By Pete Su @@ -326,7 +326,7 @@ permissions in a subtree of some context. - A good example of how to use this hierarchy is in the bboard + A good example of how to use this hierarchy is in the forums application. With only row-level permissions it is not obvious how to reasonably initialize the access control list when creating a message. At best, we have to explicitly grant various read and write Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/programming-with-aolserver.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/programming-with-aolserver.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/developers-guide/programming-with-aolserver.xml 20 Aug 2003 16:20:18 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/programming-with-aolserver.xml 17 Nov 2003 16:38:09 -0000 1.4.2.1 @@ -9,7 +9,7 @@ -by Michael Yoon, Jon Salz and Lars Pind. +by Michael Yoon, Jon Salz and Lars Pind. Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/subsites.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/subsites.xml,v diff -u -r1.5 -r1.5.2.1 --- openacs-4/packages/acs-core-docs/www/xml/developers-guide/subsites.xml 20 Aug 2003 16:20:18 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/subsites.xml 17 Nov 2003 16:38:09 -0000 1.5.2.1 @@ -10,8 +10,7 @@ -By Rafael H. Schloming -and Pete Su +By Rafael H. Schloming and Pete Su Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/templates.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/templates.xml,v diff -u -r1.6 -r1.6.2.1 --- openacs-4/packages/acs-core-docs/www/xml/developers-guide/templates.xml 20 Aug 2003 16:20:18 -0000 1.6 +++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/templates.xml 17 Nov 2003 16:38:09 -0000 1.6.2.1 @@ -9,7 +9,7 @@ -By Pete Su +By Pete Su Index: openacs-4/packages/acs-core-docs/www/xml/engineering-standards/constraint-naming.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/engineering-standards/constraint-naming.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/engineering-standards/constraint-naming.xml 20 Aug 2003 16:20:18 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/engineering-standards/constraint-naming.xml 17 Nov 2003 16:38:09 -0000 1.4.2.1 @@ -9,7 +9,7 @@ -By mbryzek@arsdigita.com +by Michael Bryzek @@ -182,7 +182,10 @@ Naming not null constraints is optional... -ArsDigita is split on whether or not we should be naming not null constraints... So, if you want to name them, please do so and follow the above naming standard. But, naming not null constraints is not a requirement at ArsDigita. +People disagree on whether or not we should be naming not null +constraints. So, if you want to name them, please do so and follow +the above naming standard. But, naming not null constraints is not a +requirement. Index: openacs-4/packages/acs-core-docs/www/xml/engineering-standards/design-template.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/engineering-standards/design-template.xml,v diff -u -r1.6 -r1.6.2.1 --- openacs-4/packages/acs-core-docs/www/xml/engineering-standards/design-template.xml 20 Aug 2003 16:20:18 -0000 1.6 +++ openacs-4/packages/acs-core-docs/www/xml/engineering-standards/design-template.xml 17 Nov 2003 16:38:09 -0000 1.6.2.1 @@ -7,7 +7,7 @@ Detailed Design Documentation Template - By You + By You Start Note Index: openacs-4/packages/acs-core-docs/www/xml/engineering-standards/docbook-primer.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/engineering-standards/docbook-primer.xml,v diff -u -r1.9 -r1.9.2.1 --- openacs-4/packages/acs-core-docs/www/xml/engineering-standards/docbook-primer.xml 20 Aug 2003 16:20:18 -0000 1.9 +++ openacs-4/packages/acs-core-docs/www/xml/engineering-standards/docbook-primer.xml 17 Nov 2003 16:38:09 -0000 1.9.2.1 @@ -8,9 +8,7 @@ OpenACS Documentation Guide - By claus@arsdigita.com, with - additions by Roberto + By Claus Rasmussen, with additions by Roberto Mello and the OpenACS Community @@ -712,8 +710,7 @@ - David - Lutterkort + David Lutterkort wrote an intro to the PSGML Mode in Emacs @@ -743,7 +740,7 @@ In the process of transforming your HTML into XML, HTML tidy can be a a handy tool to make your HTML "regexp'able". - Brandoch Calef has made a + Brandoch Calef has made a Perl script that gets you most of the way. Index: openacs-4/packages/acs-core-docs/www/xml/engineering-standards/eng-standards-versioning.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/engineering-standards/eng-standards-versioning.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/engineering-standards/eng-standards-versioning.xml 20 Aug 2003 16:20:18 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/engineering-standards/eng-standards-versioning.xml 17 Nov 2003 16:38:09 -0000 1.4.2.1 @@ -8,7 +8,7 @@ Release Version Numbering -By Ron Henderson +By Ron Henderson Index: openacs-4/packages/acs-core-docs/www/xml/engineering-standards/filenaming.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/engineering-standards/filenaming.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/engineering-standards/filenaming.xml 20 Aug 2003 16:20:18 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/engineering-standards/filenaming.xml 17 Nov 2003 16:38:09 -0000 1.4.2.1 @@ -9,8 +9,7 @@ -By michael@arsdigita.com and -aure@arsdigita.com +By Michael Yoon and Aurelius Prochazka @@ -268,7 +267,7 @@ @param password_from_from The password the user entered. @param return_url What url to return to after successful login. @param persistent_cookie_p Specifies whether a cookie should be set to keep the user logged in forever. - @author John Doe (jdoe@arsdigita.com) + @author John Doe (jdoe@example.com) @cvs-id file-standards.html,v 1.2 2000/09/19 07:22:45 ron Exp } { user_id:integer,notnull @@ -335,7 +334,7 @@ ad_library { Provides helper routines for the Wimpy Point module. - @author John Doe (jdoe@arsdigita.com) + @author John Doe (jdoe@example.com) @cvs-id file-standards.html,v 1.2 2000/09/19 07:22:45 ron Exp } Index: openacs-4/packages/acs-core-docs/www/xml/engineering-standards/plsql.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/engineering-standards/plsql.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/engineering-standards/plsql.xml 20 Aug 2003 16:20:18 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/engineering-standards/plsql.xml 17 Nov 2003 16:38:09 -0000 1.4.2.1 @@ -10,8 +10,7 @@ -By richardl@arsdigita.com -and yon@arsdigita.com +By Richard Li and Yon Feldman Index: openacs-4/packages/acs-core-docs/www/xml/engineering-standards/psgml-mode.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/engineering-standards/psgml-mode.xml,v diff -u -r1.5 -r1.5.2.1 --- openacs-4/packages/acs-core-docs/www/xml/engineering-standards/psgml-mode.xml 20 Aug 2003 16:20:18 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/xml/engineering-standards/psgml-mode.xml 17 Nov 2003 16:38:09 -0000 1.5.2.1 @@ -8,7 +8,7 @@ Using PSGML mode in Emacs -By David Lutterkort +By David Lutterkort Index: openacs-4/packages/acs-core-docs/www/xml/engineering-standards/requirements-template.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/engineering-standards/requirements-template.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/engineering-standards/requirements-template.xml 20 Aug 2003 16:20:18 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/engineering-standards/requirements-template.xml 17 Nov 2003 16:38:09 -0000 1.4.2.1 @@ -9,7 +9,7 @@ - By You + By You Index: openacs-4/packages/acs-core-docs/www/xml/files/acceptance-sql.txt =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/files/acceptance-sql.txt,v diff -u -r1.1 -r1.1.8.1 --- openacs-4/packages/acs-core-docs/www/xml/files/acceptance-sql.txt 10 Aug 2002 21:38:38 -0000 1.1 +++ openacs-4/packages/acs-core-docs/www/xml/files/acceptance-sql.txt 17 Nov 2003 16:38:10 -0000 1.1.8.1 @@ -1,4 +1,4 @@ --- acceptance-sql.txt by philg@mit.edu and jsc@arsdigita.com +-- acceptance-sql.txt by philg@mit.edu and Jin S Choi -- (Philip Greenspun and Jin Choi) -- SQL commands to test an Oracle installation Index: openacs-4/packages/acs-core-docs/www/xml/for-everyone/acs-faq.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/for-everyone/acs-faq.xml,v diff -u -r1.5 -r1.5.2.1 --- openacs-4/packages/acs-core-docs/www/xml/for-everyone/acs-faq.xml 20 Aug 2003 16:20:18 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/xml/for-everyone/acs-faq.xml 17 Nov 2003 16:38:10 -0000 1.5.2.1 @@ -39,10 +39,6 @@ - -See also: Adding collaboration to a -Web Site without buying or maintaining an RDBMS and Free Services For Web -Publishers @@ -67,8 +63,7 @@ I have a machine with Unix/Linux, Oracle or PostgreSQL and AOLServer installed. How do -I install the Open Architecture Community System and the ArsDigita Server -Architecture? +I install the Open Architecture Community System? We strongly recommend that you thoroughly examine the step-by-step OpenACS installation guide, even if you already have a working Unix and Oracle @@ -82,24 +77,25 @@ written by ArsDigita and the OpenACS community that can be installed to ensure that the server keeps running reliably. -The overview of +The overview of the ArsDigita Server Architecture is a good starting point for the development of a reliable service. The following documents will also help you keep your system running properly: -Keepalive -Installation -Uptime +Uptime Installation + - -Reporte Installation @@ -170,18 +166,18 @@ Philip and Alex's Guide to Web Publishing -SQL for Web Nerds +SQL for Web Nerds (tutorial for the SQL language; links into online Oracle docs for completeness) -Tcl +Tcl for Web Nerds (tutorial for the Tcl language; in rough shape right now and you might consider using the Welch book (below)) -Common errors made by +Common errors made by database backed web developers -Tips for using Oracle +Tips for using Oracle @@ -205,8 +201,7 @@ Problem Set 5 (how to build collaborative authoring environment, Oracle full text -indexing system) Question -and answer forum +indexing system) @@ -216,9 +211,6 @@ AOLServer Documentation -Oracle -Documentation - AOLserver Tcl Reference Manual @@ -234,12 +226,12 @@ Oracle 8: The Complete Reference (more concise than the online Oracle docs) -Practical +Practical Programming in Tcl and Tk (Brent Welch 1997; Prentice-Hall;) Visual -Explanations : Images and Quantities, Evidence and Narrative (Edward -Tufte 1997; Graphics Press; order directly by calling (800) 822-2454) - +Explanations : Images and Quantities, Evidence and Narrative (Edward +Tufte 1997; Graphics Press; order directly by calling (800) 822-2454) - general design principles @@ -251,17 +243,9 @@ I am stuck. Where can a ask a question? -Problem set 1 -questions +OpenACS Forums +#openacs IRC -Problem set 2 -questions - -Problem set 3 -questions - -Database backed web -site discussion forum @@ -305,37 +289,12 @@ development to suggest extensions, test new releases, write documentation and answer questions. -Module creators: individuals and firms have created and publicized new -modules. - Teachers: Use our teaching materials to teach your company, friends, or at a University. - -Where can I learn about ArsDigita, the company? - - -See arsdigita.com - - - - - - - -How can I work at ArsDigita? - -See Job Openings. - - - ($Id$) - - - - Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/credits.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/credits.xml,v diff -u -r1.10 -r1.10.2.1 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/credits.xml 28 Oct 2003 22:07:41 -0000 1.10 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/credits.xml 17 Nov 2003 16:38:10 -0000 1.10.2.1 @@ -60,7 +60,7 @@ All questions and comments regarding this guide should be posted on the OpenACS bboards. + url="http://openacs.org/forums/">OpenACS forums. ($Id$) @@ -81,16 +81,15 @@ These are a few of my sources: - ArsDigita installation guide + ArsDigita installation guide - OpenACS 3.x installation guide + OpenACS 3.x installation guide - Gilbert Wong's FreeBSD + Gilbert Wong's FreeBSD installation guide Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/oracle.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/oracle.xml,v diff -u -r1.12 -r1.12.2.1 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/oracle.xml 26 Sep 2003 09:51:21 -0000 1.12 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/oracle.xml 17 Nov 2003 16:38:10 -0000 1.12.2.1 @@ -127,7 +127,7 @@ For additional resources/documentation, please see this thread + url="http://openacs.org/forums/message-view?message_id=28829">thread and Andrew Piskorski's mini-guide.. @@ -2015,7 +2015,7 @@ Log back in again. If adding the nls_date_format line doesn't help, you can ask for advice in our OpenACS forum. + url="http://www.openacs.org/forums/">OpenACS forums. Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml,v diff -u -r1.17 -r1.17.2.1 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml 11 Nov 2003 14:55:29 -0000 1.17 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml 17 Nov 2003 16:38:10 -0000 1.17.2.1 @@ -337,7 +337,7 @@ - Search the bboards at + Search the forums at openacs.org - you'll often find many people who have struggled through the same spot that you're in. @@ -362,7 +362,7 @@ Post a question on the bboards. Make sure + url="http://openacs.org/forums/">forums. Make sure you've done a search first. When you do post, be sure to include your setup information (OS, etc) as well as the exact commands that are failing with the accompanying error. If Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml,v diff -u -r1.10 -r1.10.2.1 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml 5 Nov 2003 11:48:12 -0000 1.10 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml 17 Nov 2003 16:38:10 -0000 1.10.2.1 @@ -190,18 +190,10 @@ AOLserver is available at aolserver.com - - ArsDigita's AOLserver distribution (including - internationalization patches, nscache, nsrewrite, nssha1 and the - oracle driver) is available at arsdigita.com - - - The OpenACS PostgreSQL driver (nspostgres.so) is available from SourceForge. If + url="http://prdownloads.sourceforge.net/aolserver/nspostgres-3.5.tar.gz?download">SourceForge. If you do decide to use nspostgres.so, you have to remember to change the AOLserver config file to point to nspostgres.so instead of postgres.so. This guide uses Mat Kovach's distro @@ -233,10 +225,12 @@ <ulink - url="http://www.scottg.net/download/nsopenssl-2.1.tar.gz">nsopenssl 2.1</ulink>, OPTIONAL + url="http://www.scottg.net/download/nsopenssl-2.1a.tar.gz">nsopenssl 2.1a, OPTIONAL Provides SSL capabilities for AOLserver. It requires OpenSSL. You need this if you want users to make - secure (https) connections to your webserver. + secure (https) connections to your webserver. (home + page) Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/win2kinstall.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/win2kinstall.xml,v diff -u -r1.8 -r1.8.2.1 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/win2kinstall.xml 28 Oct 2003 22:07:41 -0000 1.8 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/win2kinstall.xml 17 Nov 2003 16:38:10 -0000 1.8.2.1 @@ -8,12 +8,14 @@ OpenACS Installation Guide for Windows2000 -By Matthew Burke and Curtis Galloway +by Matthew Burke and Curtis Galloway NOTE: These instructions were - valid for ACS v4, but have not been tested with OpenACS. Currently - (8/2002), the best option to get OpenACS &version; running on Windows + valid for ACS v4, but have not been tested with OpenACS and the ArsDigita binary + distributions are no longer available. + Currently + (10/2003), the best option to get OpenACS &version; running on Windows is to use VMware and John Sequeira's Oasis VM @@ -22,11 +24,11 @@ - Source: http://software.arsdigita.com/dist + Source: http://openacs.org/projects/openacs/download - Bug reports: acs-bugs@arsdigita.com + Bug reports: http://openacs.org/bugtracker/openacs - Philosophy: http://photo.net/wtr/thebook/community + Philosophy: http://photo.net/wtr/thebook/community (the community chapter of Philip and Alex's Guide to Web Publishing) @@ -76,7 +78,7 @@ AOLserver (free) - ArsDigita + Oracle driver for AOLserver (free) @@ -155,14 +157,8 @@ For more information on Oracle configuration look at http://photo.net/wtr/oracle-tips - or search the Web/db Q&A - Forum. One other note: the "nuke a user" admin page and + or search the OpenACS forums. One other note: the "nuke a user" admin page and Intermedia won't run unless you set open_cursors = 500 - for your database. For more information on Oracle configuration look at - http://photo.net/wtr/oracle-tips.html - or search the Web/db Q&A - Forum. One other note: the "nuke a user" admin page and - Intermedia won't run unless you set open_cursors = 500 for your database. @@ -383,7 +379,7 @@ Adding Yourself as a User and Making Yourself a Sysadmin - The ArsDigita Community System will define two users: system and + OpenACS will define two users: system and anonymous. It will also define a user group of system administrators. You'll want to add yourself as a user (at /register/ ) and then add yourself as as member of the site-wide administration group. Start by Index: openacs-4/packages/acs-core-docs/www/xml/kernel/apm-design.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/apm-design.xml,v diff -u -r1.5 -r1.5.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/apm-design.xml 20 Aug 2003 16:20:19 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/apm-design.xml 17 Nov 2003 16:38:10 -0000 1.5.2.1 @@ -9,7 +9,7 @@ -by Bryan Quinn +by Bryan Quinn @@ -71,7 +71,7 @@ OpenACS Applications: a "program or group of programs designed for end users" (the Webopedia definition); also known as modules, for historical reasons. -Examples of applications include Bboard and News. +Examples of applications include Forums and News. @@ -91,11 +91,11 @@ This architecture supports the growth of collaborative commerce. For example, Jane User starts a forum focusing on the merits of View Cameras by -creating an instance of the Bboard application for her personal subsite on an +creating an instance of the Forum application for her personal subsite on an OpenACS Installation. Jack User discovers Jane's forum and includes a link to it in his subsite. As interest in Jane's forum grows, she creates a subsite specializing in providing information about View cameras. This -subsite now includes several package instances beyond Bboard; it could +subsite now includes several package instances beyond Forum; it could potentially include its own Ecommerce capabilities (ala Yahoo! Shopping). This could include a knowledge management application that allows users to spread expertise about view cameras and a portal application that links to reliable camera models @@ -879,7 +879,7 @@ The central piece of the data model is the apm_package_types table where each package is registered. When a new application or service is installed on an OpenACS instance, a corresponding row in this table is inserted -with information about the type of package, e.g. if the bboard package is installed on your OpenACS server, a row +with information about the type of package, e.g. if the forum package is installed on your OpenACS server, a row in apm_package_types will be created, noting that it's an application package type. Index: openacs-4/packages/acs-core-docs/www/xml/kernel/apm-requirements.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/apm-requirements.xml,v diff -u -r1.6 -r1.6.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/apm-requirements.xml 20 Aug 2003 16:20:19 -0000 1.6 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/apm-requirements.xml 17 Nov 2003 16:38:10 -0000 1.6.2.1 @@ -8,7 +8,7 @@ OpenACS &version; Package Manager Requirements -by Bryan Quinn and Todd Nightingale +byBryan Quinn and Todd Nightingale Index: openacs-4/packages/acs-core-docs/www/xml/kernel/groups-design.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/groups-design.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/groups-design.xml 20 Aug 2003 16:20:19 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/groups-design.xml 17 Nov 2003 16:38:10 -0000 1.4.2.1 @@ -8,7 +8,7 @@ OpenACS 4 Groups Design -by Rafael H. Schloming and Mark Thomas +by Rafael H. Schloming and Mark Thomas @@ -688,7 +688,7 @@ -Mark Thomas +Mark Thomas @@ -721,7 +721,7 @@ Initial Revision 08/30/2000 -Mark Thomas +Mark Thomas @@ -730,7 +730,7 @@ Additional revisions; tried to clarify membership/compostion 09/08/2000 -Mark Thomas +Mark Thomas Index: openacs-4/packages/acs-core-docs/www/xml/kernel/groups-requirements.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/groups-requirements.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/groups-requirements.xml 20 Aug 2003 16:20:19 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/groups-requirements.xml 17 Nov 2003 16:38:10 -0000 1.4.2.1 @@ -8,7 +8,7 @@ OpenACS 4 Groups Requirements -by Rafael H. Schloming, Mark Thomas +by Rafael H. Schloming, Mark Thomas @@ -36,7 +36,7 @@ and their departments) or regions (the Boston office, the LA office); a person who is employed by (is a member of) a specific department is also a member of the division and the corporation, and works at (is a member of, but -in a different sense) a particular office. OpenACS 4's Parties and Groups +in a different sense) a particular office. OpenACS's Parties and Groups system will support such complex relations faithfully. Historical Motivations Index: openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml,v diff -u -r1.2 -r1.2.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml 20 Aug 2003 16:20:19 -0000 1.2 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/i18n-requirements.xml 17 Nov 2003 16:38:10 -0000 1.2.2.1 @@ -214,8 +214,8 @@ A developer needs to author a web site which operates in -multiple languages simultaneously. For example, arsDigita.com with -content and navigation in English, German, and Japanese. +multiple languages simultaneously. For example, www.un.org with +content and navigation in multiple languages. The site would have an end-user visible UI to support these languages, and the content management system must allow articles to @@ -313,7 +313,7 @@
See -Content +Content Repository Requirement 100.20 10.10 Provide a consistent @@ -380,7 +380,7 @@ localizable nav-bar mechanism for a site? A navigation bar might be made up of a set of text strings and graphics, where the graphics themselves are locale-specific, such as images of English or -Japanese text (as on www.arsdigita.com). It should be easy to +Japanese text (as on www.un.org). It should be easy to specify alternate configurations of text and graphics to lay out the page for different locales. Index: openacs-4/packages/acs-core-docs/www/xml/kernel/object-system-design.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/object-system-design.xml,v diff -u -r1.6 -r1.6.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/object-system-design.xml 30 Sep 2003 12:10:01 -0000 1.6 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/object-system-design.xml 17 Nov 2003 16:38:10 -0000 1.6.2.1 @@ -8,10 +8,7 @@ OpenACS 4 Object Model Design -by Pete Su, - Michael Yoon, - Richard Li - and Rafael Schloming +by Pete Su, Michael Yoon, Richard Li, Rafael Schloming @@ -82,7 +79,7 @@ include: -Bboard messages +forum messages A user home page @@ -269,8 +266,8 @@ abstract name for the default security domain to which the object belongs. Each context has a unique identifier, and all the contexts in a system form a tree. Often this tree will reflect an observed hierarchy in a site, e.g. a -bboard message would probably list a bboard topic as its context, and a -bboard topic might list a subsite as its context. Thus, contexts make it +forum message would probably list a forum topic as its context, and a +forum topic might list a subsite as its context. Thus, contexts make it easier to break the site up into security domains according to its natural structure. An object's context is stored in the context_id column of the acs_objects table. @@ -1473,8 +1470,8 @@ Authors -Pete Su generated this document -from material culled from other documents by Michael Yoon, Richard Li and Rafael Schloming. But, any remaining lies +Pete Su generated this document +from material culled from other documents by Michael Yoon, Richard Li and Rafael Schloming. But, any remaining lies are his and his alone. Index: openacs-4/packages/acs-core-docs/www/xml/kernel/object-system-req.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/object-system-req.xml,v diff -u -r1.5 -r1.5.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/object-system-req.xml 20 Aug 2003 16:20:19 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/object-system-req.xml 17 Nov 2003 16:38:10 -0000 1.5.2.1 @@ -8,7 +8,7 @@ OpenACS 4 Object Model Requirements -By Pete Su +By Pete Su Index: openacs-4/packages/acs-core-docs/www/xml/kernel/permissions-design.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/permissions-design.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/permissions-design.xml 20 Aug 2003 16:20:19 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/permissions-design.xml 17 Nov 2003 16:38:10 -0000 1.4.2.1 @@ -8,7 +8,7 @@ OpenACS 4 Permissions Design -by John Prevost and Rafael H. Schloming +by John Prevost and Rafael H. Schloming @@ -162,8 +162,8 @@ questions about permissions. For example, a number of the above tables describe "direct" or explicit permissions. Inheritance and default values can, however, introduce permissions which are not directly specified. -(For example, read access on a bboard allows read access on all the messages -in the bboard.) +(For example, read access on a forum allows read access on all the messages +in the forum.) The following views provide flattened versions of inherited information: @@ -355,7 +355,7 @@ ); -These procedures are defined in +These procedures are defined in permissions-create.sql Tcl Procedures @@ -462,7 +462,7 @@ -John Prevost +John Prevost Index: openacs-4/packages/acs-core-docs/www/xml/kernel/permissions-requirements.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/permissions-requirements.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/permissions-requirements.xml 20 Aug 2003 16:20:19 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/permissions-requirements.xml 17 Nov 2003 16:38:10 -0000 1.4.2.1 @@ -8,7 +8,7 @@ OpenACS 4 Permissions Requirements -by John McClary Prevost +by John McClary Prevost @@ -104,7 +104,7 @@ Examples of the essential question addressed by the Permissions system: -Can jane@attacker.com delete the web security bboard? Can the Boston office +Can jane@attacker.com delete the web security forum? Can the Boston office (a party) within the VirtuaCorp intranet/website create its own news instance? @@ -167,7 +167,7 @@ Privileges must be designed with appropriate scope for a given OpenACS package. Some privileges are of general utility (e.g. "read" and "write"). Others are of more limited use (e.g. "moderate" -- applies mainly to a package like bboard, where many users are contributing +- applies mainly to a package like forum, where many users are contributing content simultaneously). A package defining its own privileges should do so with moderation, being careful not to overload a privilege like "read" to mean too many things. @@ -192,8 +192,8 @@
70.10 Context There must be a method for objects to receive default access control from -some context. For example, if you do not have read access to a bboard, you -should not have read access to a message in that bboard. +some context. For example, if you do not have read access to a forum, you +should not have read access to a message in that forum.
70.20 Overriding @@ -205,7 +205,7 @@ It must be possible to allow a party more access to some target than they would get by default. (For example, a user does not have the right to edit -any message on a bboard. But a user does possibly have the right to edit +any message on a forum. But a user does possibly have the right to edit their own messages.)
70.20.20 Negative Overriding Index: openacs-4/packages/acs-core-docs/www/xml/kernel/security-design.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/security-design.xml,v diff -u -r1.5 -r1.5.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/security-design.xml 20 Aug 2003 16:20:19 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/security-design.xml 17 Nov 2003 16:38:10 -0000 1.5.2.1 @@ -8,9 +8,7 @@ OpenACS 4 Security Design - -by Richard Li, Archit Shah - +by Richard Li and Archit Shah Index: openacs-4/packages/acs-core-docs/www/xml/kernel/security-notes.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/security-notes.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/security-notes.xml 20 Aug 2003 16:20:19 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/security-notes.xml 17 Nov 2003 16:38:10 -0000 1.4.2.1 @@ -9,7 +9,7 @@ -by Richard Li +by Richard Li Index: openacs-4/packages/acs-core-docs/www/xml/kernel/security-requirements.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/security-requirements.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/security-requirements.xml 20 Aug 2003 16:20:19 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/security-requirements.xml 17 Nov 2003 16:38:10 -0000 1.4.2.1 @@ -8,7 +8,7 @@ OpenACS 4 Security Requirements -by Richard Li +by Richard Li Index: openacs-4/packages/acs-core-docs/www/xml/kernel/subsites-design.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/subsites-design.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/subsites-design.xml 20 Aug 2003 16:20:19 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/subsites-design.xml 17 Nov 2003 16:38:10 -0000 1.4.2.1 @@ -36,7 +36,7 @@ a particular user community. This definition covers a very broad range of requirements: from a Geocities style homepage where a user can install whatever available application he wants (e.g. a single user could have their -own news and bboard), to a highly structured project subsite with multiple +own news and forums), to a highly structured project subsite with multiple interdependent applications. Thus, flexibility in application deployment is the overarching philosophy of subsites. Index: openacs-4/packages/acs-core-docs/www/xml/kernel/subsites-requirements.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/subsites-requirements.xml,v diff -u -r1.4 -r1.4.2.1 --- openacs-4/packages/acs-core-docs/www/xml/kernel/subsites-requirements.xml 20 Aug 2003 16:20:19 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/subsites-requirements.xml 17 Nov 2003 16:38:10 -0000 1.4.2.1 @@ -8,7 +8,7 @@ OpenACS 4 Subsites Requirements -by Rafael H. Schloming and Dennis Gregorovic +by Rafael H. Schloming and Dennis Gregorovic @@ -83,26 +83,26 @@ subcommunities. -Joe Programmer is working on the bboard package and wants to make it +Joe Programmer is working on the forum package and wants to make it subsite-aware. Using [ad_conn package_id], Joe adds code that only displays -bboard messages associated with the current package instance. Joe is happy to +forum messages associated with the current package instance. Joe is happy to realize that ad_parameter is already smart enough to return configuration parameters for the current package instance, and so he has to do no extra work to tailor configuration parameters to the current subsite. Jane Admin maintains www.company.com. She learns of Joe's work and -would like to set up individual bboards for the Boston and Austin offices of +would like to set up individual forums for the Boston and Austin offices of her company. The first thing she does is use the APM to install the new -bboard package. +forum package. Next, Jane uses the Subsite UI to create subsites for the Boston and -Austin offices. Then Jane uses the Subsite UI to create bboards for each +Austin offices. Then Jane uses the Subsite UI to create forums for each office. -Now, the Boston office employees have their own bboard at -http://www.company.com/offices/boston/bboard, and similarly for the Austin +Now, the Boston office employees have their own forum at +http://www.company.com/offices/boston/forum, and similarly for the Austin office. At this point, the Boston and Austin office admins can customize the -configurations for each of their bboards, or they can just use the +configurations for each of their forums, or they can just use the defaults.