Index: openacs-4/ChangeLog
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/ChangeLog,v
diff -u -N -r1.13.4.2 -r1.13.4.3
--- openacs-4/ChangeLog	30 Aug 2013 08:18:29 -0000	1.13.4.2
+++ openacs-4/ChangeLog	24 Oct 2014 14:33:49 -0000	1.13.4.3
@@ -701,7 +701,7 @@
 	* packages/acs-kernel/sql/postgresql/site-nodes-create.sql:
 	* packages/acs-kernel/sql/postgresql/upgrade/upgrade-5.8.0d3-5.8.0d4.sql:
 	Creating recursive version of permissions functions iff pg 
-	version is >= 8.4. 
+	version is >= 8.4. 
 
 	* packages/acs-bootstrap-installer/tcl/30-apm-load-procs.tcl:
 	Taking .sql out of the list of ignored file extensions. 
@@ -5406,7 +5406,7 @@
 	Added my JSON utilities package.  Included are procs to 
 	parse a JSON string into a canonical Tcl list 
 	representation, to generate a JSON string from such a 
-	representation (round-tripping works, i.e. JSON -> Tcl -> 
+	representation (round-tripping works, i.e. JSON -> Tcl -> 
 	JSON), pretty-print JSON strings, set/get attributes, create 
 	objects and arrays, etc. 
 
@@ -12827,7 +12827,7 @@
 2008-09-22 daveb
 
 	* packages/tsearch2-driver/tcl/tsearch2-driver-procs-postgresql.xql:
-	Add default config for PG < 8.3 query. 
+	Add default config for PG &lt; 8.3 query. 
 
 	* packages/tsearch2-driver/tcl/tsearch2-driver-procs-postgresql.xql:
 	* packages/tsearch2-driver/tcl/tsearch2-driver-procs.tcl:
@@ -15164,7 +15164,7 @@
 
 	* packages/notifications/tcl/sweep-procs-oracle.xql:
 	Fixed problem with query on oracle. Drop condition  and 
-	!>>>!notifications.notif_date < sysdate because it doesn't 
+	!&gt;&gt;&gt;!notifications.notif_date &lt; sysdate because it doesn't 
 	exist on pg query. 
 
 2008-04-09 donb
@@ -15860,7 +15860,7 @@
 2008-02-02 donb
 
 	* packages/acs-templating/tcl/form-procs.tcl:
-	Put "<div>" around hidden elements put out by the 
+	Put "&lt;div&gt;" around hidden elements put out by the 
 	formtemplate tag when a custom template layout rather than a 
 	style template is used and that custom template layout 
 	doesn't put out the hidden elements manually. 
@@ -18026,8 +18026,8 @@
 2007-10-17 gustafn
 
 	* www/blank-master.adp:
-	don't crash, if no xinha is available (<if @::array.field@ 
-	not nil> does not seem to work) 
+	don't crash, if no xinha is available (&lt;if @::array.field@ 
+	not nil&gt; does not seem to work) 
 
 2007-10-13 maltes
 
@@ -18245,7 +18245,7 @@
 	* www/blank-master.tcl:
 	Fixed the blank master as headscript was not defined (called 
 	script) and the foreach did not work either. Not to mention 
-	the fact that the <list> tag is unknown to OpenACS 
+	the fact that the &lt;list&gt; tag is unknown to OpenACS 
 	templating 
 
 	* packages/acs-content-repository/tcl/acs-content-repository-init.tcl:
@@ -18733,7 +18733,7 @@
 	* packages/acs-templating/www/resources/xinha-nightly/functionsMozilla.js:
 	* packages/acs-templating/www/resources/xinha-nightly/plugins/Template/popups/template.html:
 	* packages/acs-templating/www/resources/xinha-nightly/popups/about.html:
-	changing <br/> to <br> to meet html transitional validation 
+	changing &lt;br/&gt; to &lt;br&gt; to meet html transitional validation 
 	requirements 
 
 2007-08-12 matthewg
@@ -19173,7 +19173,7 @@
 	* packages/acs-kernel/catalog/acs-kernel.nl_ZA.ISO-8859-1.xml:
 	* packages/acs-kernel/catalog/acs-kernel.pl_PL.utf-8.xml:
 	* packages/acs-kernel/catalog/acs-kernel.pt_BR.ISO-8859-1.xml:
-	fix typo in message catalog: common_lastt -> common_last 
+	fix typo in message catalog: common_lastt -&gt; common_last 
 
 2007-06-28 matthewg
 
@@ -19277,8 +19277,8 @@
 	* packages/acs-subsite/tcl/group-procs.tcl:
 	Adding group::add_member callback and changed the 
 	group::add_member proc to allow organization_rel's to be 
-	used - since organization => group mappings are needed and 
-	membership_rel requires person => group mappings. 
+	used - since organization =&gt; group mappings are needed and 
+	membership_rel requires person =&gt; group mappings. 
 
 2007-06-25 maltes
 
@@ -21190,7 +21190,7 @@
 2007-03-09 emmar
 
 	* packages/acs-tcl/lib/progress-bar.adp:
-	Add missing closing > for title tag 
+	Add missing closing &gt; for title tag 
 
 2007-03-07 daveb
 
@@ -24192,7 +24192,7 @@
 	Added a necessary comment to a public proc 
 
 	* packages/acs-subsite/acs-subsite.info:
-	And the last oacs-5-3 -> HEAD merge commit (vi was being 
+	And the last oacs-5-3 -&gt; HEAD merge commit (vi was being 
 	weird on the cvs.openacs.org server so I fixed this one 
 	locally) 
 
@@ -24328,7 +24328,7 @@
 	* packages/acs-tcl/tcl/test/file-test-procs.tcl:
 	Made the upgrade ordering check ignore files that are just 
 	under the package key in sql or upgrade directories.  These 
-	are old upgrade files (acs 3 -> acs 4, for instance) that 
+	are old upgrade files (acs 3 -&gt; acs 4, for instance) that 
 	don't follow the APM numbering scheme (in many cases they 
 	were meant to be run manually). 
 
@@ -24399,7 +24399,7 @@
 	* packages/search/catalog/search.pt_BR.ISO-8859-1.xml:
 	* packages/search/www/search.tcl:
 	* www/blank-master.adp:
-	Merged oacs-5-2 -> oacs-5-3 branches. 
+	Merged oacs-5-2 -&gt; oacs-5-3 branches. 
 
 	* packages/acs-admin/www/users/merge-final.tcl:
 	* packages/acs-admin/www/users/merge.tcl:
@@ -27793,7 +27793,7 @@
 2006-06-09 victorg
 
 	* packages/acs-templating/tcl/test/parse-test-procs.tcl:
-	Removing ">>>>>>" ( signs from the merge between oacs-5-2 
+	Removing "&gt;&gt;&gt;&gt;&gt;&gt;" ( signs from the merge between oacs-5-2 
 	and HEAD maybe ). 
 
 2006-06-08 rocaelh
@@ -27806,9 +27806,9 @@
 
 	* packages/acs-mail-lite/tcl/acs-mail-lite-init.tcl:
 	* packages/acs-mail-lite/tcl/acs-mail-lite-procs.tcl:
-	Cleaning up ' acs-mail-lite is littered with partially > 
+	Cleaning up ' acs-mail-lite is littered with partially &gt; 
 	completed and essentially non-functional code (hard-wired 
-	references to > malte's home directory on one of his 
+	references to &gt; malte's home directory on one of his 
 	servers, for instance)' that Don has complaining about and 
 	he says it needs fixing. 
 
@@ -28826,51 +28826,51 @@
 	* packages/search/www/search.tcl:
 	* www/blank-master.tcl:
 	* www/site-master.adp:
-	Merged acs-core oacs-5-2 (currently 5.2.3) -> HEAD.  TODO:  
+	Merged acs-core oacs-5-2 (currently 5.2.3) -&gt; HEAD.  TODO:  
 	1. Bump acs-core package version numbers to 5.3.0d1 2. Would 
 	be nice to do a test install, wouldn't it? 
 
 	* packages/acs-subsite/www/resources/core.js:
 	branches:  1.10.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* packages/acs-subsite/www/shared/parameters.tcl:
 	branches:  1.11.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* packages/acs-subsite/www/user/portrait/upload-2.tcl:
 	branches:  1.12.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* packages/acs-subsite/lib/user-new.tcl:
 	branches:  1.14.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* packages/acs-tcl/catalog/acs-tcl.de_DE.ISO-8859-1.xml:
 	* readme.txt:
 	branches:  1.15.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* packages/acs-kernel/catalog/acs-kernel.de_DE.ISO-8859-1.xml:
 	branches:  1.17.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* packages/acs-templating/resources/lists/table.adp:
 	* www/blank-master.adp:
 	branches:  1.19.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
@@ -28881,19 +28881,19 @@
 	* packages/acs-templating/resources/lists/courses.adp:
 	* packages/search/catalog/search.de_DE.ISO-8859-1.xml:
 	branches:  1.2.2; Merged acs-core oacs-5-2 (currently 5.2.3) 
-	-> HEAD.  TODO:  1. Bump acs-core package version numbers to 
+	-&gt; HEAD.  TODO:  1. Bump acs-core package version numbers to 
 	5.3.0d1 2. Would be nice to do a test install, wouldn't it? 
 
 	* packages/acs-lang/catalog/acs-lang.de_DE.ISO-8859-1.xml:
 	* packages/acs-subsite/www/pvt/home.adp:
 	branches:  1.21.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* packages/acs-subsite/catalog/acs-subsite.de_DE.ISO-8859-1.xml:
 	branches:  1.26.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
@@ -28902,97 +28902,97 @@
 	* packages/acs-core-docs/www/release-notes-4-6-3.html:
 	* packages/acs-core-docs/www/release-notes-4-6.html:
 	branches:  1.26.6; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* packages/acs-bootstrap-installer/bootstrap.tcl:
 	* packages/acs-subsite/tcl/group-procs.tcl:
 	branches:  1.27.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* etc/keepalive/keepalive-cron.sh:
 	branches:  1.3.2; Merged acs-core oacs-5-2 (currently 5.2.3) 
-	-> HEAD.  TODO:  1. Bump acs-core package version numbers to 
+	-&gt; HEAD.  TODO:  1. Bump acs-core package version numbers to 
 	5.3.0d1 2. Would be nice to do a test install, wouldn't it? 
 
 	* packages/acs-core-docs/www/contributing-code.html:
 	* packages/acs-core-docs/www/cvs-resources.html:
 	* packages/acs-core-docs/www/openacs-cvs-concepts.html:
 	* packages/acs-core-docs/www/using-cvs-with-openacs.html:
 	branches:  1.3.6; Merged acs-core oacs-5-2 (currently 5.2.3) 
-	-> HEAD.  TODO:  1. Bump acs-core package version numbers to 
+	-&gt; HEAD.  TODO:  1. Bump acs-core package version numbers to 
 	5.3.0d1 2. Would be nice to do a test install, wouldn't it? 
 
 	* packages/acs-authentication/catalog/acs-authentication.de_DE.ISO-8859-1.xml:
 	* packages/acs-kernel/sql/postgresql/upgrade/upgrade-5.2.0d1-5.2.0d2.sql:
 	* packages/acs-templating/www/resources/xinha-nightly/htmlarea.js:
 	branches:  1.4.2; Merged acs-core oacs-5-2 (currently 5.2.3) 
-	-> HEAD.  TODO:  1. Bump acs-core package version numbers to 
+	-&gt; HEAD.  TODO:  1. Bump acs-core package version numbers to 
 	5.3.0d1 2. Would be nice to do a test install, wouldn't it? 
 
 	* packages/acs-tcl/lib/complain.adp:
 	branches:  1.4.4; Merged acs-core oacs-5-2 (currently 5.2.3) 
-	-> HEAD.  TODO:  1. Bump acs-core package version numbers to 
+	-&gt; HEAD.  TODO:  1. Bump acs-core package version numbers to 
 	5.3.0d1 2. Would be nice to do a test install, wouldn't it? 
 
 	* packages/acs-subsite/www/o.vuh:
 	branches:  1.4.6; Merged acs-core oacs-5-2 (currently 5.2.3) 
-	-> HEAD.  TODO:  1. Bump acs-core package version numbers to 
+	-&gt; HEAD.  TODO:  1. Bump acs-core package version numbers to 
 	5.3.0d1 2. Would be nice to do a test install, wouldn't it? 
 
 	* packages/acs-tcl/tcl/text-html-procs.tcl:
 	branches:  1.47.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* packages/acs-api-browser/lib/search.tcl:
 	* packages/acs-content-repository/sql/common/mime-type-data.sql:
 	branches:  1.5.2; Merged acs-core oacs-5-2 (currently 5.2.3) 
-	-> HEAD.  TODO:  1. Bump acs-core package version numbers to 
+	-&gt; HEAD.  TODO:  1. Bump acs-core package version numbers to 
 	5.3.0d1 2. Would be nice to do a test install, wouldn't it? 
 
 	* packages/acs-bootstrap-installer/db-init-checks-oracle.tcl:
 	branches:  1.6.2; Merged acs-core oacs-5-2 (currently 5.2.3) 
-	-> HEAD.  TODO:  1. Bump acs-core package version numbers to 
+	-&gt; HEAD.  TODO:  1. Bump acs-core package version numbers to 
 	5.3.0d1 2. Would be nice to do a test install, wouldn't it? 
 
 	* packages/acs-tcl/tcl/00-database-procs.tcl:
 	branches:  1.63.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* packages/acs-subsite/www/admin/object-types/one.tcl:
 	branches:  1.7.12; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* ChangeLog:
 	* packages/acs-subsite/www/permissions/perm-include.tcl:
 	* packages/acs-templating/www/resources/lists.css:
 	branches:  1.7.2; Merged acs-core oacs-5-2 (currently 5.2.3) 
-	-> HEAD.  TODO:  1. Bump acs-core package version numbers to 
+	-&gt; HEAD.  TODO:  1. Bump acs-core package version numbers to 
 	5.3.0d1 2. Would be nice to do a test install, wouldn't it? 
 
 	* packages/acs-authentication/tcl/authentication-procs.tcl:
 	branches:  1.74.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
 	* packages/acs-subsite/tcl/apm-callback-procs.tcl:
 	branches:  1.8.2; Merged acs-core oacs-5-2 (currently 5.2.3) 
-	-> HEAD.  TODO:  1. Bump acs-core package version numbers to 
+	-&gt; HEAD.  TODO:  1. Bump acs-core package version numbers to 
 	5.3.0d1 2. Would be nice to do a test install, wouldn't it? 
 
 	* packages/acs-tcl/tcl/request-processor-procs.tcl:
 	branches:  1.85.2; Merged acs-core oacs-5-2 (currently 
-	5.2.3) -> HEAD.  TODO:  1. Bump acs-core package version 
+	5.2.3) -&gt; HEAD.  TODO:  1. Bump acs-core package version 
 	numbers to 5.3.0d1 2. Would be nice to do a test install, 
 	wouldn't it? 
 
@@ -29226,8 +29226,8 @@
 	* packages/acs-templating/resources/forms/accessible-forms.adp:
 	Adding new FormStype - accessible-forms. Basically its a 
 	copy from the inline formstyle with some modifications: some 
-	<br> to have it vertically (and not horizontally) and some 
-	<label> tags. Provided by Olga Santos (ocsantos@dia.uned.es) 
+	&lt;br&gt; to have it vertically (and not horizontally) and some 
+	&lt;label&gt; tags. Provided by Olga Santos (ocsantos@dia.uned.es) 
 
 	* packages/acs-templating/resources/forms/accessible-forms.adp:
 	branches:  1.1.2; file accessible-forms.adp was initially 
@@ -29249,10 +29249,10 @@
 2006-05-21 donb
 
 	* packages/acs-subsite/lib/login.adp:
-	Removed a dangling </p> that was found by Olga. 
+	Removed a dangling &lt;/p&gt; that was found by Olga. 
 
 	* packages/acs-templating/resources/forms/inline.adp:
-	Removed a dangling </table> (found by Olga) 
+	Removed a dangling &lt;/table&gt; (found by Olga) 
 
 2006-05-20 donb
 
@@ -30471,9 +30471,9 @@
 	* packages/acs-templating/sql/postgresql/template-demo-notes-create.sql:
 	fix typo in the define_function_args call for 
 	template_demo_notes__new:  if you want to use 
-	package_instantiate_object using some type <t>, then your 
-	call to define_function_args for <t>__new needs to have the 
-	object_type parameter defaulting to <t> 
+	package_instantiate_object using some type &lt;t&gt;, then your 
+	call to define_function_args for &lt;t&gt;__new needs to have the 
+	object_type parameter defaulting to &lt;t&gt; 
 
 	* packages/acs-templating/www/doc/demo/list8/delete.tcl:
 	revert file to be same as vers 1.3 
@@ -30971,7 +30971,7 @@
 	* packages/acs-content-repository/sql/oracle/upgrade/upgrade-5.2.1d1-5.2.1d2.sql:
 	* packages/acs-kernel/sql/oracle/upgrade/upgrade-5.2.0d1-5.2.0d2.sql:
 	* packages/acs-kernel/sql/oracle/upgrade/upgrade-5.2.1d1-5.2.1d2.sql:
-	Fixed 5.1->5.2 upgrade, all content repository tests now 
+	Fixed 5.1-&gt;5.2 upgrade, all content repository tests now 
 	pass. 
 
 2006-01-16 daveb
@@ -36890,7 +36890,7 @@
 	query for real roles; see bug 2543 
 
 	* packages/acs-subsite/www/admin/rel-types/roles/new.tcl:
-	replaces plsql with tcl api to create role -> 
+	replaces plsql with tcl api to create role -&gt; 
 	internationalizes role names 
 
 2005-07-22 roelc
@@ -37224,7 +37224,7 @@
 	acs-kernel, which meant that the query that determines 
 	upgrade order didn't necessarily cause acs-kernel to be 
 	upgraded first.  Oops.  With this fix, we can successfully 
-	upgrade openacs5.1 -> openacs5.2 on both Oracle and PG. 
+	upgrade openacs5.1 -&gt; openacs5.2 on both Oracle and PG. 
 
 2005-06-25 skaufman
 
@@ -37237,7 +37237,7 @@
 2005-06-25 donb
 
 	* packages/acs-subsite/tcl/apm-callback-procs.tcl:
-	Fixed upgrade of 5.1.4->5.2 for PG 
+	Fixed upgrade of 5.1.4-&gt;5.2 for PG 
 
 2005-06-23 hamiltonc
 
@@ -37706,7 +37706,7 @@
 	site_node::get_url_from_object_id calls 
 
 	* packages/acs-kernel/sql/oracle/upgrade/upgrade-5.2.0d1-5.2.0d2.sql:
-	Fix typo, were -> where 
+	Fix typo, were -&gt; where 
 
 	* packages/acs-kernel/sql/oracle/upgrade/upgrade-5.2.0d9-5.2.0d10.sql:
 	Fix typo, wrong proc qualifier 
@@ -38471,7 +38471,7 @@
 	* packages/acs-admin/www/apm/packages-install-2.tcl:
 	* packages/acs-content-repository/sql/postgresql/upgrade/upgrade-5.1.4d2-5.1.4d3.sql:
 	* packages/acs-tcl/tcl/navigation-callback-procs.tcl:
-	fix pacakge -> package typo 
+	fix pacakge -&gt; package typo 
 
 2005-04-20 daveb
 
@@ -39136,7 +39136,7 @@
 2005-03-16 jeffd
 
 	* packages/acs-templating/tcl/tag-procs.tcl:
-	<if XXYYZZ in YY> would return true.  this fixes it so the 
+	&lt;if XXYYZZ in YY&gt; would return true.  this fixes it so the 
 	literal string has to be in there 
 
 2005-03-15 daveb
@@ -41803,7 +41803,7 @@
 2005-01-19 maltes
 
 	* packages/acs-subsite/lib/login.adp:
-	Added <div id=register-login> so we could control the look 
+	Added &lt;div id=register-login&gt; so we could control the look 
 	of the login box via CSS (at least a little) 
 
 2005-01-19 lars
@@ -42534,7 +42534,7 @@
 	* packages/acs-templating/resources/forms/standard.adp:
 	* packages/acs-templating/resources/forms/tiny-plain.adp:
 	* packages/acs-templating/resources/forms/wizard.adp:
-	bug in template operator in (partial string compare) -> use 
+	bug in template operator in (partial string compare) -&gt; use 
 	seperate equality test in template 
 
 2005-01-12 jader
@@ -44409,7 +44409,7 @@
 2004-10-28 enriquec
 
 	* packages/acs-authentication/tcl/authentication-procs.tcl:
-	fixing typo (ref.bug#2088): datta_error -> data_error 
+	fixing typo (ref.bug#2088): datta_error -&gt; data_error 
 
 2004-10-27 jader
 
@@ -45317,7 +45317,7 @@
 2004-09-06 hramado
 
 	* packages/acs-authentication/tcl/apm-callback-procs.tcl:
-	upgrade logic 5.1.2 -> 5.1.2d1 
+	upgrade logic 5.1.2 -&gt; 5.1.2d1 
 
 2004-09-03 tracya
 
@@ -45439,7 +45439,7 @@
 2004-08-18 andrewg
 
 	* www/blank-master.tcl:
-	branches:  1.12.2.3.2; Markup in <title> tags doesn't render 
+	branches:  1.12.2.3.2; Markup in &lt;title&gt; tags doesn't render 
 	well 
 
 2004-08-17 maltes
@@ -46503,7 +46503,7 @@
 2004-07-02 gabrielb
 
 	* www/blank-master.adp:
-	branches:  1.11.2.1.2; Moved the textarea out of <head> and 
+	branches:  1.11.2.1.2; Moved the textarea out of &lt;head&gt; and 
 	added required fields so it validates properly on 
 	validator.w3.org. 
 
@@ -48361,7 +48361,7 @@
 2004-05-20 rocaelh
 
 	* packages/acs-mail-lite/tcl/acs-mail-lite-procs-oracle.xql:
-	bad writte <fullquery> fixed 
+	bad writte &lt;fullquery&gt; fixed 
 
 	* packages/acs-mail-lite/tcl/acs-mail-lite-procs-oracle.xql:
 	* packages/acs-mail-lite/tcl/acs-mail-lite-procs-postgresql.xql:
@@ -49677,7 +49677,7 @@
 	* packages/acs-subsite/sql/postgresql/attribute.sql:
 	* packages/acs-subsite/www/admin/site-map/application-new.adp:
 	* packages/acs-subsite/www/members/member-invite.adp:
-	Changed standard-lars -> standard form template style 
+	Changed standard-lars -&gt; standard form template style 
 
 2004-04-23 joela
 
@@ -50269,7 +50269,7 @@
 
 	* packages/acs-core-docs/www/xml/developers-guide/tutorial-advanced.xml:
 	Restoring my addition on profiling your code that was also 
-	somehow left out in the oacs-5-0 -> HEAD transition. 
+	somehow left out in the oacs-5-0 -&gt; HEAD transition. 
 
 2004-04-07 daveb
 
@@ -51004,7 +51004,7 @@
 	* packages/acs-lang/tcl/lang-util-procs.tcl:
 	* packages/acs-lang/tcl/test/acs-lang-test-procs.tcl:
 	stripping off trailing space in the text of temporary tags 
-	on syntax <# key text #>. Checked new functionality with 
+	on syntax &lt;# key text #&gt;. Checked new functionality with 
 	test case. 
 
 2004-03-18 joela
@@ -51115,8 +51115,8 @@
 	* packages/acs-admin/www/users/user-batch-add-2.adp:
 	* packages/acs-admin/www/users/user-batch-add-2.tcl:
 	* packages/acs-admin/www/users/user-batch-add.adp:
-	Fixed variable parsing, changed syntax to <first_names>, 
-	<last_name>, added a missing noquote. 
+	Fixed variable parsing, changed syntax to &lt;first_names&gt;, 
+	&lt;last_name&gt;, added a missing noquote. 
 
 	* packages/acs-subsite/lib/user-info.adp:
 	* packages/acs-subsite/lib/user-info.tcl:
@@ -52085,13 +52085,13 @@
 	"ad-return-complaint" (to match the name of the Tcl proc 
 	that calls it) ... and created a new "complain" that does 
 	the multirow thing.  "ad_return_complaint" is begging for 
-	retirement as it assumes you have an "<li>" in each error 
+	retirement as it assumes you have an "&lt;li&gt;" in each error 
 	list element if there's more than one of them and also 
 	forces you to pass the number of error messages.  That's why 
 	I created a new template rather than rewrite 
 	ad_return_complaint to stuff the error list into a multirow 
 	(my "complain" template, used by "ad_page_contract", does 
-	the <li> tags itself - something a site designer can change, 
+	the &lt;li&gt; tags itself - something a site designer can change, 
 	the whole point of templating this). 
 
 	* packages/acs-tcl/lib/complain.adp:
@@ -52102,13 +52102,13 @@
 	"ad-return-complaint" (to match the name of the Tcl proc 
 	that calls it) ... and created a new "complain" that does 
 	the multirow thing.  "ad_return_complaint" is begging for 
-	retirement as it assumes you have an "<li>" in each error 
+	retirement as it assumes you have an "&lt;li&gt;" in each error 
 	list element if there's more than one of them and also 
 	forces you to pass the number of error messages.  That's why 
 	I created a new template rather than rewrite 
 	ad_return_complaint to stuff the error list into a multirow 
 	(my "complain" template, used by "ad_page_contract", does 
-	the <li> tags itself - something a site designer can change, 
+	the &lt;li&gt; tags itself - something a site designer can change, 
 	the whole point of templating this). 
 
 2004-03-06 lars
@@ -53671,7 +53671,7 @@
 2004-02-23 jader
 
 	* packages/acs-core-docs/www/xml/install-guide/upgrade.xml:
-	Added a little more detail to Postgres 7.2->7.3 upgrade 
+	Added a little more detail to Postgres 7.2-&gt;7.3 upgrade 
 	instructions. 
 
 2004-02-22 joela
@@ -54165,14 +54165,14 @@
 	PG 7.3 doesn't support 'current_timestamp' as a literal any 
 	more (it still is defined as a variable, of course).  Also 
 	define_function_args assumes NULL as the default value if 
-	none is specified, 'null' <> NULL ... 
+	none is specified, 'null' &lt;&gt; NULL ... 
 
 	* packages/acs-content-repository/sql/postgresql/content-type.sql:
 	branches:  1.32.2; PG 7.3 doesn't support 
 	'current_timestamp' as a literal any more (it still is 
 	defined as a variable, of course).  Also 
 	define_function_args assumes NULL as the default value if 
-	none is specified, 'null' <> NULL ... 
+	none is specified, 'null' &lt;&gt; NULL ... 
 
 2004-02-16 peterm
 
@@ -55452,7 +55452,7 @@
 2004-02-04 maltes
 
 	* www/blank-master.adp:
-	Reverted to previous version. Trying the <form> tag around 
+	Reverted to previous version. Trying the &lt;form&gt; tag around 
 	did not help. 
 
 2004-02-04 lars
@@ -56420,7 +56420,7 @@
 	Removed confusing login/refresh login links 
 
 	* packages/acs-subsite/www/admin/applications/application-add.adp:
-	a.action -> ul.action-links 
+	a.action -&gt; ul.action-links 
 
 	* packages/acs-subsite/www/shared/community-member.adp:
 	branches:  1.12.2; ul.action-links 
@@ -56453,7 +56453,7 @@
 
 	* packages/acs-subsite/www/resources/site-master.css:
 	Added ul style action-links, which lets you do an 
-	<ul>..<li>.. of action links, instead of the old a.action 
+	&lt;ul&gt;..&lt;li&gt;.. of action links, instead of the old a.action 
 	class, which would make the whitespace clickable, too 
 
 	* packages/acs-tcl/tcl/acs-permissions-procs.tcl:
@@ -57467,7 +57467,7 @@
 	del/delete typo 
 
 	* packages/notifications/sql/oracle/upgrade/upgrade-4.6.4-5.0d1.sql:
-	delete--> del upgrade 
+	delete--&gt; del upgrade 
 
 2003-12-30 lars
 
@@ -57576,7 +57576,7 @@
 	the replacing:  #!/bin/bash  for file in `grep -lsr "\[clock 
 	clicks\]" /web/openacs-head/packages/ `; do   echo 
 	"repairing $file"   sed "s/\[clock clicks\]/\[clock clicks 
-	-milliseconds\]/g" $file > fout   mv fout $file done  And 
+	-milliseconds\]/g" $file &gt; fout   mv fout $file done  And 
 	then grepped for  grep -r "expr.*clock clicks" 
 	/web/openacs-head/packages/  to manually remove the 
 	divisions by 1000. 
@@ -59763,7 +59763,7 @@
 	*down* to 5.0a3 from 5.0.0a5 
 
 	* packages/acs-authentication/acs-authentication.info:
-	Typo: Syncrhonization -> Synchronization 
+	Typo: Syncrhonization -&gt; Synchronization 
 
 2003-11-26 jeffd
 
@@ -61635,7 +61635,7 @@
 
 	* packages/acs-tcl/tcl/text-html-procs.tcl:
 	add a -- to ad_html_text_convert, make util_close_html_tags 
-	not eat < not part of a tag 
+	not eat &lt; not part of a tag 
 
 	* packages/acs-api-browser/tcl/acs-api-documentation-procs.tcl:
 	branches:  1.13.4; adding -- to all ad_html_to_text calls 
@@ -62189,7 +62189,7 @@
 	Fixed creation_date bug 
 
 	* packages/acs-content-repository/tcl/publish-procs.tcl:
-	Implemnted changes to make the <relation ...> tag work. 
+	Implemnted changes to make the &lt;relation ...&gt; tag work. 
 
 	* packages/acs-admin/www/users/index.tcl:
 	Removed old code that had 'temporarily been taken out for 
@@ -62620,8 +62620,8 @@
 	* packages/acs-authentication/tcl/sync-procs.tcl:
 	- Log nicer errors when trying to update a user that doesn't 
 	exist, or when adding a user that already exists - I again 
-	read the IMS spec wrong ... the <n> tag goes *inside* the 
-	<name> tag. Grrr.. 
+	read the IMS spec wrong ... the &lt;n&gt; tag goes *inside* the 
+	&lt;name&gt; tag. Grrr.. 
 
 	* packages/acs-admin/www/auth/batch-job.tcl:
 	Add link to affected user in actions list, if exists 
@@ -63091,9 +63091,9 @@
 	exist 
 
 	* packages/acs-authentication/tcl/sync-procs.tcl:
-	Fixed IMS sync bug: we were looking at <name><given> and 
-	<name><family>, but they're really <n><given> and 
-	<n><family> 
+	Fixed IMS sync bug: we were looking at &lt;name&gt;&lt;given&gt; and 
+	&lt;name&gt;&lt;family&gt;, but they're really &lt;n&gt;&lt;given&gt; and 
+	&lt;n&gt;&lt;family&gt; 
 
 	* packages/acs-admin/www/auth/authority-set-sort-order.tcl:
 	Fixed problem with reordering authorities 
@@ -64894,7 +64894,7 @@
 	This fixes a problem with deleting an unmounted package 
 	instance. If you added and mounted, say, a subsite instance, 
 	unmounted and then attempted to delete it through 
-	sitemap->Manage unmounted applications, you would get an 
+	sitemap-&gt;Manage unmounted applications, you would get an 
 	error. It seems site_node::get_node_id_from_object_id 
 	doesn't even fail for an unmounted package, returning the 
 	empty string in this case, and the catch test doesn't trip. 
@@ -65581,7 +65581,7 @@
 	Don't display package type in list 
 
 	* packages/acs-subsite/www/index.adp:
-	Fixed 'group' -> 'community' labeling 
+	Fixed 'group' -&gt; 'community' labeling 
 
 	* packages/acs-authentication/tcl/authentication-procs.tcl:
 	* packages/acs-authentication/tcl/driver-procs.tcl:
@@ -66569,7 +66569,7 @@
 	down with [exit] instead of [ns_shutdown] 
 
 	* packages/acs-subsite/catalog/acs-subsite.en_US.ISO-8859-1.xml:
-	Forgot to quote <p>'s in message 
+	Forgot to quote &lt;p&gt;'s in message 
 
 	* packages/acs-admin/www/apm/version-callback-invoke.tcl:
 	Only offer invoke for callbacks that don't take any 
@@ -67673,7 +67673,7 @@
 
 	* packages/acs-tcl/tcl/text-html-procs.tcl:
 	ad_text_to_html: return empty if the text is empty. Make the 
-	first <p> tag not have margin-top 
+	first &lt;p&gt; tag not have margin-top 
 
 	* packages/acs-admin/www/apm/index.adp:
 	branches:  1.1.22; Templated pages 
@@ -68770,7 +68770,7 @@
 
 	* packages/acs-kernel/sql/oracle/acs-install.sql:
 	* packages/acs-kernel/sql/postgresql/acs-install.sql:
-	I messed up with that Main Site -> Home change. Turns out 
+	I messed up with that Main Site -&gt; Home change. Turns out 
 	there's code all over the place which depends on that name 
 
 	* packages/acs-tcl/tcl/community-core-procs.tcl:
@@ -68929,7 +68929,7 @@
 	Allow service contracts to be invoked with impl_id 
 
 	* packages/acs-templating/tcl/tag-init.tcl:
-	Changed the <trn> tag to use new acs-lang API 
+	Changed the &lt;trn&gt; tag to use new acs-lang API 
 
 	* packages/acs-authentication/tcl/authentication-procs.tcl:
 	* packages/acs-authentication/tcl/driver-procs-oracle.xql:
@@ -69015,8 +69015,8 @@
 
 	* packages/acs-tcl/tcl/text-html-procs.tcl:
 	Fixed two bugs in ad_html_to_text: - Tags that start with 
-	whitespace were still considered tags, and thus < p> would 
-	get treated equivalently to <p>. - The regexp to find 
+	whitespace were still considered tags, and thus &lt; p&gt; would 
+	get treated equivalently to &lt;p&gt;. - The regexp to find 
 	malformed tags wasn't bound to start and end of the inside 
 	of the tag, thus tags that had just a subset of 
 	welformedness would get interpreted. 
@@ -69820,7 +69820,7 @@
 2003-08-23 lars
 
 	* packages/acs-templating/tcl/tag-procs.tcl:
-	Added comment about a @foo;noquote@ breaking <if> tags 
+	Added comment about a @foo;noquote@ breaking &lt;if&gt; tags 
 
 	* packages/acs-templating/resources/forms/standard-lars.adp:
 	Noquote the label, because bug-tracker uses this to put a 
@@ -70704,11 +70704,11 @@
 
 	* packages/acs-templating/www/doc/tagref/index.html:
 	* packages/acs-templating/www/doc/tagref/switch.html:
-	Added documentation for the <switch> tag. 
+	Added documentation for the &lt;switch&gt; tag. 
 
 	* packages/acs-templating/www/doc/tagref/index.html:
 	* packages/acs-templating/www/doc/tagref/switch.html:
-	Oh darn it.  Looks like the documentation for the <switch> 
+	Oh darn it.  Looks like the documentation for the &lt;switch&gt; 
 	tag was already in HEAD, but I didn't notice it. So the time 
 	spent in writing the darn thing was in vain.  Backporting 
 	the switch docs from HEAD to oacs-4-6 (includes some other 
@@ -71618,7 +71618,7 @@
 	* packages/acs-tcl/tcl/00-database-procs.tcl:
 	1. Added -unclobber switch to db_multirow. 2. Added 
 	peek-ahead to db_multirow, which enables you to do something 
-	similar to the templating system's <group> tag when building 
+	similar to the templating system's &lt;group&gt; tag when building 
 	up a multirow. See documentation to    
 	db_multirow_group_last_row_p for details. 3. Untabified the 
 	whole buffer, which, unfortunately, makes the concrete 
@@ -72572,7 +72572,7 @@
 	for required elements, and has cleaner [i] help_text look 
 
 	* packages/acs-templating/tcl/tag-procs.tcl:
-	Make <if foo nil> work without foo being a static string 
+	Make &lt;if foo nil&gt; work without foo being a static string 
 	instead of a variable. 
 
 	* packages/acs-subsite/www/shared/images/info.gif:
@@ -73370,7 +73370,7 @@
 	through to the HTML form elements 
 
 	* packages/acs-templating/tcl/tag-init.tcl:
-	Fixed <group> tag so it allows you to pass in a variable 
+	Fixed &lt;group&gt; tag so it allows you to pass in a variable 
 	instead of a fixed sting 
 
 	* packages/acs-tcl/tcl/text-html-procs.tcl:
@@ -73695,9 +73695,9 @@
 	* packages/acs-core-docs/www/xml/install-guide/red-hat.xml:
 	* packages/acs-core-docs/www/xml/install-guide/software.xml:
 	* packages/acs-core-docs/www/xml/openacs.xsl:
-	Fixed:  > missing link to 
+	Fixed:  &gt; missing link to 
 	http://openacs.org/doc/openacs-4-6-2/files/analog-dev.cfg.txt
-	 > 
+	 &gt; 
 	http://openacs.org/doc/openacs-4-6-2/individual-programs.html
 	  Removed the link altogether - removed all links to files 
 	actually in the tarball  
@@ -76364,7 +76364,7 @@
 	When searching for an enclosing tag, start with the parent 
 	tag, not the current tag. Otherwise it won't work if you 
 	have to identical tags inside each other, for example a 
-	<group> tag inside a <group> tag. 
+	&lt;group&gt; tag inside a &lt;group&gt; tag. 
 
 2003-02-28 joela
 
@@ -77303,7 +77303,7 @@
 	Fixed typo. 
 
 	* packages/acs-core-docs/www/index.adp:
-	Replaced listings in <pre> tags with <ul><li> ... stuff 
+	Replaced listings in &lt;pre&gt; tags with &lt;ul&gt;&lt;li&gt; ... stuff 
 	which is better digestable by browsers and fixes bug #223, 
 	and removed empty link to old release notes 
 
@@ -77873,7 +77873,7 @@
 	* packages/acs-tcl/tcl/text-html-procs.tcl:
 	Fixed bug: util_close_html_tags would actually insert the 
 	end tag even though it had discarded the open tag, e.g. if 
-	you said <form>, you'd get </FORM>! 
+	you said &lt;form&gt;, you'd get &lt;/FORM&gt;! 
 
 	* packages/acs-templating/tcl/richtext-procs.tcl:
 	Fixed typo with $ instead of # in comment Made richtext 
@@ -77882,7 +77882,7 @@
 	* packages/acs-tcl/tcl/text-html-procs.tcl:
 	Merged bug fix from HEAD: util_close_html_tags would 
 	actually insert the end tag even though it had discarded the 
-	open tag, e.g. if you said <form>, you'd get </FORM>! 
+	open tag, e.g. if you said &lt;form&gt;, you'd get &lt;/FORM&gt;! 
 
 	* packages/acs-tcl/tcl/text-html-procs.tcl:
 	Removed extra -- in call to ad_enhanced_text_to_plain_text. 
@@ -78584,8 +78584,8 @@
 2003-01-13 danw
 
 	* packages/acs-templating/tcl/tag-init.tcl:
-	modified case tag to allow <case in foo bar baz> and <case 
-	value=foo> forms. 
+	modified case tag to allow &lt;case in foo bar baz&gt; and &lt;case 
+	value=foo&gt; forms. 
 
 2003-01-12 lars
 
@@ -78773,7 +78773,7 @@
 	multiple buttons on the form. Used for the 'Edit' button, 
 	but can be used for other buttons as well. - Fixed all the 
 	standard templates to include the new buttons and to use the 
-	<label> tag. - Added an example to the documentation showing 
+	&lt;label&gt; tag. - Added an example to the documentation showing 
 	how this new display/edit mode looks. 
 
 	* packages/acs-templating/www/doc/demo/display-edit.adp:
@@ -78785,7 +78785,7 @@
 	support multiple buttons on the form. Used for the 'Edit' 
 	button, but can be used for other buttons as well. - Fixed 
 	all the standard templates to include the new buttons and to 
-	use the <label> tag. - Added an example to the documentation 
+	use the &lt;label&gt; tag. - Added an example to the documentation 
 	showing how this new display/edit mode looks. 
 
 2003-01-01 vinodk
@@ -79801,7 +79801,7 @@
 	moving send-email to acs-subsite 
 
 	* packages/acs-templating/resources/forms/standard-lars.adp:
-	small typo spurious > in radio/checkbox widget with no label 
+	small typo spurious &gt; in radio/checkbox widget with no label 
 
 	* packages/acs-lang/tcl/localization-procs.xql:
 	unique is oracle specific bug 43/patch 9 Tilmann Singer 
@@ -80219,7 +80219,7 @@
 
 	* packages/acs-templating/tcl/paginator-procs.tcl:
 	fixed the paginator get_pages proc which would break when 
-	pages < groupsize, added query name to error for missing 
+	pages &lt; groupsize, added query name to error for missing 
 	CURRENT_PAGE_SET message 
 
 2002-10-30 ben
@@ -80301,7 +80301,7 @@
 	already in the adp 
 
 	* packages/acs-lang/tcl/lang-util-procs.tcl:
-	making the adp texts -> tags conversion script (Jeff's 
+	making the adp texts -&gt; tags conversion script (Jeff's 
 	script) less restrictive now that it's used interactively 
 
 	* packages/acs-admin/www/apm/version-i18n-index.adp~:
@@ -80624,7 +80624,7 @@
 
 	* packages/acs-lang/tcl/lang-util-procs.tcl:
 	Adding a key short hand for the temporary message lookup tag 
-	- the underscore, syntax: <#_ text#> 
+	- the underscore, syntax: &lt;#_ text#&gt; 
 
 	* packages/acs-admin/www/apm/version-i18n-process-2.tcl:
 	* packages/acs-admin/www/apm/version-i18n-process.adp:
@@ -80765,7 +80765,7 @@
 2002-10-07 rmello
 
 	* packages/acs-kernel/sql/postgresql/upgrade/upgrade-4.5-4.5.1.sql:
-	CREATE FUNCTION -> CREATE OR REPLACE FUNCTION 
+	CREATE FUNCTION -&gt; CREATE OR REPLACE FUNCTION 
 
 	* packages/acs-admin/www/users/modify-admin-privileges-oracle.xql:
 	* packages/acs-admin/www/users/modify-admin-privileges-postgresql.xql:
@@ -80897,7 +80897,7 @@
 	* packages/acs-admin/www/apm/version-extract-message-keys.tcl:
 	* packages/acs-admin/www/apm/version-view.tcl:
 	Peter: Adding a link from the package version page for 
-	replacing occurencies of <#message_key message#> in adp 
+	replacing occurencies of &lt;#message_key message#&gt; in adp 
 	templates with #message_key# and inserting the messages into 
 	the message catalog 
 
@@ -81048,7 +81048,7 @@
 2002-10-01 lars
 
 	* packages/acs-core-docs/www/xml/engineering-standards/docbook-primer.xml:
-	Fixed listitem examples so they actually say </listitem> at 
+	Fixed listitem examples so they actually say &lt;/listitem&gt; at 
 	the closing end. 
 
 	* packages/acs-core-docs/www/xml/developers-guide/i18n.xml:
@@ -81506,7 +81506,7 @@
 	* packages/acs-subsite/www/permissions/revoke.tcl:
 	* packages/acs-subsite/www/register/user-login.tcl:
 	* packages/acs-subsite/www/shared/send-email.tcl:
-	branches:  1.3.2; ns_return->ad_return, ad_script_abort, 
+	branches:  1.3.2; ns_return-&gt;ad_return, ad_script_abort, 
 	redirect to absract urls 
 
 	* packages/acs-core-docs/www/sql/display-sql.tcl:
@@ -81519,19 +81519,19 @@
 
 	* packages/acs-api-browser/www/tcl-proc-view.tcl:
 	* packages/acs-bootstrap-installer/installer/create-administrator-2.tcl:
-	branches:  1.4.2; ns_return->ad_return, ad_script_abort, 
+	branches:  1.4.2; ns_return-&gt;ad_return, ad_script_abort, 
 	redirect to absract urls 
 
 	* packages/acs-admin/www/apm/file-watch.tcl:
 	* packages/acs-subsite/www/admin/relations/add.tcl:
 	branches:  1.5.2; more abstract URLs 
 
 	* packages/acs-admin/www/apm/packages-install-2.tcl:
-	branches:  1.5.2; ns_return->ad_return, ad_script_abort, 
+	branches:  1.5.2; ns_return-&gt;ad_return, ad_script_abort, 
 	redirect to absract urls 
 
 	* packages/acs-bootstrap-installer/installer.tcl:
-	branches:  1.6.2; ns_return->ad_return, ad_script_abort, 
+	branches:  1.6.2; ns_return-&gt;ad_return, ad_script_abort, 
 	redirect to absract urls 
 
 	* packages/acs-admin/www/apm/version-files.tcl:
@@ -81545,7 +81545,7 @@
 	branches:  1.9.8; more abstract URLs 
 
 	* packages/search/www/search.tcl:
-	branches:  1.9.8; ns_return->ad_return, ad_script_abort, 
+	branches:  1.9.8; ns_return-&gt;ad_return, ad_script_abort, 
 	redirect to absract urls 
 
 	* packages/acs-admin/www/test/signed-cookies-test.tcl:
@@ -81583,7 +81583,7 @@
 	* packages/acs-tcl/tcl/request-processor-procs.tcl:
 	* packages/acs-tcl/tcl/table-display-procs.tcl:
 	* packages/acs-tcl/tcl/utilities-procs.tcl:
-	ns_return->ad_return, ad_script_abort, redirect to absract 
+	ns_return-&gt;ad_return, ad_script_abort, redirect to absract 
 	urls 
 
 2002-09-17 jeffd
@@ -81749,7 +81749,7 @@
 2002-09-14 lars
 
 	* packages/acs-templating/tcl/widget-procs.tcl:
-	Added <label for=...>...</label> tags to radio and checkbox 
+	Added &lt;label for=...&gt;...&lt;/label&gt; tags to radio and checkbox 
 	widgets ... improves the UI slightly. 
 
 	* packages/acs-templating/tcl/element-procs.tcl:
@@ -81777,15 +81777,15 @@
 	to use column_array, which makes them much simpler. 
 
 	* packages/acs-templating/resources/forms/standard.adp:
-	branches:  1.2.2; Added <label for=...>...</label> tags to 
+	branches:  1.2.2; Added &lt;label for=...&gt;...&lt;/label&gt; tags to 
 	radio and checkbox widgets ... improves the UI slightly. 
 
 	* packages/acs-tcl/tcl/apm-procs.tcl:
 	branches:  1.23.2; Added apm_package_url_from_id procedure 
 	and changed apm_package_url_from_key to use that 
 
 	* packages/acs-templating/resources/forms/standard-lars.adp:
-	branches:  1.5.2; Added <label for=...>...</label> tags to 
+	branches:  1.5.2; Added &lt;label for=...&gt;...&lt;/label&gt; tags to 
 	radio and checkbox widgets ... improves the UI slightly. 
 
 	* packages/acs-tcl/tcl/apm-procs-oracle.xql:
@@ -82108,12 +82108,12 @@
 	... 
 
 	* www/index.adp:
-	branches:  1.5.2; - Moved the <form> tags to be outside the 
-	<tr> again ... it may not be XHTML, I don't know, but the 
+	branches:  1.5.2; - Moved the &lt;form&gt; tags to be outside the 
+	&lt;tr&gt; again ... it may not be XHTML, I don't know, but the 
 	form tag introduces annoying vertical whitespace at the 
-	bottom on the login box. - Added back the <p> tag that 
+	bottom on the login box. - Added back the &lt;p&gt; tag that 
 	separates the log in box from the quick links for 
-	aesthetics. I also added a </p>, to make it XHTML. 
+	aesthetics. I also added a &lt;/p&gt;, to make it XHTML. 
 
 2002-09-06 jeffd
 
@@ -82731,7 +82731,7 @@
 	are generated through a proc. 
 
 	* packages/acs-api-browser/tcl/acs-api-documentation-procs.tcl:
-	Fixed more html problems, mainly deleted <p> in illegal 
+	Fixed more html problems, mainly deleted &lt;p&gt; in illegal 
 	places. 
 
 	* packages/acs-api-browser/www/display-sql.tcl:
@@ -82773,7 +82773,7 @@
 
 	* packages/acs-api-browser/www/index.adp:
 	Reformatted HTML so it now validates. Added if's to content 
-	to get rid of superflous <li> 
+	to get rid of superflous &lt;li&gt; 
 
 	* packages/acs-tcl/tcl/table-display-procs.tcl:
 	Updated the 100% to "100%" This file still needs a lot of 
@@ -82827,7 +82827,7 @@
 	acs-kernel/sql/postgresql/apm-create.sql Edited the 
 	acs-kernel upgrade script that JonG initially created (PG) 
 	Created an oracle upgrade script Added upgrade scripts that 
-	i had written for 4.5b->4.5 back in (didn't get merged) 
+	i had written for 4.5b-&gt;4.5 back in (didn't get merged) 
 	Update the acs-kernel .info file to 4.5.1 
 
 	* packages/acs-kernel/sql/oracle/upgrade/upgrade-4.5-4.5.1.sql:
@@ -82838,7 +82838,7 @@
 	acs-kernel/sql/postgresql/apm-create.sql Edited the 
 	acs-kernel upgrade script that JonG initially created (PG) 
 	Created an oracle upgrade script Added upgrade scripts that 
-	i had written for 4.5b->4.5 back in (didn't get merged) 
+	i had written for 4.5b-&gt;4.5 back in (didn't get merged) 
 	Update the acs-kernel .info file to 4.5.1 
 
 	* packages/acs-kernel/sql/postgresql/upgrade/upgrade-4.5-4.5.1.sql:
@@ -82849,7 +82849,7 @@
 	acs-kernel/sql/postgresql/apm-create.sql Edited the 
 	acs-kernel upgrade script that JonG initially created (PG) 
 	Created an oracle upgrade script Added upgrade scripts that 
-	i had written for 4.5b->4.5 back in (didn't get merged) 
+	i had written for 4.5b-&gt;4.5 back in (didn't get merged) 
 	Update the acs-kernel .info file to 4.5.1 
 
 	* packages/acs-service-contract/acs-service-contract.info:
@@ -82860,7 +82860,7 @@
 	acs-kernel/sql/postgresql/apm-create.sql Edited the 
 	acs-kernel upgrade script that JonG initially created (PG) 
 	Created an oracle upgrade script Added upgrade scripts that 
-	i had written for 4.5b->4.5 back in (didn't get merged) 
+	i had written for 4.5b-&gt;4.5 back in (didn't get merged) 
 	Update the acs-kernel .info file to 4.5.1 
 
 	* packages/acs-subsite/tcl/package-procs-postgresql.xql:
@@ -83212,21 +83212,21 @@
 	* packages/notifications/sql/postgresql/notification-type-sc-create.sql:
 	* packages/notifications/sql/postgresql/notifications-package-drop.sql:
 	* packages/notifications/sql/postgresql/notifications-replies-create.sql:
-	branches:  1.2.2; copyright OpenForce -> MIT 
+	branches:  1.2.2; copyright OpenForce -&gt; MIT 
 
 	* packages/notifications/sql/oracle/email-sc-impl-create.sql:
 	* packages/notifications/sql/postgresql/delivery-method-sc-create.sql:
-	branches:  1.3.2; copyright OpenForce -> MIT 
+	branches:  1.3.2; copyright OpenForce -&gt; MIT 
 
 	* packages/notifications/sql/oracle/notifications-init.sql:
 	* packages/notifications/sql/postgresql/notifications-init.sql:
-	branches:  1.4.2; copyright OpenForce -> MIT 
+	branches:  1.4.2; copyright OpenForce -&gt; MIT 
 
 	* packages/notifications/sql/postgresql/notifications-create.sql:
-	branches:  1.5.2; copyright OpenForce -> MIT 
+	branches:  1.5.2; copyright OpenForce -&gt; MIT 
 
 	* packages/notifications/sql/oracle/notifications-create.sql:
-	branches:  1.7.2; copyright OpenForce -> MIT 
+	branches:  1.7.2; copyright OpenForce -&gt; MIT 
 
 	* packages/notifications/sql/oracle/notifications-core-create.sql:
 	* packages/notifications/sql/oracle/notifications-core-drop.sql:
@@ -83238,7 +83238,7 @@
 	* packages/notifications/sql/postgresql/notifications-drop.sql:
 	* packages/notifications/sql/postgresql/notifications-package-create.sql:
 	* packages/notifications/sql/postgresql/notifications-replies-package-create.sql:
-	copyright OpenForce -> MIT 
+	copyright OpenForce -&gt; MIT 
 
 2002-08-09 chak
 
@@ -83269,7 +83269,7 @@
 	* Added db_multirow to developer's guide (I classify it as 
 	"Basic API") * Added documentation for db_multirow's -local 
 	switch to both places   (developer's guide and kernel 
-	documentation -> Should we merge these??) 
+	documentation -&gt; Should we merge these??) 
 
 	* packages/acs-tcl/tcl/00-database-procs.tcl:
 	* Added documentation for db_multirow -local switch 
@@ -83302,7 +83302,7 @@
 2002-08-03 vinodk
 
 	* packages/search/sql/postgresql/upgrade/upgrade-4.5-4.5.1.sql:
-	branches:  1.1.2; renamed jon's upgrade file 4.5->4.5.1 
+	branches:  1.1.2; renamed jon's upgrade file 4.5-&gt;4.5.1 
 
 	* packages/acs-messaging/acs-messaging.info:
 	branches:  1.6.2; updated version to 4.5 
@@ -83314,7 +83314,7 @@
 	fixed typo 
 
 	* packages/search/sql/postgresql/upgrade/upgrade-4.2-4.5.1.sql:
-	renamed jon's upgrade file 4.5->4.5.1 
+	renamed jon's upgrade file 4.5-&gt;4.5.1 
 
 	* packages/acs-admin/acs-admin.info:
 	* packages/acs-api-browser/acs-api-browser.info:
@@ -83491,7 +83491,7 @@
 
 	* packages/acs-tcl/tcl/text-html-procs.tcl:
 	added code to ad_text_to_html to Convert _single_ CRLF's to 
-	<br>'s to preserve line breaks 
+	&lt;br&gt;'s to preserve line breaks 
 
 2002-07-25 lars
 
@@ -83782,7 +83782,7 @@
 
 	* packages/acs-templating/resources/forms/grid.adp:
 	* packages/acs-templating/resources/forms/wizard.adp:
-	branches:  1.2.2; double qoute width=NUM%> to avoid the ADP 
+	branches:  1.2.2; double qoute width=NUM%&gt; to avoid the ADP 
 	parser warnings fixes bug 1582 patch 304 
 
 	* packages/acs-templating/tcl/mime-procs.tcl:
@@ -83797,7 +83797,7 @@
 	* packages/acs-automated-testing/www/admin/index.adp:
 	* packages/acs-automated-testing/www/admin/testcase.adp:
 	* packages/acs-templating/resources/forms/tabbed-dialog.adp:
-	double qoute width=NUM%> to avoid the ADP parser warnings 
+	double qoute width=NUM%&gt; to avoid the ADP parser warnings 
 	fixes bug 1582 patch 304 
 
 	* packages/acs-subsite/www/admin/rel-segments/constraints/new.xql:
@@ -84719,7 +84719,7 @@
 	stylesheet 3) Minor fixes to install guide 
 
 	* packages/acs-content-repository/sql/postgresql/upgrade/upgrade-4.1.2-4.5.sql:
-	Added upgrade script for CR 4.1.2->4.5 
+	Added upgrade script for CR 4.1.2-&gt;4.5 
 
 	* packages/acs-content-repository/sql/postgresql/upgrade/upgrade-4.1.2-4.5.sql:
 	branches:  1.1.2; file upgrade-4.1.2-4.5.sql was initially 
@@ -84736,7 +84736,7 @@
 2002-05-15 neophytosd
 
 	* packages/acs-kernel/sql/postgresql/postgresql.sql:
-	PG-7.2.1 returns false for 0<2^7. strange indeed. 2^7>0 
+	PG-7.2.1 returns false for 0&lt;2^7. strange indeed. 2^7&gt;0 
 	returns true 
 
 2002-05-13 yon
@@ -84968,7 +84968,7 @@
 	fixing code 
 
 	* packages/acs-subsite/www/user/password-update.adp:
-	was missing </form> tag so was causing errors 
+	was missing &lt;/form&gt; tag so was causing errors 
 
 2002-05-02 vinodk
 
@@ -85613,8 +85613,8 @@
 	* packages/acs-templating/tcl/tag-procs.tcl:
 	* packages/acs-templating/www/doc/demo/if.adp:
 	* packages/acs-templating/www/doc/demo/if.tcl:
-	 Applied Tilmann Singer's patch #124 which implements "<if 
-	@foo@>" as a shorthand for the true check. 
+	 Applied Tilmann Singer's patch #124 which implements "&lt;if 
+	@foo@&gt;" as a shorthand for the true check. 
 
 	* packages/acs-tcl/tcl/apm-file-procs.tcl:
 	 Applied Tilmann Singer's patch #150 - previously if tar put 
@@ -86662,10 +86662,10 @@
 	* packages/acs-core-docs/www/openacs.html:
 	* packages/acs-core-docs/www/operating-system.html:
 	* packages/acs-core-docs/www/postgres.html:
-	Changed ACS->OpenACS and regenerated HTML docs 
+	Changed ACS-&gt;OpenACS and regenerated HTML docs 
 
 	* packages/acs-core-docs/www/openacs.css:
-	branches:  1.1.2; Changed ACS->OpenACS and regenerated HTML 
+	branches:  1.1.2; Changed ACS-&gt;OpenACS and regenerated HTML 
 	docs 
 
 	* packages/acs-core-docs/www/xml/developers-guide/programming-with-aolserver.xml:
@@ -86685,14 +86685,14 @@
 	* packages/acs-core-docs/www/xml/kernel/subsites-design.xml:
 	* packages/acs-core-docs/www/xml/kernel/subsites-requirements.xml:
 	* packages/acs-core-docs/www/xml/kernel/tcl-doc.xml:
-	branches:  1.2.2; fixed ACS->OpenACS. regenerated html docs 
+	branches:  1.2.2; fixed ACS-&gt;OpenACS. regenerated html docs 
 
 	* packages/acs-core-docs/www/xml/engineering-standards/psgml-mode.xml:
 	* packages/acs-core-docs/www/xml/kernel/object-system-design.xml:
 	* packages/acs-core-docs/www/xml/kernel/object-system-req.xml:
 	* packages/acs-core-docs/www/xml/kernel/rp-design.xml:
 	* packages/acs-core-docs/www/xml/kernel/security-design.xml:
-	branches:  1.3.2; fixed ACS->OpenACS. regenerated html docs 
+	branches:  1.3.2; fixed ACS-&gt;OpenACS. regenerated html docs 
 
 	* packages/acs-core-docs/www/index.adp:
 	branches:  1.3.2; fixed aolserver tcl link 
@@ -86769,7 +86769,7 @@
 	* packages/acs-core-docs/www/xml/kernel/apm-design.xml:
 	* packages/acs-core-docs/www/xml/kernel/apm-requirements.xml:
 	* packages/acs-core-docs/www/xml/kernel/db-api.xml:
-	fixed ACS->OpenACS. regenerated html docs 
+	fixed ACS-&gt;OpenACS. regenerated html docs 
 
 	* packages/acs-core-docs/www/acs.html:
 	* packages/acs-core-docs/www/ad.css:
@@ -87079,7 +87079,7 @@
 	APM wouldn't let me load any packages when I added all the 
 	dotLRN packages plus standard packages over to a new 
 	"dotlrn" user from my normal "acs" user - the list of 
-	packages grew to > 4KB in size!  Grrrr! 
+	packages grew to &gt; 4KB in size!  Grrrr! 
 
 	* packages/acs-kernel/sql/postgresql/groups-body-create.sql:
 	 I accidently included a change intended for use with PG 7.2 
@@ -87092,7 +87092,7 @@
 	available.  The APM wouldn't let me load any packages when I 
 	added all the dotLRN packages plus standard packages over to 
 	a new "dotlrn" user from my normal "acs" user - the list of 
-	packages grew to > 4KB in size!  Grrrr! 
+	packages grew to &gt; 4KB in size!  Grrrr! 
 
 2001-12-24 rmello
 
@@ -87873,10 +87873,10 @@
 
 	* packages/acs-service-contract/www/doc/index.stx:
 	* packages/acs-service-contract/www/doc/index.xml:
-	branches:  1.1.28; converted structured text -> docbook,html 
+	branches:  1.1.28; converted structured text -&gt; docbook,html 
 
 	* packages/acs-service-contract/www/doc/index.html:
-	branches:  1.2.28; converted structured text -> docbook,html 
+	branches:  1.2.28; converted structured text -&gt; docbook,html 
 
 2001-10-28 neophytosd
 
@@ -88893,28 +88893,28 @@
 	* packages/acs-subsite/www/admin/object-types/one.tcl:
 	* packages/acs-tcl/tcl/apm-xml-procs.tcl:
 	* www/index.tcl:
-	 A bunch of "ACS"->"OpenACS" and similar changes 
+	 A bunch of "ACS"-&gt;"OpenACS" and similar changes 
 
 	* packages/acs-api-browser/www/index.adp:
 	* packages/acs-bootstrap-installer/db-init-checks-oracle.tcl:
-	branches:  1.2.2;  A bunch of "ACS"->"OpenACS" and similar 
+	branches:  1.2.2;  A bunch of "ACS"-&gt;"OpenACS" and similar 
 	changes 
 
 	* packages/acs-lang/tcl/locale-procs.tcl:
 	* packages/acs-lang/www/index.html:
-	branches:  1.2.4;  A bunch of "ACS"->"OpenACS" and similar 
+	branches:  1.2.4;  A bunch of "ACS"-&gt;"OpenACS" and similar 
 	changes 
 
 	* packages/acs-bootstrap-installer/installer/packages-install.tcl:
-	branches:  1.3.4;  A bunch of "ACS"->"OpenACS" and similar 
+	branches:  1.3.4;  A bunch of "ACS"-&gt;"OpenACS" and similar 
 	changes 
 
 	* tcl/0-acs-init.tcl:
-	branches:  1.4.10;  A bunch of "ACS"->"OpenACS" and similar 
+	branches:  1.4.10;  A bunch of "ACS"-&gt;"OpenACS" and similar 
 	changes 
 
 	* packages/acs-bootstrap-installer/installer.tcl:
-	branches:  1.4.2;  A bunch of "ACS"->"OpenACS" and similar 
+	branches:  1.4.2;  A bunch of "ACS"-&gt;"OpenACS" and similar 
 	changes 
 
 2001-08-29 danw
Index: openacs-4/packages/acs-core-docs/www/acs-package-dev.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/acs-package-dev.html,v
diff -u -N -r1.32.2.1 -r1.32.2.2
--- openacs-4/packages/acs-core-docs/www/acs-package-dev.html	21 Aug 2013 10:19:18 -0000	1.32.2.1
+++ openacs-4/packages/acs-core-docs/www/acs-package-dev.html	24 Oct 2014 14:33:50 -0000	1.32.2.2
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Part III. For OpenACS Package Developers</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="index.html" title="OpenACS Core Documentation"><link rel="previous" href="install-resources.html" title="Resources"><link rel="next" href="tutorial.html" title="Chapter 9. Development Tutorial"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="install-resources.html">Prev</a> </td><th width="60%" align="center"></th><td width="20%" align="right"> <a accesskey="n" href="tutorial.html">Next</a></td></tr></table><hr></div><div class="part"><div class="titlepage"><div><div><h1 class="title"><a name="acs-package-dev"></a>Part III. For OpenACS Package Developers</h1></div></div></div><div class="partintro"><div></div><p>Tutorials and reference material for creating new OpenACS packages.
-      </p><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="chapter"><a href="tutorial.html">9. Development Tutorial</a></span></dt><dd><dl><dt><span class="sect1"><a href="tutorial-newpackage.html">Creating an Application Package</a></span></dt><dt><span class="sect1"><a href="tutorial-database.html">Setting Up Database Objects</a></span></dt><dt><span class="sect1"><a href="tutorial-pages.html">Creating Web Pages</a></span></dt><dt><span class="sect1"><a href="tutorial-debug.html">Debugging and Automated Testing</a></span></dt></dl></dd><dt><span class="chapter"><a href="tutorial-advanced.html">10. Advanced Topics</a></span></dt><dd><dl><dt><span class="sect1"><a href="tutorial-specs.html">Write the Requirements and Design Specs</a></span></dt><dt><span class="sect1"><a href="tutorial-cvs.html">Add the new package to CVS</a></span></dt><dt><span class="sect1"><a href="tutorial-etp-templates.html">OpenACS Edit This Page Templates</a></span></dt><dt><span class="sect1"><a href="tutorial-comments.html">Adding Comments</a></span></dt><dt><span class="sect1"><a href="tutorial-admin-pages.html">Admin Pages</a></span></dt><dt><span class="sect1"><a href="tutorial-categories.html">Categories</a></span></dt><dt><span class="sect1"><a href="profile-code.html">Profile your code</a></span></dt><dt><span class="sect1"><a href="tutorial-distribute.html">Prepare the package for distribution.</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrades.html">Distributing upgrades of your package</a></span></dt><dt><span class="sect1"><a href="tutorial-notifications.html">Notifications</a></span></dt><dt><span class="sect1"><a href="tutorial-hierarchical.html">Hierarchical data</a></span></dt><dt><span class="sect1"><a href="tutorial-vuh.html">Using .vuh files for pretty urls</a></span></dt><dt><span class="sect1"><a href="tutorial-css-layout.html">Laying out a page with CSS instead of tables</a></span></dt><dt><span class="sect1"><a href="tutorial-html-email.html">Sending HTML email from your application</a></span></dt><dt><span class="sect1"><a href="tutorial-caching.html">Basic Caching</a></span></dt><dt><span class="sect1"><a href="tutorial-schedule-procs.html">Scheduled Procedures</a></span></dt><dt><span class="sect1"><a href="tutorial-wysiwyg-editor.html">Enabling WYSIWYG</a></span></dt><dt><span class="sect1"><a href="tutorial-parameters.html">Adding in parameters for your package</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrade-scripts.html">Writing upgrade scripts</a></span></dt><dt><span class="sect1"><a href="tutorial-second-database.html">Connect to a second database</a></span></dt><dt><span class="sect1"><a href="tutorial-future-topics.html">Future Topics</a></span></dt></dl></dd><dt><span class="chapter"><a href="dev-guide.html">11. Development Reference</a></span></dt><dd><dl><dt><span class="sect1"><a href="packages.html">OpenACS Packages</a></span></dt><dt><span class="sect1"><a href="objects.html">OpenACS Data Models and the Object System</a></span></dt><dt><span class="sect1"><a href="request-processor.html">The Request Processor</a></span></dt><dt><span class="sect1"><a href="db-api.html">The OpenACS Database Access API</a></span></dt><dt><span class="sect1"><a href="templates.html">Using Templates in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions.html">Groups, Context, Permissions</a></span></dt><dt><span class="sect1"><a href="subsites.html">Writing OpenACS Application Pages</a></span></dt><dt><span class="sect1"><a href="parties.html">Parties in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions-tediously-explained.html">OpenACS Permissions Tediously Explained</a></span></dt><dt><span class="sect1"><a href="object-identity.html">Object Identity</a></span></dt><dt><span class="sect1"><a href="programming-with-aolserver.html">Programming with AOLserver</a></span></dt><dt><span class="sect1"><a href="form-builder.html">Using Form Builder: building html forms dynamically</a></span></dt></dl></dd><dt><span class="chapter"><a href="eng-standards.html">12. Engineering Standards</a></span></dt><dd><dl><dt><span class="sect1"><a href="style-guide.html">OpenACS Style Guide</a></span></dt><dt><span class="sect1"><a href="cvs-guidelines.html">
+    </p><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="chapter"><a href="tutorial.html">9. Development Tutorial</a></span></dt><dd><dl><dt><span class="sect1"><a href="tutorial-newpackage.html">Creating an Application Package</a></span></dt><dt><span class="sect1"><a href="tutorial-database.html">Setting Up Database Objects</a></span></dt><dt><span class="sect1"><a href="tutorial-pages.html">Creating Web Pages</a></span></dt></dl></dd><dt><span class="chapter"><a href="tutorial-advanced.html">10. Advanced Topics</a></span></dt><dd><dl><dt><span class="sect1"><a href="tutorial-specs.html">Write the Requirements and Design Specs</a></span></dt><dt><span class="sect1"><a href="tutorial-cvs.html">Add the new package to CVS</a></span></dt><dt><span class="sect1"><a href="tutorial-etp-templates.html">OpenACS Edit This Page Templates</a></span></dt><dt><span class="sect1"><a href="tutorial-comments.html">Adding Comments</a></span></dt><dt><span class="sect1"><a href="tutorial-admin-pages.html">Admin Pages</a></span></dt><dt><span class="sect1"><a href="tutorial-categories.html">Categories</a></span></dt><dt><span class="sect1"><a href="profile-code.html">Profile your code</a></span></dt><dt><span class="sect1"><a href="tutorial-distribute.html">Prepare the package for distribution.</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrades.html">Distributing upgrades of your package</a></span></dt><dt><span class="sect1"><a href="tutorial-notifications.html">Notifications</a></span></dt><dt><span class="sect1"><a href="tutorial-hierarchical.html">Hierarchical data</a></span></dt><dt><span class="sect1"><a href="tutorial-vuh.html">Using .vuh files for pretty urls</a></span></dt><dt><span class="sect1"><a href="tutorial-css-layout.html">Laying out a page with CSS instead of tables</a></span></dt><dt><span class="sect1"><a href="tutorial-html-email.html">Sending HTML email from your application</a></span></dt><dt><span class="sect1"><a href="tutorial-caching.html">Basic Caching</a></span></dt><dt><span class="sect1"><a href="tutorial-schedule-procs.html">Scheduled Procedures</a></span></dt><dt><span class="sect1"><a href="tutorial-wysiwyg-editor.html">Enabling WYSIWYG</a></span></dt><dt><span class="sect1"><a href="tutorial-parameters.html">Adding in parameters for your package</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrade-scripts.html">Writing upgrade scripts</a></span></dt><dt><span class="sect1"><a href="tutorial-second-database.html">Connect to a second database</a></span></dt><dt><span class="sect1"><a href="tutorial-future-topics.html">Future Topics</a></span></dt></dl></dd><dt><span class="chapter"><a href="dev-guide.html">11. Development Reference</a></span></dt><dd><dl><dt><span class="sect1"><a href="packages.html">OpenACS Packages</a></span></dt><dt><span class="sect1"><a href="objects.html">OpenACS Data Models and the Object System</a></span></dt><dt><span class="sect1"><a href="request-processor.html">The Request Processor</a></span></dt><dt><span class="sect1"><a href="db-api.html">The OpenACS Database Access API</a></span></dt><dt><span class="sect1"><a href="templates.html">Using Templates in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions.html">Groups, Context, Permissions</a></span></dt><dt><span class="sect1"><a href="subsites.html">Writing OpenACS Application Pages</a></span></dt><dt><span class="sect1"><a href="parties.html">Parties in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions-tediously-explained.html">OpenACS Permissions Tediously Explained</a></span></dt><dt><span class="sect1"><a href="object-identity.html">Object Identity</a></span></dt><dt><span class="sect1"><a href="programming-with-aolserver.html">Programming with AOLserver</a></span></dt></dl></dd><dt><span class="chapter"><a href="eng-standards.html">12. Engineering Standards</a></span></dt><dd><dl><dt><span class="sect1"><a href="style-guide.html">OpenACS Style Guide</a></span></dt><dt><span class="sect1"><a href="cvs-guidelines.html">
     CVS Guidelines
   </a></span></dt><dt><span class="sect1"><a href="eng-standards-versioning.html">Release Version Numbering</a></span></dt><dt><span class="sect1"><a href="eng-standards-constraint-naming.html">Constraint naming standard</a></span></dt><dt><span class="sect1"><a href="eng-standards-filenaming.html">ACS File Naming and Formatting Standards</a></span></dt><dt><span class="sect1"><a href="eng-standards-plsql.html">PL/SQL Standards</a></span></dt><dt><span class="sect1"><a href="variables.html">Variables</a></span></dt><dt><span class="sect1"><a href="automated-testing-best-practices.html">Automated Testing</a></span></dt></dl></dd><dt><span class="chapter"><a href="doc-standards.html">13. Documentation Standards</a></span></dt><dd><dl><dt><span class="sect1"><a href="docbook-primer.html">OpenACS Documentation Guide</a></span></dt><dt><span class="sect1"><a href="psgml-mode.html">Using PSGML mode in Emacs</a></span></dt><dt><span class="sect1"><a href="nxml-mode.html">Using nXML mode in Emacs</a></span></dt><dt><span class="sect1"><a href="filename.html">Detailed Design Documentation Template</a></span></dt><dt><span class="sect1"><a href="requirements-template.html">System/Application Requirements Template</a></span></dt></dl></dd><dt><span class="chapter"><a href="i18n.html">14. Internationalization</a></span></dt><dd><dl><dt><span class="sect1"><a href="i18n-overview.html">Internationalization and Localization Overview</a></span></dt><dt><span class="sect1"><a href="i18n-introduction.html">How Internationalization/Localization works in OpenACS</a></span></dt><dt><span class="sect1"><a href="i18n-convert.html">How to Internationalize a Package</a></span></dt><dt><span class="sect1"><a href="i18n-design.html">Design Notes</a></span></dt><dt><span class="sect1"><a href="i18n-translators.html">Translator's Guide</a></span></dt></dl></dd><dt><span class="appendix"><a href="cvs-tips.html">D. Using CVS with an OpenACS Site</a></span></dt></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="install-resources.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="tutorial.html">Next</a></td></tr><tr><td width="40%" align="left">Resources </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> Chapter 9. Development Tutorial</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/acs-package-dev.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/backup-recovery.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/backup-recovery.html,v
diff -u -N -r1.42.2.1 -r1.42.2.2
--- openacs-4/packages/acs-core-docs/www/backup-recovery.html	21 Aug 2013 10:19:19 -0000	1.42.2.1
+++ openacs-4/packages/acs-core-docs/www/backup-recovery.html	24 Oct 2014 14:33:51 -0000	1.42.2.2
@@ -6,7 +6,7 @@
     oracle, while easy to set up, are far from the best solution).
     </p><p>There are three basic things which need to be backed up, the database data, the server 
     source tree, and the acs-content-repository (which is in the server source tree).</p><p>
-    </p><div class="figure"><a name="idp140726694608160"></a><p class="title"><b>Figure 8.1. Backup and Recovery Strategy</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/backup.png" align="middle" alt="Backup and Recovery Strategy"></div></div></div><p><br class="figure-break">
+    </p><div class="figure"><a name="idp140717553999872"></a><p class="title"><b>Figure 8.1. Backup and Recovery Strategy</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/backup.png" align="middle" alt="Backup and Recovery Strategy"></div></div></div><p><br class="figure-break">
   </p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
Index: openacs-4/packages/acs-core-docs/www/configuring-configuring-packages.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/configuring-configuring-packages.html,v
diff -u -N -r1.9.2.1 -r1.9.2.2
--- openacs-4/packages/acs-core-docs/www/configuring-configuring-packages.html	21 Aug 2013 10:19:20 -0000	1.9.2.1
+++ openacs-4/packages/acs-core-docs/www/configuring-configuring-packages.html	24 Oct 2014 14:33:51 -0000	1.9.2.2
@@ -2,7 +2,7 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Configuring an OpenACS package</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="configuring-new-site.html" title="Chapter 4. Configuring a new OpenACS Site"><link rel="previous" href="configuring-mounting-packages.html" title="Mounting OpenACS packages"><link rel="next" href="configuring-configuring-permissions.html" title="Setting Permissions on an OpenACS package"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="configuring-mounting-packages.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Configuring a new OpenACS Site</th><td width="20%" align="right"> <a accesskey="n" href="configuring-configuring-permissions.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="configuring-configuring-packages"></a>Configuring an OpenACS package</h2></div></div></div><div class="authorblurb"><p>by <a class="ulink" href="mailto:jade@rubick.com" target="_top">Jade Rubick</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694470128"></a>Configuring an OpenACS package</h3></div></div></div><p>After you've installed and mounted your package, you can
+        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717552902256"></a>Configuring an OpenACS package</h3></div></div></div><p>After you've installed and mounted your package, you can
       configure each instance to act as you would like. </p><p>This is done from the Applications page. Log in, go to the
       Admin or Control Panel, click on the subsite the application is
       in, and click on Applications. If you click on the 'Parameters'
Index: openacs-4/packages/acs-core-docs/www/configuring-configuring-permissions.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/configuring-configuring-permissions.html,v
diff -u -N -r1.9.2.1 -r1.9.2.2
--- openacs-4/packages/acs-core-docs/www/configuring-configuring-permissions.html	21 Aug 2013 10:19:20 -0000	1.9.2.1
+++ openacs-4/packages/acs-core-docs/www/configuring-configuring-permissions.html	24 Oct 2014 14:33:51 -0000	1.9.2.2
@@ -2,7 +2,7 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Setting Permissions on an OpenACS package</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="configuring-new-site.html" title="Chapter 4. Configuring a new OpenACS Site"><link rel="previous" href="configuring-configuring-packages.html" title="Configuring an OpenACS package"><link rel="next" href="how-do-I.html" title="How Do I?"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="configuring-configuring-packages.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Configuring a new OpenACS Site</th><td width="20%" align="right"> <a accesskey="n" href="how-do-I.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="configuring-configuring-permissions"></a>Setting Permissions on an OpenACS package</h2></div></div></div><div class="authorblurb"><p>by <a class="ulink" href="mailto:jade@rubick.com" target="_top">Jade Rubick</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694474144"></a>Setting Permission on an OpenACS package</h3></div></div></div><p>After you've installed and mounted your package, you can
+        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717552906272"></a>Setting Permission on an OpenACS package</h3></div></div></div><p>After you've installed and mounted your package, you can
       configure each instance to act as you would like. </p><p>This is done from the Applications page. Log in, go to the
       Admin or Control Panel, click on the subsite the application is
       in, and click on Applications. If you click on the 'Permissions'
Index: openacs-4/packages/acs-core-docs/www/configuring-install-packages.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/configuring-install-packages.html,v
diff -u -N -r1.9.2.1 -r1.9.2.2
--- openacs-4/packages/acs-core-docs/www/configuring-install-packages.html	21 Aug 2013 10:19:20 -0000	1.9.2.1
+++ openacs-4/packages/acs-core-docs/www/configuring-install-packages.html	24 Oct 2014 14:33:52 -0000	1.9.2.2
@@ -2,7 +2,7 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Installing OpenACS packages</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="configuring-new-site.html" title="Chapter 4. Configuring a new OpenACS Site"><link rel="previous" href="configuring-new-site.html" title="Chapter 4. Configuring a new OpenACS Site"><link rel="next" href="configuring-mounting-packages.html" title="Mounting OpenACS packages"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="configuring-new-site.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Configuring a new OpenACS Site</th><td width="20%" align="right"> <a accesskey="n" href="configuring-mounting-packages.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="configuring-install-packages"></a>Installing OpenACS packages</h2></div></div></div><div class="authorblurb"><p>by <a class="ulink" href="mailto:jade@rubick.com" target="_top">Jade Rubick</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726690503264"></a>Installing OpenACS packages</h3></div></div></div><p>An OpenACS package extends your website and lets it do
+        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717553836480"></a>Installing OpenACS packages</h3></div></div></div><p>An OpenACS package extends your website and lets it do
       things it wasn't able to do before. You can have a weblog, a
       forums, a calendar, or even do sophisticated project-management
       via your website.</p><p>After you've installed OpenACS, you can congratulate
Index: openacs-4/packages/acs-core-docs/www/configuring-mounting-packages.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/configuring-mounting-packages.html,v
diff -u -N -r1.9.2.1 -r1.9.2.2
--- openacs-4/packages/acs-core-docs/www/configuring-mounting-packages.html	21 Aug 2013 10:19:20 -0000	1.9.2.1
+++ openacs-4/packages/acs-core-docs/www/configuring-mounting-packages.html	24 Oct 2014 14:33:52 -0000	1.9.2.2
@@ -2,7 +2,7 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Mounting OpenACS packages</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="configuring-new-site.html" title="Chapter 4. Configuring a new OpenACS Site"><link rel="previous" href="configuring-install-packages.html" title="Installing OpenACS packages"><link rel="next" href="configuring-configuring-packages.html" title="Configuring an OpenACS package"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="configuring-install-packages.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Configuring a new OpenACS Site</th><td width="20%" align="right"> <a accesskey="n" href="configuring-configuring-packages.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="configuring-mounting-packages"></a>Mounting OpenACS packages</h2></div></div></div><div class="authorblurb"><p>by <a class="ulink" href="mailto:jade@rubick.com" target="_top">Jade Rubick</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726693156640"></a>Mounting OpenACS packages</h3></div></div></div><p>After you've installed your packages, you have to 'mount'
+        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717555999056"></a>Mounting OpenACS packages</h3></div></div></div><p>After you've installed your packages, you have to 'mount'
       them in order to make them appear on your website.</p><p>Make sure you are logged in, and then click on the
       'Admin' or 'Control Panel' link to get to the Site-Wide
       Administration page (at /acs-admin). Click on the subsite you'd
Index: openacs-4/packages/acs-core-docs/www/cvs-guidelines.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/cvs-guidelines.html,v
diff -u -N -r1.9.2.1 -r1.9.2.2
--- openacs-4/packages/acs-core-docs/www/cvs-guidelines.html	21 Aug 2013 10:19:20 -0000	1.9.2.1
+++ openacs-4/packages/acs-core-docs/www/cvs-guidelines.html	24 Oct 2014 14:33:52 -0000	1.9.2.2
@@ -6,7 +6,7 @@
     </p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="using-cvs-with-openacs"></a>Using CVS with OpenACS</h3></div></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726689580928"></a>Getting Started</h4></div></div></div><p>
+        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="using-cvs-with-openacs"></a>Using CVS with OpenACS</h3></div></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717577001040"></a>Getting Started</h4></div></div></div><p>
         All OpenACS code is available anonymously.  To get code
       anonymously, use the parameter
       <code class="computeroutput">-d:pserver:anonymous@cvs.openacs.org:/cvsroot</code> immediately after <code class="computeroutput">cvs</code> in a cvs command to check out or export code.
@@ -51,7 +51,7 @@
 cd CVSROOT
 emacs avail</span></span></pre><p>Add an avail line of the form:</p><pre class="programlisting">avail|<span class="replaceable"><span class="replaceable">username</span></span>|openacs-4</pre><pre class="screen"><span class="action"><span class="action">cvs commit -m "added commit on X for username" avail</span></span></pre></li></ol></div></div><div class="sidebar"><div class="titlepage"></div><p>Branimir suggests an additional level of abstraction.  If you put</p><pre class="programlisting">Host cvs-server
       HostName cvs.openacs.org
-      User <span class="replaceable"><span class="replaceable">yournamehere</span></span></pre><p>into your <code class="computeroutput">~/.ssh/config</code> file, then you can use <code class="computeroutput">-d :ext:cvs-server:/cvsroot</code> instead of <code class="computeroutput">-d :ext:cvs.openacs.org:/cvsroot</code>.  You can then change the definition of <code class="computeroutput">cvs-server</code> by changing one file instead of editing hundreds of <code class="computeroutput">CVSROOT/Repository</code> files.</p></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726694630752"></a>Checkout for Package Development</h4></div></div></div><p>If you are actively developing a non-core package, you
+      User <span class="replaceable"><span class="replaceable">yournamehere</span></span></pre><p>into your <code class="computeroutput">~/.ssh/config</code> file, then you can use <code class="computeroutput">-d :ext:cvs-server:/cvsroot</code> instead of <code class="computeroutput">-d :ext:cvs.openacs.org:/cvsroot</code>.  You can then change the definition of <code class="computeroutput">cvs-server</code> by changing one file instead of editing hundreds of <code class="computeroutput">CVSROOT/Repository</code> files.</p></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717566685024"></a>Checkout for Package Development</h4></div></div></div><p>If you are actively developing a non-core package, you
       should work from the latest core release branch.  Currently this
       is oacs-5-7.  This ensures that you are working on top
       of a stable OpenACS core, but still allows you to commit feature
@@ -66,13 +66,13 @@
             Inventory</a> and <a class="ulink" href="http://openacs.org/projects/openacs/packages/" target="_top">Package
             maintainers and status</a> for a list of available
             packages and their current state.
-      </p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726694096976"></a>Checkout for Core Development</h4></div></div></div><p>If you are actively developing packages in the OpenACS
+      </p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717566682048"></a>Checkout for Core Development</h4></div></div></div><p>If you are actively developing packages in the OpenACS
       Core, work from the HEAD branch.  HEAD is used for active
               development of the next version of core OpenACS. It may be very
               buggy; it may not even install correctly. Do not use this branch for
               development of non-core features unless your work depends on some
               of the HEAD core work. To check out HEAD, omit the
-              <code class="computeroutput">-r</code> tag.</p><p></p><p>To check out HEAD for development, which requires an OpenACS developer account:</p><pre class="screen"><span class="action"><span class="action">cvs -d:ext:cvs.openacs.org:/cvsroot checkout acs-core</span></span></pre><p>To check out HEAD anonymously:</p><pre class="screen"><span class="action"><span class="action">cvs -d:pserver:anonymous@cvs.openacs.org:/cvsroot checkout acs-core</span></span></pre></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726692612928"></a>Checkout .LRN</h4></div></div></div><p>
+              <code class="computeroutput">-r</code> tag.</p><p></p><p>To check out HEAD for development, which requires an OpenACS developer account:</p><pre class="screen"><span class="action"><span class="action">cvs -d:ext:cvs.openacs.org:/cvsroot checkout acs-core</span></span></pre><p>To check out HEAD anonymously:</p><pre class="screen"><span class="action"><span class="action">cvs -d:pserver:anonymous@cvs.openacs.org:/cvsroot checkout acs-core</span></span></pre></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717566672320"></a>Checkout .LRN</h4></div></div></div><p>
         .LRN consists of a given version openacs core, plus a set of
         packages. These are collectively packages together to form a
         distrubution of .LRN. F .LRN 2.0.0 sits on top of OpenACS 5.0.0.
@@ -87,7 +87,7 @@
 mv dotlrn/install.xml ..</span></span></pre></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="working-with-cvs"></a>Working with CVS</h4></div></div></div><p>
       Once you have a checkout you can use some commands to track
       what has changed since you checked out your copy.  <code class="computeroutput">cvs -n update</code> does not change any files, but reports which changes have been updated or locally modified, or are not present in CVS.
-    </p><p>To update your files, use <code class="computeroutput">cvs update</code>.  This will merge changes from the repository with your local files.  It has no effect on the cvs.openacs.org repository.</p></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="openacs-cvs-concepts"></a>OpenACS CVS Concepts</h3></div></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726694642064"></a>Modules</h4></div></div></div><p>
+    </p><p>To update your files, use <code class="computeroutput">cvs update</code>.  This will merge changes from the repository with your local files.  It has no effect on the cvs.openacs.org repository.</p></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="openacs-cvs-concepts"></a>OpenACS CVS Concepts</h3></div></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717566667904"></a>Modules</h4></div></div></div><p>
         All OpenACS code resides within a single CVS module, <code class="computeroutput">openacs-4</code>.  (The openacs-4 directory contains code for all versions of OpenACS 4 and later, and .LRN 1 and later.)   Checking out this module retrieves all openacs code of any type.  For convenience, subsets of <code class="computeroutput">openacs-4</code> are repackaged as smaller modules.</p><p>
           <code class="computeroutput">acs-core</code> contains only critical common
           packages. It does not have any user applications, such as forums,
@@ -115,7 +115,7 @@
           <code class="computeroutput">project-manager-all</code> contains the packages required, in combination with acs-core, to run the project-manager package.
         </p><p>
           Each OpenACS package (i.e., directory in <code class="computeroutput">openacs-4/packages/</code>) is also aliased as a module of the same name.
-        </p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726689338688"></a>
+        </p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717566655856"></a>
         Tags and Branches
       </h4></div></div></div><p>
         Tags and Branches look similar in commands, but behave differently. A tag is a fixed point on a branch.  Check out
@@ -315,7 +315,7 @@
           flag which defaults to no-effect wouldn't require a TIP. Added a
           new mandatory flag to an existing function would require a
           TIP.
-        </p></li></ol></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726689384864"></a>
+        </p></li></ol></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717566549520"></a>
       Informal Guidelines
     </h4></div></div></div><p>
       Informal guidelines which may be obsolete in places and should be reviewed:
Index: openacs-4/packages/acs-core-docs/www/cvs-tips.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/cvs-tips.html,v
diff -u -N -r1.33.2.1 -r1.33.2.2
--- openacs-4/packages/acs-core-docs/www/cvs-tips.html	21 Aug 2013 10:19:20 -0000	1.33.2.1
+++ openacs-4/packages/acs-core-docs/www/cvs-tips.html	24 Oct 2014 14:33:52 -0000	1.33.2.2
@@ -2,7 +2,7 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Appendix D. Using CVS with an OpenACS Site</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="acs-package-dev.html" title="Part III. For OpenACS Package Developers"><link rel="previous" href="i18n-translators.html" title="Translator's Guide"><link rel="next" href="acs-plat-dev.html" title="Part IV. For OpenACS Platform Developers"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="i18n-translators.html">Prev</a> </td><th width="60%" align="center">Part III. For OpenACS Package Developers</th><td width="20%" align="right"> <a accesskey="n" href="acs-plat-dev.html">Next</a></td></tr></table><hr></div><div class="appendix"><div class="titlepage"><div><div><h2 class="title"><a name="cvs-tips"></a>Appendix D. Using CVS with an OpenACS Site</h2></div></div></div><div class="authorblurb"><p>      By <a class="ulink" href="mailto:joel@aufrecht.org" target="_top">Joel Aufrecht</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><p><a name="cvs-service-import"></a><b>Add the Service to CVS - OPTIONAL. </b><a class="indexterm" name="idp140726697140368"></a>These steps take an existing OpenACS directory and add
+        </div><p><a name="cvs-service-import"></a><b>Add the Service to CVS - OPTIONAL. </b><a class="indexterm" name="idp140717566077744"></a>These steps take an existing OpenACS directory and add
           it to a <a class="link" href="install-cvs.html" title="Initialize CVS (OPTIONAL)">CVS
           repository</a>.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Create and set permissions on a subdirectory in the local cvs repository.</p><pre class="screen">[root root]# <strong class="userinput"><code>mkdir /cvsroot/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></code></strong>
 [root root]#<strong class="userinput"><code> chown <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME.$OPENACS_SERVICE_NAME</span></span> /cvsroot/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></code></strong>
Index: openacs-4/packages/acs-core-docs/www/dev-guide.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/dev-guide.html,v
diff -u -N -r1.35.2.1 -r1.35.2.2
--- openacs-4/packages/acs-core-docs/www/dev-guide.html	21 Aug 2013 10:19:21 -0000	1.35.2.1
+++ openacs-4/packages/acs-core-docs/www/dev-guide.html	24 Oct 2014 14:33:52 -0000	1.35.2.2
@@ -1,2 +1,2 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 11. Development Reference</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="acs-package-dev.html" title="Part III. For OpenACS Package Developers"><link rel="previous" href="tutorial-future-topics.html" title="Future Topics"><link rel="next" href="packages.html" title="OpenACS Packages"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="tutorial-future-topics.html">Prev</a> </td><th width="60%" align="center">Part III. For OpenACS Package Developers</th><td width="20%" align="right"> <a accesskey="n" href="packages.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="dev-guide"></a>Chapter 11. Development Reference</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="packages.html">OpenACS Packages</a></span></dt><dt><span class="sect1"><a href="objects.html">OpenACS Data Models and the Object System</a></span></dt><dt><span class="sect1"><a href="request-processor.html">The Request Processor</a></span></dt><dt><span class="sect1"><a href="db-api.html">The OpenACS Database Access API</a></span></dt><dt><span class="sect1"><a href="templates.html">Using Templates in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions.html">Groups, Context, Permissions</a></span></dt><dt><span class="sect1"><a href="subsites.html">Writing OpenACS Application Pages</a></span></dt><dt><span class="sect1"><a href="parties.html">Parties in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions-tediously-explained.html">OpenACS Permissions Tediously Explained</a></span></dt><dt><span class="sect1"><a href="object-identity.html">Object Identity</a></span></dt><dt><span class="sect1"><a href="programming-with-aolserver.html">Programming with AOLserver</a></span></dt><dt><span class="sect1"><a href="form-builder.html">Using Form Builder: building html forms dynamically</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tutorial-future-topics.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="packages.html">Next</a></td></tr><tr><td width="40%" align="left">Future Topics </td><td width="20%" align="center"><a accesskey="u" href="acs-package-dev.html">Up</a></td><td width="40%" align="right"> OpenACS Packages</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/dev-guide.html#comments">View comments on this page at openacs.org</a></center></body></html>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 11. Development Reference</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="acs-package-dev.html" title="Part III. For OpenACS Package Developers"><link rel="previous" href="tutorial-future-topics.html" title="Future Topics"><link rel="next" href="packages.html" title="OpenACS Packages"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="tutorial-future-topics.html">Prev</a> </td><th width="60%" align="center">Part III. For OpenACS Package Developers</th><td width="20%" align="right"> <a accesskey="n" href="packages.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="dev-guide"></a>Chapter 11. Development Reference</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="packages.html">OpenACS Packages</a></span></dt><dt><span class="sect1"><a href="objects.html">OpenACS Data Models and the Object System</a></span></dt><dt><span class="sect1"><a href="request-processor.html">The Request Processor</a></span></dt><dt><span class="sect1"><a href="db-api.html">The OpenACS Database Access API</a></span></dt><dt><span class="sect1"><a href="templates.html">Using Templates in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions.html">Groups, Context, Permissions</a></span></dt><dt><span class="sect1"><a href="subsites.html">Writing OpenACS Application Pages</a></span></dt><dt><span class="sect1"><a href="parties.html">Parties in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions-tediously-explained.html">OpenACS Permissions Tediously Explained</a></span></dt><dt><span class="sect1"><a href="object-identity.html">Object Identity</a></span></dt><dt><span class="sect1"><a href="programming-with-aolserver.html">Programming with AOLserver</a></span></dt></dl></div>Section missing</div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tutorial-future-topics.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="packages.html">Next</a></td></tr><tr><td width="40%" align="left">Future Topics </td><td width="20%" align="center"><a accesskey="u" href="acs-package-dev.html">Up</a></td><td width="40%" align="right"> OpenACS Packages</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/dev-guide.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/docbook-primer.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/docbook-primer.html,v
diff -u -N -r1.51.2.1 -r1.51.2.2
--- openacs-4/packages/acs-core-docs/www/docbook-primer.html	21 Aug 2013 10:19:21 -0000	1.51.2.1
+++ openacs-4/packages/acs-core-docs/www/docbook-primer.html	24 Oct 2014 14:33:53 -0000	1.51.2.2
@@ -578,7 +578,7 @@
       DTD</a>. The remaining discussion is about publishing using
     Docbook.
 </p><p>
-<a class="indexterm" name="idp140726697924784"></a> 
+<a class="indexterm" name="idp140717564941744"></a> 
       is a publishing standard based on XML with
       similar goals to the OpenACS Documentation project.  Some specific reasons why we are using DocBook:
     </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>      
@@ -641,7 +641,7 @@
     list of elements</a> 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 <span class="strong"><strong>as long as you remember to</strong></span>:
-      <a class="indexterm" name="idp140726695629056"></a>
+      <a class="indexterm" name="idp140717564959584"></a>
     </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
       Always close your tags with corresponding end-tags and to
       <span class="strong"><strong>not use other tag minimization</strong></span>
@@ -690,7 +690,7 @@
       The documentation for each package will make up a little "book" that is structured like this 
       - examples are <span class="emphasis"><em>emphasized</em></span>:
 
-      <a class="indexterm" name="idp140726695648160"></a>
+      <a class="indexterm" name="idp140717564978896"></a>
 
     </p><pre class="programlisting">
     book                        : <span class="strong"><strong>Docs for one package</strong></span> - <span class="emphasis"><em>templating</em></span>
@@ -714,20 +714,20 @@
       <a class="ulink" href="http://openacs.org/cvs/openacs-4/packages/acs-core-docs/www/xml/engineering-standards" target="_top">sources of these DocBook documents</a>
       to get an idea of how they are tied together.
     </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="dbprimer-sections"></a>Headlines, Sections</h3></div></div></div><p>
-      <a class="indexterm" name="idp140726695658928"></a>
+      <a class="indexterm" name="idp140717577531952"></a>
       Given that your job starts at the <code class="computeroutput">sect1</code>-level, all your documents should open with a
       <a class="ulink" href="http://docbook.org/tdg/en/html/sect1.html" target="_top"><code class="computeroutput">&lt;sect1&gt;</code></a>-tag and end 
       with the corresponding <code class="computeroutput">&lt;/sect1&gt;</code>.
     </p><p>
-      <a class="indexterm" name="idp140726695662480"></a>
+      <a class="indexterm" name="idp140717577535568"></a>
       You need to feed every <code class="computeroutput">&lt;sect1&gt;</code> two attributes. The first attribute,
       <code class="computeroutput">id</code>, 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 <a class="xref" href="docbook-primer.html#dbprimer-links" title="Links">the section called “Links”</a>). 
       The value of <code class="computeroutput">id</code> has to be unique 
       throughout the book you're making since the <code class="computeroutput">id</code>'s in your 
       <code class="computeroutput">sect1</code>'s will turn into filenames when the book is parsed into HTML.
     </p><p>
-      <a class="indexterm" name="idp140726695667296"></a>
+      <a class="indexterm" name="idp140717577540544"></a>
       The other attribute is <code class="computeroutput">xreflabel</code>. The value of this is the text that will appear
       as the link when referring to this <code class="computeroutput">sect1</code>.
     </p><p>
@@ -742,7 +742,7 @@
 
 &lt;/sect1&gt;
 </pre><p>
-      <a class="indexterm" name="idp140726695671664"></a>
+      <a class="indexterm" name="idp140717577544912"></a>
       Inside this container your document will be split up into 
       <a class="ulink" href="http://docbook.org/tdg/en/html/sect2.html" target="_top"><code class="computeroutput">&lt;sect2&gt;</code></a>'s,
       each with the same requirements - <code class="computeroutput">id</code> and <code class="computeroutput">xreflabel</code>
@@ -751,7 +751,7 @@
       When it comes to naming your
       <code class="computeroutput">sect2</code>'s and below, prefix them with some abbreviation of the <code class="computeroutput">id</code> in the <code class="computeroutput">sect1</code> such as <code class="computeroutput">requirements-overview</code>.
     </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="dbprimer-code"></a>Code</h3></div></div></div><p>
-      <a class="indexterm" name="idp140726695680144"></a>
+      <a class="indexterm" name="idp140717577553472"></a>
       For displaying a snippet of code, a filename or anything else you just want to appear as a part of
       a sentence, we use  
       <a class="ulink" href="http://docbook.org/tdg/en/html/computeroutput.html" target="_top"><code class="computeroutput">&lt;computeroutput&gt;</code></a>
@@ -769,12 +769,12 @@
       tag around text that has been wrapped by combinations of <a class="ulink" href="http://docbook.org/tdg/en/html/computeroutput.html" target="_top"><code class="computeroutput">&lt;computeroutput&gt;</code></a>
       and <a class="ulink" href="http://docbook.org/tdg/en/html/userinput.html" target="_top"><strong class="userinput"><code>&lt;userinput&gt;</code></strong></a>
 </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="dbprimer-links"></a>Links</h3></div></div></div><p>
-      <a class="indexterm" name="idp140726695690016"></a>
+      <a class="indexterm" name="idp140717577563344"></a>
       Linking falls into two different categories: inside the book you're making and outside:
     </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span class="strong"><strong>1. Inside linking, cross-referencing other parts of your book</strong></span></span></dt><dd><p>
         By having unique <code class="computeroutput">id</code>'s you can cross-reference any part of your book
         with a simple tag, regardless of where that part is.
-      </p><p><a class="indexterm" name="idp140726695693680"></a>Check out how I link to a subsection of the Developer's Guide:</p><p>Put this in your XML:</p><pre class="programlisting">
+      </p><p><a class="indexterm" name="idp140717577567008"></a>Check out how I link to a subsection of the Developer's Guide:</p><p>Put this in your XML:</p><pre class="programlisting">
 - Find information about creating a package in
 &lt;xref linkend="packages-making-a-package"&gt;&lt;/xref&gt;.
 </pre><p>And the output is:</p><pre class="programlisting">
@@ -798,7 +798,7 @@
         <code class="computeroutput">packages-looks</code>, the
         parser will try its best to explain where the link takes you.
       </p></dd><dt><span class="term"><span class="strong"><strong>2. Linking outside the documentation</strong></span></span></dt><dd><p>
-        <a class="indexterm" name="idp140726695708624"></a>
+        <a class="indexterm" name="idp140717577581952"></a>
         If you're hyper-linking out of the documentation, it works almost the same way as HTML - the tag is just
         a little different
 
@@ -819,7 +819,7 @@
     for you.
       </em></span>
     </p><p>
-      <a class="indexterm" name="idp140726695716864"></a>
+      <a class="indexterm" name="idp140717577590192"></a>
       To insert a graphic we use the elements 
       <a class="ulink" href="http://docbook.org/tdg/en/html/mediaobject.html" target="_top"><code class="computeroutput">&lt;mediaobject&gt;</code></a>,
       <a class="ulink" href="http://docbook.org/tdg/en/html/imageobject.html" target="_top"><code class="computeroutput">&lt;imageobject&gt;</code></a>,
@@ -845,7 +845,7 @@
       Put your graphics in a separate directory ("images") and link to them 
       only with relative paths.
     </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="dbprimer-lists"></a>Lists</h3></div></div></div><p>
-      <a class="indexterm" name="idp140726695724848"></a>
+      <a class="indexterm" name="idp140717577598176"></a>
       Here's how you make the DocBook equivalent of the three usual HTML-lists:
     </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span class="strong"><strong>1. How to make an &lt;ul&gt;</strong></span></span></dt><dd><p>
         Making an unordered list is pretty much like doing the same thing in HTML - if you close your <code class="computeroutput">&lt;li&gt;</code>, that is. The only differences are that each list item has to be wrapped in something more, such as
@@ -890,7 +890,7 @@
 
 &lt;/variablelist&gt;
 </pre></dd></dl></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="dbprimer-tables"></a>Tables</h3></div></div></div><p>
-      <a class="indexterm" name="idp140726695744272"></a>
+      <a class="indexterm" name="idp140717577617600"></a>
       DocBook supports several types of tables, but in most cases, the
       <a class="ulink" href="http://docbook.org/tdg/en/html/informaltable.html" target="_top"><code class="computeroutput">&lt;informaltable&gt;</code></a>
       is enough:
@@ -927,7 +927,7 @@
       <a class="ulink" href="http://docbook.org/tdg/en/html/table.html" target="_top"><code class="computeroutput">&lt;table&gt;</code></a>
       for an example.
     </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="dbprimer-emphasis"></a>Emphasis</h3></div></div></div><p>
-      <a class="indexterm" name="idp140726695756944"></a>
+      <a class="indexterm" name="idp140717577630272"></a>
       Our documentation uses two flavors of emphasis - italics and bold type. DocBook uses one - 
       <a class="ulink" href="http://docbook.org/tdg/en/html/emphasis.html" target="_top"><code class="computeroutput">&lt;emphasis&gt;</code></a>.
     </p><p>
Index: openacs-4/packages/acs-core-docs/www/eng-standards-filenaming.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/eng-standards-filenaming.html,v
diff -u -N -r1.47.2.1 -r1.47.2.2
--- openacs-4/packages/acs-core-docs/www/eng-standards-filenaming.html	21 Aug 2013 10:19:21 -0000	1.47.2.1
+++ openacs-4/packages/acs-core-docs/www/eng-standards-filenaming.html	24 Oct 2014 14:33:53 -0000	1.47.2.2
@@ -178,7 +178,7 @@
 </p><p>
 For example:
 </p><pre class="programlisting">
-set page_content "[ad_header "<span class="emphasis"><em>Page Title</em></span>"]
+set page_content "<span class="emphasis"><em>Page Title</em></span>]
 
 &lt;h2&gt;<span class="emphasis"><em>Page Title</em></span>&lt;/h2&gt;
 
@@ -216,15 +216,6 @@
 Local procedures (i.e., procedures defined and used only within one
 page) should be prefixed with "<span class="emphasis"><em><code class="computeroutput">module_</code></em></span>" and
 should be used rarely, only when they are exceedingly useful.
-</p><p>
-All files that prepare HTML to display should end with [ad_footer] or
-[<span class="emphasis"><em>module</em></span>_footer].  If your module requires its own footer,
-this footer should call ad_footer within it.  Why?  Because when we
-adapt the ACS to a new site, it is often the case that the client will
-want a much fancier display than the ACS standard.  We like to be able to
-edit ad_header (which quite possibly can start a &lt;table&gt;) and
-ad_footer (which may need to end the table started in ad_footer) to
-customize the look and feel of the entire site.
 </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="eng-standards-filenaming-tcllib"></a>Tcl Library Files</h3></div></div></div><p>
 Further standards for Tcl library files are under discussion; we plan to 
 include naming conventions for procs.
Index: openacs-4/packages/acs-core-docs/www/eng-standards.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/eng-standards.html,v
diff -u -N -r1.31.2.1 -r1.31.2.2
--- openacs-4/packages/acs-core-docs/www/eng-standards.html	21 Aug 2013 10:19:22 -0000	1.31.2.1
+++ openacs-4/packages/acs-core-docs/www/eng-standards.html	24 Oct 2014 14:33:53 -0000	1.31.2.2
@@ -1,4 +1,4 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 12. Engineering Standards</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="acs-package-dev.html" title="Part III. For OpenACS Package Developers"><link rel="previous" href="form-builder.html" title="Using Form Builder: building html forms dynamically"><link rel="next" href="style-guide.html" title="OpenACS Style Guide"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="form-builder.html">Prev</a> </td><th width="60%" align="center">Part III. For OpenACS Package Developers</th><td width="20%" align="right"> <a accesskey="n" href="style-guide.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="eng-standards"></a>Chapter 12. Engineering Standards</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="style-guide.html">OpenACS Style Guide</a></span></dt><dt><span class="sect1"><a href="cvs-guidelines.html">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 12. Engineering Standards</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="acs-package-dev.html" title="Part III. For OpenACS Package Developers"><link rel="previous" href="programming-with-aolserver.html" title="Programming with AOLserver"><link rel="next" href="style-guide.html" title="OpenACS Style Guide"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="programming-with-aolserver.html">Prev</a> </td><th width="60%" align="center">Part III. For OpenACS Package Developers</th><td width="20%" align="right"> <a accesskey="n" href="style-guide.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="eng-standards"></a>Chapter 12. Engineering Standards</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="style-guide.html">OpenACS Style Guide</a></span></dt><dt><span class="sect1"><a href="cvs-guidelines.html">
     CVS Guidelines
-  </a></span></dt><dt><span class="sect1"><a href="eng-standards-versioning.html">Release Version Numbering</a></span></dt><dt><span class="sect1"><a href="eng-standards-constraint-naming.html">Constraint naming standard</a></span></dt><dt><span class="sect1"><a href="eng-standards-filenaming.html">ACS File Naming and Formatting Standards</a></span></dt><dt><span class="sect1"><a href="eng-standards-plsql.html">PL/SQL Standards</a></span></dt><dt><span class="sect1"><a href="variables.html">Variables</a></span></dt><dt><span class="sect1"><a href="automated-testing-best-practices.html">Automated Testing</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="form-builder.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="style-guide.html">Next</a></td></tr><tr><td width="40%" align="left">Using Form Builder: building html forms dynamically </td><td width="20%" align="center"><a accesskey="u" href="acs-package-dev.html">Up</a></td><td width="40%" align="right"> OpenACS Style Guide</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/eng-standards.html#comments">View comments on this page at openacs.org</a></center></body></html>
+  </a></span></dt><dt><span class="sect1"><a href="eng-standards-versioning.html">Release Version Numbering</a></span></dt><dt><span class="sect1"><a href="eng-standards-constraint-naming.html">Constraint naming standard</a></span></dt><dt><span class="sect1"><a href="eng-standards-filenaming.html">ACS File Naming and Formatting Standards</a></span></dt><dt><span class="sect1"><a href="eng-standards-plsql.html">PL/SQL Standards</a></span></dt><dt><span class="sect1"><a href="variables.html">Variables</a></span></dt><dt><span class="sect1"><a href="automated-testing-best-practices.html">Automated Testing</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="programming-with-aolserver.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="style-guide.html">Next</a></td></tr><tr><td width="40%" align="left">Programming with AOLserver </td><td width="20%" align="center"><a accesskey="u" href="acs-package-dev.html">Up</a></td><td width="40%" align="right"> OpenACS Style Guide</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/eng-standards.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/ext-auth-requirements.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/ext-auth-requirements.html,v
diff -u -N -r1.39.2.1 -r1.39.2.2
--- openacs-4/packages/acs-core-docs/www/ext-auth-requirements.html	21 Aug 2013 10:19:22 -0000	1.39.2.1
+++ openacs-4/packages/acs-core-docs/www/ext-auth-requirements.html	24 Oct 2014 14:33:54 -0000	1.39.2.2
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>External Authentication Requirements</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="kernel-doc.html" title="Chapter 15. Kernel Documentation"><link rel="previous" href="bootstrap-acs.html" title="Bootstrapping OpenACS"><link rel="next" href="releasing-openacs.html" title="Chapter 16. Releasing OpenACS"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="bootstrap-acs.html">Prev</a> </td><th width="60%" align="center">Chapter 15. Kernel Documentation</th><td width="20%" align="right"> <a accesskey="n" href="releasing-openacs.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="ext-auth-requirements"></a>External Authentication Requirements</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726693012048"></a>Vision</h3></div></div></div><p>People have plenty of usernames and passwords already, we
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>External Authentication Requirements</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="kernel-doc.html" title="Chapter 15. Kernel Documentation"><link rel="previous" href="bootstrap-acs.html" title="Bootstrapping OpenACS"><link rel="next" href="releasing-openacs.html" title="Chapter 16. Releasing OpenACS"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="bootstrap-acs.html">Prev</a> </td><th width="60%" align="center">Chapter 15. Kernel Documentation</th><td width="20%" align="right"> <a accesskey="n" href="releasing-openacs.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="ext-auth-requirements"></a>External Authentication Requirements</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717566830256"></a>Vision</h3></div></div></div><p>People have plenty of usernames and passwords already, we
 don't want them to have yet another. We want people to be able to
 log in to OpenACS with the same password they use to log in to any
 other system.</p><p>Besides, administrators have better things to do than create
@@ -45,7 +45,7 @@
         only one implementation of the authentication API, namly the one
         included in OpenACS Core.</p></li><li class="listitem"><p>Authentication Driver API: The service contract which
         authentication drivers implement.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="Diagram"></a>Conceptual Pictures</h3></div></div></div><p>Authentication:</p><p><span class="inlinemediaobject"><img src="images/ext-auth.png"></span>
-</p><p>Account Management (NO PICTURE YET)</p><p>Batch Synchronization (NO PICTURE YET)</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="Requirements"></a>Requirements</h3></div></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726702299136"></a>New API</h4></div></div></div><div class="segmentedlist"><table border="1" cellpadding="3" cellspacing="0" width="90%"><tr><th width="15%">Feature</th><th width="8%">Status</th><th width="77%">Description</th></tr><thead><tr><th>New API</th></tr></thead><tbody><tr class="seglistitem"><td class="seg">EXT-AUTH-01</td><td class="seg">A</td><td class="seg">Extend Authentication/Acct Status API</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-03</td><td class="seg">A</td><td class="seg">Account Creation API</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-05</td><td class="seg">A</td><td class="seg">Password Management API</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-30</td><td class="seg">A</td><td class="seg">Authority Management API</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="Login"></a>Login</h4></div></div></div><div class="segmentedlist"><table border="1" cellpadding="3" cellspacing="0" width="90%"><tr><th width="15%">Feature</th><th width="8%">Status</th><th width="77%">Description</th></tr><thead><tr><th>Login</th></tr></thead><tbody><tr class="seglistitem"><td class="seg">EXT-AUTH-04</td><td class="seg">A</td><td class="seg">Rewrite login, register, and admin pages to use APIs</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-38</td><td class="seg">A</td><td class="seg">ad_form complain feature</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-19</td><td class="seg">A</td><td class="seg">Rewrite password recovery to use API</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-21</td><td class="seg">A</td><td class="seg">Rewrite email verification with API</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-28</td><td class="seg">A</td><td class="seg">Username is email switch</td></tr></tbody></table></div><p>Users will log in using a username, a authority, and a
+</p><p>Account Management (NO PICTURE YET)</p><p>Batch Synchronization (NO PICTURE YET)</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="Requirements"></a>Requirements</h3></div></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717581054144"></a>New API</h4></div></div></div><div class="segmentedlist"><table border="1" cellpadding="3" cellspacing="0" width="90%"><tr><th width="15%">Feature</th><th width="8%">Status</th><th width="77%">Description</th></tr><thead><tr><th>New API</th></tr></thead><tbody><tr class="seglistitem"><td class="seg">EXT-AUTH-01</td><td class="seg">A</td><td class="seg">Extend Authentication/Acct Status API</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-03</td><td class="seg">A</td><td class="seg">Account Creation API</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-05</td><td class="seg">A</td><td class="seg">Password Management API</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-30</td><td class="seg">A</td><td class="seg">Authority Management API</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="Login"></a>Login</h4></div></div></div><div class="segmentedlist"><table border="1" cellpadding="3" cellspacing="0" width="90%"><tr><th width="15%">Feature</th><th width="8%">Status</th><th width="77%">Description</th></tr><thead><tr><th>Login</th></tr></thead><tbody><tr class="seglistitem"><td class="seg">EXT-AUTH-04</td><td class="seg">A</td><td class="seg">Rewrite login, register, and admin pages to use APIs</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-38</td><td class="seg">A</td><td class="seg">ad_form complain feature</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-19</td><td class="seg">A</td><td class="seg">Rewrite password recovery to use API</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-21</td><td class="seg">A</td><td class="seg">Rewrite email verification with API</td></tr><tr class="seglistitem"><td class="seg">EXT-AUTH-28</td><td class="seg">A</td><td class="seg">Username is email switch</td></tr></tbody></table></div><p>Users will log in using a username, a authority, and a
       password.  The authority is the source for user/password
       verification.  OpenACS can be an authority itself. </p><p>Each user in OpenACS will belong to exactly one authority, which
 can either be the "local" OpenACS users table, in which case the
Index: openacs-4/packages/acs-core-docs/www/high-avail.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/high-avail.html,v
diff -u -N -r1.23.2.1 -r1.23.2.2
--- openacs-4/packages/acs-core-docs/www/high-avail.html	21 Aug 2013 10:19:22 -0000	1.23.2.1
+++ openacs-4/packages/acs-core-docs/www/high-avail.html	24 Oct 2014 14:33:54 -0000	1.23.2.2
@@ -1,2 +1,2 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>High Availability/High Performance Configurations</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="maintenance-web.html" title="Chapter 6. Production Environments"><link rel="previous" href="install-next-add-server.html" title="Running multiple services on one machine"><link rel="next" href="maintenance-deploy.html" title="Staged Deployment for Production Networks"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="install-next-add-server.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Production Environments</th><td width="20%" align="right"> <a accesskey="n" href="maintenance-deploy.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="high-avail"></a>High Availability/High Performance Configurations</h2></div></div></div><p>See also <a class="xref" href="remote-postgres.html" title="Running a PostgreSQL database on another server">the section called “Running a PostgreSQL database on another server”</a>.</p><div class="figure"><a name="idp140726695316240"></a><p class="title"><b>Figure 6.1. Multiple-server configuration</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/hpha.png" align="middle" alt="Multiple-server configuration"></div></div></div><br class="figure-break"></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="install-next-add-server.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="maintenance-deploy.html">Next</a></td></tr><tr><td width="40%" align="left">Running multiple services on one machine </td><td width="20%" align="center"><a accesskey="u" href="maintenance-web.html">Up</a></td><td width="40%" align="right"> Staged Deployment for Production Networks</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/high-avail.html#comments">View comments on this page at openacs.org</a></center></body></html>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>High Availability/High Performance Configurations</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="maintenance-web.html" title="Chapter 6. Production Environments"><link rel="previous" href="install-next-add-server.html" title="Running multiple services on one machine"><link rel="next" href="maintenance-deploy.html" title="Staged Deployment for Production Networks"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="install-next-add-server.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Production Environments</th><td width="20%" align="right"> <a accesskey="n" href="maintenance-deploy.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="high-avail"></a>High Availability/High Performance Configurations</h2></div></div></div><p>See also <a class="xref" href="remote-postgres.html" title="Running a PostgreSQL database on another server">the section called “Running a PostgreSQL database on another server”</a>.</p><div class="figure"><a name="idp140717558399040"></a><p class="title"><b>Figure 6.1. Multiple-server configuration</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/hpha.png" align="middle" alt="Multiple-server configuration"></div></div></div><br class="figure-break"></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="install-next-add-server.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="maintenance-deploy.html">Next</a></td></tr><tr><td width="40%" align="left">Running multiple services on one machine </td><td width="20%" align="center"><a accesskey="u" href="maintenance-web.html">Up</a></td><td width="40%" align="right"> Staged Deployment for Production Networks</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/high-avail.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/how-do-I.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/how-do-I.html,v
diff -u -N -r1.26.2.2 -r1.26.2.3
--- openacs-4/packages/acs-core-docs/www/how-do-I.html	9 Sep 2014 08:31:54 -0000	1.26.2.2
+++ openacs-4/packages/acs-core-docs/www/how-do-I.html	24 Oct 2014 14:33:54 -0000	1.26.2.3
@@ -1,7 +1,7 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>How Do I?</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="configuring-new-site.html" title="Chapter 4. Configuring a new OpenACS Site"><link rel="previous" href="configuring-configuring-permissions.html" title="Setting Permissions on an OpenACS package"><link rel="next" href="upgrade.html" title="Chapter 5. Upgrading"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="configuring-configuring-permissions.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Configuring a new OpenACS Site</th><td width="20%" align="right"> <a accesskey="n" href="upgrade.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="how-do-I"></a>How Do I?</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694478224"></a>How do I edit the front page of a new site through a web interface?</h3></div></div></div><p>The easiest way is to install the Edit-This-Page package.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Log in to the web site as an administrator.</p></li><li class="listitem"><p>Click on Admin &gt; Install Software &gt; Install from OpenACS Repository / Install new application</p></li><li class="listitem"><p>Choose Edit This Page and install</p></li><li class="listitem"><p>Follow the instructions within <a class="ulink" href="/doc/edit-this-page/install" target="_top">Edit This Page</a> (the link will only work after Edit This Page is installed).</p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694483600"></a>How do I let anybody who registers post to a weblog?</h3></div></div></div><p>Go to <code class="computeroutput"><a class="ulink" href="/admin/permissions" target="_top">/admin/permissions</a></code> and grant Create to Registered Users</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694485520"></a>How do I replace the front page of a new site with the front page of an application on that site</h3></div></div></div><p>Suppose you install a new site and install Weblogger, and you want all visitors to see weblogger automatically.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>On the front page, click the <code class="computeroutput"><a class="ulink" href="/admin" target="_top">Admin</a></code> button.</p></li><li class="listitem"><p>On the administration page, click <code class="computeroutput">Parameters</code> link.</p></li><li class="listitem"><p>Change the parameter <code class="computeroutput">IndexRedirectUrl</code> to be the URI of the desired application.  For a default weblogger installation, this would be <code class="computeroutput"><strong class="userinput"><code>weblogger/</code></strong></code>.  Note the trailing slash.</p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694492176"></a>How do I put custom functionality on front page of a new site?</h3></div></div></div><p>Every page within an OpenACS site is part of a <span class="strong"><strong>subsite</strong></span> <a class="ulink" href="/doc/acs-subsite" target="_top">More information)</a>.  The home page of the entire site is the front page is a special, default instance of a subsite, served from <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www</code>.  If an index page is not found there, the default index page for all subsites is used.  To customize the code on the front page, copy the default index page from the Subsite package to the Main site and edit it:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><pre class="screen"><strong class="userinput"><code>cp <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/acs-subsite/www/index*</code> <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www</code></code></strong></pre></li><li class="listitem"><p>Edit the new <code class="computeroutput">index.adp</code> to change the text; you shouldn't need to edit <code class="computeroutput">index.tcl</code> unless you are adding new functionality.</p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694500720"></a>How do I change the site-wide style?</h3></div></div></div><p>Almost all pages on an OpenACS site use <a class="ulink" href="/doc/acs-templating" target="_top">ACS Templating</a>, and so their appearance is driven by a layer of different files.  Let's examine how this works:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>How Do I?</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="configuring-new-site.html" title="Chapter 4. Configuring a new OpenACS Site"><link rel="previous" href="configuring-configuring-permissions.html" title="Setting Permissions on an OpenACS package"><link rel="next" href="upgrade.html" title="Chapter 5. Upgrading"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="configuring-configuring-permissions.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Configuring a new OpenACS Site</th><td width="20%" align="right"> <a accesskey="n" href="upgrade.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="how-do-I"></a>How Do I?</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717552523056"></a>How do I edit the front page of a new site through a web interface?</h3></div></div></div><p>The easiest way is to install the Edit-This-Page package.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Log in to the web site as an administrator.</p></li><li class="listitem"><p>Click on Admin &gt; Install Software &gt; Install from OpenACS Repository / Install new application</p></li><li class="listitem"><p>Choose Edit This Page and install</p></li><li class="listitem"><p>Follow the instructions within <a class="ulink" href="/doc/edit-this-page/install" target="_top">Edit This Page</a> (the link will only work after Edit This Page is installed).</p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717555471488"></a>How do I let anybody who registers post to a weblog?</h3></div></div></div><p>Go to <code class="computeroutput"><a class="ulink" href="/admin/permissions" target="_top">/admin/permissions</a></code> and grant Create to Registered Users</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717552226592"></a>How do I replace the front page of a new site with the front page of an application on that site</h3></div></div></div><p>Suppose you install a new site and install Weblogger, and you want all visitors to see weblogger automatically.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>On the front page, click the <code class="computeroutput"><a class="ulink" href="/admin" target="_top">Admin</a></code> button.</p></li><li class="listitem"><p>On the administration page, click <code class="computeroutput">Parameters</code> link.</p></li><li class="listitem"><p>Change the parameter <code class="computeroutput">IndexRedirectUrl</code> to be the URI of the desired application.  For a default weblogger installation, this would be <code class="computeroutput"><strong class="userinput"><code>weblogger/</code></strong></code>.  Note the trailing slash.</p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717556310544"></a>How do I put custom functionality on front page of a new site?</h3></div></div></div><p>Every page within an OpenACS site is part of a <span class="strong"><strong>subsite</strong></span> <a class="ulink" href="/doc/acs-subsite" target="_top">More information)</a>.  The home page of the entire site is the front page is a special, default instance of a subsite, served from <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www</code>.  If an index page is not found there, the default index page for all subsites is used.  To customize the code on the front page, copy the default index page from the Subsite package to the Main site and edit it:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><pre class="screen"><strong class="userinput"><code>cp <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/acs-subsite/www/index*</code> <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www</code></code></strong></pre></li><li class="listitem"><p>Edit the new <code class="computeroutput">index.adp</code> to change the text; you shouldn't need to edit <code class="computeroutput">index.tcl</code> unless you are adding new functionality.</p></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717557783552"></a>How do I change the site-wide style?</h3></div></div></div><p>Almost all pages on an OpenACS site use <a class="ulink" href="/doc/acs-templating" target="_top">ACS Templating</a>, and so their appearance is driven by a layer of different files.  Let's examine how this works:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
           A templated page uses an ADP/Tcl pair.  The first line in the ADP file is usually:
           </p><pre class="programlisting">&lt;master&gt;</pre><p>If it appears exactly like this, without any arguments, the template processer uses <code class="computeroutput">default-master</code> for that subsite.  For pages in <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www</code>, this is <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www/default-master.adp</code> and the associated .tcl file.
-          </p></li><li class="listitem"><p>The <code class="computeroutput">default-master</code> is itself a normal ADP page.  It draws the subsite navigation elements and invokes <code class="computeroutput">site-master</code> (<code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www/site-master.adp</code> and .tcl)</p></li><li class="listitem"><p>The <code class="computeroutput">site-master</code> draws site-wide navigation elements and invokes <code class="computeroutput">blank-master</code> (<code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www/blank-master.adp</code> and .tcl).  </p></li><li class="listitem"><p><code class="computeroutput">Blank-master</code> does HTML housekeeping and provides a framework for special sitewide navigation "meta" elements such as Translator widgets and Admin widgets.</p></li></ul></div><div class="figure"><a name="idp140726694513504"></a><p class="title"><b>Figure 4.1. Site Templates</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/site-templates.png" alt="Site Templates"></div></div></div><br class="figure-break"></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694515808"></a>How do I diagnose a permissions problem?</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><b>Steps to Reproduce. </b>The events package does not allow users to register for new events.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Go to the http://yourserver.net/events as a visitor (ie, log out and, if necessary, clear cookies).  This in on a 4.6.3 site with events version 0.1d3.</p></li><li class="listitem"><p>Select an available event</p></li><li class="listitem"><p>A link such as <code class="computeroutput">Registration: Deadline is 03/15/2004 10:00am. 
+          </p></li><li class="listitem"><p>The <code class="computeroutput">default-master</code> is itself a normal ADP page.  It draws the subsite navigation elements and invokes <code class="computeroutput">site-master</code> (<code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www/site-master.adp</code> and .tcl)</p></li><li class="listitem"><p>The <code class="computeroutput">site-master</code> draws site-wide navigation elements and invokes <code class="computeroutput">blank-master</code> (<code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www/blank-master.adp</code> and .tcl).  </p></li><li class="listitem"><p><code class="computeroutput">Blank-master</code> does HTML housekeeping and provides a framework for special sitewide navigation "meta" elements such as Translator widgets and Admin widgets.</p></li></ul></div><div class="figure"><a name="idp140717557796112"></a><p class="title"><b>Figure 4.1. Site Templates</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/site-templates.png" alt="Site Templates"></div></div></div><br class="figure-break"></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717557798416"></a>How do I diagnose a permissions problem?</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><b>Steps to Reproduce. </b>The events package does not allow users to register for new events.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Go to the http://yourserver.net/events as a visitor (ie, log out and, if necessary, clear cookies).  This in on a 4.6.3 site with events version 0.1d3.</p></li><li class="listitem"><p>Select an available event</p></li><li class="listitem"><p>A link such as <code class="computeroutput">Registration: Deadline is 03/15/2004 10:00am. 
 » Login or sign up to register for this event.</code> is visible.  Click on "Login or sign up"
-          </p></li><li class="listitem"><p>Complete a new registration.  Afterwards, you should be redirected back to the same page.</p></li></ol></div><p>Actual Results: The page says <code class="computeroutput">"You do not have permission to register for this event."</code></p><p>Expected results: A link or form to sign up for the event is shown.</p></li><li class="listitem"><p><b>Finding the problem. </b>We start with the page that has the error.  In the URL it's <code class="computeroutput">http://myserver.net/events/event-info.tcl</code>, so open the file <code class="computeroutput">/var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/events/www/event-info.tcl</code>.  It contains this line:</p><pre class="programlisting">set can_register_p [events::security::can_register_for_event_p -event_id $event_id]</pre><p>We need to know what that procedure does, so go to <a class="ulink" href="/api-doc" target="_top">/api-doc</a>, paste events::security::can_register_for_event_p into the ACS Tcl API Search box, and click Feeling Lucky.  The next pages shows the proc, and we click "show source" to see more information.  The body of the proc is simply</p><pre class="programlisting">return [permission::permission_p -party_id $user_id -object_id $event_id -privilege write]</pre><p>This means that a given user must have the write privilige on the event in order to register.  Let's assume that the priviliges inherit, so that if a user has the write privilige on the whole package, they will have the write privilege on the event.</p></li><li class="listitem"><p><b>Setting Permissions. </b>A permission has three parts: the privilige, the object of the privilige, and the subject being granted the privilige.  In this case the privilige is "write," the object is the Events package, and the subject is all Registered Users.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>To grant permissions on a package, start at the <a class="ulink" href="/admin/site-map" target="_top">site map</a>.  Find the event package and click "Set permissions".  </p></li><li class="listitem"><p>Click "Grant Permission"</p></li><li class="listitem"><p>Grant the write permission to Registered Users.</p><div class="figure"><a name="idp140726694533984"></a><p class="title"><b>Figure 4.2. Granting Permissions</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/grant-perm-463.png" alt="Granting Permissions"></div></div></div><br class="figure-break"></li></ol></div><p>OpenACS 5.0 offers a prettier version at <a class="ulink" href="/admin/applications" target="_top">/admin/applications</a>.</p><div class="figure"><a name="idp140726694537312"></a><p class="title"><b>Figure 4.3. Granting Permissions in 5.0</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/grant-perm-50.png" alt="Granting Permissions in 5.0"></div></div></div><br class="figure-break"></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="configuring-configuring-permissions.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="upgrade.html">Next</a></td></tr><tr><td width="40%" align="left">Setting Permissions on an OpenACS package </td><td width="20%" align="center"><a accesskey="u" href="configuring-new-site.html">Up</a></td><td width="40%" align="right"> Chapter 5. Upgrading</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/how-do-I.html#comments">View comments on this page at openacs.org</a></center></body></html>
+          </p></li><li class="listitem"><p>Complete a new registration.  Afterwards, you should be redirected back to the same page.</p></li></ol></div><p>Actual Results: The page says <code class="computeroutput">"You do not have permission to register for this event."</code></p><p>Expected results: A link or form to sign up for the event is shown.</p></li><li class="listitem"><p><b>Finding the problem. </b>We start with the page that has the error.  In the URL it's <code class="computeroutput">http://myserver.net/events/event-info.tcl</code>, so open the file <code class="computeroutput">/var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/events/www/event-info.tcl</code>.  It contains this line:</p><pre class="programlisting">set can_register_p [events::security::can_register_for_event_p -event_id $event_id]</pre><p>We need to know what that procedure does, so go to <a class="ulink" href="/api-doc" target="_top">/api-doc</a>, paste events::security::can_register_for_event_p into the ACS Tcl API Search box, and click Feeling Lucky.  The next pages shows the proc, and we click "show source" to see more information.  The body of the proc is simply</p><pre class="programlisting">return [permission::permission_p -party_id $user_id -object_id $event_id -privilege write]</pre><p>This means that a given user must have the write privilige on the event in order to register.  Let's assume that the priviliges inherit, so that if a user has the write privilige on the whole package, they will have the write privilege on the event.</p></li><li class="listitem"><p><b>Setting Permissions. </b>A permission has three parts: the privilige, the object of the privilige, and the subject being granted the privilige.  In this case the privilige is "write," the object is the Events package, and the subject is all Registered Users.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>To grant permissions on a package, start at the <a class="ulink" href="/admin/site-map" target="_top">site map</a>.  Find the event package and click "Set permissions".  </p></li><li class="listitem"><p>Click "Grant Permission"</p></li><li class="listitem"><p>Grant the write permission to Registered Users.</p><div class="figure"><a name="idp140717557816592"></a><p class="title"><b>Figure 4.2. Granting Permissions</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/grant-perm-463.png" alt="Granting Permissions"></div></div></div><br class="figure-break"></li></ol></div><p>OpenACS 5.0 offers a prettier version at <a class="ulink" href="/admin/applications" target="_top">/admin/applications</a>.</p><div class="figure"><a name="idp140717557820208"></a><p class="title"><b>Figure 4.3. Granting Permissions in 5.0</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/grant-perm-50.png" alt="Granting Permissions in 5.0"></div></div></div><br class="figure-break"></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="configuring-configuring-permissions.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="upgrade.html">Next</a></td></tr><tr><td width="40%" align="left">Setting Permissions on an OpenACS package </td><td width="20%" align="center"><a accesskey="u" href="configuring-new-site.html">Up</a></td><td width="40%" align="right"> Chapter 5. Upgrading</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/how-do-I.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/i18n-convert.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/i18n-convert.html,v
diff -u -N -r1.25.2.3 -r1.25.2.4
--- openacs-4/packages/acs-core-docs/www/i18n-convert.html	9 Sep 2014 08:31:54 -0000	1.25.2.3
+++ openacs-4/packages/acs-core-docs/www/i18n-convert.html	24 Oct 2014 14:33:54 -0000	1.25.2.4
@@ -72,7 +72,7 @@
         test. If you don't provide the package_key argument then all
         packages with catalog files will be checked. 
         The script will run its checks primarily on en_US xml catalog files.
-      </p></li></ol></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726696201296"></a>Avoiding common i18n mistakes</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><b>Replace complicated keys with longer, simpler keys. </b>When writing in one language, it is possible to create clever code to make correct text.  In English, for example, you can put an <code class="computeroutput">if</code> command at the end of a word which adds "s" if a count is anything but 1.  This pluralizes nouns correctly based on the data.  However, it is confusing to read and, when internationalized, may result in message keys that are both confusing and impossible to set correctly in some languages.  While internationalizing, watch out that the automate converter does not create such keys.  Also, refactor compound text as you encounter it.</p><p>The automated system can easily get confused by tags within message texts, so that it tries to create two or three message keys for one long string with a tag in the middle.  In these cases, uncheck those keys during the conversion and then edit the files directly.  For example, this code:</p><pre class="programlisting">  &lt;p class="form-help-text"&gt;&lt;b&gt;Invitations&lt;/b&gt; are sent,
+      </p></li></ol></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717578026800"></a>Avoiding common i18n mistakes</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><b>Replace complicated keys with longer, simpler keys. </b>When writing in one language, it is possible to create clever code to make correct text.  In English, for example, you can put an <code class="computeroutput">if</code> command at the end of a word which adds "s" if a count is anything but 1.  This pluralizes nouns correctly based on the data.  However, it is confusing to read and, when internationalized, may result in message keys that are both confusing and impossible to set correctly in some languages.  While internationalizing, watch out that the automate converter does not create such keys.  Also, refactor compound text as you encounter it.</p><p>The automated system can easily get confused by tags within message texts, so that it tries to create two or three message keys for one long string with a tag in the middle.  In these cases, uncheck those keys during the conversion and then edit the files directly.  For example, this code:</p><pre class="programlisting">  &lt;p class="form-help-text"&gt;&lt;b&gt;Invitations&lt;/b&gt; are sent,
           when this wizard is completed and casting begins.&lt;/p&gt;</pre><p>has a bold tag which confuses the converter into thinking there are two message keys for the text beginning "Invitations ..." where there should be one:</p><div class="mediaobject" align="center"><img src="images/i18n-3.png" align="middle"></div><p>Instead, we cancel those keys, edit the file manually, and put in a single temporary message tag:</p><pre class="programlisting">  &lt;p class="form-help-text"&gt; &lt;#Invitations_are_sent &lt;b&gt;Invitations&lt;/b&gt; are sent, 
 when this wizard is completed and casting begins.#&gt;
   &lt;/p&gt;</pre><p>Complex if statements may produce convoluted message keys that are very hard to localize.  Rewrite these if statements.  For example:</p><pre class="programlisting">Select which case &lt;if @simulation.casting_type@ eq "open"&gt;and
@@ -124,12 +124,12 @@
 &lt;/if&gt;
 </pre><p>It would probably be better to do this as something like:</p><pre class="programlisting">&lt;if @components.view_bugs_url@ not nil&gt;
   &lt;if @components.num_bugs@ eq 1&gt;
-    &lt;a href="@components.view_bugs_url@" title="<span>#</span>bug-tracker.View_the_bug_fo_component#"&gt;<span>#</span>bug-tracker.one_bug#&lt;/a&gt;
+    &lt;a href="@components.view_bugs_url@" title="#bug-tracker.View_the_bug_fo_component#"&gt;#bug-tracker.one_bug#&lt;/a&gt;
   &lt;/if&gt;&lt;else&gt;
-    &lt;a href="@components.view_bugs_url@" title="<span>#</span>bug-tracker.View_the_bug_fo_component#"&gt;<span>#</span>bug-tracker.N_bugs#&lt;/a&gt;
+    &lt;a href="@components.view_bugs_url@" title="#bug-tracker.View_the_bug_fo_component#"&gt;#bug-tracker.N_bugs#&lt;/a&gt;
   &lt;/else&gt;
 &lt;/if&gt;</pre></li><li class="listitem"><p><b>Don't combine keys in  display text. </b>Converting a phrase from one language to another is usually more complicated than simply replacing each word with an equivalent.  When several keys are concatenated, the resulting word order will not be correct for every language.  Different languages may use expressions or idioms that don't match the phrase key-for-key.  Create complete, distinct keys instead of building text from several keys.  For example:</p><p>Original code:</p><pre class="programlisting">multirow append links "New [bug_tracker::conn Bug]" </pre><p>Problematic conversion:</p><pre class="programlisting">multirow append links "[_ bug-tracker.New] [bug_tracker::conn Bug]"</pre><p>Better conversion:</p><pre class="programlisting">set bug_label [bug_tracker::conn Bug]
-multirow append links "[_ bug-tracker.New_Bug]" "${url_prefix}bug-add"</pre><p>... and include the variable in the key: <code class="computeroutput">"New %bug_label%"</code>.  This gives translators more control over the phrase.</p><p>In this example of bad i18n, full name is created by concatenating first and last name (admittedly this is pervasive in the toolkit):</p><pre class="programlisting">&lt;a href="@past_version.maintainer_url@" title="<span>#</span>bug-tracker.Email# @past_version.maintainer_email@"&gt;
+multirow append links "[_ bug-tracker.New_Bug]" "${url_prefix}bug-add"</pre><p>... and include the variable in the key: <code class="computeroutput">"New %bug_label%"</code>.  This gives translators more control over the phrase.</p><p>In this example of bad i18n, full name is created by concatenating first and last name (admittedly this is pervasive in the toolkit):</p><pre class="programlisting">&lt;a href="@past_version.maintainer_url@" title="#bug-tracker.Email# @past_version.maintainer_email@"&gt;
 @past_version.maintainer_first_names@ @past_version.maintainer_last_name@&lt;/a&gt;</pre></li><li class="listitem"><p><b>Avoid unnecessary duplicate keys. </b>When phrases are exactly the same in several places, use a single key.</p><p>For common words such as
             Yes and No, you can use a library of keys at <a class="ulink" href="/acs-lang/admin/message-list?package%5fkey=acs%2dkernel&amp;locale=en%5fUS" target="_top">acs-kernel</a>.
             For example, instead of using
Index: openacs-4/packages/acs-core-docs/www/index.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/index.html,v
diff -u -N -r1.52.2.1 -r1.52.2.2
--- openacs-4/packages/acs-core-docs/www/index.html	21 Aug 2013 10:19:23 -0000	1.52.2.1
+++ openacs-4/packages/acs-core-docs/www/index.html	24 Oct 2014 14:33:54 -0000	1.52.2.2
@@ -1,4 +1,4 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>OpenACS Core Documentation</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="next" href="for-everyone.html" title="Part I. OpenACS For Everyone"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"> </td><th width="60%" align="center"></th><td width="20%" align="right"> <a accesskey="n" href="for-everyone.html">Next</a></td></tr></table><hr></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a name="idp140726686162224"></a>OpenACS Core Documentation</h1></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="part"><a href="for-everyone.html">I. OpenACS For Everyone</a></span></dt><dd><dl><dt><span class="chapter"><a href="general-documents.html">1. High level information: What is OpenACS?</a></span></dt><dd><dl><dt><span class="sect1"><a href="openacs-overview.html">Overview</a></span></dt><dt><span class="sect1"><a href="release-notes.html">OpenACS Release Notes</a></span></dt></dl></dd></dl></dd><dt><span class="part"><a href="acs-admin.html">II. Administrator's Guide</a></span></dt><dd><dl><dt><span class="chapter"><a href="install-overview.html">2. Installation Overview</a></span></dt><dd><dl><dt><span class="sect1"><a href="install-steps.html">Basic Steps</a></span></dt><dt><span class="sect1"><a href="individual-programs.html">Prerequisite Software</a></span></dt></dl></dd><dt><span class="chapter"><a href="complete-install.html">3. Complete Installation</a></span></dt><dd><dl><dt><span class="sect1"><a href="unix-installation.html">Install a Unix-like system and supporting software</a></span></dt><dt><span class="sect1"><a href="oracle.html">Install Oracle 8.1.7</a></span></dt><dt><span class="sect1"><a href="postgres.html">Install PostgreSQL</a></span></dt><dt><span class="sect1"><a href="aolserver4.html">Install AOLserver 4</a></span></dt><dt><span class="sect1"><a href="openacs.html">Install OpenACS 5.7.0</a></span></dt><dt><span class="sect1"><a href="win2k-installation.html">OpenACS Installation Guide for Windows2000</a></span></dt><dt><span class="sect1"><a href="mac-installation.html">OpenACS Installation Guide for Mac OS X</a></span></dt></dl></dd><dt><span class="chapter"><a href="configuring-new-site.html">4. Configuring a new OpenACS Site</a></span></dt><dd><dl><dt><span class="sect1"><a href="configuring-install-packages.html">Installing OpenACS packages</a></span></dt><dt><span class="sect1"><a href="configuring-mounting-packages.html">Mounting OpenACS packages</a></span></dt><dt><span class="sect1"><a href="configuring-configuring-packages.html">Configuring an OpenACS package</a></span></dt><dt><span class="sect1"><a href="configuring-configuring-permissions.html">Setting Permissions on an OpenACS package</a></span></dt><dt><span class="sect1"><a href="how-do-I.html">How Do I?</a></span></dt></dl></dd><dt><span class="chapter"><a href="upgrade.html">5. Upgrading</a></span></dt><dd><dl><dt><span class="sect1"><a href="upgrade-overview.html">Overview</a></span></dt><dt><span class="sect1"><a href="upgrade-4.5-to-4.6.html">Upgrading 4.5 or higher to 4.6.3</a></span></dt><dt><span class="sect1"><a href="upgrade-4.6.3-to-5.html">Upgrading OpenACS 4.6.3 to 5.0</a></span></dt><dt><span class="sect1"><a href="upgrade-5-0-dot.html">Upgrading an OpenACS 5.0.0 or greater installation</a></span></dt><dt><span class="sect1"><a href="upgrade-openacs-files.html">Upgrading the OpenACS files</a></span></dt><dt><span class="sect1"><a href="upgrade-supporting.html">Upgrading Platform components</a></span></dt></dl></dd><dt><span class="chapter"><a href="maintenance-web.html">6. Production Environments</a></span></dt><dd><dl><dt><span class="sect1"><a href="install-openacs-keepalive.html">Starting and Stopping an OpenACS instance.</a></span></dt><dt><span class="sect1"><a href="install-openacs-inittab.html">AOLserver keepalive with inittab</a></span></dt><dt><span class="sect1"><a href="install-next-add-server.html">Running multiple services on one machine</a></span></dt><dt><span class="sect1"><a href="high-avail.html">High Availability/High Performance Configurations</a></span></dt><dt><span class="sect1"><a href="maintenance-deploy.html">Staged Deployment for Production Networks</a></span></dt><dt><span class="sect1"><a href="install-ssl.html">Installing SSL Support for an OpenACS service</a></span></dt><dt><span class="sect1"><a href="analog-setup.html">Set up Log Analysis Reports</a></span></dt><dt><span class="sect1"><a href="uptime.html">External uptime validation</a></span></dt><dt><span class="sect1"><a href="maint-performance.html">Diagnosing Performance Problems</a></span></dt></dl></dd><dt><span class="chapter"><a href="database-management.html">7. Database Management</a></span></dt><dd><dl><dt><span class="sect1"><a href="remote-postgres.html">Running a PostgreSQL database on another server</a></span></dt><dt><span class="sect1"><a href="install-openacs-delete-tablespace.html">Deleting a tablespace</a></span></dt><dt><span class="sect1"><a href="install-next-nightly-vacuum.html">Vacuum Postgres nightly</a></span></dt></dl></dd><dt><span class="chapter"><a href="backup-recovery.html">8. Backup and Recovery</a></span></dt><dd><dl><dt><span class="sect1"><a href="install-next-backups.html">Backup Strategy</a></span></dt><dt><span class="sect1"><a href="snapshot-backup.html">Manual backup and recovery</a></span></dt><dt><span class="sect1"><a href="automated-backup.html">Automated Backup</a></span></dt><dt><span class="sect1"><a href="backups-with-cvs.html">Using CVS for backup-recovery</a></span></dt></dl></dd><dt><span class="appendix"><a href="install-redhat.html">A. Install Red Hat 8/9</a></span></dt><dt><span class="appendix"><a href="install-more-software.html">B. Install additional supporting software</a></span></dt><dd><dl><dt><span class="sect1"><a href="openacs-unpack.html">Unpack the OpenACS tarball</a></span></dt><dt><span class="sect1"><a href="install-cvs.html">Initialize CVS (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="psgml-for-emacs.html">Add PSGML commands to emacs init file (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="install-daemontools.html">Install Daemontools (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="install-qmail.html">Install qmail (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="analog-install.html">Install Analog web file analyzer</a></span></dt><dt><span class="sect1"><a href="install-nspam.html">Install nspam</a></span></dt><dt><span class="sect1"><a href="install-full-text-search-tsearch2.html">Install Full Text Search using Tsearch2</a></span></dt><dt><span class="sect1"><a href="install-full-text-search-openfts.html">Install Full Text Search using OpenFTS (deprecated see tsearch2)</a></span></dt><dt><span class="sect1"><a href="install-nsopenssl.html">Install nsopenssl</a></span></dt><dt><span class="sect1"><a href="install-tclwebtest.html">Install tclwebtest.</a></span></dt><dt><span class="sect1"><a href="install-php.html">Install PHP for use in AOLserver</a></span></dt><dt><span class="sect1"><a href="install-squirrelmail.html">Install Squirrelmail for use as a webmail system for OpenACS</a></span></dt><dt><span class="sect1"><a href="install-pam-radius.html">Install PAM Radius for use as external authentication</a></span></dt><dt><span class="sect1"><a href="install-ldap-radius.html">Install LDAP for use as external authentication</a></span></dt><dt><span class="sect1"><a href="aolserver.html">Install AOLserver 3.3oacs1</a></span></dt></dl></dd><dt><span class="appendix"><a href="credits.html">C. Credits</a></span></dt><dd><dl><dt><span class="section"><a href="install-origins.html">Where did this document come from?</a></span></dt><dt><span class="section"><a href="os-install.html">Linux Install Guides</a></span></dt><dt><span class="section"><a href="os-security.html">Security Information</a></span></dt><dt><span class="section"><a href="install-resources.html">Resources</a></span></dt></dl></dd></dl></dd><dt><span class="part"><a href="acs-package-dev.html">III. For OpenACS Package Developers</a></span></dt><dd><dl><dt><span class="chapter"><a href="tutorial.html">9. Development Tutorial</a></span></dt><dd><dl><dt><span class="sect1"><a href="tutorial-newpackage.html">Creating an Application Package</a></span></dt><dt><span class="sect1"><a href="tutorial-database.html">Setting Up Database Objects</a></span></dt><dt><span class="sect1"><a href="tutorial-pages.html">Creating Web Pages</a></span></dt><dt><span class="sect1"><a href="tutorial-debug.html">Debugging and Automated Testing</a></span></dt></dl></dd><dt><span class="chapter"><a href="tutorial-advanced.html">10. Advanced Topics</a></span></dt><dd><dl><dt><span class="sect1"><a href="tutorial-specs.html">Write the Requirements and Design Specs</a></span></dt><dt><span class="sect1"><a href="tutorial-cvs.html">Add the new package to CVS</a></span></dt><dt><span class="sect1"><a href="tutorial-etp-templates.html">OpenACS Edit This Page Templates</a></span></dt><dt><span class="sect1"><a href="tutorial-comments.html">Adding Comments</a></span></dt><dt><span class="sect1"><a href="tutorial-admin-pages.html">Admin Pages</a></span></dt><dt><span class="sect1"><a href="tutorial-categories.html">Categories</a></span></dt><dt><span class="sect1"><a href="profile-code.html">Profile your code</a></span></dt><dt><span class="sect1"><a href="tutorial-distribute.html">Prepare the package for distribution.</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrades.html">Distributing upgrades of your package</a></span></dt><dt><span class="sect1"><a href="tutorial-notifications.html">Notifications</a></span></dt><dt><span class="sect1"><a href="tutorial-hierarchical.html">Hierarchical data</a></span></dt><dt><span class="sect1"><a href="tutorial-vuh.html">Using .vuh files for pretty urls</a></span></dt><dt><span class="sect1"><a href="tutorial-css-layout.html">Laying out a page with CSS instead of tables</a></span></dt><dt><span class="sect1"><a href="tutorial-html-email.html">Sending HTML email from your application</a></span></dt><dt><span class="sect1"><a href="tutorial-caching.html">Basic Caching</a></span></dt><dt><span class="sect1"><a href="tutorial-schedule-procs.html">Scheduled Procedures</a></span></dt><dt><span class="sect1"><a href="tutorial-wysiwyg-editor.html">Enabling WYSIWYG</a></span></dt><dt><span class="sect1"><a href="tutorial-parameters.html">Adding in parameters for your package</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrade-scripts.html">Writing upgrade scripts</a></span></dt><dt><span class="sect1"><a href="tutorial-second-database.html">Connect to a second database</a></span></dt><dt><span class="sect1"><a href="tutorial-future-topics.html">Future Topics</a></span></dt></dl></dd><dt><span class="chapter"><a href="dev-guide.html">11. Development Reference</a></span></dt><dd><dl><dt><span class="sect1"><a href="packages.html">OpenACS Packages</a></span></dt><dt><span class="sect1"><a href="objects.html">OpenACS Data Models and the Object System</a></span></dt><dt><span class="sect1"><a href="request-processor.html">The Request Processor</a></span></dt><dt><span class="sect1"><a href="db-api.html">The OpenACS Database Access API</a></span></dt><dt><span class="sect1"><a href="templates.html">Using Templates in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions.html">Groups, Context, Permissions</a></span></dt><dt><span class="sect1"><a href="subsites.html">Writing OpenACS Application Pages</a></span></dt><dt><span class="sect1"><a href="parties.html">Parties in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions-tediously-explained.html">OpenACS Permissions Tediously Explained</a></span></dt><dt><span class="sect1"><a href="object-identity.html">Object Identity</a></span></dt><dt><span class="sect1"><a href="programming-with-aolserver.html">Programming with AOLserver</a></span></dt><dt><span class="sect1"><a href="form-builder.html">Using Form Builder: building html forms dynamically</a></span></dt></dl></dd><dt><span class="chapter"><a href="eng-standards.html">12. Engineering Standards</a></span></dt><dd><dl><dt><span class="sect1"><a href="style-guide.html">OpenACS Style Guide</a></span></dt><dt><span class="sect1"><a href="cvs-guidelines.html">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>OpenACS Core Documentation</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="next" href="for-everyone.html" title="Part I. OpenACS For Everyone"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"> </td><th width="60%" align="center"></th><td width="20%" align="right"> <a accesskey="n" href="for-everyone.html">Next</a></td></tr></table><hr></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a name="idp140717547632592"></a>OpenACS Core Documentation</h1></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="part"><a href="for-everyone.html">I. OpenACS For Everyone</a></span></dt><dd><dl><dt><span class="chapter"><a href="general-documents.html">1. High level information: What is OpenACS?</a></span></dt><dd><dl><dt><span class="sect1"><a href="openacs-overview.html">Overview</a></span></dt><dt><span class="sect1"><a href="release-notes.html">OpenACS Release Notes</a></span></dt></dl></dd></dl></dd><dt><span class="part"><a href="acs-admin.html">II. Administrator's Guide</a></span></dt><dd><dl><dt><span class="chapter"><a href="install-overview.html">2. Installation Overview</a></span></dt><dd><dl><dt><span class="sect1"><a href="install-steps.html">Basic Steps</a></span></dt><dt><span class="sect1"><a href="individual-programs.html">Prerequisite Software</a></span></dt></dl></dd><dt><span class="chapter"><a href="complete-install.html">3. Complete Installation</a></span></dt><dd><dl><dt><span class="sect1"><a href="unix-installation.html">Install a Unix-like system and supporting software</a></span></dt><dt><span class="sect1"><a href="oracle.html">Install Oracle 8.1.7</a></span></dt><dt><span class="sect1"><a href="postgres.html">Install PostgreSQL</a></span></dt><dt><span class="sect1"><a href="aolserver4.html">Install AOLserver 4</a></span></dt><dt><span class="sect1"><a href="openacs.html">Install OpenACS 5.7.0</a></span></dt><dt><span class="sect1"><a href="win2k-installation.html">OpenACS Installation Guide for Windows2000</a></span></dt><dt><span class="sect1"><a href="mac-installation.html">OpenACS Installation Guide for Mac OS X</a></span></dt></dl></dd><dt><span class="chapter"><a href="configuring-new-site.html">4. Configuring a new OpenACS Site</a></span></dt><dd><dl><dt><span class="sect1"><a href="configuring-install-packages.html">Installing OpenACS packages</a></span></dt><dt><span class="sect1"><a href="configuring-mounting-packages.html">Mounting OpenACS packages</a></span></dt><dt><span class="sect1"><a href="configuring-configuring-packages.html">Configuring an OpenACS package</a></span></dt><dt><span class="sect1"><a href="configuring-configuring-permissions.html">Setting Permissions on an OpenACS package</a></span></dt><dt><span class="sect1"><a href="how-do-I.html">How Do I?</a></span></dt></dl></dd><dt><span class="chapter"><a href="upgrade.html">5. Upgrading</a></span></dt><dd><dl><dt><span class="sect1"><a href="upgrade-overview.html">Overview</a></span></dt><dt><span class="sect1"><a href="upgrade-4.5-to-4.6.html">Upgrading 4.5 or higher to 4.6.3</a></span></dt><dt><span class="sect1"><a href="upgrade-4.6.3-to-5.html">Upgrading OpenACS 4.6.3 to 5.0</a></span></dt><dt><span class="sect1"><a href="upgrade-5-0-dot.html">Upgrading an OpenACS 5.0.0 or greater installation</a></span></dt><dt><span class="sect1"><a href="upgrade-openacs-files.html">Upgrading the OpenACS files</a></span></dt><dt><span class="sect1"><a href="upgrade-supporting.html">Upgrading Platform components</a></span></dt></dl></dd><dt><span class="chapter"><a href="maintenance-web.html">6. Production Environments</a></span></dt><dd><dl><dt><span class="sect1"><a href="install-openacs-keepalive.html">Starting and Stopping an OpenACS instance.</a></span></dt><dt><span class="sect1"><a href="install-openacs-inittab.html">AOLserver keepalive with inittab</a></span></dt><dt><span class="sect1"><a href="install-next-add-server.html">Running multiple services on one machine</a></span></dt><dt><span class="sect1"><a href="high-avail.html">High Availability/High Performance Configurations</a></span></dt><dt><span class="sect1"><a href="maintenance-deploy.html">Staged Deployment for Production Networks</a></span></dt><dt><span class="sect1"><a href="install-ssl.html">Installing SSL Support for an OpenACS service</a></span></dt><dt><span class="sect1"><a href="analog-setup.html">Set up Log Analysis Reports</a></span></dt><dt><span class="sect1"><a href="uptime.html">External uptime validation</a></span></dt><dt><span class="sect1"><a href="maint-performance.html">Diagnosing Performance Problems</a></span></dt></dl></dd><dt><span class="chapter"><a href="database-management.html">7. Database Management</a></span></dt><dd><dl><dt><span class="sect1"><a href="remote-postgres.html">Running a PostgreSQL database on another server</a></span></dt><dt><span class="sect1"><a href="install-openacs-delete-tablespace.html">Deleting a tablespace</a></span></dt><dt><span class="sect1"><a href="install-next-nightly-vacuum.html">Vacuum Postgres nightly</a></span></dt></dl></dd><dt><span class="chapter"><a href="backup-recovery.html">8. Backup and Recovery</a></span></dt><dd><dl><dt><span class="sect1"><a href="install-next-backups.html">Backup Strategy</a></span></dt><dt><span class="sect1"><a href="snapshot-backup.html">Manual backup and recovery</a></span></dt><dt><span class="sect1"><a href="automated-backup.html">Automated Backup</a></span></dt><dt><span class="sect1"><a href="backups-with-cvs.html">Using CVS for backup-recovery</a></span></dt></dl></dd><dt><span class="appendix"><a href="install-redhat.html">A. Install Red Hat 8/9</a></span></dt><dt><span class="appendix"><a href="install-more-software.html">B. Install additional supporting software</a></span></dt><dd><dl><dt><span class="sect1"><a href="openacs-unpack.html">Unpack the OpenACS tarball</a></span></dt><dt><span class="sect1"><a href="install-cvs.html">Initialize CVS (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="psgml-for-emacs.html">Add PSGML commands to emacs init file (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="install-daemontools.html">Install Daemontools (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="install-qmail.html">Install qmail (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="analog-install.html">Install Analog web file analyzer</a></span></dt><dt><span class="sect1"><a href="install-nspam.html">Install nspam</a></span></dt><dt><span class="sect1"><a href="install-full-text-search-tsearch2.html">Install Full Text Search using Tsearch2</a></span></dt><dt><span class="sect1"><a href="install-full-text-search-openfts.html">Install Full Text Search using OpenFTS (deprecated see tsearch2)</a></span></dt><dt><span class="sect1"><a href="install-nsopenssl.html">Install nsopenssl</a></span></dt><dt><span class="sect1"><a href="install-tclwebtest.html">Install tclwebtest.</a></span></dt><dt><span class="sect1"><a href="install-php.html">Install PHP for use in AOLserver</a></span></dt><dt><span class="sect1"><a href="install-squirrelmail.html">Install Squirrelmail for use as a webmail system for OpenACS</a></span></dt><dt><span class="sect1"><a href="install-pam-radius.html">Install PAM Radius for use as external authentication</a></span></dt><dt><span class="sect1"><a href="install-ldap-radius.html">Install LDAP for use as external authentication</a></span></dt><dt><span class="sect1"><a href="aolserver.html">Install AOLserver 3.3oacs1</a></span></dt></dl></dd><dt><span class="appendix"><a href="credits.html">C. Credits</a></span></dt><dd><dl><dt><span class="section"><a href="install-origins.html">Where did this document come from?</a></span></dt><dt><span class="section"><a href="os-install.html">Linux Install Guides</a></span></dt><dt><span class="section"><a href="os-security.html">Security Information</a></span></dt><dt><span class="section"><a href="install-resources.html">Resources</a></span></dt></dl></dd></dl></dd><dt><span class="part"><a href="acs-package-dev.html">III. For OpenACS Package Developers</a></span></dt><dd><dl><dt><span class="chapter"><a href="tutorial.html">9. Development Tutorial</a></span></dt><dd><dl><dt><span class="sect1"><a href="tutorial-newpackage.html">Creating an Application Package</a></span></dt><dt><span class="sect1"><a href="tutorial-database.html">Setting Up Database Objects</a></span></dt><dt><span class="sect1"><a href="tutorial-pages.html">Creating Web Pages</a></span></dt></dl></dd><dt><span class="chapter"><a href="tutorial-advanced.html">10. Advanced Topics</a></span></dt><dd><dl><dt><span class="sect1"><a href="tutorial-specs.html">Write the Requirements and Design Specs</a></span></dt><dt><span class="sect1"><a href="tutorial-cvs.html">Add the new package to CVS</a></span></dt><dt><span class="sect1"><a href="tutorial-etp-templates.html">OpenACS Edit This Page Templates</a></span></dt><dt><span class="sect1"><a href="tutorial-comments.html">Adding Comments</a></span></dt><dt><span class="sect1"><a href="tutorial-admin-pages.html">Admin Pages</a></span></dt><dt><span class="sect1"><a href="tutorial-categories.html">Categories</a></span></dt><dt><span class="sect1"><a href="profile-code.html">Profile your code</a></span></dt><dt><span class="sect1"><a href="tutorial-distribute.html">Prepare the package for distribution.</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrades.html">Distributing upgrades of your package</a></span></dt><dt><span class="sect1"><a href="tutorial-notifications.html">Notifications</a></span></dt><dt><span class="sect1"><a href="tutorial-hierarchical.html">Hierarchical data</a></span></dt><dt><span class="sect1"><a href="tutorial-vuh.html">Using .vuh files for pretty urls</a></span></dt><dt><span class="sect1"><a href="tutorial-css-layout.html">Laying out a page with CSS instead of tables</a></span></dt><dt><span class="sect1"><a href="tutorial-html-email.html">Sending HTML email from your application</a></span></dt><dt><span class="sect1"><a href="tutorial-caching.html">Basic Caching</a></span></dt><dt><span class="sect1"><a href="tutorial-schedule-procs.html">Scheduled Procedures</a></span></dt><dt><span class="sect1"><a href="tutorial-wysiwyg-editor.html">Enabling WYSIWYG</a></span></dt><dt><span class="sect1"><a href="tutorial-parameters.html">Adding in parameters for your package</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrade-scripts.html">Writing upgrade scripts</a></span></dt><dt><span class="sect1"><a href="tutorial-second-database.html">Connect to a second database</a></span></dt><dt><span class="sect1"><a href="tutorial-future-topics.html">Future Topics</a></span></dt></dl></dd><dt><span class="chapter"><a href="dev-guide.html">11. Development Reference</a></span></dt><dd><dl><dt><span class="sect1"><a href="packages.html">OpenACS Packages</a></span></dt><dt><span class="sect1"><a href="objects.html">OpenACS Data Models and the Object System</a></span></dt><dt><span class="sect1"><a href="request-processor.html">The Request Processor</a></span></dt><dt><span class="sect1"><a href="db-api.html">The OpenACS Database Access API</a></span></dt><dt><span class="sect1"><a href="templates.html">Using Templates in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions.html">Groups, Context, Permissions</a></span></dt><dt><span class="sect1"><a href="subsites.html">Writing OpenACS Application Pages</a></span></dt><dt><span class="sect1"><a href="parties.html">Parties in OpenACS</a></span></dt><dt><span class="sect1"><a href="permissions-tediously-explained.html">OpenACS Permissions Tediously Explained</a></span></dt><dt><span class="sect1"><a href="object-identity.html">Object Identity</a></span></dt><dt><span class="sect1"><a href="programming-with-aolserver.html">Programming with AOLserver</a></span></dt></dl></dd><dt><span class="chapter"><a href="eng-standards.html">12. Engineering Standards</a></span></dt><dd><dl><dt><span class="sect1"><a href="style-guide.html">OpenACS Style Guide</a></span></dt><dt><span class="sect1"><a href="cvs-guidelines.html">
     CVS Guidelines
-  </a></span></dt><dt><span class="sect1"><a href="eng-standards-versioning.html">Release Version Numbering</a></span></dt><dt><span class="sect1"><a href="eng-standards-constraint-naming.html">Constraint naming standard</a></span></dt><dt><span class="sect1"><a href="eng-standards-filenaming.html">ACS File Naming and Formatting Standards</a></span></dt><dt><span class="sect1"><a href="eng-standards-plsql.html">PL/SQL Standards</a></span></dt><dt><span class="sect1"><a href="variables.html">Variables</a></span></dt><dt><span class="sect1"><a href="automated-testing-best-practices.html">Automated Testing</a></span></dt></dl></dd><dt><span class="chapter"><a href="doc-standards.html">13. Documentation Standards</a></span></dt><dd><dl><dt><span class="sect1"><a href="docbook-primer.html">OpenACS Documentation Guide</a></span></dt><dt><span class="sect1"><a href="psgml-mode.html">Using PSGML mode in Emacs</a></span></dt><dt><span class="sect1"><a href="nxml-mode.html">Using nXML mode in Emacs</a></span></dt><dt><span class="sect1"><a href="filename.html">Detailed Design Documentation Template</a></span></dt><dt><span class="sect1"><a href="requirements-template.html">System/Application Requirements Template</a></span></dt></dl></dd><dt><span class="chapter"><a href="i18n.html">14. Internationalization</a></span></dt><dd><dl><dt><span class="sect1"><a href="i18n-overview.html">Internationalization and Localization Overview</a></span></dt><dt><span class="sect1"><a href="i18n-introduction.html">How Internationalization/Localization works in OpenACS</a></span></dt><dt><span class="sect1"><a href="i18n-convert.html">How to Internationalize a Package</a></span></dt><dt><span class="sect1"><a href="i18n-design.html">Design Notes</a></span></dt><dt><span class="sect1"><a href="i18n-translators.html">Translator's Guide</a></span></dt></dl></dd><dt><span class="appendix"><a href="cvs-tips.html">D. Using CVS with an OpenACS Site</a></span></dt></dl></dd><dt><span class="part"><a href="acs-plat-dev.html">IV. For OpenACS Platform Developers</a></span></dt><dd><dl><dt><span class="chapter"><a href="kernel-doc.html">15. Kernel Documentation</a></span></dt><dd><dl><dt><span class="sect1"><a href="kernel-overview.html">Overview</a></span></dt><dt><span class="sect1"><a href="object-system-requirements.html">Object Model Requirements</a></span></dt><dt><span class="sect1"><a href="object-system-design.html">Object Model Design</a></span></dt><dt><span class="sect1"><a href="permissions-requirements.html">Permissions Requirements</a></span></dt><dt><span class="sect1"><a href="permissions-design.html">Permissions Design</a></span></dt><dt><span class="sect1"><a href="groups-requirements.html">Groups Requirements</a></span></dt><dt><span class="sect1"><a href="groups-design.html">Groups Design</a></span></dt><dt><span class="sect1"><a href="subsites-requirements.html">Subsites Requirements</a></span></dt><dt><span class="sect1"><a href="subsites-design.html">Subsites Design Document</a></span></dt><dt><span class="sect1"><a href="apm-requirements.html">Package Manager Requirements</a></span></dt><dt><span class="sect1"><a href="apm-design.html">Package Manager Design</a></span></dt><dt><span class="sect1"><a href="db-api-detailed.html">Database Access API</a></span></dt><dt><span class="sect1"><a href="i18n-requirements.html">OpenACS Internationalization Requirements</a></span></dt><dt><span class="sect1"><a href="security-requirements.html">Security Requirements</a></span></dt><dt><span class="sect1"><a href="security-design.html">Security Design</a></span></dt><dt><span class="sect1"><a href="security-notes.html">Security Notes</a></span></dt><dt><span class="sect1"><a href="rp-requirements.html">Request Processor Requirements</a></span></dt><dt><span class="sect1"><a href="rp-design.html">Request Processor Design</a></span></dt><dt><span class="sect1"><a href="tcl-doc.html">Documenting Tcl Files: Page Contracts and Libraries</a></span></dt><dt><span class="sect1"><a href="bootstrap-acs.html">Bootstrapping OpenACS</a></span></dt><dt><span class="sect1"><a href="ext-auth-requirements.html">External Authentication Requirements</a></span></dt></dl></dd><dt><span class="chapter"><a href="releasing-openacs.html">16. Releasing OpenACS</a></span></dt><dd><dl><dt><span class="section"><a href="releasing-openacs-core.html">OpenACS Core and .LRN</a></span></dt><dt><span class="section"><a href="update-repository.html">How to Update the OpenACS.org repository</a></span></dt><dt><span class="section"><a href="releasing-package.html">How to package and release an OpenACS Package</a></span></dt><dt><span class="section"><a href="update-translations.html">How to Update the translations</a></span></dt></dl></dd></dl></dd><dt><span class="index"><a href="ix01.html">Index</a></span></dt></dl></div><div class="list-of-figures"><p><b>List of Figures</b></p><dl><dt>4.1. <a href="how-do-I.html#idp140726694513504">Site Templates</a></dt><dt>4.2. <a href="how-do-I.html#idp140726694533984">Granting Permissions</a></dt><dt>4.3. <a href="how-do-I.html#idp140726694537312">Granting Permissions in 5.0</a></dt><dt>5.1. <a href="upgrade-overview.html#idp140726691636320">Upgrading with the APM</a></dt><dt>5.2. <a href="upgrade-openacs-files.html#idp140726694840672">Upgrading a local CVS repository</a></dt><dt>6.1. <a href="high-avail.html#idp140726695316240">Multiple-server configuration</a></dt><dt>6.2. <a href="maintenance-deploy.html#idp140726695339776">Simple A/B Deployment - Step 1</a></dt><dt>6.3. <a href="maintenance-deploy.html#idp140726695342464">Simple A/B Deployment - Step 2</a></dt><dt>6.4. <a href="maintenance-deploy.html#idp140726695345152">Simple A/B Deployment - Step 3</a></dt><dt>6.5. <a href="maintenance-deploy.html#idp140726695348608">Complex A/B Deployment - Step 1</a></dt><dt>6.6. <a href="maintenance-deploy.html#idp140726695351296">Complex A/B Deployment - Step 2</a></dt><dt>6.7. <a href="maintenance-deploy.html#idp140726695353984">Complex A/B Deployment - Step 3</a></dt><dt>6.8. <a href="maint-performance.html#idp140726695423536">Query Analysis example</a></dt><dt>8.1. <a href="backup-recovery.html#idp140726694608160">Backup and Recovery Strategy</a></dt><dt>9.1. <a href="tutorial-newpackage.html#idp140726696643408">Assumptions in this section</a></dt><dt>9.2. <a href="tutorial-database.html#idp140726688727968">Tutorial Data Model</a></dt><dt>9.3. <a href="tutorial-database.html#idp140726690600144">The Database Creation Script</a></dt><dt>9.4. <a href="tutorial-database.html#idp140726689099568">Database Deletion Script</a></dt><dt>9.5. <a href="tutorial-pages.html#idp140726698448720">Page Map</a></dt><dt>10.1. <a href="tutorial-cvs.html#idp140726695097200">Upgrading a local CVS repository</a></dt><dt>11.1. <a href="packages.html#idp140726690686304">Server file layout diagram</a></dt><dt>11.2. <a href="packages.html#idp140726699564432">Package file layout diagram</a></dt></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>2.1. <a href="install-steps.html#idp140726692957968">Default directories for a standard install</a></dt><dt>2.2. <a href="individual-programs.html#compatibility-matrix">Version Compatibility Matrix</a></dt><dt>5.1. <a href="upgrade-overview.html#idp140726694731168">Assumptions in this section</a></dt><dt>6.1. <a href="install-openacs-keepalive.html#idp140726695243776">How it Works</a></dt><dt>10.1. <a href="tutorial-etp-templates.html#idp140726693435296">table showing ETP layout</a></dt><dt>11.1. <a href="packages.html#idp140726698138576">Package files</a></dt><dt>11.2. <a href="permissions-tediously-explained.html#idp140726692474656">Context Hierarchy Example</a></dt><dt>11.3. <a href="permissions-tediously-explained.html#idp140726691953632">acs_objects example data</a></dt><dt>14.1. <a href="i18n-overview.html#i18n-l10n-process">Internationalization and Localization Overview</a></dt></dl></div><div class="list-of-examples"><p><b>List of Examples</b></p><dl><dt>12.1. <a href="variables.html#idp140726695125520">Getting datetime from the database ANSI-style</a></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"></td><td width="40%" align="right"> <a accesskey="n" href="for-everyone.html">Next</a></td></tr><tr><td width="40%" align="left"> </td><td width="20%" align="center"></td><td width="40%" align="right"> Part I. OpenACS For Everyone</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/index.html#comments">View comments on this page at openacs.org</a></center></body></html>
+  </a></span></dt><dt><span class="sect1"><a href="eng-standards-versioning.html">Release Version Numbering</a></span></dt><dt><span class="sect1"><a href="eng-standards-constraint-naming.html">Constraint naming standard</a></span></dt><dt><span class="sect1"><a href="eng-standards-filenaming.html">ACS File Naming and Formatting Standards</a></span></dt><dt><span class="sect1"><a href="eng-standards-plsql.html">PL/SQL Standards</a></span></dt><dt><span class="sect1"><a href="variables.html">Variables</a></span></dt><dt><span class="sect1"><a href="automated-testing-best-practices.html">Automated Testing</a></span></dt></dl></dd><dt><span class="chapter"><a href="doc-standards.html">13. Documentation Standards</a></span></dt><dd><dl><dt><span class="sect1"><a href="docbook-primer.html">OpenACS Documentation Guide</a></span></dt><dt><span class="sect1"><a href="psgml-mode.html">Using PSGML mode in Emacs</a></span></dt><dt><span class="sect1"><a href="nxml-mode.html">Using nXML mode in Emacs</a></span></dt><dt><span class="sect1"><a href="filename.html">Detailed Design Documentation Template</a></span></dt><dt><span class="sect1"><a href="requirements-template.html">System/Application Requirements Template</a></span></dt></dl></dd><dt><span class="chapter"><a href="i18n.html">14. Internationalization</a></span></dt><dd><dl><dt><span class="sect1"><a href="i18n-overview.html">Internationalization and Localization Overview</a></span></dt><dt><span class="sect1"><a href="i18n-introduction.html">How Internationalization/Localization works in OpenACS</a></span></dt><dt><span class="sect1"><a href="i18n-convert.html">How to Internationalize a Package</a></span></dt><dt><span class="sect1"><a href="i18n-design.html">Design Notes</a></span></dt><dt><span class="sect1"><a href="i18n-translators.html">Translator's Guide</a></span></dt></dl></dd><dt><span class="appendix"><a href="cvs-tips.html">D. Using CVS with an OpenACS Site</a></span></dt></dl></dd><dt><span class="part"><a href="acs-plat-dev.html">IV. For OpenACS Platform Developers</a></span></dt><dd><dl><dt><span class="chapter"><a href="kernel-doc.html">15. Kernel Documentation</a></span></dt><dd><dl><dt><span class="sect1"><a href="kernel-overview.html">Overview</a></span></dt><dt><span class="sect1"><a href="object-system-requirements.html">Object Model Requirements</a></span></dt><dt><span class="sect1"><a href="object-system-design.html">Object Model Design</a></span></dt><dt><span class="sect1"><a href="permissions-requirements.html">Permissions Requirements</a></span></dt><dt><span class="sect1"><a href="permissions-design.html">Permissions Design</a></span></dt><dt><span class="sect1"><a href="groups-requirements.html">Groups Requirements</a></span></dt><dt><span class="sect1"><a href="groups-design.html">Groups Design</a></span></dt><dt><span class="sect1"><a href="subsites-requirements.html">Subsites Requirements</a></span></dt><dt><span class="sect1"><a href="subsites-design.html">Subsites Design Document</a></span></dt><dt><span class="sect1"><a href="apm-requirements.html">Package Manager Requirements</a></span></dt><dt><span class="sect1"><a href="apm-design.html">Package Manager Design</a></span></dt><dt><span class="sect1"><a href="db-api-detailed.html">Database Access API</a></span></dt><dt><span class="sect1"><a href="i18n-requirements.html">OpenACS Internationalization Requirements</a></span></dt><dt><span class="sect1"><a href="security-requirements.html">Security Requirements</a></span></dt><dt><span class="sect1"><a href="security-design.html">Security Design</a></span></dt><dt><span class="sect1"><a href="security-notes.html">Security Notes</a></span></dt><dt><span class="sect1"><a href="rp-requirements.html">Request Processor Requirements</a></span></dt><dt><span class="sect1"><a href="rp-design.html">Request Processor Design</a></span></dt><dt><span class="sect1"><a href="tcl-doc.html">Documenting Tcl Files: Page Contracts and Libraries</a></span></dt><dt><span class="sect1"><a href="bootstrap-acs.html">Bootstrapping OpenACS</a></span></dt><dt><span class="sect1"><a href="ext-auth-requirements.html">External Authentication Requirements</a></span></dt></dl></dd><dt><span class="chapter"><a href="releasing-openacs.html">16. Releasing OpenACS</a></span></dt><dd><dl><dt><span class="section"><a href="releasing-openacs-core.html">OpenACS Core and .LRN</a></span></dt><dt><span class="section"><a href="update-repository.html">How to Update the OpenACS.org repository</a></span></dt><dt><span class="section"><a href="releasing-package.html">How to package and release an OpenACS Package</a></span></dt><dt><span class="section"><a href="update-translations.html">How to Update the translations</a></span></dt></dl></dd></dl></dd><dt><span class="index"><a href="ix01.html">Index</a></span></dt></dl></div><div class="list-of-figures"><p><b>List of Figures</b></p><dl><dt>4.1. <a href="how-do-I.html#idp140717557796112">Site Templates</a></dt><dt>4.2. <a href="how-do-I.html#idp140717557816592">Granting Permissions</a></dt><dt>4.3. <a href="how-do-I.html#idp140717557820208">Granting Permissions in 5.0</a></dt><dt>5.1. <a href="upgrade-overview.html#idp140717556838416">Upgrading with the APM</a></dt><dt>5.2. <a href="upgrade-openacs-files.html#idp140717558119968">Upgrading a local CVS repository</a></dt><dt>6.1. <a href="high-avail.html#idp140717558399040">Multiple-server configuration</a></dt><dt>6.2. <a href="maintenance-deploy.html#idp140717558422640">Simple A/B Deployment - Step 1</a></dt><dt>6.3. <a href="maintenance-deploy.html#idp140717558425328">Simple A/B Deployment - Step 2</a></dt><dt>6.4. <a href="maintenance-deploy.html#idp140717558428016">Simple A/B Deployment - Step 3</a></dt><dt>6.5. <a href="maintenance-deploy.html#idp140717558431472">Complex A/B Deployment - Step 1</a></dt><dt>6.6. <a href="maintenance-deploy.html#idp140717558434160">Complex A/B Deployment - Step 2</a></dt><dt>6.7. <a href="maintenance-deploy.html#idp140717558436848">Complex A/B Deployment - Step 3</a></dt><dt>6.8. <a href="maint-performance.html#idp140717558506400">Query Analysis example</a></dt><dt>8.1. <a href="backup-recovery.html#idp140717553999872">Backup and Recovery Strategy</a></dt><dt>9.1. <a href="tutorial-newpackage.html#idp140717559847248">Assumptions in this section</a></dt><dt>9.2. <a href="tutorial-database.html#idp140717552745104">Tutorial Data Model</a></dt><dt>9.3. <a href="tutorial-database.html#idp140717555906896">The Database Creation Script</a></dt><dt>9.4. <a href="tutorial-database.html#idp140717557395744">Database Deletion Script</a></dt><dt>9.5. <a href="tutorial-pages.html#idp140717560509488">Page Map</a></dt><dt>10.1. <a href="tutorial-cvs.html#idp140717562296240">Upgrading a local CVS repository</a></dt><dt>11.1. <a href="packages.html#idp140717560098832">Server file layout diagram</a></dt><dt>11.2. <a href="packages.html#idp140717560263104">Package file layout diagram</a></dt></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>2.1. <a href="install-steps.html#idp140717556272912">Default directories for a standard install</a></dt><dt>2.2. <a href="individual-programs.html#compatibility-matrix">Version Compatibility Matrix</a></dt><dt>5.1. <a href="upgrade-overview.html#idp140717558009040">Assumptions in this section</a></dt><dt>6.1. <a href="install-openacs-keepalive.html#idp140717558342832">How it Works</a></dt><dt>10.1. <a href="tutorial-etp-templates.html#idp140717562326464">table showing ETP layout</a></dt><dt>11.1. <a href="packages.html#idp140717563054368">Package files</a></dt><dt>11.2. <a href="permissions-tediously-explained.html#idp140717554704112">Context Hierarchy Example</a></dt><dt>11.3. <a href="permissions-tediously-explained.html#idp140717553040016">acs_objects example data</a></dt><dt>14.1. <a href="i18n-overview.html#i18n-l10n-process">Internationalization and Localization Overview</a></dt></dl></div><div class="list-of-examples"><p><b>List of Examples</b></p><dl><dt>12.1. <a href="variables.html#idp140717563967264">Getting datetime from the database ANSI-style</a></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"></td><td width="40%" align="right"> <a accesskey="n" href="for-everyone.html">Next</a></td></tr><tr><td width="40%" align="left"> </td><td width="20%" align="center"></td><td width="40%" align="right"> Part I. OpenACS For Everyone</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/index.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/individual-programs.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/individual-programs.html,v
diff -u -N -r1.32.2.2 -r1.32.2.3
--- openacs-4/packages/acs-core-docs/www/individual-programs.html	9 Sep 2014 08:31:55 -0000	1.32.2.2
+++ openacs-4/packages/acs-core-docs/www/individual-programs.html	24 Oct 2014 14:33:54 -0000	1.32.2.3
@@ -36,10 +36,10 @@
               whereas on BSD distributions,
               <code class="computeroutput">make</code> and
               <code class="computeroutput">gmake</code> are
-              different --use gmake.</p></li></ul></div></li><li class="listitem"><p><b><a class="ulink" href="http://www.tcl.tk/" target="_top">Tcl</a> 8.4.x. </b></p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p><b><a class="ulink" href="http://www.tcl.tk/" target="_top">Tcl</a> 8.5.x, REQUIRED. </b>OpenACS is written in Tcl, an interpreted
+              different --use gmake.</p></li></ul></div></li><li class="listitem"><p><b><a class="ulink" href="http://www.tcl.tk/" target="_top">Tcl</a> 8.5.x. </b></p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p><b><a class="ulink" href="http://www.tcl.tk/" target="_top">Tcl</a> 8.5.x, REQUIRED. </b>OpenACS is written in Tcl, an interpreted
               language.  A threaded version of the Tcl interpreter must be installed for
               OpenACS to work.  The Tcl interpreter that is included in most standard
-              distributions may not be thread safe.  </p></li><li class="listitem"><p><b><a class="ulink" href="http://www.tcl.tk/" target="_top">TCL</a> 8.5.x development headers and libraries, OPTIONAL. </b>  The site-wide-search service, OpenFTS, requires these to
+              distributions may not be thread safe.  </p></li><li class="listitem"><p><b><a class="ulink" href="http://www.tcl.tk/" target="_top">Tcl</a> 8.5.x development headers and libraries, OPTIONAL. </b>  The site-wide-search service, OpenFTS, requires these to
               compile. (Debian users: <code class="computeroutput">apt-get install
                 tcl8.5-dev</code>).  You need this
               to install OpenFTS.</p></li></ul></div></li><li class="listitem"><a name="source-tcllib"></a><p><b><a class="ulink" href="http://tcllib.sourceforge.net/" target="_top">Tcllib</a>, REQUIRED. </b>
Index: openacs-4/packages/acs-core-docs/www/install-cvs.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-cvs.html,v
diff -u -N -r1.39.2.1 -r1.39.2.2
--- openacs-4/packages/acs-core-docs/www/install-cvs.html	21 Aug 2013 10:19:23 -0000	1.39.2.1
+++ openacs-4/packages/acs-core-docs/www/install-cvs.html	24 Oct 2014 14:33:55 -0000	1.39.2.2
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Initialize CVS (OPTIONAL)</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="install-more-software.html" title="Appendix B. Install additional supporting software"><link rel="previous" href="openacs-unpack.html" title="Unpack the OpenACS tarball"><link rel="next" href="psgml-for-emacs.html" title="Add PSGML commands to emacs init file (OPTIONAL)"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="openacs-unpack.html">Prev</a> </td><th width="60%" align="center">Appendix B. Install additional supporting software</th><td width="20%" align="right"> <a accesskey="n" href="psgml-for-emacs.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="install-cvs"></a>Initialize CVS (OPTIONAL)</h2></div></div></div><a class="indexterm" name="idp140726690549152"></a><p>CVS is a source control system.  Create and initialize a
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Initialize CVS (OPTIONAL)</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="install-more-software.html" title="Appendix B. Install additional supporting software"><link rel="previous" href="openacs-unpack.html" title="Unpack the OpenACS tarball"><link rel="next" href="psgml-for-emacs.html" title="Add PSGML commands to emacs init file (OPTIONAL)"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="openacs-unpack.html">Prev</a> </td><th width="60%" align="center">Appendix B. Install additional supporting software</th><td width="20%" align="right"> <a accesskey="n" href="psgml-for-emacs.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="install-cvs"></a>Initialize CVS (OPTIONAL)</h2></div></div></div><a class="indexterm" name="idp140717556754496"></a><p>CVS is a source control system.  Create and initialize a
       directory for a local cvs repository.</p><pre class="screen">[root tmp]# <strong class="userinput"><code>mkdir /cvsroot</code></strong>
 [root tmp]#<strong class="userinput"><code> cvs -d /cvsroot init</code></strong>
 [root tmp]#
Index: openacs-4/packages/acs-core-docs/www/install-daemontools.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-daemontools.html,v
diff -u -N -r1.40.2.1 -r1.40.2.2
--- openacs-4/packages/acs-core-docs/www/install-daemontools.html	21 Aug 2013 10:19:23 -0000	1.40.2.1
+++ openacs-4/packages/acs-core-docs/www/install-daemontools.html	24 Oct 2014 14:33:55 -0000	1.40.2.2
@@ -4,7 +4,7 @@
       installed in /package.  These commands install daemontools and
       svgroup.  svgroup is a script for granting permissions, to allow
       users other than root to use daemontools for specific
-      services.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Install Daemontools</p><a class="indexterm" name="idp140726699986448"></a><p><a class="link" href="individual-programs.html#daemontools-download">download daemontools</a> and install it.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Red Hat 8</p><pre class="screen">[root root]# <strong class="userinput"><code>mkdir -p /package</code></strong>
+      services.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Install Daemontools</p><a class="indexterm" name="idp140717562702976"></a><p><a class="link" href="individual-programs.html#daemontools-download">download daemontools</a> and install it.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Red Hat 8</p><pre class="screen">[root root]# <strong class="userinput"><code>mkdir -p /package</code></strong>
 [root root]# <strong class="userinput"><code>chmod 1755 /package/</code></strong>
 [root root]# <strong class="userinput"><code>cd /package/</code></strong>
 [root package]# <strong class="userinput"><code>tar xzf /tmp/daemontools-0.76.tar.gz</code></strong>
Index: openacs-4/packages/acs-core-docs/www/install-full-text-search-openfts.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-full-text-search-openfts.html,v
diff -u -N -r1.10.2.1 -r1.10.2.2
--- openacs-4/packages/acs-core-docs/www/install-full-text-search-openfts.html	21 Aug 2013 10:19:23 -0000	1.10.2.1
+++ openacs-4/packages/acs-core-docs/www/install-full-text-search-openfts.html	24 Oct 2014 14:33:55 -0000	1.10.2.2
@@ -6,7 +6,7 @@
       Tsearch2. See 
       <a class="xref" href="install-full-text-search-tsearch2.html" title="Install Full Text Search using Tsearch2">Install       Full Text Search using Tsearch2</a>. Tsearch2 is much easier to install, requiring only
       compilation of one module from PostgreSQL contrib, with an
-      automated install process using the tsearch2-driver package.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="install-openfts"></a>Install OpenFTS module</h3></div></div></div><a class="indexterm" name="idp140726698804480"></a><p>If you want full text search, and you are running PostgreSQL, install this module to support FTS.  Do this step after you have installed both PostgreSQL and
+      automated install process using the tsearch2-driver package.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="install-openfts"></a>Install OpenFTS module</h3></div></div></div><a class="indexterm" name="idp140717562186432"></a><p>If you want full text search, and you are running PostgreSQL, install this module to support FTS.  Do this step after you have installed both PostgreSQL and
       AOLserver.  You will need the <a class="link" href="individual-programs.html#openfts-download">openfts
       tarball</a> in <code class="computeroutput">/tmp</code>.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Install Tsearch.  This is a PostgreSQL module that
 	  OpenFTS requires.</p><pre class="screen">[root root]# <strong class="userinput"><code>su - postgres</code></strong>
@@ -81,7 +81,7 @@
 make
 su postgres
 make install
-exit</span></span></pre></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="install-openfts-postgres"></a>Install OpenFTS prerequisites in PostgreSQL instance</h3></div></div></div><a class="indexterm" name="idp140726698356368"></a><p>If you are installing Full Text Search, add required
+exit</span></span></pre></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="install-openfts-postgres"></a>Install OpenFTS prerequisites in PostgreSQL instance</h3></div></div></div><a class="indexterm" name="idp140717562809904"></a><p>If you are installing Full Text Search, add required
         packages to the new database.  (In order for full text search
         to work, you must also <a class="link" href="install-full-text-search-openfts.html#install-openfts" title="Install OpenFTS module">install</a> the PostgreSQL
         OpenFTS module and prerequisites.)</p><pre class="screen">[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ <strong class="userinput"><code>/usr/local/pgsql/bin/psql <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span> -f /usr/local/src/postgresql-7.3.4/contrib/tsearch/tsearch.sql</code></strong>
Index: openacs-4/packages/acs-core-docs/www/install-full-text-search-tsearch2.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-full-text-search-tsearch2.html,v
diff -u -N -r1.10.2.1 -r1.10.2.2
--- openacs-4/packages/acs-core-docs/www/install-full-text-search-tsearch2.html	21 Aug 2013 10:19:23 -0000	1.10.2.1
+++ openacs-4/packages/acs-core-docs/www/install-full-text-search-tsearch2.html	24 Oct 2014 14:33:55 -0000	1.10.2.2
@@ -6,7 +6,7 @@
       V2 Introduction by Andrew J. Kopciuch</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="install-tsearch2"></a>Install Tsearch2 module</h3></div></div></div><a class="indexterm" name="idp140726699059856"></a><p>If you want full text search, and you are running PostgreSQL, install this module to support FTS.  Do this step after you have installed both PostgreSQL and
+        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="install-tsearch2"></a>Install Tsearch2 module</h3></div></div></div><a class="indexterm" name="idp140717562494192"></a><p>If you want full text search, and you are running PostgreSQL, install this module to support FTS.  Do this step after you have installed both PostgreSQL and
       AOLserver.  You will need the tseach2 module form PostgreSQL
       contrib. This is included with the PostgreSQL full source
       distribution. It is also available with the PostgreSQL contrib
Index: openacs-4/packages/acs-core-docs/www/install-openacs-keepalive.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-openacs-keepalive.html,v
diff -u -N -r1.23.2.1 -r1.23.2.2
--- openacs-4/packages/acs-core-docs/www/install-openacs-keepalive.html	21 Aug 2013 10:19:24 -0000	1.23.2.1
+++ openacs-4/packages/acs-core-docs/www/install-openacs-keepalive.html	24 Oct 2014 14:33:55 -0000	1.23.2.2
@@ -64,6 +64,6 @@
 
         Most of this information comes from Tom Jackson's <a class="ulink" href="http://zmbh.com/daemontools-aolserver/daemontools-aolserver.html" target="_top">AOLserver+Daemontools
           Mini-HOWTO</a>.
-</p></li></ol></div><div class="table"><a name="idp140726695243776"></a><p class="title"><b>Table 6.1. How it Works</b></p><div class="table-contents"><table summary="How it Works" cellspacing="0" border="1"><colgroup><col><col><col><col><col><col></colgroup><thead><tr><th align="center">Program</th><th align="center">Invoked by this program ...</th><th align="center">... using this file</th><th align="center">Where to find errors</th><th align="center">Log goes to</th><th align="center">Use these commands to control it</th></tr></thead><tbody><tr><td align="center">svscanboot
+</p></li></ol></div><div class="table"><a name="idp140717558342832"></a><p class="title"><b>Table 6.1. How it Works</b></p><div class="table-contents"><table summary="How it Works" cellspacing="0" border="1"><colgroup><col><col><col><col><col><col></colgroup><thead><tr><th align="center">Program</th><th align="center">Invoked by this program ...</th><th align="center">... using this file</th><th align="center">Where to find errors</th><th align="center">Log goes to</th><th align="center">Use these commands to control it</th></tr></thead><tbody><tr><td align="center">svscanboot
       </td><td align="center">init</td><td align="center">/etc/inittab</td><td align="center">ps -auxw | grep readproctitle</td><td align="center">n/a</td><td align="center"> </td></tr><tr><td align="center">aolserver</td><td align="center"><code class="computeroutput"></code>supervise
 (a child of svscanboot)</td><td align="center">/service/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/run</td><td align="center">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/log/error.log</td><td align="center">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/log/$OPENACS_SERVICE_NAME.log</td><td align="center">svc -k /service/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td align="center">postgresql</td><td align="center">Redhat init scripts during boot</td><td align="center">/etc/init.d/postgresql</td><td align="center">/usr/local/pgsql/data/server.log</td><td align="center"> </td><td align="center">service postgresql start (Red Hat), /etc/init.d/postgresql start (Debian)</td></tr></tbody></table></div></div><br class="table-break"></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="maintenance-web.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="install-openacs-inittab.html">Next</a></td></tr><tr><td width="40%" align="left">Chapter 6. Production Environments </td><td width="20%" align="center"><a accesskey="u" href="maintenance-web.html">Up</a></td><td width="40%" align="right"> AOLserver keepalive with inittab</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/install-openacs-keepalive.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/install-qmail.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-qmail.html,v
diff -u -N -r1.40.2.1 -r1.40.2.2
--- openacs-4/packages/acs-core-docs/www/install-qmail.html	21 Aug 2013 10:19:25 -0000	1.40.2.1
+++ openacs-4/packages/acs-core-docs/www/install-qmail.html	24 Oct 2014 14:33:55 -0000	1.40.2.2
@@ -30,7 +30,7 @@
 tcpserver: usage: tcpserver [ -1UXpPhHrRoOdDqQv ] [ -c limit ] [ -x rules.cdb ] [ -B banner ] [ -g gid ] [ -u uid
 ] [ -b backlog ] [ -l localname ] [ -t timeout ] host port program
 [root ucspi-tcp-0.88]#
-</pre><p><a class="indexterm" name="idp140726700037056"></a>
+</pre><p><a class="indexterm" name="idp140717563462832"></a>
 (I'm not sure if this next step is 100% necessary, but when I skip it
 I get problems.  If you get the error <code class="computeroutput">553 sorry, that domain isn't in my list of allowed rcpthosts (#5.7.1)</code> then you need to do this.)  AOLserver sends outgoing mail via the ns_sendmail
 command, which pipes a command to the sendmail executable.  Or, in our
@@ -44,7 +44,7 @@
 send outgoing mail.</p><pre class="screen">[root ucspi-tcp-0.88]# <strong class="userinput"><code>cp /tmp/openacs-5.7.0/packages/acs-core-docs/www/files/tcp.smtp.txt /etc/tcp.smtp</code></strong>
 [root ucspi-tcp-0.88]# <strong class="userinput"><code>tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp &lt; /etc/tcp.smtp</code></strong>
 <span class="action"><span class="action">cp /tmp/openacs-5.7.0/packages/acs-core-docs/www/files/tcp.smtp.txt /etc/tcp.smtp 
-tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp &lt; /etc/tcp.smtp </span></span></pre></li><li class="listitem"><p><b>Install Qmail. </b><a class="indexterm" name="idp140726700043520"></a></p><p><a class="link" href="individual-programs.html#ucspi-download" title="ucspi-tcp 0.88, OPTIONAL">Download qmail</a>,
+tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp &lt; /etc/tcp.smtp </span></span></pre></li><li class="listitem"><p><b>Install Qmail. </b><a class="indexterm" name="idp140717563469296"></a></p><p><a class="link" href="individual-programs.html#ucspi-download" title="ucspi-tcp 0.88, OPTIONAL">Download qmail</a>,
             set up the standard supporting users and build the binaries:</p><pre class="screen">[root root]# <strong class="userinput"><code>cd /usr/local/src</code></strong>
 [root src]# <strong class="userinput"><code>wget http://www.qmail.org/netqmail-1.04.tar.gz</code></strong>
 [root src]# <strong class="userinput"><code>tar xzf netqmail-1.04.tar.gz</code></strong>
@@ -103,7 +103,7 @@
 cd netqmail-1.04
 ./collate.sh
 cd netqmail-1.04
-make setup check</span></span></pre><p>Replace sendmail with qmail's wrapper.</p><a class="indexterm" name="idp140726700059728"></a><pre class="screen">[root qmail-1.03]# <strong class="userinput"><code>rm -f /usr/bin/sendmail /usr/sbin/sendmail</code></strong>
+make setup check</span></span></pre><p>Replace sendmail with qmail's wrapper.</p><a class="indexterm" name="idp140717563485504"></a><pre class="screen">[root qmail-1.03]# <strong class="userinput"><code>rm -f /usr/bin/sendmail /usr/sbin/sendmail</code></strong>
 [root qmail-1.03]# <strong class="userinput"><code>ln -s /var/qmail/bin/sendmail /usr/sbin/sendmail</code></strong>
 [root qmail-1.03]#
 <span class="action"><span class="action">rm -f /usr/bin/sendmail /usr/sbin/sendmail
@@ -125,7 +125,7 @@
 <span class="action"><span class="action">cd ~alias; touch .qmail-postmaster .qmail-mailer-daemon .qmail-root 
 chmod 644 ~alias/.qmail* 
 /var/qmail/bin/maildirmake ~alias/Maildir/ 
-chown -R alias.nofiles /var/qmail/alias/Maildir</span></span></pre><a class="indexterm" name="idp140726698978512"></a><p>Configure qmail to use the Maildir delivery format
+chown -R alias.nofiles /var/qmail/alias/Maildir</span></span></pre><a class="indexterm" name="idp140717563498592"></a><p>Configure qmail to use the Maildir delivery format
           (instead of mbox), and install a version of the qmail startup script modified to use Maildir.</p><pre class="screen">[root alias]# <strong class="userinput"><code>echo "./Maildir" &gt; /var/qmail/bin/.qmail</code></strong>
 [root alias]# <strong class="userinput"><code>cp /tmp/openacs-5.7.0/packages/acs-core-docs/www/files/qmail.rc.txt /var/qmail/rc</code></strong>
 [root alias]# <strong class="userinput"><code>chmod 755 /var/qmail/rc</code></strong>
Index: openacs-4/packages/acs-core-docs/www/install-redhat.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-redhat.html,v
diff -u -N -r1.40.2.1 -r1.40.2.2
--- openacs-4/packages/acs-core-docs/www/install-redhat.html	21 Aug 2013 10:19:25 -0000	1.40.2.1
+++ openacs-4/packages/acs-core-docs/www/install-redhat.html	24 Oct 2014 14:33:56 -0000	1.40.2.2
@@ -27,7 +27,7 @@
 	</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><a name="install-first-step"></a>Unplug the network cable from your
           computer.  We don't want to connect to the network
           until we're sure the computer is secure.  
-           <a class="indexterm" name="idp140726691359200"></a>
+           <a class="indexterm" name="idp140717558694016"></a>
   (Wherever you see
           the word secure, you should always read it as, "secure
           enough for our purposes, given the amount of work we're
@@ -55,7 +55,7 @@
 <code class="computeroutput"><span class="guilabel"><span class="guilabel">Re<u><span class="accel">v</span></u>iew (and modify if needed) the partitions created</span></span></code> and click <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">N</span></u>ext</span></span></code></p></li><li class="listitem"><p>On the pop-up window asking "Are you sure
 	  you want to do this?" click
 	  <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">Y</span></u>es</span></span></code>
-	  IF YOU ARE WIPING YOUR HARD DRIVE.</p></li><li class="listitem"><p>Click <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">N</span></u>ext</span></span></code> on the boot loader screen</p></li></ol></div></li><li class="listitem"><p>Configure Networking.  <a class="indexterm" name="idp140726689648240"></a>
+	  IF YOU ARE WIPING YOUR HARD DRIVE.</p></li><li class="listitem"><p>Click <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">N</span></u>ext</span></span></code> on the boot loader screen</p></li></ol></div></li><li class="listitem"><p>Configure Networking.  <a class="indexterm" name="idp140717558718656"></a>
 Again, if you know what you're doing, do this step
           yourself, being sure to note the firewall holes. Otherwise,
           follow the instructions in this step to set up a computer directly connected to the internet with a dedicated IP address.</p><div class="orderedlist"><ol class="orderedlist" type="a"><li class="listitem"><p>DHCP is a system by which a computer that
@@ -76,7 +76,7 @@
 <code class="computeroutput"><span class="guilabel"><span class="guilabel">Mail (SMTP)</span></span></code>.  In the <code class="computeroutput"><span class="guilabel"><span class="guilabel">Other <u><span class="accel">p</span></u>orts</span></span></code>
 box, enter <strong class="userinput"><code>443, 8000, 8443</code></strong>.  Click
 <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">N</span></u>ext</span></span></code>.
-Port 443 is for https (http over ssl), and 8000 and 8443 are http and https access to the development server we'll be setting up.</p></li></ol></div></li><li class="listitem"><p><a class="indexterm" name="idp140726693102608"></a>Select any additional languages you want the
+Port 443 is for https (http over ssl), and 8000 and 8443 are http and https access to the development server we'll be setting up.</p></li></ol></div></li><li class="listitem"><p><a class="indexterm" name="idp140717558736336"></a>Select any additional languages you want the
 	  computer to support and then click
 	  <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">N</span></u>ext</span></span></code></p></li><li class="listitem"><p>Choose your time zone and click <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">N</span></u>ext</span></span></code>.</p></li><li class="listitem"><p>Type in a root
 password, twice.</p></li><li class="listitem"><p>On the Package selection page, we're going to
@@ -88,13 +88,13 @@
 risk that's still screened by the firewall, or a resource hog.  Just
 don't install a database or web server, because that would conflict
 with the database and web server we'll install later.
-</p><table border="0" summary="Simple list" class="simplelist"><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">Editors</span></span></code> (this installs emacs<a class="indexterm" name="idp140726690625280"></a>),</td></tr><tr><td>click <code class="computeroutput"><span class="guilabel"><span class="guilabel">Details</span></span></code> next to <code class="computeroutput"><span class="guilabel"><span class="guilabel">Text-based Internet</span></span></code>, check <code class="computeroutput"><span class="guilabel"><span class="guilabel">lynx</span></span></code>, and click <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">O</span></u>K</span></span></code>;</td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">Authoring and Publishing</span></span></code> (<a class="indexterm" name="idp140726691233376"></a>this installs docbook),</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">Server Configuration Tools</span></span></code>,</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">Web Server</span></span></code>,</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">Windows File Server</span></span></code>,</td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">SQL Database Server</span></span></code> (this installs PostgreSQL),</td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">Development Tools</span></span></code> (this installs gmake and other build tools),</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">Administration Tools</span></span></code>, and</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">Printing Support</span></span></code>.</td></tr></table><p>At the bottom, check <code class="computeroutput"><span class="guilabel"><span class="guilabel"><u><span class="accel">S</span></u>elect Individual Packages</span></span></code> and click <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">N</span></u>ext</span></span></code></p></li><li class="listitem"><p>We need to fine-tune the exact list of packages.
+</p><table border="0" summary="Simple list" class="simplelist"><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">Editors</span></span></code> (this installs emacs<a class="indexterm" name="idp140717558744064"></a>),</td></tr><tr><td>click <code class="computeroutput"><span class="guilabel"><span class="guilabel">Details</span></span></code> next to <code class="computeroutput"><span class="guilabel"><span class="guilabel">Text-based Internet</span></span></code>, check <code class="computeroutput"><span class="guilabel"><span class="guilabel">lynx</span></span></code>, and click <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">O</span></u>K</span></span></code>;</td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">Authoring and Publishing</span></span></code> (<a class="indexterm" name="idp140717558750880"></a>this installs docbook),</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">Server Configuration Tools</span></span></code>,</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">Web Server</span></span></code>,</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">Windows File Server</span></span></code>,</td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">SQL Database Server</span></span></code> (this installs PostgreSQL),</td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">Development Tools</span></span></code> (this installs gmake and other build tools),</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">Administration Tools</span></span></code>, and</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">Printing Support</span></span></code>.</td></tr></table><p>At the bottom, check <code class="computeroutput"><span class="guilabel"><span class="guilabel"><u><span class="accel">S</span></u>elect Individual Packages</span></span></code> and click <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">N</span></u>ext</span></span></code></p></li><li class="listitem"><p>We need to fine-tune the exact list of packages.
 The same rules apply as in the last step - you can add more stuff, but
 you shouldn't remove anything the guide adds.  We're going to go
 through all the packages in one big list, so select
 <code class="computeroutput"><span class="guilabel"><span class="guilabel"><u><span class="accel">F</span></u>lat
 View</span></span></code> and wait. In a minute, a
-list of packages will appear.</p><table border="0" summary="Simple list" class="simplelist"><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">apmd</span></span></code> (monitors power, not very useful for servers), </td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">ImageMagick</span></span></code> (required for the <a class="indexterm" name="idp140726695458016"></a>photo-album packages, </td></tr><tr><td>uncheck<code class="computeroutput"><span class="guilabel"><span class="guilabel">isdn4k-utils</span></span></code> (unless you are using isdn, this installs a useless daemon), </td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">mutt</span></span></code> (a mail program that reads Maildir),</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">nfs-utils</span></span></code> (nfs is a major security risk), </td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">pam-devel</span></span></code> (I don't remember why, but we don't want this), </td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">portmap</span></span></code>, </td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">postfix</span></span></code> (this is an MTA, but we're going to install qmail later), </td></tr><tr><td>check  <code class="computeroutput"><span class="guilabel"><span class="guilabel">postgresql-devel</span></span></code>,</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">rsh</span></span></code> (rsh is a security hole), </td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">sendmail</span></span></code> (sendmail is an insecure MTA; we're going to install qmail instead later),</td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">tcl</span></span></code> (we need tcl), and </td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">xinetd</span></span></code> (xinetd handles incoming tcp connections.  We'll install a different, more secure program, ucspi-tcp).</td></tr><tr><td>Click <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">N</span></u>ext</span></span></code></td></tr></table></li><li class="listitem"><p>Red Hat isn't completely happy with the combination
+list of packages will appear.</p><table border="0" summary="Simple list" class="simplelist"><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">apmd</span></span></code> (monitors power, not very useful for servers), </td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">ImageMagick</span></span></code> (required for the <a class="indexterm" name="idp140717558769360"></a>photo-album packages, </td></tr><tr><td>uncheck<code class="computeroutput"><span class="guilabel"><span class="guilabel">isdn4k-utils</span></span></code> (unless you are using isdn, this installs a useless daemon), </td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">mutt</span></span></code> (a mail program that reads Maildir),</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">nfs-utils</span></span></code> (nfs is a major security risk), </td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">pam-devel</span></span></code> (I don't remember why, but we don't want this), </td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">portmap</span></span></code>, </td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">postfix</span></span></code> (this is an MTA, but we're going to install qmail later), </td></tr><tr><td>check  <code class="computeroutput"><span class="guilabel"><span class="guilabel">postgresql-devel</span></span></code>,</td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">rsh</span></span></code> (rsh is a security hole), </td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">sendmail</span></span></code> (sendmail is an insecure MTA; we're going to install qmail instead later),</td></tr><tr><td>check <code class="computeroutput"><span class="guilabel"><span class="guilabel">tcl</span></span></code> (we need tcl), and </td></tr><tr><td>uncheck <code class="computeroutput"><span class="guilabel"><span class="guilabel">xinetd</span></span></code> (xinetd handles incoming tcp connections.  We'll install a different, more secure program, ucspi-tcp).</td></tr><tr><td>Click <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">N</span></u>ext</span></span></code></td></tr></table></li><li class="listitem"><p>Red Hat isn't completely happy with the combination
 of packages we've selected, and wants to satisfy some dependencies.
 Don't let it.  On the next screen, choose
 <code class="computeroutput"><span class="guilabel"><span class="guilabel">I<u><span class="accel">g</span></u>nore Package
@@ -120,7 +120,7 @@
         upgrading all of that.  Since you are upgrading the kernel,
         reboot after this step.
 </p></li><li class="listitem"><p>Lock down SSH</p><div class="orderedlist"><ol class="orderedlist" type="a"><li class="listitem"><p>
-              <a class="indexterm" name="idp140726695493904"></a>
+              <a class="indexterm" name="idp140717558805248"></a>
               SSH is the protocol we use to connect
               securely to the computer (replacing telnet, which is
               insecure).  sshd is the daemon that listens for incoming
Index: openacs-4/packages/acs-core-docs/www/install-steps.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-steps.html,v
diff -u -N -r1.34.2.2 -r1.34.2.3
--- openacs-4/packages/acs-core-docs/www/install-steps.html	9 Sep 2014 08:31:56 -0000	1.34.2.2
+++ openacs-4/packages/acs-core-docs/www/install-steps.html	24 Oct 2014 14:33:56 -0000	1.34.2.3
@@ -26,7 +26,7 @@
     </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="how-to-use"></a>How to use this guide</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><code class="computeroutput">This</code> is text you will see on
           screen, such as a <code class="computeroutput"><span class="guibutton"><span class="guibutton"><u><span class="accel">B</span></u>utton</span></span></code> or <code class="computeroutput"><span class="guilabel"><span class="guilabel"><u><span class="accel">link</span></u></span></span></code>
           in a radio button list or menu.</p></li><li class="listitem"><p><strong class="userinput"><code>This is text that you will type.</code></strong></p></li><li class="listitem"><p>This is text from a program or file which you may need to
-          examine or edit:</p><pre class="programlisting">if {$database == "oracle"} {
+          examine or edit:</p><pre class="programlisting">if {$database eq "oracle"} {
           set db_password        "mysitepassword"
 }</pre></li><li class="listitem"><p>This is text that you will
           <code class="computeroutput">see</code> and <strong class="userinput"><code>type</code></strong> in a command shell, including <span class="replaceable"><span class="replaceable">text you may have to
@@ -41,7 +41,7 @@
 <span class="action"><span class="action">su - $OPENACS_SERVICE_NAME
 svc -d /service/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>
 dropdb <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>
-createdb <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></span></span></pre><p><a name="cut-and-paste-name-var"></a><b>Setting a global shell variable for cut and paste. </b>In order to cut and paste the instructions into your shell, you must set the environment variable $OPENACS_SERVICE_NAME.  In order to set it globally so that it works for any new users or special service users you may create, edit the file <code class="computeroutput">/etc/profile</code> ( <code class="computeroutput">/etc/share/skel/dot.profile</code> for FreeBSD) and add this line:</p><pre class="programlisting">export OPENACS_SERVICE_NAME=<span class="replaceable"><span class="replaceable">service0</span></span></pre></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726692957328"></a>Paths and Users</h3></div></div></div><div class="table"><a name="idp140726692957968"></a><p class="title"><b>Table 2.1. Default directories for a standard install</b></p><div class="table-contents"><table summary="Default directories for a standard install" cellspacing="0" width="100%" border="1"><colgroup><col><col></colgroup><tbody><tr><td>Fully qualified domain name of your server</td><td><span class="replaceable"><span class="replaceable">yourserver.test</span></span></td></tr><tr><td>name of administrative access account</td><td>remadmin</td></tr><tr><td>OpenACS service</td><td><a class="indexterm" name="idp140726692962576"></a>
+createdb <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></span></span></pre><p><a name="cut-and-paste-name-var"></a><b>Setting a global shell variable for cut and paste. </b>In order to cut and paste the instructions into your shell, you must set the environment variable $OPENACS_SERVICE_NAME.  In order to set it globally so that it works for any new users or special service users you may create, edit the file <code class="computeroutput">/etc/profile</code> ( <code class="computeroutput">/etc/share/skel/dot.profile</code> for FreeBSD) and add this line:</p><pre class="programlisting">export OPENACS_SERVICE_NAME=<span class="replaceable"><span class="replaceable">service0</span></span></pre></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717556272272"></a>Paths and Users</h3></div></div></div><div class="table"><a name="idp140717556272912"></a><p class="title"><b>Table 2.1. Default directories for a standard install</b></p><div class="table-contents"><table summary="Default directories for a standard install" cellspacing="0" width="100%" border="1"><colgroup><col><col></colgroup><tbody><tr><td>Fully qualified domain name of your server</td><td><span class="replaceable"><span class="replaceable">yourserver.test</span></span></td></tr><tr><td>name of administrative access account</td><td>remadmin</td></tr><tr><td>OpenACS service</td><td><a class="indexterm" name="idp140717556277712"></a>
                 <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span> (set to service0 in default install)</td></tr><tr><td>OpenACS service account</td><td><span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td>OpenACS database name</td><td><span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td>Root of OpenACS service file tree (SERVERROOT)</td><td><span class="replaceable"><span class="replaceable">/var/lib/aolserver/$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td>Location of source code tarballs for new software</td><td>/var/tmp</td></tr><tr><td>The OpenACS tarball contains some files which
                 are useful while setting up other software.  Those
                 files are located at:</td><td>/var/tmp/openacs-5.7.0/packages/acs-core-docs/www/files</td></tr><tr><td>Database backup directory</td><td><span class="replaceable"><span class="replaceable">/var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backup</span></span></td></tr><tr><td>Service config files</td><td><span class="replaceable"><span class="replaceable">/var/lib/aolserver/$OPENACS_SERVICE_NAME/etc</span></span></td></tr><tr><td>Service log files</td><td><span class="replaceable"><span class="replaceable">/var/lib/aolserver/$OPENACS_SERVICE_NAME/log</span></span></td></tr><tr><td>Compile directory</td><td>/usr/local/src</td></tr><tr><td>PostgreSQL directory</td><td>/usr/local/pgsql</td></tr><tr><td>AOLserver directory</td><td>/usr/local/aolserver</td></tr></tbody></table></div></div><br class="table-break"><p>
Index: openacs-4/packages/acs-core-docs/www/ix01.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/ix01.html,v
diff -u -N -r1.28.2.1 -r1.28.2.2
--- openacs-4/packages/acs-core-docs/www/ix01.html	21 Aug 2013 10:19:25 -0000	1.28.2.1
+++ openacs-4/packages/acs-core-docs/www/ix01.html	24 Oct 2014 14:33:56 -0000	1.28.2.2
@@ -1,3 +1,3 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Index</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="index.html" title="OpenACS Core Documentation"><link rel="previous" href="update-translations.html" title="How to Update the translations"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="update-translations.html">Prev</a> </td><th width="60%" align="center"></th><td width="20%" align="right"> </td></tr></table><hr></div><div class="index"><div class="titlepage"><div><div><h1 class="title"><a name="idp140726688629488"></a>Index</h1></div></div></div><div class="index"><div class="indexdiv"><h3>Symbols</h3><dl><dt>$OPENACS_SERVICE_NAME, <a class="indexterm" href="install-steps.html#idp140726692957328">Paths and Users</a></dt></dl></div><div class="indexdiv"><h3>A</h3><dl><dt>AOLserver</dt><dd><dl><dt>configuration, <a class="indexterm" href="openacs.html#install-from-tarball">Installation Option 2: Install from tarball</a></dt></dl></dd><dt>Automated tests, <a class="indexterm" href="tutorial-debug.html#idp140726697719424">Write automated tests</a></dt></dl></div><div class="indexdiv"><h3>C</h3><dl><dt>computeroutput</dt><dd><dl><dt>code, <a class="indexterm" href="docbook-primer.html#dbprimer-code">Code</a></dt></dl></dd><dt>cvs</dt><dd><dl><dt>initializing, <a class="indexterm" href="install-cvs.html">Initialize CVS (OPTIONAL)</a></dt><dt>setup, <a class="indexterm" href="cvs-tips.html">Using CVS with an OpenACS Site</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>D</h3><dl><dt>daemontools</dt><dd><dl><dt>installation, <a class="indexterm" href="install-daemontools.html">Install Daemontools (OPTIONAL)</a></dt></dl></dd><dt>docbook</dt><dd><dl><dt>installation, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt></dl></dd><dt>DocBook</dt><dd><dl><dt>DTD, <a class="indexterm" href="docbook-primer.html#dbprimer-why">OpenACS Documentation Strategy: Why DocBook?</a></dt><dt>emacs configuration for, <a class="indexterm" href="psgml-for-emacs.html">Add PSGML commands to emacs init file (OPTIONAL)</a></dt></dl></dd><dt>Document structure, <a class="indexterm" href="docbook-primer.html#dbprimer-structure">Document Structure</a></dt></dl></div><div class="indexdiv"><h3>E</h3><dl><dt>emacs</dt><dd><dl><dt>installation, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt></dl></dd><dt>emphasis</dt><dd><dl><dt>bold, italics, <a class="indexterm" href="docbook-primer.html#dbprimer-emphasis">Emphasis</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>F</h3><dl><dt>full text search</dt><dd><dl><dt>installation, <a class="indexterm" href="install-full-text-search-tsearch2.html#install-tsearch2">Install Tsearch2 module</a>, <a class="indexterm" href="install-full-text-search-openfts.html#install-openfts">Install OpenFTS module</a>, <a class="indexterm" href="install-full-text-search-openfts.html#install-openfts-postgres">Install OpenFTS prerequisites in PostgreSQL instance</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>G</h3><dl><dt>Graphics</dt><dd><dl><dt>Images, <a class="indexterm" href="docbook-primer.html#dbprimer-graphics">Graphics</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>I</h3><dl><dt>informaltable</dt><dd><dl><dt>table, <a class="indexterm" href="docbook-primer.html#dbprimer-tables">Tables</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>L</h3><dl><dt>language</dt><dd><dl><dt>installation, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt></dl></dd><dt>Linking, <a class="indexterm" href="docbook-primer.html#dbprimer-links">Links</a></dt><dt>lists, <a class="indexterm" href="docbook-primer.html#dbprimer-lists">Lists</a></dt></dl></div><div class="indexdiv"><h3>O</h3><dl><dt>OpenACS Package, <a class="indexterm" href="packages.html#packages-looks">What a Package Looks Like</a></dt></dl></div><div class="indexdiv"><h3>P</h3><dl><dt>photo-album</dt><dd><dl><dt>installation (see ImageMagick)</dt></dl></dd><dt>Postgres</dt><dd><dl><dt>Vacuuming, <a class="indexterm" href="openacs.html#install-from-tarball">Installation Option 2: Install from tarball</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>Q</h3><dl><dt>qmail</dt><dd><dl><dt>installation, <a class="indexterm" href="install-qmail.html">Install qmail (OPTIONAL)</a></dt><dt>Maildir, <a class="indexterm" href="install-qmail.html">Install qmail (OPTIONAL)</a></dt><dt>rcpthosts error message, <a class="indexterm" href="install-qmail.html">Install qmail (OPTIONAL)</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>S</h3><dl><dt>sect1, <a class="indexterm" href="docbook-primer.html#dbprimer-sections">Headlines, Sections</a></dt><dt>sect2, <a class="indexterm" href="docbook-primer.html#dbprimer-sections">Headlines, Sections</a></dt><dt>Sections</dt><dd><dl><dt>Headlines, <a class="indexterm" href="docbook-primer.html#dbprimer-sections">Headlines, Sections</a></dt></dl></dd><dt>security</dt><dd><dl><dt>definition, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt><dt>firewall, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt></dl></dd><dt>sendmail</dt><dd><dl><dt>removing, <a class="indexterm" href="install-qmail.html">Install qmail (OPTIONAL)</a></dt></dl></dd><dt>ssh, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt></dl></div><div class="indexdiv"><h3>T</h3><dl><dt>The publish point for new packages should be
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Index</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="index.html" title="OpenACS Core Documentation"><link rel="previous" href="update-translations.html" title="How to Update the translations"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="update-translations.html">Prev</a> </td><th width="60%" align="center"></th><td width="20%" align="right"> </td></tr></table><hr></div><div class="index"><div class="titlepage"><div><div><h1 class="title"><a name="idp140717551950384"></a>Index</h1></div></div></div><div class="index"><div class="indexdiv"><h3>Symbols</h3><dl><dt>$OPENACS_SERVICE_NAME, <a class="indexterm" href="install-steps.html#idp140717556272272">Paths and Users</a></dt></dl></div><div class="indexdiv"><h3>A</h3><dl><dt>AOLserver</dt><dd><dl><dt>configuration, <a class="indexterm" href="openacs.html#install-from-tarball">Installation Option 2: Install from tarball</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>C</h3><dl><dt>computeroutput</dt><dd><dl><dt>code, <a class="indexterm" href="docbook-primer.html#dbprimer-code">Code</a></dt></dl></dd><dt>cvs</dt><dd><dl><dt>initializing, <a class="indexterm" href="install-cvs.html">Initialize CVS (OPTIONAL)</a></dt><dt>setup, <a class="indexterm" href="cvs-tips.html">Using CVS with an OpenACS Site</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>D</h3><dl><dt>daemontools</dt><dd><dl><dt>installation, <a class="indexterm" href="install-daemontools.html">Install Daemontools (OPTIONAL)</a></dt></dl></dd><dt>docbook</dt><dd><dl><dt>installation, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt></dl></dd><dt>DocBook</dt><dd><dl><dt>DTD, <a class="indexterm" href="docbook-primer.html#dbprimer-why">OpenACS Documentation Strategy: Why DocBook?</a></dt><dt>emacs configuration for, <a class="indexterm" href="psgml-for-emacs.html">Add PSGML commands to emacs init file (OPTIONAL)</a></dt></dl></dd><dt>Document structure, <a class="indexterm" href="docbook-primer.html#dbprimer-structure">Document Structure</a></dt></dl></div><div class="indexdiv"><h3>E</h3><dl><dt>emacs</dt><dd><dl><dt>installation, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt></dl></dd><dt>emphasis</dt><dd><dl><dt>bold, italics, <a class="indexterm" href="docbook-primer.html#dbprimer-emphasis">Emphasis</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>F</h3><dl><dt>full text search</dt><dd><dl><dt>installation, <a class="indexterm" href="install-full-text-search-tsearch2.html#install-tsearch2">Install Tsearch2 module</a>, <a class="indexterm" href="install-full-text-search-openfts.html#install-openfts">Install OpenFTS module</a>, <a class="indexterm" href="install-full-text-search-openfts.html#install-openfts-postgres">Install OpenFTS prerequisites in PostgreSQL instance</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>G</h3><dl><dt>Graphics</dt><dd><dl><dt>Images, <a class="indexterm" href="docbook-primer.html#dbprimer-graphics">Graphics</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>I</h3><dl><dt>informaltable</dt><dd><dl><dt>table, <a class="indexterm" href="docbook-primer.html#dbprimer-tables">Tables</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>L</h3><dl><dt>language</dt><dd><dl><dt>installation, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt></dl></dd><dt>Linking, <a class="indexterm" href="docbook-primer.html#dbprimer-links">Links</a></dt><dt>lists, <a class="indexterm" href="docbook-primer.html#dbprimer-lists">Lists</a></dt></dl></div><div class="indexdiv"><h3>O</h3><dl><dt>OpenACS Package, <a class="indexterm" href="packages.html#packages-looks">What a Package Looks Like</a></dt></dl></div><div class="indexdiv"><h3>P</h3><dl><dt>photo-album</dt><dd><dl><dt>installation (see ImageMagick)</dt></dl></dd><dt>Postgres</dt><dd><dl><dt>Vacuuming, <a class="indexterm" href="openacs.html#install-from-tarball">Installation Option 2: Install from tarball</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>Q</h3><dl><dt>qmail</dt><dd><dl><dt>installation, <a class="indexterm" href="install-qmail.html">Install qmail (OPTIONAL)</a></dt><dt>Maildir, <a class="indexterm" href="install-qmail.html">Install qmail (OPTIONAL)</a></dt><dt>rcpthosts error message, <a class="indexterm" href="install-qmail.html">Install qmail (OPTIONAL)</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>S</h3><dl><dt>sect1, <a class="indexterm" href="docbook-primer.html#dbprimer-sections">Headlines, Sections</a></dt><dt>sect2, <a class="indexterm" href="docbook-primer.html#dbprimer-sections">Headlines, Sections</a></dt><dt>Sections</dt><dd><dl><dt>Headlines, <a class="indexterm" href="docbook-primer.html#dbprimer-sections">Headlines, Sections</a></dt></dl></dd><dt>security</dt><dd><dl><dt>definition, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt><dt>firewall, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt></dl></dd><dt>sendmail</dt><dd><dl><dt>removing, <a class="indexterm" href="install-qmail.html">Install qmail (OPTIONAL)</a></dt></dl></dd><dt>ssh, <a class="indexterm" href="install-redhat.html">Install Red Hat 8/9</a></dt></dl></div><div class="indexdiv"><h3>T</h3><dl><dt>The publish point for new packages should be
         fixed., <a class="indexterm" href="tutorial-distribute.html">Prepare the package for distribution.</a></dt></dl></div><div class="indexdiv"><h3>U</h3><dl><dt>ulink, <a class="indexterm" href="docbook-primer.html#dbprimer-links">Links</a></dt><dt>upgrade</dt><dd><dl><dt>OpenACS 4.5 to 4.6.x</dt><dd><dl><dt>Linux/Unix, <a class="indexterm" href="upgrade-4.5-to-4.6.html">Upgrading 4.5 or higher to 4.6.3</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>X</h3><dl><dt>XML guidelines, <a class="indexterm" href="docbook-primer.html#dbprimer-why">OpenACS Documentation Strategy: Why DocBook?</a></dt><dt>xref</dt><dd><dl><dt>linkend, <a class="indexterm" href="docbook-primer.html#dbprimer-links">Links</a></dt></dl></dd><dt>xreflabel, <a class="indexterm" href="docbook-primer.html#dbprimer-sections">Headlines, Sections</a></dt></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="update-translations.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left">How to Update the translations </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> </td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/ix01.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/kernel-overview.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/kernel-overview.html,v
diff -u -N -r1.30.2.1 -r1.30.2.2
--- openacs-4/packages/acs-core-docs/www/kernel-overview.html	21 Aug 2013 10:19:25 -0000	1.30.2.1
+++ openacs-4/packages/acs-core-docs/www/kernel-overview.html	24 Oct 2014 14:33:56 -0000	1.30.2.2
@@ -1,26 +1,26 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Overview</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="kernel-doc.html" title="Chapter 15. Kernel Documentation"><link rel="previous" href="kernel-doc.html" title="Chapter 15. Kernel Documentation"><link rel="next" href="object-system-requirements.html" title="Object Model Requirements"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="kernel-doc.html">Prev</a> </td><th width="60%" align="center">Chapter 15. Kernel Documentation</th><td width="20%" align="right"> <a accesskey="n" href="object-system-requirements.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="kernel-overview"></a>Overview</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
-              The <span class="emphasis"><em>OpenACS Kernel</em></span>, which
-              handles system-wide necessities such as metadata,
-              security, users and groups, subsites, and package
-              management and deployment.
-            </p></li><li class="listitem"><p>
-              The <span class="emphasis"><em>OpenACS Core</em></span>, which
-              comprises all the other packages that ship with the
-              kernel and are most frequently needed by users, such as
-              templating, forums, and user
-              registration/management. The packages tend to be
-              developed and distributed with the kernel.
-            </p></li><li class="listitem"><p>
+            The <span class="emphasis"><em>OpenACS Kernel</em></span>, which
+            handles system-wide necessities such as metadata,
+            security, users and groups, subsites, and package
+            management and deployment.
+          </p></li><li class="listitem"><p>
+            The <span class="emphasis"><em>OpenACS Core</em></span>, which
+            comprises all the other packages that ship with the
+            kernel and are most frequently needed by users, such as
+            templating, forums, and user
+            registration/management. The packages tend to be
+            developed and distributed with the kernel.
+          </p></li><li class="listitem"><p>
 
-              <span class="emphasis"><em>OpenACS Application packages</em></span>,
-              which typically provide user-level
-              web services built on top of the Kernel and Core.
-              Application packages are
-              developed separately from the Kernel, and are typically
-              released independently of it.
+            <span class="emphasis"><em>OpenACS Application packages</em></span>,
+            which typically provide user-level
+            web services built on top of the Kernel and Core.
+            Application packages are
+            developed separately from the Kernel, and are typically
+            released independently of it.
 
-            </p></li></ul></div><p>
-          This document provides a high level overview of the kernel
-          package. <a class="ulink" href="index.html" target="_top">Documentation for other packages on this server</a>
-        </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="kernel-doc.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="object-system-requirements.html">Next</a></td></tr><tr><td width="40%" align="left">Chapter 15. Kernel Documentation </td><td width="20%" align="center"><a accesskey="u" href="kernel-doc.html">Up</a></td><td width="40%" align="right"> Object Model Requirements</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/kernel-overview.html#comments">View comments on this page at openacs.org</a></center></body></html>
+          </p></li></ul></div><p>
+        This document provides a high level overview of the kernel
+        package. <a class="ulink" href="index.html" target="_top">Documentation for other packages on this server</a>
+      </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="kernel-doc.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="object-system-requirements.html">Next</a></td></tr><tr><td width="40%" align="left">Chapter 15. Kernel Documentation </td><td width="20%" align="center"><a accesskey="u" href="kernel-doc.html">Up</a></td><td width="40%" align="right"> Object Model Requirements</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/kernel-overview.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/mac-installation.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/mac-installation.html,v
diff -u -N -r1.41.2.1 -r1.41.2.2
--- openacs-4/packages/acs-core-docs/www/mac-installation.html	21 Aug 2013 10:19:25 -0000	1.41.2.1
+++ openacs-4/packages/acs-core-docs/www/mac-installation.html	24 Oct 2014 14:33:57 -0000	1.41.2.2
@@ -1,9 +1,3 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>OpenACS Installation Guide for Mac OS X</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="complete-install.html" title="Chapter 3. Complete Installation"><link rel="previous" href="win2k-installation.html" title="OpenACS Installation Guide for Windows2000"><link rel="next" href="configuring-new-site.html" title="Chapter 4. Configuring a new OpenACS Site"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="win2k-installation.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Complete Installation</th><td width="20%" align="right"> <a accesskey="n" href="configuring-new-site.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mac-installation"></a>OpenACS Installation Guide for Mac OS X</h2></div></div></div><p><b>Prerequisites. </b>Install readline:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Download readline from http://ftp.gnu.org/pub/gnu/readline/readline-4.3.tar.gz into /usr/local/src</p></li><li class="listitem"><p>Extract readline in /usr/local/src, configure, compile, and install:</p><pre class="screen"><strong class="userinput"><code>su - root
-cd /usr/local/src
-tar xvfz readline-4.3.tar.gz
-readline-4.3
-./configure
-make
-make install</code></strong></pre></li><li class="listitem"><p>Proceed with the Unix-like system instructions.  OS X is incompatible with Oracle 8, and Oracle 9i on OSX is not yet verified for OpenACS.  So continue with <a class="xref" href="postgres.html" title="Install PostgreSQL">Install PostgreSQL</a>.  Additional special steps for OS X are documented inline with the standard Unix-like instructions.</p></li></ol></div><p>Additional resources for installing on OS X.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><a class="ulink" href="http://borkware.com/rants/openacs/" target="_top">OpenACS on Mac OS X Quickstart</a></p></li><li class="listitem"><p><a class="ulink" href="http://openacs.org/forums/message-view?message_id=24887" target="_top">An
-    older forum thread</a></p></li></ul></div><div class="cvstag">($Id$)</div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="win2k-installation.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="configuring-new-site.html">Next</a></td></tr><tr><td width="40%" align="left">OpenACS Installation Guide for Windows2000 </td><td width="20%" align="center"><a accesskey="u" href="complete-install.html">Up</a></td><td width="40%" align="right"> Chapter 4. Configuring a new OpenACS Site</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/mac-installation.html#comments">View comments on this page at openacs.org</a></center></body></html>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>OpenACS Installation Guide for Mac OS X</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="complete-install.html" title="Chapter 3. Complete Installation"><link rel="previous" href="win2k-installation.html" title="OpenACS Installation Guide for Windows2000"><link rel="next" href="configuring-new-site.html" title="Chapter 4. Configuring a new OpenACS Site"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="win2k-installation.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Complete Installation</th><td width="20%" align="right"> <a accesskey="n" href="configuring-new-site.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mac-installation"></a>OpenACS Installation Guide for Mac OS X</h2></div></div></div><p>
+    See the wiki for an actual guideline: <a class="ulink" href="http://openacs.org/xowiki/openacs-system-install-osx/" target="_top">Installing OpenACS on Mac OS X</a></p><div class="cvstag">($Id$)</div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="win2k-installation.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="configuring-new-site.html">Next</a></td></tr><tr><td width="40%" align="left">OpenACS Installation Guide for Windows2000 </td><td width="20%" align="center"><a accesskey="u" href="complete-install.html">Up</a></td><td width="40%" align="right"> Chapter 4. Configuring a new OpenACS Site</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/mac-installation.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/maint-performance.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/maint-performance.html,v
diff -u -N -r1.28.2.1 -r1.28.2.2
--- openacs-4/packages/acs-core-docs/www/maint-performance.html	21 Aug 2013 10:19:25 -0000	1.28.2.1
+++ openacs-4/packages/acs-core-docs/www/maint-performance.html	24 Oct 2014 14:33:57 -0000	1.28.2.2
@@ -2,7 +2,7 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Diagnosing Performance Problems</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="maintenance-web.html" title="Chapter 6. Production Environments"><link rel="previous" href="uptime.html" title="External uptime validation"><link rel="next" href="database-management.html" title="Chapter 7. Database Management"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="uptime.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Production Environments</th><td width="20%" align="right"> <a accesskey="n" href="database-management.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="maint-performance"></a>Diagnosing Performance Problems</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Did performance problems happen overnight, or did they sneak up on
     you? Any clue what caused the performance problems (e.g. loading 20K
     users into .LRN)</p></li><li class="listitem"><p>Is the file system out of space?  Is the machine swapping to disk constantly?</p></li><li class="listitem"><p>Isolating and solving database problems.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>Without daily internal maintenance, most databases slowly degrade in performance.  For PostGreSQL, see <a class="xref" href="install-next-nightly-vacuum.html" title="Vacuum Postgres nightly">the section called “Vacuum Postgres nightly”</a>.  For Oracle, use <code class="computeroutput">exec dbms_stats.gather_schema_stats('SCHEMA_NAME')</code> (<a class="ulink" href="http://www.piskorski.com/docs/oracle.html" target="_top">Andrew Piskorski's Oracle notes</a>).</p></li><li class="listitem"><p>You can track the exact amount of time each database query on a page takes:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Go to <a class="ulink" href="/acs-admin/install" target="_top">Main Site : Site-Wide Administration : Install Software</a></p></li><li class="listitem"><p>Click on "Install New Application" in "Install from OpenACS Repository"</p></li><li class="listitem"><p>Choose "ACS Developer Support"&gt;</p></li><li class="listitem"><p>After install is complete, restart the server.</p></li><li class="listitem"><p>Browse to Developer Support, which is automatically mounted at <code class="computeroutput"><a class="ulink" href="/ds" target="_top">/ds</a></code>.
-              </p></li><li class="listitem"><p>Turn on Database statistics</p></li><li class="listitem"><p>Browse directly to a slow page and click "Request Information" at the bottom of the page.</p></li><li class="listitem"><p>This should return a list of database queries on the page, including the exact query (so it can be cut-paste into psql or oracle) and the time each query took.</p><div class="figure"><a name="idp140726695423536"></a><p class="title"><b>Figure 6.8. Query Analysis example</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/query-duration.png" alt="Query Analysis example"></div></div></div><br class="figure-break"></li></ol></div></li><li class="listitem"><p>Identify a runaway Oracle query: first, use <strong class="userinput"><code>ps aux</code></strong> or <strong class="userinput"><code>top</code></strong> to get the UNIX process ID of a runaway Oracle process.</p><p>Log in to SQL*Plus as the admin:</p><pre class="screen">[<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span> ~]$ svrmgrl
+              </p></li><li class="listitem"><p>Turn on Database statistics</p></li><li class="listitem"><p>Browse directly to a slow page and click "Request Information" at the bottom of the page.</p></li><li class="listitem"><p>This should return a list of database queries on the page, including the exact query (so it can be cut-paste into psql or oracle) and the time each query took.</p><div class="figure"><a name="idp140717558506400"></a><p class="title"><b>Figure 6.8. Query Analysis example</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/query-duration.png" alt="Query Analysis example"></div></div></div><br class="figure-break"></li></ol></div></li><li class="listitem"><p>Identify a runaway Oracle query: first, use <strong class="userinput"><code>ps aux</code></strong> or <strong class="userinput"><code>top</code></strong> to get the UNIX process ID of a runaway Oracle process.</p><p>Log in to SQL*Plus as the admin:</p><pre class="screen">[<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span> ~]$ svrmgrl
 
 Oracle Server Manager Release 3.1.7.0.0 - Production
 
@@ -59,7 +59,7 @@
     </p><p>
       To be able to get a overview of how Oracle executes a particular query,
       install "autotrace". I usually follow the instructions here <a class="ulink" href="http://asktom.oracle.com/~tkyte/article1/autotrace.html" target="_top">http://asktom.oracle.com/~tkyte/article1/autotrace.html</a>.
-    </p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726695446576"></a>Make sure, that the Oracle CBO works with adequate statistics</h4></div></div></div><p>
+    </p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717558529440"></a>Make sure, that the Oracle CBO works with adequate statistics</h4></div></div></div><p>
     The Oracle Cost Based optimizer is a piece of software that tries to find
     the "optimal" execution plan for a given SQL statement. For that it
     estimates the costs of running a SQL query in a particular way (by default
Index: openacs-4/packages/acs-core-docs/www/maintenance-deploy.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/maintenance-deploy.html,v
diff -u -N -r1.23.2.1 -r1.23.2.2
--- openacs-4/packages/acs-core-docs/www/maintenance-deploy.html	21 Aug 2013 10:19:25 -0000	1.23.2.1
+++ openacs-4/packages/acs-core-docs/www/maintenance-deploy.html	24 Oct 2014 14:33:57 -0000	1.23.2.2
@@ -2,7 +2,7 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Staged Deployment for Production Networks</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="maintenance-web.html" title="Chapter 6. Production Environments"><link rel="previous" href="high-avail.html" title="High Availability/High Performance Configurations"><link rel="next" href="install-ssl.html" title="Installing SSL Support for an OpenACS service"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="high-avail.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Production Environments</th><td width="20%" align="right"> <a accesskey="n" href="install-ssl.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="maintenance-deploy"></a>Staged Deployment for Production Networks</h2></div></div></div><div class="authorblurb"><div class="cvstag">($Id$)</div><p>By <a class="ulink" href="mailto:joel@aufrecht.org" target="_top">Joel Aufrecht</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><p>This section describes two minimal-risk methods for deploying changes on a production network.  The important characteristics of a safe change deployment include:  (THIS SECTION IN DEVELOPMENT)</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Control: You know for sure that the change you are making is the change that you intend to make and is the change that you tested.</p></li><li class="listitem"><p>Rollback: If anything goes wrong, you can return to the previous working configuration safely and quickly.</p></li></ul></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726695324672"></a>Method 1: Deployment with CVS</h3></div></div></div><p>With this method, we control the files on a site via
+        </div><p>This section describes two minimal-risk methods for deploying changes on a production network.  The important characteristics of a safe change deployment include:  (THIS SECTION IN DEVELOPMENT)</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Control: You know for sure that the change you are making is the change that you intend to make and is the change that you tested.</p></li><li class="listitem"><p>Rollback: If anything goes wrong, you can return to the previous working configuration safely and quickly.</p></li></ul></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717558407536"></a>Method 1: Deployment with CVS</h3></div></div></div><p>With this method, we control the files on a site via
       CVS. This example uses one developmental server (service0-dev) and one
       production server (service0). Depending on your needs, you can also
       have a staging server for extensive testing before you go
@@ -67,4 +67,4 @@
 cvs up -Pd index.adp</pre><p>If you make changes that require changes to the database,
       test them out first on service0-dev, using either -create.sql or
       upgrade scripts. Once you've tested them, you then update and
-      run the upgrade scripts from the package manager. </p><p>The production site can run "HEAD" from cvs.</p><p>The drawback to using HEAD as the live code is that you cannot commit new work on the development server without erasing the definition of 'working production code.'  So a better method is to use a tag.  This guarantees that, at any time in the future, you can retrieve exactly the same set of code.  This is useful for both of the characteristics of safe change deployment.  For control, you can use tags to define a body of code, test that code, and then know that what you are deploying is exactly that code.  For rollback, you can use return to the last working tag if the new tag (or new, untagged changes) cause problems.  .... example of using tags to follow ...</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726695336720"></a>Method 2: A/B Deployment</h3></div></div></div><p>The approach taken in this section is to always create a new service with the desired changes, running in parallel with the existing site.  This guarantees control, at least at the final step of the process: you know what changes you are about to make because you can see them directly.  It does not, by itself, guarantee the entire control chain.  You need additional measures to make sure that the change you are making is exactly and completely the change you intended to make and tested previously, and nothing more.  Those additional measures typically take the form of source control tags and system version numbers.  The parallel-server approach also guarantees rollback because the original working service is not touched; it is merely set aside.</p><p>This approach can has limitations.  If the database or file system regularly receiving new data, you must interrupt this function or risk losing data in the shuffle.  It also requires extra steps if the database will be affected.</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726695339136"></a>Simple A/B Deployment: Database is not changed</h4></div></div></div><div class="figure"><a name="idp140726695339776"></a><p class="title"><b>Figure 6.2. Simple A/B Deployment - Step 1</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/simple-deploy-1.png" align="middle" alt="Simple A/B Deployment - Step 1"></div></div></div><br class="figure-break"><div class="figure"><a name="idp140726695342464"></a><p class="title"><b>Figure 6.3. Simple A/B Deployment - Step 2</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/simple-deploy-2.png" align="middle" alt="Simple A/B Deployment - Step 2"></div></div></div><br class="figure-break"><div class="figure"><a name="idp140726695345152"></a><p class="title"><b>Figure 6.4. Simple A/B Deployment - Step 3</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/simple-deploy-3.png" align="middle" alt="Simple A/B Deployment - Step 3"></div></div></div><br class="figure-break"></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726695347968"></a>Complex A/B Deployment: Database is changed</h4></div></div></div><div class="figure"><a name="idp140726695348608"></a><p class="title"><b>Figure 6.5. Complex A/B Deployment - Step 1</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/complex-deploy-1.png" align="middle" alt="Complex A/B Deployment - Step 1"></div></div></div><br class="figure-break"><div class="figure"><a name="idp140726695351296"></a><p class="title"><b>Figure 6.6. Complex A/B Deployment - Step 2</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/complex-deploy-2.png" align="middle" alt="Complex A/B Deployment - Step 2"></div></div></div><br class="figure-break"><div class="figure"><a name="idp140726695353984"></a><p class="title"><b>Figure 6.7. Complex A/B Deployment - Step 3</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/complex-deploy-3.png" align="middle" alt="Complex A/B Deployment - Step 3"></div></div></div><br class="figure-break"></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="high-avail.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="install-ssl.html">Next</a></td></tr><tr><td width="40%" align="left">High Availability/High Performance Configurations </td><td width="20%" align="center"><a accesskey="u" href="maintenance-web.html">Up</a></td><td width="40%" align="right"> Installing SSL Support for an OpenACS service</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/maintenance-deploy.html#comments">View comments on this page at openacs.org</a></center></body></html>
+      run the upgrade scripts from the package manager. </p><p>The production site can run "HEAD" from cvs.</p><p>The drawback to using HEAD as the live code is that you cannot commit new work on the development server without erasing the definition of 'working production code.'  So a better method is to use a tag.  This guarantees that, at any time in the future, you can retrieve exactly the same set of code.  This is useful for both of the characteristics of safe change deployment.  For control, you can use tags to define a body of code, test that code, and then know that what you are deploying is exactly that code.  For rollback, you can use return to the last working tag if the new tag (or new, untagged changes) cause problems.  .... example of using tags to follow ...</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717558419584"></a>Method 2: A/B Deployment</h3></div></div></div><p>The approach taken in this section is to always create a new service with the desired changes, running in parallel with the existing site.  This guarantees control, at least at the final step of the process: you know what changes you are about to make because you can see them directly.  It does not, by itself, guarantee the entire control chain.  You need additional measures to make sure that the change you are making is exactly and completely the change you intended to make and tested previously, and nothing more.  Those additional measures typically take the form of source control tags and system version numbers.  The parallel-server approach also guarantees rollback because the original working service is not touched; it is merely set aside.</p><p>This approach can has limitations.  If the database or file system regularly receiving new data, you must interrupt this function or risk losing data in the shuffle.  It also requires extra steps if the database will be affected.</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717558422000"></a>Simple A/B Deployment: Database is not changed</h4></div></div></div><div class="figure"><a name="idp140717558422640"></a><p class="title"><b>Figure 6.2. Simple A/B Deployment - Step 1</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/simple-deploy-1.png" align="middle" alt="Simple A/B Deployment - Step 1"></div></div></div><br class="figure-break"><div class="figure"><a name="idp140717558425328"></a><p class="title"><b>Figure 6.3. Simple A/B Deployment - Step 2</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/simple-deploy-2.png" align="middle" alt="Simple A/B Deployment - Step 2"></div></div></div><br class="figure-break"><div class="figure"><a name="idp140717558428016"></a><p class="title"><b>Figure 6.4. Simple A/B Deployment - Step 3</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/simple-deploy-3.png" align="middle" alt="Simple A/B Deployment - Step 3"></div></div></div><br class="figure-break"></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717558430832"></a>Complex A/B Deployment: Database is changed</h4></div></div></div><div class="figure"><a name="idp140717558431472"></a><p class="title"><b>Figure 6.5. Complex A/B Deployment - Step 1</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/complex-deploy-1.png" align="middle" alt="Complex A/B Deployment - Step 1"></div></div></div><br class="figure-break"><div class="figure"><a name="idp140717558434160"></a><p class="title"><b>Figure 6.6. Complex A/B Deployment - Step 2</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/complex-deploy-2.png" align="middle" alt="Complex A/B Deployment - Step 2"></div></div></div><br class="figure-break"><div class="figure"><a name="idp140717558436848"></a><p class="title"><b>Figure 6.7. Complex A/B Deployment - Step 3</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/complex-deploy-3.png" align="middle" alt="Complex A/B Deployment - Step 3"></div></div></div><br class="figure-break"></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="high-avail.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="install-ssl.html">Next</a></td></tr><tr><td width="40%" align="left">High Availability/High Performance Configurations </td><td width="20%" align="center"><a accesskey="u" href="maintenance-web.html">Up</a></td><td width="40%" align="right"> Installing SSL Support for an OpenACS service</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/maintenance-deploy.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/objects.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/objects.html,v
diff -u -N -r1.51.2.1 -r1.51.2.2
--- openacs-4/packages/acs-core-docs/www/objects.html	21 Aug 2013 10:19:26 -0000	1.51.2.1
+++ openacs-4/packages/acs-core-docs/www/objects.html	24 Oct 2014 14:33:57 -0000	1.51.2.2
@@ -79,7 +79,7 @@
 Fire up your text editor and open the
 <code class="computeroutput">ROOT/packages/notes/sql/oracle/notes-create.sql</code> (<code class="computeroutput">ROOT/packages/notes/sql/postgresql/notes-create.sql</code> for the PG version) file created
 when we <a class="link" href="packages.html" title="OpenACS Packages">created the package</a>.  Then, do the following:
-</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726697512784"></a>Describe the new type to the type system</h4></div></div></div><p>
+</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717562637856"></a>Describe the new type to the type system</h4></div></div></div><p>
 First, add an entry to the <code class="computeroutput">acs_object_types</code> table with the following PL/SQL call:
 </p><pre class="programlisting">
 begin  
@@ -139,7 +139,7 @@
 because the new type <code class="computeroutput">note</code> is a subtype of
 <code class="computeroutput">acs_object</code>, it will inherit these attributes, so there is
 no need for us to define them.
-</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726698969088"></a>Define a table in which to store your objects</h4></div></div></div><p>
+</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717559745456"></a>Define a table in which to store your objects</h4></div></div></div><p>
 The next thing we do is make a small modification to the data model to
 reflect the fact that each row in the <code class="computeroutput">notes</code> table
 represents something that is not only an object of type
@@ -164,7 +164,7 @@
 use the <code class="computeroutput">acs_objects</code> table to find objects will
 transparently find any objects that are instances of any subtype of
 <code class="computeroutput">acs_objects</code>.
-</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726699517872"></a>Define a package for type specific procedures</h4></div></div></div><p>
+</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717562490000"></a>Define a package for type specific procedures</h4></div></div></div><p>
 The next step is to define a PL/SQL package for your new type, and
 write some basic procedures to create and delete objects. Here is a
 package definition for our new type:
@@ -212,7 +212,7 @@
 object OBJ was "read only", then any other object that used OBJ as its
 context would also be "read only" by default. We'll talk about this more
 later.
-</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140726697002288"></a>Define a package body for type specific procedures</h4></div></div></div><p>
+</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="idp140717558867552"></a>Define a package body for type specific procedures</h4></div></div></div><p>
 The PL/SQL package body contains the implementations of the procedures
 defined above. The only subtle thing going on here is that we must use
 <code class="computeroutput">acs_object.new</code> to insert a row into
Index: openacs-4/packages/acs-core-docs/www/openacs-overview.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/openacs-overview.html,v
diff -u -N -r1.28.2.1 -r1.28.2.2
--- openacs-4/packages/acs-core-docs/www/openacs-overview.html	21 Aug 2013 10:19:26 -0000	1.28.2.1
+++ openacs-4/packages/acs-core-docs/www/openacs-overview.html	24 Oct 2014 14:33:57 -0000	1.28.2.2
@@ -1,52 +1,52 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Overview</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="general-documents.html" title="Chapter 1. High level information: What is OpenACS?"><link rel="previous" href="general-documents.html" title="Chapter 1. High level information: What is OpenACS?"><link rel="next" href="release-notes.html" title="OpenACS Release Notes"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="general-documents.html">Prev</a> </td><th width="60%" align="center">Chapter 1. High level information: What is OpenACS?</th><td width="20%" align="right"> <a accesskey="n" href="release-notes.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="openacs-overview"></a>Overview</h2></div></div></div><p>
-          OpenACS (Open Architecture Community System) is an
-          advanced toolkit for building scalable, community-oriented
-          web applications.  If you're thinking of building an
-          enterprise-level web application, OpenACS is a solid,
-          scalable framework for building dynamic content driven
-          sites.
-        </p><p>
-          OpenACS is a collection of pre-built applications and
-          services that you can use to build your web
-          site/application. Through a modular architecture, OpenACS
-          has packages for user/groups management, content
-          management, e-commerce, news, FAQs, calendar, forums, bug
-          tracking, full-text searching, and <a class="ulink" href="http://openacs.org/packages/" target="_top">much
-            more</a>.
-        </p><p>
-          OpenACS relies on <a class="ulink" href="http://www.aolserver.com/" target="_top">AOLserver</a>, the
-          free, multithreaded, scalable, Tcl-enabled,
-          web/application server used by America Online for most of
-          its web sites, and a true ACID-compliant Relational
-          Database Management System (RDBMS). Currently OpenACS
-          supports PostgreSQL, an open source RDBMS, and Oracle and
-          is easily extensible to other databases which support a
-          comparable feature set.
-        </p><p>
-          The OpenACS toolkit is derived from the ArsDigita
-          Community System (ACS). ArsDigita (now part of Red Hat,
-          Inc.) kindly made their work available under the <a class="ulink" href="http://www.gnu.org/licenses/gpl.txt" target="_top">GPL</a>,
-          making all of this possible.
-        </p><p>
-          The OpenACS project was born when Don Baccus, Ben Adida, and
-          others decided to port ACS from Oracle to PostgreSQL, thus
-          making it a fully open-source solution.  With OpenACS 4,
-          Oracle and PostgreSQL support were combined in one code base
-          and with OpenACS 5, support for internationalization and
-          localization has been added.
-        </p><p>
-          A vibrant and productive community has sprung up around the
-          OpenACS software and there are many volunteer contributors
-          as well as a commercial companies able to provide support,
-          hosting, and custom development.  Many of the production
-          users are actively funding and contributing work back to the
-          project.  Formal, consensus driven governance has been
-          established (with semi-annual elections) which ensures the
-          project serves the needs of it's constituents.
-        </p><p>
-          The OpenACS community would like to hear your comments and
-          can help you in your endeavors with the system. Visit our
-          <a class="ulink" href="http://openacs.org/" target="_top">web site</a> and feel
-          free to <a class="ulink" href="http://openacs.org/forums/" target="_top">ask questions or provide feedback</a>.
-        </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="general-documents.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="release-notes.html">Next</a></td></tr><tr><td width="40%" align="left">Chapter 1. High level information: What is OpenACS? </td><td width="20%" align="center"><a accesskey="u" href="general-documents.html">Up</a></td><td width="40%" align="right"> OpenACS Release Notes</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/openacs-overview.html#comments">View comments on this page at openacs.org</a></center></body></html>
+        OpenACS (Open Architecture Community System) is an
+        advanced toolkit for building scalable, community-oriented
+        web applications.  If you're thinking of building an
+        enterprise-level web application, OpenACS is a solid,
+        scalable framework for building dynamic content driven
+        sites.
+      </p><p>
+        OpenACS is a collection of pre-built applications and
+        services that you can use to build your web
+        site/application. Through a modular architecture, OpenACS
+        has packages for user/groups management, content
+        management, e-commerce, news, FAQs, calendar, forums, bug
+        tracking, full-text searching, and <a class="ulink" href="http://openacs.org/packages/" target="_top">much
+        more</a>.
+      </p><p>
+        OpenACS relies on <a class="ulink" href="http://www.aolserver.com/" target="_top">AOLserver</a>, the
+        free, multithreaded, scalable, Tcl-enabled,
+        web/application server used by America Online for most of
+        its web sites, and a true ACID-compliant Relational
+        Database Management System (RDBMS). Currently OpenACS
+        supports PostgreSQL, an open source RDBMS, and Oracle and
+        is easily extensible to other databases which support a
+        comparable feature set.
+      </p><p>
+        The OpenACS toolkit is derived from the ArsDigita
+        Community System (ACS). ArsDigita (now part of Red Hat,
+        Inc.) kindly made their work available under the <a class="ulink" href="http://www.gnu.org/licenses/gpl.txt" target="_top">GPL</a>,
+        making all of this possible.
+      </p><p>
+        The OpenACS project was born when Don Baccus, Ben Adida, and
+        others decided to port ACS from Oracle to PostgreSQL, thus
+        making it a fully open-source solution.  With OpenACS 4,
+        Oracle and PostgreSQL support were combined in one code base
+        and with OpenACS 5, support for internationalization and
+        localization has been added.
+      </p><p>
+        A vibrant and productive community has sprung up around the
+        OpenACS software and there are many volunteer contributors
+        as well as a commercial companies able to provide support,
+        hosting, and custom development.  Many of the production
+        users are actively funding and contributing work back to the
+        project.  Formal, consensus driven governance has been
+        established (with semi-annual elections) which ensures the
+        project serves the needs of it's constituents.
+      </p><p>
+        The OpenACS community would like to hear your comments and
+        can help you in your endeavors with the system. Visit our
+        <a class="ulink" href="http://openacs.org/" target="_top">web site</a> and feel
+        free to <a class="ulink" href="http://openacs.org/forums/" target="_top">ask questions or provide feedback</a>.
+      </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="general-documents.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="release-notes.html">Next</a></td></tr><tr><td width="40%" align="left">Chapter 1. High level information: What is OpenACS? </td><td width="20%" align="center"><a accesskey="u" href="general-documents.html">Up</a></td><td width="40%" align="right"> OpenACS Release Notes</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/openacs-overview.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/openacs.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/openacs.html,v
diff -u -N -r1.50.2.1 -r1.50.2.2
--- openacs-4/packages/acs-core-docs/www/openacs.html	21 Aug 2013 10:19:26 -0000	1.50.2.1
+++ openacs-4/packages/acs-core-docs/www/openacs.html	24 Oct 2014 14:33:58 -0000	1.50.2.2
@@ -238,7 +238,7 @@
 CREATE DATABASE
 [$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$
 <span class="action"><span class="action">su - <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>
-/usr/local/pgsql/bin/createdb -E UNICODE <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></span></span></pre></li><li class="listitem"><p>Automate daily database Vacuuming.  This is a process which cleans out discarded data from the database.  A quick way to automate vacuuming is to edit the cron file for the database user.  Recommended: <code class="computeroutput">VACUUM ANALYZE</code> every hour and <code class="computeroutput">VACUUM FULL ANALYZE</code> every day.</p><a class="indexterm" name="idp140726694247472"></a><pre class="screen">[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ <strong class="userinput"><code>export EDITOR=emacs;crontab -e</code></strong></pre><p>Add these lines to the file.  The vacuum command cleans up temporary structures within a PostGreSQL database, and can improve performance.  We vacuum gently every hour and completely every day.  The numbers and stars at the beginning are cron columns that specify when the program should be run - in this case, whenever the minute is 0 and the hour is 1, i.e., 1:00 am every day, and every (*) day of month, month, and day of week.  Type <code class="computeroutput">man 5 crontab</code> for more information.</p><pre class="programlisting">0 1-23 * * * /usr/local/pgsql/bin/vacuumdb --analyze <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>
+/usr/local/pgsql/bin/createdb -E UNICODE <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></span></span></pre></li><li class="listitem"><p>Automate daily database Vacuuming.  This is a process which cleans out discarded data from the database.  A quick way to automate vacuuming is to edit the cron file for the database user.  Recommended: <code class="computeroutput">VACUUM ANALYZE</code> every hour and <code class="computeroutput">VACUUM FULL ANALYZE</code> every day.</p><a class="indexterm" name="idp140717557652768"></a><pre class="screen">[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ <strong class="userinput"><code>export EDITOR=emacs;crontab -e</code></strong></pre><p>Add these lines to the file.  The vacuum command cleans up temporary structures within a PostGreSQL database, and can improve performance.  We vacuum gently every hour and completely every day.  The numbers and stars at the beginning are cron columns that specify when the program should be run - in this case, whenever the minute is 0 and the hour is 1, i.e., 1:00 am every day, and every (*) day of month, month, and day of week.  Type <code class="computeroutput">man 5 crontab</code> for more information.</p><pre class="programlisting">0 1-23 * * * /usr/local/pgsql/bin/vacuumdb --analyze <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>
 0 0 * * * /usr/local/pgsql/bin/vacuumdb --full --analyze <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></pre><p>Depending on your distribution, you may receive
                 email when the crontab items are executed. If you
                 don't want to receive email for those crontab items,
@@ -251,7 +251,7 @@
 	  need to configure a virtual server.  The Reference Platform
 	  uses a configuration file included in the OpenACS tarball,
 	  <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/etc/config.tcl</code>.
-	   Open it in an editor to adjust the parameters.</p><a class="indexterm" name="idp140726694261328"></a><pre class="screen">[root root]# <strong class="userinput"><code>su - <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></code></strong>
+	   Open it in an editor to adjust the parameters.</p><a class="indexterm" name="idp140717557665168"></a><pre class="screen">[root root]# <strong class="userinput"><code>su - <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></code></strong>
 [$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ <strong class="userinput"><code>cd /var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/etc</code></strong>
 [$OPENACS_SERVICE_NAME etc]$ <strong class="userinput"><code>emacs config.tcl</code></strong>
 </pre><p>
Index: openacs-4/packages/acs-core-docs/www/packages.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/packages.html,v
diff -u -N -r1.50.2.1 -r1.50.2.2
--- openacs-4/packages/acs-core-docs/www/packages.html	21 Aug 2013 10:19:27 -0000	1.50.2.1
+++ openacs-4/packages/acs-core-docs/www/packages.html	24 Oct 2014 14:33:58 -0000	1.50.2.2
@@ -13,7 +13,7 @@
     </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="server-file-layout"></a>Server file layout</h3></div></div></div><p>
       Here is how an OpenACS 5 server is laid out
       starting from the Server root (ROOT):
-    </p><div class="figure"><a name="idp140726690686304"></a><p class="title"><b>Figure 11.1. Server file layout diagram</b></p><div class="figure-contents"><pre class="programlisting">
+    </p><div class="figure"><a name="idp140717560098832"></a><p class="title"><b>Figure 11.1. Server file layout diagram</b></p><div class="figure-contents"><pre class="programlisting">
 ROOT/
     bin/
         Various executables and scripts for server maintanence.
@@ -51,7 +51,7 @@
       <a class="indexterm" name="baby"></a>
       To illustrate the general structure of a package, let's see what the
       package for the "notes" application should look like.
-    </p><div class="figure"><a name="idp140726699564432"></a><p class="title"><b>Figure 11.2. Package file layout diagram</b></p><div class="figure-contents"><pre class="programlisting">
+    </p><div class="figure"><a name="idp140717560263104"></a><p class="title"><b>Figure 11.2. Package file layout diagram</b></p><div class="figure-contents"><pre class="programlisting">
 ROOT/
   +-- packages/    APM Root
         |
@@ -124,7 +124,7 @@
       directories.  This makes it suitable for storing icons, css
       files, javascript, and other static content which can be treated
       this way.
-    </p><div class="table"><a name="idp140726698138576"></a><p class="title"><b>Table 11.1. Package files</b></p><div class="table-contents"><table summary="Package files" cellspacing="0" border="1"><colgroup><col><col><col></colgroup><thead><tr><th>File Type</th><th>Its Use</th><th>Naming Convention</th></tr></thead><tbody><tr><td>Package Specification File</td><td>The package specification file is an XML file generated and
+    </p><div class="table"><a name="idp140717563054368"></a><p class="title"><b>Table 11.1. Package files</b></p><div class="table-contents"><table summary="Package files" cellspacing="0" border="1"><colgroup><col><col><col></colgroup><thead><tr><th>File Type</th><th>Its Use</th><th>Naming Convention</th></tr></thead><tbody><tr><td>Package Specification File</td><td>The package specification file is an XML file generated and
           maintained by the OpenACS Package Manager (APM).  It specifies
           information about the package including its parameters and its
           files.</td><td><code class="computeroutput">notes.info</code></td></tr><tr><td>Data Model Creation Script</td><td>
Index: openacs-4/packages/acs-core-docs/www/permissions-design.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/permissions-design.html,v
diff -u -N -r1.33.2.1 -r1.33.2.2
--- openacs-4/packages/acs-core-docs/www/permissions-design.html	21 Aug 2013 10:19:27 -0000	1.33.2.1
+++ openacs-4/packages/acs-core-docs/www/permissions-design.html	24 Oct 2014 14:33:59 -0000	1.33.2.2
@@ -156,10 +156,10 @@
 <code class="computeroutput">permissions-create.sql</code></a></p><p><span class="strong"><strong>Tcl Procedures</strong></span></p><p>Two tcl procedures provide a simple call for the query, "Can this
 user perform this method on this object?" One returns true or false, the
 other presents an error page.</p><p>To receive a true or false value, Tcl code should call:</p><pre class="programlisting">
-ad_permission_p $object_id $object_type $method -user_id $user_id
+permission::permission_p -object_id $object_id -party_id $user_id -privilege $method
 </pre><p>If the <code class="computeroutput">user_id</code> argument is left out, then the currently logged in
 user is checked. To create an error page, Tcl code should call:</p><pre class="programlisting">
-ad_require_permission $object_id $object_type $method
+permission::require_permission -object_id $object_id -privilege $method
 </pre><p>These procedures are defined in <code class="computeroutput">acs-permissions-procs.tcl</code>.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="permissions-design-ui"></a>User Interface</h3></div></div></div><p>All users of the permissions system are the same at the user-interface
 level. If you have the <code class="computeroutput">administer_privileges</code> method permission on an
 object, then you may edit privileges for that object with the UI.</p><p>The UI currently provides a list of all granted permissions on the object.
Index: openacs-4/packages/acs-core-docs/www/permissions-tediously-explained.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/permissions-tediously-explained.html,v
diff -u -N -r1.45.2.1 -r1.45.2.2
--- openacs-4/packages/acs-core-docs/www/permissions-tediously-explained.html	21 Aug 2013 10:19:28 -0000	1.45.2.1
+++ openacs-4/packages/acs-core-docs/www/permissions-tediously-explained.html	24 Oct 2014 14:33:59 -0000	1.45.2.2
@@ -105,7 +105,7 @@
     </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="permissions-tedious-context-hierarchy"></a>Context Hierarchy</h3></div></div></div><p>
       Suppose objects <span class="emphasis"><em>A</em></span>, <span class="emphasis"><em>B</em></span>, ..., 
       and <span class="emphasis"><em>F</em></span> form the following hierarchy. 
-    </p><div class="table"><a name="idp140726692474656"></a><p class="title"><b>Table 11.2. Context Hierarchy Example</b></p><div class="table-contents"><table summary="Context Hierarchy Example" cellspacing="0" border="1"><colgroup><col align="center" class="c1"><col align="center" class="c2"><col align="center" class="c3"></colgroup><tbody><tr><td colspan="3" align="center">
+    </p><div class="table"><a name="idp140717554704112"></a><p class="title"><b>Table 11.2. Context Hierarchy Example</b></p><div class="table-contents"><table summary="Context Hierarchy Example" cellspacing="0" border="1"><colgroup><col align="center" class="c1"><col align="center" class="c2"><col align="center" class="c3"></colgroup><tbody><tr><td colspan="3" align="center">
 	      <span class="bold"><strong>A</strong></span>
 	      <p>
   	        <code class="computeroutput">object_id=10</code>
@@ -139,7 +139,7 @@
       This can be represented in the 
       <a class="xref" href="permissions-tediously-explained.html#acs_objects">acs_objects</a> table
       by the following entries: 
-    </p><div class="table"><a name="idp140726691953632"></a><p class="title"><b>Table 11.3. acs_objects example data</b></p><div class="table-contents"><table summary="acs_objects example data" cellspacing="0" border="1"><colgroup><col align="center" class="c1"><col align="center" class="c2"></colgroup><thead><tr><th align="center">object_id</th><th align="center">context_id</th></tr></thead><tbody><tr><td align="center">20</td><td align="center">10</td></tr><tr><td align="center">30</td><td align="center">10</td></tr><tr><td align="center">40</td><td align="center">20</td></tr><tr><td align="center">50</td><td align="center">20</td></tr><tr><td align="center">60</td><td align="center">30</td></tr></tbody></table></div></div><br class="table-break"><p>
+    </p><div class="table"><a name="idp140717553040016"></a><p class="title"><b>Table 11.3. acs_objects example data</b></p><div class="table-contents"><table summary="acs_objects example data" cellspacing="0" border="1"><colgroup><col align="center" class="c1"><col align="center" class="c2"></colgroup><thead><tr><th align="center">object_id</th><th align="center">context_id</th></tr></thead><tbody><tr><td align="center">20</td><td align="center">10</td></tr><tr><td align="center">30</td><td align="center">10</td></tr><tr><td align="center">40</td><td align="center">20</td></tr><tr><td align="center">50</td><td align="center">20</td></tr><tr><td align="center">60</td><td align="center">30</td></tr></tbody></table></div></div><br class="table-break"><p>
       The first entry tells us that object 20 is the descendant of object 10, and
       the third entry shows that object 40 is the descendant of object 20. By
       running a <a class="ulink" href="http://www.oradoc.com/ora817/server.817/a85397/expressi.htm#1023748" target="_top">CONNECT BY</a> query,
Index: openacs-4/packages/acs-core-docs/www/programming-with-aolserver.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/programming-with-aolserver.html,v
diff -u -N -r1.48.2.2 -r1.48.2.3
--- openacs-4/packages/acs-core-docs/www/programming-with-aolserver.html	27 Aug 2013 10:52:32 -0000	1.48.2.2
+++ openacs-4/packages/acs-core-docs/www/programming-with-aolserver.html	24 Oct 2014 14:34:00 -0000	1.48.2.3
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Programming with AOLserver</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="dev-guide.html" title="Chapter 11. Development Reference"><link rel="previous" href="object-identity.html" title="Object Identity"><link rel="next" href="form-builder.html" title="Using Form Builder: building html forms dynamically"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="object-identity.html">Prev</a> </td><th width="60%" align="center">Chapter 11. Development Reference</th><td width="20%" align="right"> <a accesskey="n" href="form-builder.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="programming-with-aolserver"></a>Programming with AOLserver</h2></div></div></div><div class="authorblurb"><p>By Michael Yoon, Jon Salz and <a class="ulink" href="http://www.pinds.com/lars" target="_top">Lars Pind</a>.</p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Programming with AOLserver</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="dev-guide.html" title="Chapter 11. Development Reference"><link rel="previous" href="object-identity.html" title="Object Identity"><link rel="next" href="eng-standards.html" title="Chapter 12. Engineering Standards"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="object-identity.html">Prev</a> </td><th width="60%" align="center">Chapter 11. Development Reference</th><td width="20%" align="right"> <a accesskey="n" href="eng-standards.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="programming-with-aolserver"></a>Programming with AOLserver</h2></div></div></div><div class="authorblurb"><p>By Michael Yoon, Jon Salz and <a class="ulink" href="http://www.pinds.com/lars" target="_top">Lars Pind</a>.</p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
         </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="programming-aolserver-global"></a>The <code class="computeroutput">global</code> command</h3></div></div></div><p>
@@ -210,4 +210,4 @@
 perform lookup by name, they perform a linear lookup, whereas arrays use a
 hash table, so <code class="computeroutput">ns_set</code>s are slower than arrays when the number of
 entries is large. 
-</p><div class="cvstag">($Id$)</div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="object-identity.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="form-builder.html">Next</a></td></tr><tr><td width="40%" align="left">Object Identity </td><td width="20%" align="center"><a accesskey="u" href="dev-guide.html">Up</a></td><td width="40%" align="right"> Using Form Builder: building html forms dynamically</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/programming-with-aolserver.html#comments">View comments on this page at openacs.org</a></center></body></html>
+</p><div class="cvstag">($Id$)</div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="object-identity.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="eng-standards.html">Next</a></td></tr><tr><td width="40%" align="left">Object Identity </td><td width="20%" align="center"><a accesskey="u" href="dev-guide.html">Up</a></td><td width="40%" align="right"> Chapter 12. Engineering Standards</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/programming-with-aolserver.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/psgml-for-emacs.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/psgml-for-emacs.html,v
diff -u -N -r1.40.2.1 -r1.40.2.2
--- openacs-4/packages/acs-core-docs/www/psgml-for-emacs.html	21 Aug 2013 10:19:28 -0000	1.40.2.1
+++ openacs-4/packages/acs-core-docs/www/psgml-for-emacs.html	24 Oct 2014 14:34:00 -0000	1.40.2.2
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Add PSGML commands to emacs init file (OPTIONAL)</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="install-more-software.html" title="Appendix B. Install additional supporting software"><link rel="previous" href="install-cvs.html" title="Initialize CVS (OPTIONAL)"><link rel="next" href="install-daemontools.html" title="Install Daemontools (OPTIONAL)"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="install-cvs.html">Prev</a> </td><th width="60%" align="center">Appendix B. Install additional supporting software</th><td width="20%" align="right"> <a accesskey="n" href="install-daemontools.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="psgml-for-emacs"></a>Add PSGML commands to emacs init file (OPTIONAL)</h2></div></div></div><p><a class="indexterm" name="idp140726697821328"></a>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Add PSGML commands to emacs init file (OPTIONAL)</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="install-more-software.html" title="Appendix B. Install additional supporting software"><link rel="previous" href="install-cvs.html" title="Initialize CVS (OPTIONAL)"><link rel="next" href="install-daemontools.html" title="Install Daemontools (OPTIONAL)"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="install-cvs.html">Prev</a> </td><th width="60%" align="center">Appendix B. Install additional supporting software</th><td width="20%" align="right"> <a accesskey="n" href="install-daemontools.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="psgml-for-emacs"></a>Add PSGML commands to emacs init file (OPTIONAL)</h2></div></div></div><p><a class="indexterm" name="idp140717563151808"></a>
 If you plan to write or edit any documentation with emacs, install a
       customized emacs configuration file with DocBook commands in the skeleton
       directory, so it will be used for all new users.  The file also
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.54.2.2 -r1.54.2.3
--- openacs-4/packages/acs-core-docs/www/release-notes.html	9 Sep 2014 08:31:56 -0000	1.54.2.2
+++ openacs-4/packages/acs-core-docs/www/release-notes.html	24 Oct 2014 14:34:00 -0000	1.54.2.3
@@ -1,6 +1,108 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>OpenACS Release Notes</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="general-documents.html" title="Chapter 1. High level information: What is OpenACS?"><link rel="previous" href="openacs-overview.html" title="Overview"><link rel="next" href="acs-admin.html" title="Part II. Administrator's Guide"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="openacs-overview.html">Prev</a> </td><th width="60%" align="center">Chapter 1. High level information: What is OpenACS?</th><td width="20%" align="right"> <a accesskey="n" href="acs-admin.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="release-notes"></a>OpenACS Release Notes</h2></div></div></div><p>The ChangeLogs include an annotated list of changes (<a class="xref" href="release-notes.html#changelog-latest" title="Changelog (most recent release only)">the section called “Changelog (most recent release only)”</a>) since the last release and in the
-entire 5.7 release sequence <a class="xref" href="release-notes.html#changelog" title="Changelog for oacs-5-7">the section called “Changelog for oacs-5-7”</a>.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-7-0"></a>Release 5.7.0</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>OpenACS Release Notes</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="general-documents.html" title="Chapter 1. High level information: What is OpenACS?"><link rel="previous" href="openacs-overview.html" title="Overview"><link rel="next" href="acs-admin.html" title="Part II. Administrator's Guide"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="openacs-overview.html">Prev</a> </td><th width="60%" align="center">Chapter 1. High level information: What is OpenACS?</th><td width="20%" align="right"> <a accesskey="n" href="acs-admin.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="release-notes"></a>OpenACS Release Notes</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-8-1"></a>Release 5.8.1</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+      The release contains the 78 packages of the oacs-5-8 branch.
+      These packages contain the OpenACS core packages, major
+      application packages (e.g. most the ones used on OpenACS.org), and
+      DotLRN.
+    </p></li><li class="listitem"><p>
+      All packages have the following properties:
+      </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>SQL:
+	</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: square; "><li class="listitem"><p>
+            All packages are PostgreSQL 9.1+ compatible 
+            (tested with PostgreSQL 9.3)
+	  </p></li><li class="listitem"><p>
+            All SQL files with stored procedures use the
+            recommended $$ quoting
+	  </p></li><li class="listitem"><p>
+            All SQL-functions have regular function arguments
+            instead of the old-style aliases
+	  </p></li><li class="listitem"><p>
+            The function_args() (query-able meta-data) are
+            completed and fixed
+	  </p></li><li class="listitem"><p>
+            Incompatible functions (e.g. for sequences) are
+            replaced.
+	  </p></li></ul></div><p>	    
+	</p></li><li class="listitem"><p>Tcl:
+	</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: square; "><li class="listitem"><p>
+            All packages were brought up Tcl 8.5, including
+            the actual Tcl idioms where appropriate (e.g.
+            using the safer expand operator, range indices,
+            dict, lassign, etc.)
+	  </p></li><li class="listitem"><p>
+            The code was updated to prefer byte-compiled functions
+            instead of legacy functions from ancient Tcl versions.
+	  </p></li><li class="listitem"><p>
+            The code works with NaviServer and AOLserver.
+	  </p></li></ul></div><p>
+	</p></li><li class="listitem"><p>API:
+	</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: square; "><li class="listitem"><p>
+            All packages are free from calls to deprecated code
+            (157 functions are marked as deprecated and will be
+            moved into an "outdated" package in the 5.9 or 6.0
+	    release)
+	  </p></li><li class="listitem"><p>
+	    General overhaul of package management
+	  </p></li><li class="listitem"><p>
+            Install-from-local and install-from-repository can be used
+            to install the provided packages based on a acs-core
+            installation. This means that also DotLRN can be
+            installed from repository or from
+            local into an existing OpenACS instance.
+	  </p></li><li class="listitem"><p>
+            Install-from-repository offers filtering functions, allows
+            to install optionally from head-channel (for packages
+            not in the base channel of the installed instance).
+            Install-from-repository works more like an app-store,
+            showing as well vendor information
+	  </p></li><li class="listitem"><p>
+            Packages can be equipped with configuration files
+            (e.g. changing parameters for style packages)
+	  </p></li><li class="listitem"><p>
+            Package developers can upload .apm packages via workflow
+            for review by core members and for inclusion to the
+            repository. The option is integrated with package
+            management, the link is offered for local packages.
+            We hope to attract additional vendors (universities,
+            companies) to make their packages available on this
+	    path.
+	  </p></li><li class="listitem"><p>
+            New management-functions for package instances
+            (list, create, delete package instances)
+	  </p></li><li class="listitem"><p>
+            Substantially improved API browser:
+	    </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+		Show just relevant parts of .xql files for a function
+	      </p></li><li class="listitem"><p>
+		Provide syntax-highlighting for www scripts as well
+	      </p></li><li class="listitem"><p>
+		Handle more special cases like e.g. util_memoize
+	      </p></li><li class="listitem"><p>
+		Provide links to Tcl functions depending on the installed
+		Tcl version
+	      </p></li><li class="listitem"><p>
+		Provide links to NaviServer or OpenACS functions depending
+		on installed version
+	      </p></li><li class="listitem"><p>
+		Syntax highlighter uses CSS rather than hard-coded markup
+	      </p></li><li class="listitem"><p>
+		Significant performance improvement for large
+		installations
+	      </p></li></ul></div><p>
+ 	  </p></li></ul></div><p>
+	</p></li></ul></div><p>
+    </p></li></ul></div><p> Altogether, OpenACS 5.8.1 differs from OpenACS 5.8.0 in
+  about 100,000 modifications (6145 commits) contributed by 5
+  committers.
+  </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-8-0"></a>Release 5.8.0</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
+	  Compatibility with PostgreSQL 9.2:
+	  The new version installs without any need for special parameter
+	  settings in new PostgreSQL versions. This makes it easier to use
+	  e.g. shared or packaged PostgreSQL installations.
+      </p></li><li class="listitem"><p>Compatibility with NaviServer 4.99.5 or newer</p></li><li class="listitem"><p>Performance and scalability improvements</p></li><li class="listitem"><p>Various bug fixes </p></li></ul></div><p> Altogether, OpenACS 5.8.0 differs from OpenACS 5.7.0 in
+    more than 18.000 modifications (781 commits) contributed by 7
+    committers.
+    </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-7-0"></a>Release 5.7.0</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
           Made changes that extend acs-kernel's create_type and create_attribute procs,
           so they're optionally able to create sql tables and columns.  Optional metadata
           params allow for the automatic generation of foreign key references, check
@@ -80,15 +182,15 @@
               in the API browser for details.
               </p><p>Templates have been modified to comply with HTML strict</p><p>The Search package's results page has been improved</p><p>TinyMCE WYSIWYG support has been added, RTE and HTMLArea support dropped</p><p>acs-mail-lite's send has been cleaned up to properly encode content, to handle
               file attachments, etc.  "complex-send" will disappear from acs-core in a future
-              release.</p></li></ul></div></div><p>The ChangeLogs include an annotated list of changes (<a class="xref" href="release-notes.html#changelog-latest" title="Changelog (most recent release only)">the section called “Changelog (most recent release only)”</a>) since the last release and in the
-entire 5.7 release sequence <a class="xref" href="release-notes.html#changelog" title="Changelog for oacs-5-7">the section called “Changelog for oacs-5-7”</a>.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-3-1"></a>Release 5.3.1</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes.</p><p>New TIPs implemented.</p><p>All Core Automated Tests for Postgres pass.</p><p>New Site and Blank master templates and CSS compatible with the .LRN Zen
-              work.  Compatibility master templates are provided for existing sites.</p></li></ul></div></div><p>The ChangeLogs include an annotated list of changes (<a class="xref" href="release-notes.html#changelog-latest" title="Changelog (most recent release only)">the section called “Changelog (most recent release only)”</a>) since the last release and in the
-entire 5.7 release sequence <a class="xref" href="release-notes.html#changelog" title="Changelog for oacs-5-7">the section called “Changelog for oacs-5-7”</a>.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-3-0"></a>Release 5.3.0</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes.</p><p>New TIPs implemented.</p><p>All Core Automated Tests for Postgres pass.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-2-0"></a>Release 5.2.0</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes.</p><p>New TIPs implemented.</p><p>This release does <span class="strong"><strong>not</strong></span> include new translations.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-1-4"></a>Release 5.1.4</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes.</p><p>The missing CR Tcl API has been filled in, thanks to Rocael and
+              release.</p></li></ul></div></div><p>The ChangeLogs include an annotated list of changes (<a class="xref" href="">???</a>) since the last release and in the
+entire 5.7 release sequence <a class="xref" href="">???</a>.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-3-1"></a>Release 5.3.1</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes.</p><p>New TIPs implemented.</p><p>All Core Automated Tests for Postgres pass.</p><p>New Site and Blank master templates and CSS compatible with the .LRN Zen
+              work.  Compatibility master templates are provided for existing sites.</p></li></ul></div></div><p>The ChangeLogs include an annotated list of changes (<a class="xref" href="">???</a>) since the last release and in the
+entire 5.7 release sequence <a class="xref" href="">???</a>.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-3-0"></a>Release 5.3.0</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes.</p><p>New TIPs implemented.</p><p>All Core Automated Tests for Postgres pass.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-2-0"></a>Release 5.2.0</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes.</p><p>New TIPs implemented.</p><p>This release does <span class="strong"><strong>not</strong></span> include new translations.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-1-4"></a>Release 5.1.4</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes.</p><p>The missing CR Tcl API has been filled in, thanks to Rocael and
         his team and Dave Bauer.</p><p>This release does <span class="strong"><strong>not</strong></span> include new translations.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-1-3"></a>Release 5.1.3</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes, primarily for .LRN compatibility in support of upcoming .LRN 2.1.0 releases. This release does <span class="strong"><strong>not</strong></span> include new translations since 5.1.2.
         </p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-1-2"></a>Release 5.1.2</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Translations syncronized with the translation server.
         Basque and Catalan added.
         </p></li><li class="listitem"><p>For a complete change list, see the  Change list since
-          5.1.0 in <a class="xref" href="release-notes.html#changelog" title="Changelog for oacs-5-7">the section called “Changelog for oacs-5-7”</a>.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-1-1"></a>Release 5.1.1</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>This is the first release using the newest adjustment to the versioning convention.  The OpenACS 5.1.1 tag will apply to OpenACS core as well as to the most recent released version of every package, including .LRN.</p></li><li class="listitem"><p>Translations syncronized with the translation server.
+          5.1.0 in <a class="xref" href="">???</a>.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-1-1"></a>Release 5.1.1</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>This is the first release using the newest adjustment to the versioning convention.  The OpenACS 5.1.1 tag will apply to OpenACS core as well as to the most recent released version of every package, including .LRN.</p></li><li class="listitem"><p>Translations syncronized with the translation server.
         </p></li><li class="listitem"><p><a class="ulink" href="http://openacs.org/bugtracker/openacs/com/acs-lang/bug?bug%5fnumber=1519" target="_top">Bug
             1519</a> fixed.  This involved renaming all catalog
           files for ch_ZH, TH_TH, AR_EG, AR_LB, ms_my, RO_RO, FA_IR,
@@ -99,7 +201,7 @@
           the files and database before upgrading.)</p></li><li class="listitem"><p>Other bug fixes since 5.1.0: <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug_number=1785" target="_top">1785</a>,
           <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug_number=1793" target="_top">1793</a>,
       and over a dozen additional bug fixes.</p></li><li class="listitem"><p>For a complete change list, see the  Change list since
-          5.0.0 in <a class="xref" href="release-notes.html#changelog" title="Changelog for oacs-5-7">the section called “Changelog for oacs-5-7”</a>.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-1-0"></a>Release 5.1.0</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Lots of little tweaks and fixes</p></li><li class="listitem"><p>Complete Change list since 5.0.0 in Changelog</p></li><li class="listitem"><p><a class="ulink" href="http://openacs.org/bugtracker/openacs/core?filter%2efix%5ffor%5fversion=125273&amp;filter%2estatus=closed" target="_top">Many Bug fixes</a></p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-0-4"></a>Release 5.0.4</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>New translations, including for .LRN 2.0.2.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-0-3"></a>Release 5.0.3</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes: <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug%5fnumber=1560" target="_top">1560</a>, <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug%5fnumber=1556" target="_top">#1556. Site becomes unresponsive, requires restart</a></p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-0-2"></a>Release 5.0.2</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes: <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug%5fnumber=1495" target="_top">#1495. Croatian enabled by default</a>, <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug%5fnumber=1496" target="_top">#1496. APM automated install fails if files have spaces in their names</a>, <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug%5fnumber=1494" target="_top">#1494. automated upgrade crashes (halting the upgrade process)</a></p></li><li class="listitem"><p>Complete Change list since 5.0.0 in Changelog</p></li><li class="listitem"><p>File tagging scheme in CVS changed to follow <a class="ulink" href="http://openacs.org/forums/message-view?message_id=161375" target="_top">TIP #46: (Approved) Rules for Version Numbering and CVS tagging of Packages</a></p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-0-1"></a>Release 5.0.1</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>All work on the translation server from 7 Nov 2003 to 7 Feb 2004 is now included in catalogs.</p></li><li class="listitem"><p>One new function in acs-tcl, util::age_pretty</p></li><li class="listitem"><p>Complete Change list since 5.0.0 in Changelog</p></li><li class="listitem"><p>Many documentation updates and doc bug fixes </p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-0-0"></a>Release 5.0.0</h3></div></div></div><p>
+          5.0.0 in <a class="xref" href="">???</a>.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-1-0"></a>Release 5.1.0</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Lots of little tweaks and fixes</p></li><li class="listitem"><p>Complete Change list since 5.0.0 in Changelog</p></li><li class="listitem"><p><a class="ulink" href="http://openacs.org/bugtracker/openacs/core?filter%2efix%5ffor%5fversion=125273&amp;filter%2estatus=closed" target="_top">Many Bug fixes</a></p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-0-4"></a>Release 5.0.4</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>New translations, including for .LRN 2.0.2.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-0-3"></a>Release 5.0.3</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes: <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug%5fnumber=1560" target="_top">1560</a>, <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug%5fnumber=1556" target="_top">#1556. Site becomes unresponsive, requires restart</a></p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-0-2"></a>Release 5.0.2</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Bug fixes: <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug%5fnumber=1495" target="_top">#1495. Croatian enabled by default</a>, <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug%5fnumber=1496" target="_top">#1496. APM automated install fails if files have spaces in their names</a>, <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug%5fnumber=1494" target="_top">#1494. automated upgrade crashes (halting the upgrade process)</a></p></li><li class="listitem"><p>Complete Change list since 5.0.0 in Changelog</p></li><li class="listitem"><p>File tagging scheme in CVS changed to follow <a class="ulink" href="http://openacs.org/forums/message-view?message_id=161375" target="_top">TIP #46: (Approved) Rules for Version Numbering and CVS tagging of Packages</a></p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-0-1"></a>Release 5.0.1</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>All work on the translation server from 7 Nov 2003 to 7 Feb 2004 is now included in catalogs.</p></li><li class="listitem"><p>One new function in acs-tcl, util::age_pretty</p></li><li class="listitem"><p>Complete Change list since 5.0.0 in Changelog</p></li><li class="listitem"><p>Many documentation updates and doc bug fixes </p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="release-notes-5-0-0"></a>Release 5.0.0</h3></div></div></div><p>
         This is OpenACS 5.0.0.  This version contains no known security, data loss, or crashing bugs, nor any bugs judged release blockers.  This version has received manual testing.  It has passed current automated testing, which is not comprehensive.  This release contains work done on the translation server http://translate.openacs.org through 7 Nov 2003.  
   </p><p>
         Please report bugs using our
@@ -196,199 +298,4 @@
         </p></li><li class="listitem"><p>
            Serving backup files and files from the CVS directories is turned off by default via the acs-kernel parameter
                 ExcludedFiles in section request-processor (The variable provides a string match glob list of files and is defaulted to "*/CVS/* *~")
-        </p></li></ul></div><div class="cvstag">($Id$)</div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726692943888"></a>Release 4.6.3</h3></div></div></div><p><a class="ulink" href="release-notes-4-6-3.html" target="_top">Release Notes for 4.6.3</a></p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726692945392"></a>Release 4.6.2</h3></div></div></div><p><a class="ulink" href="release-notes-4-6-2.html" target="_top">Release Notes for 4.6.2</a></p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726692946896"></a>Release 4.6</h3></div></div></div><p><a class="ulink" href="release-notes-4-6.html" target="_top">Release Notes for 4.6</a></p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726692948400"></a>Release 4.5</h3></div></div></div><p><a class="ulink" href="release-notes-4-5.html" target="_top">Release Notes for 4.5</a></p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="changelog-latest"></a>Changelog (most recent release only)</h3></div></div></div><pre class="programlisting">ChangeLog missing</pre></div>
---&gt;
-
-
-<div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="changelog"></a>Changelog for oacs-5-7</h3></div></div></div><pre class="programlisting">
-2009-09-05 21:44  donb
-
-	* packages/acs-content-repository/tcl/apm-callback-procs.tcl: The
-	  after upgrade callback needed a documentation block.
-
-2009-09-05 16:27  donb
-
-	* packages/: acs-admin/acs-admin.info,
-	  acs-api-browser/acs-api-browser.info,
-	  acs-authentication/acs-authentication.info,
-	  acs-automated-testing/acs-automated-testing.info,
-	  acs-bootstrap-installer/acs-bootstrap-installer.info,
-	  acs-content-repository/acs-content-repository.info,
-	  acs-core-docs/acs-core-docs.info, acs-kernel/acs-kernel.info,
-	  acs-lang/acs-lang.info, acs-mail-lite/acs-mail-lite.info,
-	  acs-messaging/acs-messaging.info,
-	  acs-reference/acs-reference.info,
-	  acs-service-contract/acs-service-contract.info,
-	  acs-subsite/acs-subsite.info, acs-tcl/acs-tcl.info,
-	  acs-templating/acs-templating.info,
-	  acs-translations/acs-translations.info,
-	  intermedia-driver/intermedia-driver.info,
-	  notifications/notifications.info,
-	  openacs-default-theme/openacs-default-theme.info,
-	  ref-timezones/ref-timezones.info, search/search.info,
-	  tsearch2-driver/tsearch2-driver.info: Bumped version number to
-	  5.5.1b1 in preparation for release.
-
-2009-09-02 17:32  daveb
-
-	* packages/acs-tcl/tcl/request-processor-procs.tcl: Fix redirect
-	  when ForceHostP is true. Fix redirect to/from HTTP/HTTPS where
-	  full URLs are used.
-
-2009-08-10 23:40  donb
-
-	* packages/acs-subsite/tcl/: package-procs-oracle.xql,
-	  package-procs-postgresql.xql, package-procs.tcl:
-	  package_exec_plsql didn't work if the sql proc being called has a
-	  parameter named "package_name"...
-
-2009-08-10 18:35  michaels
-
-	* packages/acs-templating/tcl/richtext-procs.tcl: remove html
-	  security check bypass for admins in the richtext validation per
-	  OCT discussion
-
-2009-07-29 22:21  donb
-
-	* packages/search/: search.info, tcl/apm-callback-procs.tcl,
-	  tcl/search-init.tcl: Added a package instantiate callback so when
-	  someone mounts "search", the search indexer is correctly started
-	  up without a server restart being required.
-
-2009-07-24 14:12  victorg
-
-	* packages/acs-templating/: acs-templating.info,
-	  tcl/apm-callback-procs.tcl: Providing upgrade logic for removing
-	  Xinha invalid plugins from the parameter XinhaDefaultPlugins.
-
-2009-07-22 20:47  emmar
-
-	* packages/acs-subsite/acs-subsite.info: Fix dependencies and their
-	  version
-
-2009-07-21 22:14  emmar
-
-	* packages/acs-templating/tcl/date-procs.tcl: Localized default
-	  format for date widget
-
-2009-07-20 21:29  emmar
-
-	* packages/acs-templating/tcl/richtext-procs.tcl: Close LABEL tag
-	  before adding the Format and Spellcheck widgets. This HTML should
-	  be build in the template rather than in the rendering proc. Each
-	  widget should be computed separately.
-
-2009-07-20 12:24  emmar
-
-	* packages/acs-content-repository/: acs-content-repository.info,
-	  sql/common/mime-type-data.sql, tcl/apm-callback-procs.tcl:
-	  Implements TIP #135 (OOXML formats)
-
-2009-07-20 09:32  emmar
-
-	* packages/acs-core-docs/www/individual-programs.html: Fix Tcl
-	  version
-
-2009-07-20 08:42  emmar
-
-	* packages/acs-core-docs/www/xml/install-guide/software.xml: Fix
-	  Tcl version
-
-2009-07-17 11:48  emmar
-
-	* packages/: acs-admin/acs-admin.info,
-	  acs-api-browser/acs-api-browser.info,
-	  acs-authentication/acs-authentication.info,
-	  acs-automated-testing/acs-automated-testing.info,
-	  acs-bootstrap-installer/acs-bootstrap-installer.info,
-	  acs-content-repository/acs-content-repository.info,
-	  acs-core-docs/acs-core-docs.info, acs-kernel/acs-kernel.info,
-	  acs-lang/acs-lang.info, acs-mail-lite/acs-mail-lite.info,
-	  acs-messaging/acs-messaging.info,
-	  acs-reference/acs-reference.info,
-	  acs-service-contract/acs-service-contract.info,
-	  acs-subsite/acs-subsite.info, acs-tcl/acs-tcl.info,
-	  acs-templating/acs-templating.info,
-	  acs-translations/acs-translations.info,
-	  intermedia-driver/intermedia-driver.info,
-	  notifications/notifications.info,
-	  openacs-default-theme/openacs-default-theme.info,
-	  ref-timezones/ref-timezones.info, search/search.info,
-	  tsearch2-driver/tsearch2-driver.info: Bumped version to 5.5.1d1
-
-2009-07-14 11:44  emmar
-
-	* packages/notifications/:
-	  catalog/notifications.en_US.ISO-8859-1.xml,
-	  catalog/notifications.es_ES.ISO-8859-1.xml,
-	  tcl/notification-procs.tcl, www/manage.adp, www/manage.tcl,
-	  www/request-change-frequency.adp,
-	  www/request-change-frequency.tcl, www/request-new.adp,
-	  www/request-new.tcl: Localization (level AA requirement)
-
-2009-07-14 09:47  emmar
-
-	* packages/acs-subsite/: catalog/acs-subsite.en_US.ISO-8859-1.xml,
-	  catalog/acs-subsite.es_ES.ISO-8859-1.xml,
-	  www/shared/whos-online.adp, www/shared/whos-online.tcl:
-	  Localization
-
-2009-07-06 11:17  emmar
-
-	* packages/acs-core-docs/www/: database-management.html,
-	  docbook-primer.html, install-next-nightly-vacuum.html,
-	  install-openacs-delete-tablespace.html,
-	  programming-with-aolserver.html, remote-postgres.html,
-	  unix-installation.html: Regenerate HTML files after updating
-	  variables values and the compatibility table
-
-2009-07-06 11:14  emmar
-
-	* packages/acs-core-docs/www/: acs-admin.html,
-	  acs-package-dev.html, acs-plat-dev.html, aolserver.html,
-	  aolserver4.html, apm-design.html, apm-requirements.html,
-	  automated-backup.html, automated-testing-best-practices.html,
-	  backup-recovery.html, backups-with-cvs.html,
-	  complete-install.html, configuring-configuring-packages.html,
-	  configuring-configuring-permissions.html,
-	  configuring-install-packages.html,
-	  configuring-mounting-packages.html, credits.html,
-	  cvs-guidelines.html, cvs-tips.html, db-api-detailed.html,
-	  db-api.html, dev-guide.html, doc-standards.html,
-	  eng-standards-constraint-naming.html,
-	  eng-standards-filenaming.html, eng-standards-plsql.html,
-	  eng-standards-versioning.html, ext-auth-requirements.html,
-	  filename.html, form-builder.html, groups-design.html,
-	  high-avail.html, how-do-I.html, i18n-convert.html, index.html,
-	  individual-programs.html, install-cvs.html,
-	  install-daemontools.html, install-full-text-search-openfts.html,
-	  install-full-text-search-tsearch2.html,
-	  install-next-add-server.html, install-next-backups.html,
-	  install-openacs-keepalive.html, install-qmail.html,
-	  install-redhat.html, install-steps.html, ix01.html,
-	  kernel-doc.html, mac-installation.html, maint-performance.html,
-	  maintenance-deploy.html, object-identity.html,
-	  object-system-design.html, object-system-requirements.html,
-	  objects.html, openacs-unpack.html, openacs.html, oracle.html,
-	  packages.html, parties.html,
-	  permissions-tediously-explained.html, permissions.html,
-	  postgres.html, psgml-for-emacs.html, psgml-mode.html,
-	  release-notes.html, releasing-openacs-core.html,
-	  request-processor.html, requirements-template.html,
-	  rp-design.html, security-notes.html, snapshot-backup.html,
-	  style-guide.html, subsites.html, templates.html,
-	  tutorial-database.html, tutorial-debug.html,
-	  tutorial-newpackage.html, tutorial-pages.html, tutorial.html,
-	  upgrade-4.5-to-4.6.html, upgrade-openacs-files.html,
-	  upgrade-overview.html, variables.html: Updated with correct
-	  variable values and last changes in the compatibility table
-
-2009-07-06 11:02  emmar
-
-	* packages/acs-core-docs/www/xml/: variables.ent,
-	  install-guide/compatibility.xml, install-guide/software.xml:
-	  Updated the compatibility table.  Set the variables according to
-	  the last final release.  Removed unused (and duplicated) file.
-
-
-</pre></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="openacs-overview.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="acs-admin.html">Next</a></td></tr><tr><td width="40%" align="left">Overview </td><td width="20%" align="center"><a accesskey="u" href="general-documents.html">Up</a></td><td width="40%" align="right"> Part II. Administrator's Guide</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/release-notes.html#comments">View comments on this page at openacs.org</a></center></body></html>
+        </p></li></ul></div><div class="cvstag">($Id$)</div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717556255920"></a>Release 4.6.3</h3></div></div></div><p><a class="ulink" href="release-notes-4-6-3.html" target="_top">Release Notes for 4.6.3</a></p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717556257424"></a>Release 4.6.2</h3></div></div></div><p><a class="ulink" href="release-notes-4-6-2.html" target="_top">Release Notes for 4.6.2</a></p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717556258928"></a>Release 4.6</h3></div></div></div><p><a class="ulink" href="release-notes-4-6.html" target="_top">Release Notes for 4.6</a></p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717556260432"></a>Release 4.5</h3></div></div></div><p><a class="ulink" href="release-notes-4-5.html" target="_top">Release Notes for 4.5</a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="openacs-overview.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="acs-admin.html">Next</a></td></tr><tr><td width="40%" align="left">Overview </td><td width="20%" align="center"><a accesskey="u" href="general-documents.html">Up</a></td><td width="40%" align="right"> Part II. Administrator's Guide</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/release-notes.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/security-notes.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/security-notes.html,v
diff -u -N -r1.47.4.2 -r1.47.4.3
--- openacs-4/packages/acs-core-docs/www/security-notes.html	27 Aug 2013 10:52:33 -0000	1.47.4.2
+++ openacs-4/packages/acs-core-docs/www/security-notes.html	24 Oct 2014 14:34:01 -0000	1.47.4.3
@@ -27,7 +27,7 @@
     if { [ad_secure_conn_p] &amp;&amp; ![ad_login_page] } {
         set s_token_cookie [ns_urldecode [ad_get_cookie "ad_secure_token"]]
         
-        if { $s_token_cookie eq "" || $s_token_cookie ne [lindex [sec_get_session_info $session_id] 2] } {
+        if { $s_token_cookie eq "" || $s_token_cookie ne [lindex [sec_get_session_info $session_id] 2]} {
         # token is incorrect or nonexistent, so we force relogin.
         ad_returnredirect "/register/index?return_url=[ns_urlencode [ad_conn url]?[ad_conn query]]"
         }
Index: openacs-4/packages/acs-core-docs/www/subsites.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/subsites.html,v
diff -u -N -r1.47.2.1 -r1.47.2.2
--- openacs-4/packages/acs-core-docs/www/subsites.html	21 Aug 2013 10:19:30 -0000	1.47.2.1
+++ openacs-4/packages/acs-core-docs/www/subsites.html	24 Oct 2014 14:34:01 -0000	1.47.2.2
@@ -206,11 +206,11 @@
 database updates when the form is submitted and validated:
 </p><pre class="programlisting">
 
-if [template::form is_valid new_note] {
+if {[template::form is_valid new_note]} {
   set user_id [ad_conn user_id]
   set peeraddr [ad_conn peeraddr]
 
-  if [info exists note_id] {
+  if {[info exists note_id]} {
     db_dml note_update {
       update notes
       set title = :title,
Index: openacs-4/packages/acs-core-docs/www/templates.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/templates.html,v
diff -u -N -r1.48.2.6 -r1.48.2.7
--- openacs-4/packages/acs-core-docs/www/templates.html	9 Sep 2013 16:50:34 -0000	1.48.2.6
+++ openacs-4/packages/acs-core-docs/www/templates.html	24 Oct 2014 14:34:02 -0000	1.48.2.7
@@ -136,23 +136,7 @@
 Master templates allow you do centralize display code that is used
 throughout an application in a single file. In this case, we intend to
 have a master template that does the standard page headers and footers
-for us - create the <code class="computeroutput">master.adp</code> file, which looks like
-this:
-</p><pre class="programlisting">
-
-&lt;%= [ad_header $title] %&gt; 
-&lt;h2&gt;@title@&lt;/h2&gt; 
-&lt;%= [eval ad_context_bar $context_bar] %&gt; 
-&lt;hr&gt; 
-&lt;slave&gt; 
-&lt;br clear="all"&gt; 
-&lt;%= [ad_footer] %&gt;
-
-</pre><p>
-The main subtlety in this code is the inline Tcl code for running
-procs to build the header, footer, context bar, etc.  Also, note the
-property substitutions that happen here, the values of which are set
-up in the <code class="computeroutput">&lt;property&gt;</code> tags in the slave page.  
+for us
 </p><p>
 After putting all these files into
 <code class="computeroutput">ROOT/packages/notes/www</code>, you should be able to go to
Index: openacs-4/packages/acs-core-docs/www/tutorial-advanced.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-advanced.html,v
diff -u -N -r1.34.4.1 -r1.34.4.2
--- openacs-4/packages/acs-core-docs/www/tutorial-advanced.html	21 Aug 2013 10:19:31 -0000	1.34.4.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-advanced.html	24 Oct 2014 14:34:02 -0000	1.34.4.2
@@ -1,8 +1,8 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 10. Advanced Topics</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="acs-package-dev.html" title="Part III. For OpenACS Package Developers"><link rel="previous" href="tutorial-debug.html" title="Debugging and Automated Testing"><link rel="next" href="tutorial-specs.html" title="Write the Requirements and Design Specs"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="tutorial-debug.html">Prev</a> </td><th width="60%" align="center">Part III. For OpenACS Package Developers</th><td width="20%" align="right"> <a accesskey="n" href="tutorial-specs.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="tutorial-advanced"></a>Chapter 10. Advanced Topics</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="tutorial-specs.html">Write the Requirements and Design Specs</a></span></dt><dt><span class="sect1"><a href="tutorial-cvs.html">Add the new package to CVS</a></span></dt><dt><span class="sect1"><a href="tutorial-etp-templates.html">OpenACS Edit This Page Templates</a></span></dt><dt><span class="sect1"><a href="tutorial-comments.html">Adding Comments</a></span></dt><dt><span class="sect1"><a href="tutorial-admin-pages.html">Admin Pages</a></span></dt><dt><span class="sect1"><a href="tutorial-categories.html">Categories</a></span></dt><dt><span class="sect1"><a href="profile-code.html">Profile your code</a></span></dt><dt><span class="sect1"><a href="tutorial-distribute.html">Prepare the package for distribution.</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrades.html">Distributing upgrades of your package</a></span></dt><dt><span class="sect1"><a href="tutorial-notifications.html">Notifications</a></span></dt><dt><span class="sect1"><a href="tutorial-hierarchical.html">Hierarchical data</a></span></dt><dt><span class="sect1"><a href="tutorial-vuh.html">Using .vuh files for pretty urls</a></span></dt><dt><span class="sect1"><a href="tutorial-css-layout.html">Laying out a page with CSS instead of tables</a></span></dt><dt><span class="sect1"><a href="tutorial-html-email.html">Sending HTML email from your application</a></span></dt><dt><span class="sect1"><a href="tutorial-caching.html">Basic Caching</a></span></dt><dt><span class="sect1"><a href="tutorial-schedule-procs.html">Scheduled Procedures</a></span></dt><dt><span class="sect1"><a href="tutorial-wysiwyg-editor.html">Enabling WYSIWYG</a></span></dt><dt><span class="sect1"><a href="tutorial-parameters.html">Adding in parameters for your package</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrade-scripts.html">Writing upgrade scripts</a></span></dt><dt><span class="sect1"><a href="tutorial-second-database.html">Connect to a second database</a></span></dt><dt><span class="sect1"><a href="tutorial-future-topics.html">Future Topics</a></span></dt></dl></div><div class="authorblurb"><p>by <a class="ulink" href="mailto:joel@aufrecht.org" target="_top">Joel Aufrecht</a></p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 10. Advanced Topics</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="acs-package-dev.html" title="Part III. For OpenACS Package Developers"><link rel="previous" href="tutorial-pages.html" title="Creating Web Pages"><link rel="next" href="tutorial-specs.html" title="Write the Requirements and Design Specs"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="tutorial-pages.html">Prev</a> </td><th width="60%" align="center">Part III. For OpenACS Package Developers</th><td width="20%" align="right"> <a accesskey="n" href="tutorial-specs.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="tutorial-advanced"></a>Chapter 10. Advanced Topics</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="tutorial-specs.html">Write the Requirements and Design Specs</a></span></dt><dt><span class="sect1"><a href="tutorial-cvs.html">Add the new package to CVS</a></span></dt><dt><span class="sect1"><a href="tutorial-etp-templates.html">OpenACS Edit This Page Templates</a></span></dt><dt><span class="sect1"><a href="tutorial-comments.html">Adding Comments</a></span></dt><dt><span class="sect1"><a href="tutorial-admin-pages.html">Admin Pages</a></span></dt><dt><span class="sect1"><a href="tutorial-categories.html">Categories</a></span></dt><dt><span class="sect1"><a href="profile-code.html">Profile your code</a></span></dt><dt><span class="sect1"><a href="tutorial-distribute.html">Prepare the package for distribution.</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrades.html">Distributing upgrades of your package</a></span></dt><dt><span class="sect1"><a href="tutorial-notifications.html">Notifications</a></span></dt><dt><span class="sect1"><a href="tutorial-hierarchical.html">Hierarchical data</a></span></dt><dt><span class="sect1"><a href="tutorial-vuh.html">Using .vuh files for pretty urls</a></span></dt><dt><span class="sect1"><a href="tutorial-css-layout.html">Laying out a page with CSS instead of tables</a></span></dt><dt><span class="sect1"><a href="tutorial-html-email.html">Sending HTML email from your application</a></span></dt><dt><span class="sect1"><a href="tutorial-caching.html">Basic Caching</a></span></dt><dt><span class="sect1"><a href="tutorial-schedule-procs.html">Scheduled Procedures</a></span></dt><dt><span class="sect1"><a href="tutorial-wysiwyg-editor.html">Enabling WYSIWYG</a></span></dt><dt><span class="sect1"><a href="tutorial-parameters.html">Adding in parameters for your package</a></span></dt><dt><span class="sect1"><a href="tutorial-upgrade-scripts.html">Writing upgrade scripts</a></span></dt><dt><span class="sect1"><a href="tutorial-second-database.html">Connect to a second database</a></span></dt><dt><span class="sect1"><a href="tutorial-future-topics.html">Future Topics</a></span></dt></dl></div><div class="authorblurb"><p>by <a class="ulink" href="mailto:joel@aufrecht.org" target="_top">Joel Aufrecht</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
         </div><p>This tutorial covers topics which are not essential to
     creating a minimal working package.  Each section can be used
     independently of all of the others; all sections assume that
-    you've completed the basic tutorial.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tutorial-debug.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="tutorial-specs.html">Next</a></td></tr><tr><td width="40%" align="left">Debugging and Automated Testing </td><td width="20%" align="center"><a accesskey="u" href="acs-package-dev.html">Up</a></td><td width="40%" align="right"> Write the Requirements and Design Specs</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/tutorial-advanced.html#comments">View comments on this page at openacs.org</a></center></body></html>
+    you've completed the basic tutorial.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tutorial-pages.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="tutorial-specs.html">Next</a></td></tr><tr><td width="40%" align="left">Creating Web Pages </td><td width="20%" align="center"><a accesskey="u" href="acs-package-dev.html">Up</a></td><td width="40%" align="right"> Write the Requirements and Design Specs</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/tutorial-advanced.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/tutorial-categories.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-categories.html,v
diff -u -N -r1.13.4.4 -r1.13.4.5
--- openacs-4/packages/acs-core-docs/www/tutorial-categories.html	17 Oct 2013 09:08:35 -0000	1.13.4.4
+++ openacs-4/packages/acs-core-docs/www/tutorial-categories.html	24 Oct 2014 14:34:02 -0000	1.13.4.5
@@ -196,7 +196,7 @@
  	  <code class="computeroutput">-from_clause</code>.</p><pre class="programlisting">
  	  	set use_categories_p [parameter::get -parameter "EnableCategoriesP" -default 0]
 
-		if { $use_categories_p == 1 &amp;&amp; [exists_and_not_null category_id] } {
+		if { $use_categories_p == 1 &amp;&amp; $category_id ne "" } {
 
 			set from_clause "category_object_map com, acs_named_objects nam"
 			set_where_clause "com.object_id = qa.entry_id and
Index: openacs-4/packages/acs-core-docs/www/tutorial-css-layout.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-css-layout.html,v
diff -u -N -r1.11.4.1 -r1.11.4.2
--- openacs-4/packages/acs-core-docs/www/tutorial-css-layout.html	21 Aug 2013 10:19:31 -0000	1.11.4.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-css-layout.html	24 Oct 2014 14:34:02 -0000	1.11.4.2
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Laying out a page with CSS instead of tables</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="tutorial-advanced.html" title="Chapter 10. Advanced Topics"><link rel="previous" href="tutorial-vuh.html" title="Using .vuh files for pretty urls"><link rel="next" href="tutorial-html-email.html" title="Sending HTML email from your application"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="tutorial-vuh.html">Prev</a> </td><th width="60%" align="center">Chapter 10. Advanced Topics</th><td width="20%" align="right"> <a accesskey="n" href="tutorial-html-email.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="tutorial-css-layout"></a>Laying out a page with CSS instead of tables</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726695580800"></a>.LRN home page with table-based layout</h3></div></div></div><div class="mediaobject" align="center"><img src="images/dotlrn-style-1.png" align="middle"></div><p>A sample of the HTML code (<a class="ulink" href="files/dotlrn-style-1.html" target="_top">full source</a>)</p><pre class="programlisting">&lt;table border="0" width="100%"&gt;
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Laying out a page with CSS instead of tables</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="tutorial-advanced.html" title="Chapter 10. Advanced Topics"><link rel="previous" href="tutorial-vuh.html" title="Using .vuh files for pretty urls"><link rel="next" href="tutorial-html-email.html" title="Sending HTML email from your application"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="tutorial-vuh.html">Prev</a> </td><th width="60%" align="center">Chapter 10. Advanced Topics</th><td width="20%" align="right"> <a accesskey="n" href="tutorial-html-email.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="tutorial-css-layout"></a>Laying out a page with CSS instead of tables</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717560322368"></a>.LRN home page with table-based layout</h3></div></div></div><div class="mediaobject" align="center"><img src="images/dotlrn-style-1.png" align="middle"></div><p>A sample of the HTML code (<a class="ulink" href="files/dotlrn-style-1.html" target="_top">full source</a>)</p><pre class="programlisting">&lt;table border="0" width="100%"&gt;
   &lt;tr&gt;
     &lt;td valign="top" width="50%"&gt;
       &lt;table class="element" border=0 cellpadding="0" cellspacing="0" width="100%"&gt;
@@ -21,7 +21,7 @@
                   &lt;table border="0" bgcolor="white" cellpadding="0" cellspacing="0" width="100%"&gt;
                     &lt;tr&gt;
                       &lt;td class=element-text&gt;
-                        MBA 101</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726695585808"></a>.LRN Home with CSS-based layout</h3></div></div></div><div class="mediaobject" align="center"><img src="images/dotlrn-style-3.png" align="middle"></div><p>A sample of the HTML code (<a class="ulink" href="files/dotlrn-style-2.html" target="_top">full source</a>)</p><pre class="programlisting">&lt;div class="left"&gt;
+                        MBA 101</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717560327376"></a>.LRN Home with CSS-based layout</h3></div></div></div><div class="mediaobject" align="center"><img src="images/dotlrn-style-3.png" align="middle"></div><p>A sample of the HTML code (<a class="ulink" href="files/dotlrn-style-2.html" target="_top">full source</a>)</p><pre class="programlisting">&lt;div class="left"&gt;
   &lt;div class="portlet-wrap-shadow"&gt;
     &lt;div class="portlet-wrap-bl"&gt;
       &lt;div class="portlet-wrap-tr"&gt;
Index: openacs-4/packages/acs-core-docs/www/tutorial-cvs.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-cvs.html,v
diff -u -N -r1.25.4.1 -r1.25.4.2
--- openacs-4/packages/acs-core-docs/www/tutorial-cvs.html	21 Aug 2013 10:19:31 -0000	1.25.4.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-cvs.html	24 Oct 2014 14:34:02 -0000	1.25.4.2
@@ -59,4 +59,4 @@
 initial revision: 1.1
 done
 <span class="emphasis"><em>(many lines omitted)</em></span>
-[$OPENACS_SERVICE_NAME myfirstpackage]$</pre><div class="figure"><a name="idp140726695097200"></a><p class="title"><b>Figure 10.1. Upgrading a local CVS repository</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/development-with-cvs.png" align="middle" alt="Upgrading a local CVS repository"></div></div></div><br class="figure-break"></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tutorial-specs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="tutorial-etp-templates.html">Next</a></td></tr><tr><td width="40%" align="left">Write the Requirements and Design Specs </td><td width="20%" align="center"><a accesskey="u" href="tutorial-advanced.html">Up</a></td><td width="40%" align="right"> OpenACS Edit This Page Templates</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/tutorial-cvs.html#comments">View comments on this page at openacs.org</a></center></body></html>
+[$OPENACS_SERVICE_NAME myfirstpackage]$</pre><div class="figure"><a name="idp140717562296240"></a><p class="title"><b>Figure 10.1. Upgrading a local CVS repository</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/development-with-cvs.png" align="middle" alt="Upgrading a local CVS repository"></div></div></div><br class="figure-break"></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tutorial-specs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="tutorial-etp-templates.html">Next</a></td></tr><tr><td width="40%" align="left">Write the Requirements and Design Specs </td><td width="20%" align="center"><a accesskey="u" href="tutorial-advanced.html">Up</a></td><td width="40%" align="right"> OpenACS Edit This Page Templates</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/tutorial-cvs.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/tutorial-database.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-database.html,v
diff -u -N -r1.43.2.1 -r1.43.2.2
--- openacs-4/packages/acs-core-docs/www/tutorial-database.html	21 Aug 2013 10:19:31 -0000	1.43.2.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-database.html	24 Oct 2014 14:34:02 -0000	1.43.2.2
@@ -2,7 +2,7 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Setting Up Database Objects</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="tutorial.html" title="Chapter 9. Development Tutorial"><link rel="previous" href="tutorial-newpackage.html" title="Creating an Application Package"><link rel="next" href="tutorial-pages.html" title="Creating Web Pages"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="tutorial-newpackage.html">Prev</a> </td><th width="60%" align="center">Chapter 9. Development Tutorial</th><td width="20%" align="right"> <a accesskey="n" href="tutorial-pages.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="tutorial-database"></a>Setting Up Database Objects</h2></div></div></div><div class="authorblurb"><p>by <a class="ulink" href="mailto:joel@aufrecht.org" target="_top">Joel Aufrecht</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694440400"></a>Code the data model</h3></div></div></div><p>We create all database objects with scripts in the
+        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717553994400"></a>Code the data model</h3></div></div></div><p>We create all database objects with scripts in the
       <code class="computeroutput">myfirstpackage/sql/</code> directory.  All
       database scripts are database-specific and are thus in either
       the <code class="computeroutput">myfirstpackage/sql/oracle</code> or
@@ -32,13 +32,13 @@
       repository functions to simplify our database creation.  (<a class="ulink" href="objects.html" target="_top">More
       information about ACS Objects</a>.  <a class="ulink" href="/doc/acs-content-repository" target="_top">More information about the
       Content Repository</a>.)
-</p><div class="figure"><a name="idp140726688727968"></a><p class="title"><b>Figure 9.2. Tutorial Data Model</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/tutorial-data-model.png" align="middle" alt="Tutorial Data Model"></div></div></div><br class="figure-break"><p>The top of each sql file has some
+</p><div class="figure"><a name="idp140717552745104"></a><p class="title"><b>Figure 9.2. Tutorial Data Model</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/tutorial-data-model.png" align="middle" alt="Tutorial Data Model"></div></div></div><br class="figure-break"><p>The top of each sql file has some
       standard comments, including doc tags such as
       <code class="computeroutput">@author</code> which will be picked up
       by the API browser.  The string
       <code class="computeroutput">$Id$</code> will automatically be
       expanded when the file is checked in to cvs.</p><pre class="screen">[$OPENACS_SERVICE_NAME ~]$ <strong class="userinput"><code>cd /var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/myfirstpackage/sql/postgresql</code></strong>
-[$OPENACS_SERVICE_NAME postgresql]$ <strong class="userinput"><code>emacs myfirstpackage-create.sql</code></strong></pre><p>Paste the text below into the file, save, and close.</p><div class="figure"><a name="idp140726690600144"></a><p class="title"><b>Figure 9.3. The Database Creation Script</b></p><div class="figure-contents"><pre class="programlisting">-- creation script
+[$OPENACS_SERVICE_NAME postgresql]$ <strong class="userinput"><code>emacs myfirstpackage-create.sql</code></strong></pre><p>Paste the text below into the file, save, and close.</p><div class="figure"><a name="idp140717555906896"></a><p class="title"><b>Figure 9.3. The Database Creation Script</b></p><div class="figure-contents"><pre class="programlisting">-- creation script
 --
 -- @author joel@aufrecht.org
 -- @cvs-id &amp;Id:$
@@ -62,7 +62,7 @@
     object.  Notice the use of "mfp."  This is derived from "My
     First Package" and ensures that our object is unlikely to conflict
     with objects from other packages.</p><p>Create a database file to drop everything if the package is uninstalled.</p><pre class="screen">
-[$OPENACS_SERVICE_NAME postgresql]$ <strong class="userinput"><code>emacs myfirstpackage-drop.sql</code></strong></pre><div class="figure"><a name="idp140726689099568"></a><p class="title"><b>Figure 9.4. Database Deletion Script</b></p><div class="figure-contents"><pre class="programlisting">-- drop script
+[$OPENACS_SERVICE_NAME postgresql]$ <strong class="userinput"><code>emacs myfirstpackage-drop.sql</code></strong></pre><div class="figure"><a name="idp140717557395744"></a><p class="title"><b>Figure 9.4. Database Deletion Script</b></p><div class="figure-contents"><pre class="programlisting">-- drop script
 --
 -- @author joel@aufrecht.org
 -- @cvs-id &amp;Id:$
Index: openacs-4/packages/acs-core-docs/www/tutorial-distribute.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-distribute.html,v
diff -u -N -r1.25.4.1 -r1.25.4.2
--- openacs-4/packages/acs-core-docs/www/tutorial-distribute.html	21 Aug 2013 10:19:32 -0000	1.25.4.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-distribute.html	24 Oct 2014 14:34:02 -0000	1.25.4.2
@@ -7,5 +7,5 @@
         (<code class="computeroutput"><span class="guilabel"><span class="guilabel">37.1KB</span></span></code>)
         after the label <code class="computeroutput"><span class="guilabel"><span class="guilabel">Distribution
         File:</span></span></code> and save the file to
-        /var/tmp.</p><p><a class="indexterm" name="idp140726689361152"></a>
+        /var/tmp.</p><p><a class="indexterm" name="idp140717561802288"></a>
 </p><p><a class="ulink" href="http://openacs.org/forums/message-view?message_id=192919" target="_top">Package development guidelines</a></p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="profile-code.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="tutorial-upgrades.html">Next</a></td></tr><tr><td width="40%" align="left">Profile your code </td><td width="20%" align="center"><a accesskey="u" href="tutorial-advanced.html">Up</a></td><td width="40%" align="right"> Distributing upgrades of your package</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/tutorial-distribute.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/tutorial-etp-templates.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-etp-templates.html,v
diff -u -N -r1.8.4.1 -r1.8.4.2
--- openacs-4/packages/acs-core-docs/www/tutorial-etp-templates.html	21 Aug 2013 10:19:32 -0000	1.8.4.1
+++ openacs-4/packages/acs-core-docs/www/tutorial-etp-templates.html	24 Oct 2014 14:34:02 -0000	1.8.4.2
@@ -13,5 +13,5 @@
             cvs -d:pserver:anonymous@openacs.org:/cvsroot co edit-this-page</pre></li><li class="listitem"><p>Go to the package manager at http://yoursite/acs-admin/apm. And install  the new package: edit-this-page.</p></li><li class="listitem"><p>Or use the "Add Application" form available on the Main site.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="exercise3"></a>Change ETP Application</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Work out how to change the ETP application.</p></li><li class="listitem"><p>Investigate each of the available ETP templates:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>Default</p></li><li class="listitem"><p>News</p></li><li class="listitem"><p>FAQ</p></li></ul></div></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="exercise4"></a>Exercise 4: Create a New ETP Template</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Browse the files for each of the above ETP templates at:</p><pre class="screen">cd ~/openacs/packages/edit-this-page/templates</pre></li><li class="listitem"><p>Use the article template as the basis of our new col2 template.</p><pre class="screen">cp article-content.adp col2-content.adp
             cp article-content.tcl col2-content.tcl
             cp article-index.adp col2-index.adp
-            cp article-index.tcl col2-index.tcl</pre></li><li class="listitem"><p>The template should provide us with the following ETP layout:</p><div class="table"><a name="idp140726693435296"></a><p class="title"><b>Table 10.1. table showing ETP layout</b></p><div class="table-contents"><table summary="table showing ETP layout" cellspacing="0" border="1" width="250"><colgroup><col align="left" class="c1"><col width="2" align="left" class="c2"></colgroup><tbody><tr><td colspan="2" align="center">Header</td></tr><tr height="200"><td align="left">Sidebar</td><td align="left">Main Content Pane</td></tr></tbody></table></div></div><br class="table-break"></li><li class="listitem"><p>The "Main Content" pane should contain the editable content that ETP provides.</p></li><li class="listitem"><p>The "Header" should display the title of the page that you set in ETP.</p></li><li class="listitem"><p>The "Sidebar" should display the extlinks that you add as a content item in ETP.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="exercise5"></a>Exercise 5: Register the col2 Template with ETP</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Need to register your template with ETP so that it appears in the drop-down menu that you would have seen in Exercise 3.</p><pre class="screen">cd ~/openacs/packages/edit-this-page/tcl
+            cp article-index.tcl col2-index.tcl</pre></li><li class="listitem"><p>The template should provide us with the following ETP layout:</p><div class="table"><a name="idp140717562326464"></a><p class="title"><b>Table 10.1. table showing ETP layout</b></p><div class="table-contents"><table summary="table showing ETP layout" cellspacing="0" border="1" width="250"><colgroup><col align="left" class="c1"><col width="2" align="left" class="c2"></colgroup><tbody><tr><td colspan="2" align="center">Header</td></tr><tr height="200"><td align="left">Sidebar</td><td align="left">Main Content Pane</td></tr></tbody></table></div></div><br class="table-break"></li><li class="listitem"><p>The "Main Content" pane should contain the editable content that ETP provides.</p></li><li class="listitem"><p>The "Header" should display the title of the page that you set in ETP.</p></li><li class="listitem"><p>The "Sidebar" should display the extlinks that you add as a content item in ETP.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="exercise5"></a>Exercise 5: Register the col2 Template with ETP</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Need to register your template with ETP so that it appears in the drop-down menu that you would have seen in Exercise 3.</p><pre class="screen">cd ~/openacs/packages/edit-this-page/tcl
             emacs etp-custom-init.tcl</pre></li><li class="listitem"><p>Use the function etp::define_application to register your template with ETP</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>Uncomment the "asc" definition</p></li><li class="listitem"><p>Set allow_extlinks to true, the rest should be false.</p></li></ul></div></li><li class="listitem"><p>Restart your server for the changes to take effect.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="exercise6"></a>Exercise 6: Configure ETP to use the col2 Template</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Configure your ETP instance at /lab4/index to use the col2 template.</p></li><li class="listitem"><p>Create external links to link to other mounted ETP instances.</p></li><li class="listitem"><p>Check that your external links show up in the sidebar when you view your ETP application using the col2 template.</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="end"></a>Who Wrote This and When</h3></div></div></div><p>This problem set was originally written by <a class="ulink" href="http://www.weg.ee.usyd.edu.au/people/ncarroll" target="_top">Nick Carroll</a> in August 2004 for the <a class="ulink" href="http://www.usyd.edu.au" target="_top">University of Sydney</a> Course <a class="ulink" href="http://www.weg.ee.usyd.edu.au/courses/ebus5002" target="_top">EBUS5002</a>.</p><p>This material is copyright 2004 by Nick Carroll.  It may be copied, reused, and modified, provided credit is given to the original author.</p><div class="cvstag">($Id$)</div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tutorial-cvs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="tutorial-comments.html">Next</a></td></tr><tr><td width="40%" align="left">Add the new package to CVS </td><td width="20%" align="center"><a accesskey="u" href="tutorial-advanced.html">Up</a></td><td width="40%" align="right"> Adding Comments</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/tutorial-etp-templates.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html,v
diff -u -N -r1.42.2.2 -r1.42.2.3
--- openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html	9 Sep 2014 08:31:56 -0000	1.42.2.2
+++ openacs-4/packages/acs-core-docs/www/tutorial-newpackage.html	24 Oct 2014 14:34:03 -0000	1.42.2.3
@@ -2,7 +2,7 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Creating an Application Package</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="tutorial.html" title="Chapter 9. Development Tutorial"><link rel="previous" href="tutorial.html" title="Chapter 9. Development Tutorial"><link rel="next" href="tutorial-database.html" title="Setting Up Database Objects"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="tutorial.html">Prev</a> </td><th width="60%" align="center">Chapter 9. Development Tutorial</th><td width="20%" align="right"> <a accesskey="n" href="tutorial-database.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="tutorial-newpackage"></a>Creating an Application Package</h2></div></div></div><div class="authorblurb"><p>by <a class="ulink" href="mailto:joel@aufrecht.org" target="_top">Joel Aufrecht</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="tutorial-picture"></a>The intended page map</h3></div></div></div><div class="mediaobject"><img src="images/openacs-best-practice.png"></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726696991120"></a>Overview</h3></div></div></div><p>To start developing new code in OpenACS, we build a new package. A package 
+        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="tutorial-picture"></a>The intended page map</h3></div></div></div><div class="mediaobject"><img src="images/openacs-best-practice.png"></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717560462480"></a>Overview</h3></div></div></div><p>To start developing new code in OpenACS, we build a new package. A package 
       is a a discrete collection of web pages, tcl code, and database tables and procedures.
       A package with user interface is called an <span class="strong"><strong>application</strong></span>; 
       a package which provides functions to other packages and has no direct interface, a
@@ -18,11 +18,11 @@
         right now.  Code that is temporary hackage is clearly marked.
       </p><p>In this tutorial, we will make an application package for
     displaying a list of text notes.
-</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726697540016"></a>Before you begin</h3></div></div></div><p>You will need:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>A computer with a working installation of
+</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717559727488"></a>Before you begin</h3></div></div></div><p>You will need:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>A computer with a working installation of
 	  OpenACS.  If you don't have this, see <a class="xref" href="install-overview.html" title="Chapter 2. Installation Overview">Chapter 2, <i>Installation Overview</i></a>.
 	  </p></li><li class="listitem"><p>Example files, which are included in the
 standard OpenACS 5.7.0 distribution.
-	  </p></li></ul></div><div class="figure"><a name="idp140726696643408"></a><p class="title"><b>Figure 9.1. Assumptions in this section</b></p><div class="figure-contents"><div class="informaltable"><table cellspacing="0" border="1"><colgroup><col><col></colgroup><tbody><tr><td>Fully qualified domain name of your server</td><td><span class="replaceable"><span class="replaceable">yourserver.test</span></span></td></tr><tr><td>URL of your server</td><td><span class="replaceable"><span class="replaceable">http://yourserver.test:8000</span></span></td></tr><tr><td>Name of development account</td><td><span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td>New Package key</td><td><span class="replaceable"><span class="replaceable">myfirstpackage</span></span></td></tr></tbody></table></div></div></div><br class="figure-break"></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726698695616"></a>Use the APM to initialize a new package</h3></div></div></div><p>We use the <a class="ulink" href="packages.html" target="_top">ACS Package Manager</a> (APM) to add, remove, and
+	  </p></li></ul></div><div class="figure"><a name="idp140717559847248"></a><p class="title"><b>Figure 9.1. Assumptions in this section</b></p><div class="figure-contents"><div class="informaltable"><table cellspacing="0" border="1"><colgroup><col><col></colgroup><tbody><tr><td>Fully qualified domain name of your server</td><td><span class="replaceable"><span class="replaceable">yourserver.test</span></span></td></tr><tr><td>URL of your server</td><td><span class="replaceable"><span class="replaceable">http://yourserver.test:8000</span></span></td></tr><tr><td>Name of development account</td><td><span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td>New Package key</td><td><span class="replaceable"><span class="replaceable">myfirstpackage</span></span></td></tr></tbody></table></div></div></div><br class="figure-break"></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717560661520"></a>Use the APM to initialize a new package</h3></div></div></div><p>We use the <a class="ulink" href="packages.html" target="_top">ACS Package Manager</a> (APM) to add, remove, and
     upgrade packages.  It handles package meta-data, such as lists of
     files that belong in the package.  Each package is uniquely
     identified by a package key.  To start developing a new
@@ -55,7 +55,7 @@
           <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/<span class="replaceable"><span class="replaceable">myfirstpackage</span></span></code>.
           This is the "home directory" of our new package, and all
           files in the package will be within this directory. <a class="ulink" href="packages.html" target="_top">More on the structure of
-          packages</a>). </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726698716032"></a>Add an Application Instance to the Server</h3></div></div></div><p>In order to see your work in progress, you must create a
+          packages</a>). </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717560681936"></a>Add an Application Instance to the Server</h3></div></div></div><p>In order to see your work in progress, you must create a
       map between the URL space of incoming requests and the package application instance.
       You do this by adding the application in the main site administration).  This
       creates a link between the incoming URL requests and an
@@ -66,7 +66,7 @@
       in this tutorial.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Browse to
 <code class="computeroutput"><span class="replaceable"><span class="replaceable">http://yourserver.test:8000</span></span><a class="ulink" href="/admin/applications/application-add" target="_top">/admin/applications/application-add/</a></code>.</p></li><li class="listitem"><p>Choose "My First Package" from the list and click OK (the other fields are optional).</p></li></ol></div><p>By mounting the package, we've caused all requests to
       <code class="computeroutput">http://yourserver.test:8000/myfirstpackage</code>
-      to be satisfied from the files at <code class="computeroutput">/var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/www</code>.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726698723840"></a>Quick start</h3></div></div></div><p>The remainder of the tutorial walks you through each file one at a time as you create the package.  You can skip all this, and get a working package, by doing the following:</p><pre class="screen">cd /var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/acs-core-docs/www/files/tutorial
+      to be satisfied from the files at <code class="computeroutput">/var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/myfirstpackage/www</code>.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717563036880"></a>Quick start</h3></div></div></div><p>The remainder of the tutorial walks you through each file one at a time as you create the package.  You can skip all this, and get a working package, by doing the following:</p><pre class="screen">cd /var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/acs-core-docs/www/files/tutorial
 psql <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span> -f myfirstpackage-create.sql
 cp note-edit.* note-delete.tcl index.* ../../../../myfirstpackage/www/
 mkdir ../../../../myfirstpackage/lib
Index: openacs-4/packages/acs-core-docs/www/tutorial-pages.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-pages.html,v
diff -u -N -r1.43.2.2 -r1.43.2.3
--- openacs-4/packages/acs-core-docs/www/tutorial-pages.html	9 Sep 2014 08:31:57 -0000	1.43.2.2
+++ openacs-4/packages/acs-core-docs/www/tutorial-pages.html	24 Oct 2014 14:34:03 -0000	1.43.2.3
@@ -1,9 +1,9 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Creating Web Pages</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="tutorial.html" title="Chapter 9. Development Tutorial"><link rel="previous" href="tutorial-database.html" title="Setting Up Database Objects"><link rel="next" href="tutorial-debug.html" title="Debugging and Automated Testing"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="tutorial-database.html">Prev</a> </td><th width="60%" align="center">Chapter 9. Development Tutorial</th><td width="20%" align="right"> <a accesskey="n" href="tutorial-debug.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="tutorial-pages"></a>Creating Web Pages</h2></div></div></div><div class="authorblurb"><p>by <a class="ulink" href="mailto:joel@aufrecht.org" target="_top">Joel Aufrecht</a></p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Creating Web Pages</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="tutorial.html" title="Chapter 9. Development Tutorial"><link rel="previous" href="tutorial-database.html" title="Setting Up Database Objects"><link rel="next" href="tutorial-advanced.html" title="Chapter 10. Advanced Topics"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="tutorial-database.html">Prev</a> </td><th width="60%" align="center">Chapter 9. Development Tutorial</th><td width="20%" align="right"> <a accesskey="n" href="tutorial-advanced.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="tutorial-pages"></a>Creating Web Pages</h2></div></div></div><div class="authorblurb"><p>by <a class="ulink" href="mailto:joel@aufrecht.org" target="_top">Joel Aufrecht</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726689759984"></a>Install some API</h3></div></div></div><p>As a workaround for missing content-repository functionality, copy a provided file into the directory for tcl files:</p><pre class="screen">
-    <span class="action"><span class="action">cp /var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/acs-core-docs/www/files/tutorial/note-procs.tcl /var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/myfirstpackage/tcl/</span></span></pre><p>To make this file take effect, go to the <a class="ulink" href="/acs-admin/apm" target="_top">APM</a> and choose "Reload changed" for "MyFirstPackage".</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726698277840"></a>Page Map</h3></div></div></div><p>Our package will have two visible pages.  The first shows a list of all objects; the second shows a single object in view or edit mode, and can also be used to add an object.  The index page will display the list, but since we might reuse the list later, we'll put it in a seperate file and include it on the index page.</p><div class="figure"><a name="idp140726698448720"></a><p class="title"><b>Figure 9.5. Page Map</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/tutorial-page-map.png" align="middle" alt="Page Map"></div></div></div><br class="figure-break"></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726698145952"></a>Build the "Index" page</h3></div></div></div><p>Each user-visible page in your package has, typically,
+        </div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717563013824"></a>Install some API</h3></div></div></div><p>As a workaround for missing content-repository functionality, copy a provided file into the directory for tcl files:</p><pre class="screen">
+    <span class="action"><span class="action">cp /var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/acs-core-docs/www/files/tutorial/note-procs.tcl /var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/myfirstpackage/tcl/</span></span></pre><p>To make this file take effect, go to the <a class="ulink" href="/acs-admin/apm" target="_top">APM</a> and choose "Reload changed" for "MyFirstPackage".</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717560863424"></a>Page Map</h3></div></div></div><p>Our package will have two visible pages.  The first shows a list of all objects; the second shows a single object in view or edit mode, and can also be used to add an object.  The index page will display the list, but since we might reuse the list later, we'll put it in a seperate file and include it on the index page.</p><div class="figure"><a name="idp140717560509488"></a><p class="title"><b>Figure 9.5. Page Map</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/tutorial-page-map.png" align="middle" alt="Page Map"></div></div></div><br class="figure-break"></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717562968752"></a>Build the "Index" page</h3></div></div></div><p>Each user-visible page in your package has, typically,
       three parts.  The  <code class="computeroutput">tcl</code> file
       holds the procedural logic for the page, including Tcl and
       database-independent SQL code, and does things like
@@ -23,7 +23,7 @@
 
 set page_title [ad_conn instance_name]
 set context [list]</pre><p>Now <code class="computeroutput">index.adp</code>:</p><pre class="programlisting">&lt;master&gt;
-  &lt;property name="title"&gt;@page_title;noquote@&lt;/property&gt;
+  &lt;property name="doc(title)"&gt;@page_title;noquote@&lt;/property&gt;
   &lt;property name="context"&gt;@context;noquote@&lt;/property&gt;
 &lt;include src="/packages/myfirstpackage/lib/note-list"&gt;</pre><p>The index page includes the list page, which we put in /lib instead of /www to designate that it's available for reuse by other packages.</p><pre class="screen">[$OPENACS_SERVICE_NAME www]$<strong class="userinput"><code> mkdir /var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/myfirstpackage/lib</code></strong>
 [$OPENACS_SERVICE_NAME www]$<strong class="userinput"><code> cd /var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/myfirstpackage/lib</code></strong>
@@ -74,7 +74,7 @@
  
     @param item_id If present, assume we are editing that note.  Otherwise, we are creating a new note.
 } {
-    item_id:integer,optional
+    item_id:naturalnum,optional
 }
 
 ad_form -name note -form {
@@ -107,7 +107,7 @@
     ad_returnredirect "."
     ad_script_abort
 }</pre><pre class="screen">[$OPENACS_SERVICE_NAME www]$ <strong class="userinput"><code>emacs note-edit.adp</code></strong></pre><pre class="programlisting">&lt;master&gt;
-  &lt;property name="title"&gt;@page_title;noquote@&lt;/property&gt;
+  &lt;property name="doc(title)"&gt;@page_title;noquote@&lt;/property&gt;
   &lt;property name="context"&gt;@context;noquote@&lt;/property&gt;
   &lt;property name="focus"&gt;note.title&lt;/property&gt;
   
@@ -124,10 +124,10 @@
 }
 
 permission::require_write_permission -object_id $item_id
-set title [item::get_title $item_id]
+set title [content::item::get_title -item_id $item_id]
 mfp::note::delete -item_id $item_id
 
 ad_returnredirect "."
 # stop running this code, since we're redirecting
 abort
-</pre></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tutorial-database.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="tutorial-debug.html">Next</a></td></tr><tr><td width="40%" align="left">Setting Up Database Objects </td><td width="20%" align="center"><a accesskey="u" href="tutorial.html">Up</a></td><td width="40%" align="right"> Debugging and Automated Testing</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/tutorial-pages.html#comments">View comments on this page at openacs.org</a></center></body></html>
+</pre></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tutorial-database.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="tutorial-advanced.html">Next</a></td></tr><tr><td width="40%" align="left">Setting Up Database Objects </td><td width="20%" align="center"><a accesskey="u" href="tutorial.html">Up</a></td><td width="40%" align="right"> Chapter 10. Advanced Topics</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/tutorial-pages.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/tutorial-second-database.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-second-database.html,v
diff -u -N -r1.9.4.2 -r1.9.4.3
--- openacs-4/packages/acs-core-docs/www/tutorial-second-database.html	9 Sep 2014 08:31:57 -0000	1.9.4.2
+++ openacs-4/packages/acs-core-docs/www/tutorial-second-database.html	24 Oct 2014 14:34:03 -0000	1.9.4.3
@@ -18,7 +18,7 @@
 ns_param   verbose            $debug
 ns_param   extendedtableinfo  true
 ns_param   logsqlerrors       $debug
-if { $database == "oracle" } {
+if { $database eq "oracle" } {
     ns_param   driver             ora8
     ns_param   datasource         {}
     ns_param   user               $db_name
Index: openacs-4/packages/acs-core-docs/www/tutorial-wysiwyg-editor.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial-wysiwyg-editor.html,v
diff -u -N -r1.8.4.3 -r1.8.4.4
--- openacs-4/packages/acs-core-docs/www/tutorial-wysiwyg-editor.html	9 Sep 2013 16:50:34 -0000	1.8.4.3
+++ openacs-4/packages/acs-core-docs/www/tutorial-wysiwyg-editor.html	24 Oct 2014 14:34:03 -0000	1.8.4.4
@@ -2,7 +2,7 @@
 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Enabling WYSIWYG</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="tutorial-advanced.html" title="Chapter 10. Advanced Topics"><link rel="previous" href="tutorial-schedule-procs.html" title="Scheduled Procedures"><link rel="next" href="tutorial-parameters.html" title="Adding in parameters for your package"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="tutorial-schedule-procs.html">Prev</a> </td><th width="60%" align="center">Chapter 10. Advanced Topics</th><td width="20%" align="right"> <a accesskey="n" href="tutorial-parameters.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="tutorial-wysiwyg-editor"></a>Enabling WYSIWYG</h2></div></div></div><div class="authorblurb"><p>by <a class="ulink" href="mailto:nima.mazloumi@gmx.de" target="_top">Nima Mazloumi</a></p>
           OpenACS docs are written by the named authors, and may be edited
           by OpenACS documentation staff.
-        </div><p>Most of the forms in OpenACS are created using the form builder, see <a class="xref" href="form-builder.html" title="Using Form Builder: building html forms dynamically">the section called “Using Form Builder: building html forms dynamically”</a>. For detailed information on the 
+        </div><p>Most of the forms in OpenACS are created using the form builder, see <a class="xref" href="">???</a>. For detailed information on the 
     API take a look <a class="ulink" href="/api-doc/proc-view?proc=ad_form" target="_top">here</a>.</p><p>The following section shows how you can modify your form to allow WYSIWYG functionalities.</p><p>Convert your page to use <code class="code">ad_form</code> (some changes but worth it)</p><p>Here an examples. From:</p><pre class="programlisting">
 	template::form create my_form
 	template::element create my_form my_form_id -label "The ID" -datatype integer -widget hidden
Index: openacs-4/packages/acs-core-docs/www/tutorial.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/tutorial.html,v
diff -u -N -r1.24.2.1 -r1.24.2.2
--- openacs-4/packages/acs-core-docs/www/tutorial.html	21 Aug 2013 10:19:33 -0000	1.24.2.1
+++ openacs-4/packages/acs-core-docs/www/tutorial.html	24 Oct 2014 14:34:03 -0000	1.24.2.2
@@ -1,2 +1,2 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 9. Development Tutorial</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="acs-package-dev.html" title="Part III. For OpenACS Package Developers"><link rel="previous" href="acs-package-dev.html" title="Part III. For OpenACS Package Developers"><link rel="next" href="tutorial-newpackage.html" title="Creating an Application Package"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="acs-package-dev.html">Prev</a> </td><th width="60%" align="center">Part III. For OpenACS Package Developers</th><td width="20%" align="right"> <a accesskey="n" href="tutorial-newpackage.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="tutorial"></a>Chapter 9. Development Tutorial</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="tutorial-newpackage.html">Creating an Application Package</a></span></dt><dt><span class="sect1"><a href="tutorial-database.html">Setting Up Database Objects</a></span></dt><dt><span class="sect1"><a href="tutorial-pages.html">Creating Web Pages</a></span></dt><dt><span class="sect1"><a href="tutorial-debug.html">Debugging and Automated Testing</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="acs-package-dev.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="tutorial-newpackage.html">Next</a></td></tr><tr><td width="40%" align="left">Part III. For OpenACS Package Developers </td><td width="20%" align="center"><a accesskey="u" href="acs-package-dev.html">Up</a></td><td width="40%" align="right"> Creating an Application Package</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/tutorial.html#comments">View comments on this page at openacs.org</a></center></body></html>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 9. Development Tutorial</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="acs-package-dev.html" title="Part III. For OpenACS Package Developers"><link rel="previous" href="acs-package-dev.html" title="Part III. For OpenACS Package Developers"><link rel="next" href="tutorial-newpackage.html" title="Creating an Application Package"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="acs-package-dev.html">Prev</a> </td><th width="60%" align="center">Part III. For OpenACS Package Developers</th><td width="20%" align="right"> <a accesskey="n" href="tutorial-newpackage.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="tutorial"></a>Chapter 9. Development Tutorial</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="tutorial-newpackage.html">Creating an Application Package</a></span></dt><dt><span class="sect1"><a href="tutorial-database.html">Setting Up Database Objects</a></span></dt><dt><span class="sect1"><a href="tutorial-pages.html">Creating Web Pages</a></span></dt></dl></div>Section missing</div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="acs-package-dev.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="tutorial-newpackage.html">Next</a></td></tr><tr><td width="40%" align="left">Part III. For OpenACS Package Developers </td><td width="20%" align="center"><a accesskey="u" href="acs-package-dev.html">Up</a></td><td width="40%" align="right"> Creating an Application Package</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/tutorial.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html,v
diff -u -N -r1.26.2.1 -r1.26.2.2
--- openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html	21 Aug 2013 10:19:34 -0000	1.26.2.1
+++ openacs-4/packages/acs-core-docs/www/upgrade-4.5-to-4.6.html	24 Oct 2014 14:34:03 -0000	1.26.2.2
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Upgrading 4.5 or higher to 4.6.3</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="upgrade.html" title="Chapter 5. Upgrading"><link rel="previous" href="upgrade-overview.html" title="Overview"><link rel="next" href="upgrade-4.6.3-to-5.html" title="Upgrading OpenACS 4.6.3 to 5.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="upgrade-overview.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Upgrading</th><td width="20%" align="right"> <a accesskey="n" href="upgrade-4.6.3-to-5.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="upgrade-4.5-to-4.6"></a>Upgrading 4.5 or higher to 4.6.3</h2></div></div></div><a class="indexterm" name="idp140726694738848"></a><p>The required platform for OpenACS 4.6 is the same as
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Upgrading 4.5 or higher to 4.6.3</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="upgrade.html" title="Chapter 5. Upgrading"><link rel="previous" href="upgrade-overview.html" title="Overview"><link rel="next" href="upgrade-4.6.3-to-5.html" title="Upgrading OpenACS 4.6.3 to 5.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="upgrade-overview.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Upgrading</th><td width="20%" align="right"> <a accesskey="n" href="upgrade-4.6.3-to-5.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="upgrade-4.5-to-4.6"></a>Upgrading 4.5 or higher to 4.6.3</h2></div></div></div><a class="indexterm" name="idp140717558016720"></a><p>The required platform for OpenACS 4.6 is the same as
       4.5, with the exception of OpenFTS.  OpenACS 4.6 and later require OpenFTS 0.3.2 for full text search on PostGreSQL.  If you have OpenFTS 0.2, you'll need to upgrade.  </p><p>If upgrading from 4.4, you need to manually run acs-kernel/sql/postgres/upgrade-4.4-4.5.sql.  See <a class="ulink" href="http://openacs.org/bugtracker/openacs/bug?bug_number=632" target="_top">Bug #632</a></p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem" style="list-style-type: circle"><p>A computer with OpenACS 4.5.</p></li><li class="listitem" style="list-style-type: circle"><p><a class="ulink" href="http://openacs.org/projects/openacs/download/" target="_top">OpenACS 4.6 tarball</a> or CVS checkout/export.</p></li><li class="listitem" style="list-style-type: circle"><p>Required for Full Text Search on PostgreSQL: <a class="ulink" href="http://openfts.sourceforge.net" target="_top">OpenFTS 0.3.2</a></p></li></ul></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><b>Make a Backup. </b>Back up the database and file system (see <a class="xref" href="snapshot-backup.html" title="Manual backup and recovery">the section called “Manual backup and recovery”</a>).</p></li><li class="listitem"><p><b>OPTIONAL: Upgrade OpenFTS. </b><a class="xref" href="upgrade-supporting.html#upgrade-openfts-0.2-to-0.3.2" title="Upgrading OpenFTS from 0.2 to 0.3.2">the section called “Upgrading OpenFTS from 0.2 to 0.3.2”</a></p></li><li class="listitem"><p>
             Stop the server
           </p><pre class="screen">[root root]# <strong class="userinput"><code>svc -d /service/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></code></strong></pre></li><li class="listitem"><p><b>Upgrade the file system. </b><a class="xref" href="upgrade-openacs-files.html" title="Upgrading the OpenACS files">the section called “Upgrading the OpenACS files”</a></p></li><li class="listitem"><p>
Index: openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.html,v
diff -u -N -r1.26.2.1 -r1.26.2.2
--- openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.html	21 Aug 2013 10:19:34 -0000	1.26.2.1
+++ openacs-4/packages/acs-core-docs/www/upgrade-openacs-files.html	24 Oct 2014 14:34:04 -0000	1.26.2.2
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 'http://www.w3.org/TR/html4/loose.dtd"'>
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Upgrading the OpenACS files</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="upgrade.html" title="Chapter 5. Upgrading"><link rel="previous" href="upgrade-5-0-dot.html" title="Upgrading an OpenACS 5.0.0 or greater installation"><link rel="next" href="upgrade-supporting.html" title="Upgrading Platform components"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="upgrade-5-0-dot.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Upgrading</th><td width="20%" align="right"> <a accesskey="n" href="upgrade-supporting.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="upgrade-openacs-files"></a>Upgrading the OpenACS files</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694825744"></a>Chosing a Method to Upgrade your Files</h3></div></div></div><p>OpenACS is distributed in many different ways:
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Upgrading the OpenACS files</title><link rel="stylesheet" type="text/css" href="openacs.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="OpenACS Core Documentation"><link rel="up" href="upgrade.html" title="Chapter 5. Upgrading"><link rel="previous" href="upgrade-5-0-dot.html" title="Upgrading an OpenACS 5.0.0 or greater installation"><link rel="next" href="upgrade-supporting.html" title="Upgrading Platform components"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><a href="http://openacs.org"><img src="/doc/images/alex.jpg" style="border:0" alt="Alex logo"></a><table width="100%" summary="Navigation header" border="0"><tr><td width="20%" align="left"><a accesskey="p" href="upgrade-5-0-dot.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Upgrading</th><td width="20%" align="right"> <a accesskey="n" href="upgrade-supporting.html">Next</a></td></tr></table><hr></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="upgrade-openacs-files"></a>Upgrading the OpenACS files</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717558104768"></a>Chosing a Method to Upgrade your Files</h3></div></div></div><p>OpenACS is distributed in many different ways:
         </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>as a collection of files</p></li><li class="listitem"><p> as one big tarball</p></li><li class="listitem"><p> via CVS</p></li><li class="listitem"><p> via automatic download from within the APM
             (package manager)</p></li></ul></div><p>
       </p><p>Upgrades work by first changing the file system (via any
@@ -11,7 +11,7 @@
         describes whether or not you need to be upgrading using this
         page or not:
         <a class="xref" href="upgrade-5-0-dot.html" title="Upgrading an OpenACS 5.0.0 or greater installation">the section called “Upgrading an OpenACS 5.0.0 or greater installation”</a>
-      </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694830688"></a>Methods of upgrading OpenACS files</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><b>Upgrading files for a site which is not in a CVS repository. </b>Unpack the tarball into a new directory and copy its
+      </p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717558109856"></a>Methods of upgrading OpenACS files</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><b>Upgrading files for a site which is not in a CVS repository. </b>Unpack the tarball into a new directory and copy its
           contents on top of your working directory. Or just 'install
           software', select remote repository, and upgrade your files
           from there.</p><pre class="screen">[root root]# <strong class="userinput"><code>su - <span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></code></strong>
@@ -32,7 +32,7 @@
         with the latest OpenACS version, without overriding your own
         local customizations. </p><p>This diagram explains the basic idea. However, the
         labels are incorrect. Step 1(a) has been removed, and Step
-        1(b) should be labelled Step 1.</p><div class="figure"><a name="idp140726694840672"></a><p class="title"><b>Figure 5.2. Upgrading a local CVS repository</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/upgrade-cvs.png" align="middle" alt="Upgrading a local CVS repository"></div></div></div><br class="figure-break"><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p><b>Step 0: Set up a working CVS checkout. </b>To get your OpenACS code into your local CVS
+        1(b) should be labelled Step 1.</p><div class="figure"><a name="idp140717558119968"></a><p class="title"><b>Figure 5.2. Upgrading a local CVS repository</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/upgrade-cvs.png" align="middle" alt="Upgrading a local CVS repository"></div></div></div><br class="figure-break"><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p><b>Step 0: Set up a working CVS checkout. </b>To get your OpenACS code into your local CVS
                 repository, you will set up a working CVS checkout of
                 OpenACS. When you want to update your site, you'll
                 update the working CVS checkout, import those changes
@@ -97,7 +97,7 @@
       </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><pre class="screen">[$OPENACS_SERVICE_NAME ~]$ <strong class="userinput"><code>cd /var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></code></strong>
 [$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ <strong class="userinput"><code>cvs up -Pd</code></strong>
 (CVS feedback)
-[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$</pre></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140726694897744"></a>Upgrading a Production Site Safely</h3></div></div></div><p>If you are upgrading a production OpenACS site which is on a private CVS tree, this process lets you do the upgrade without risking extended downtime or an unusable site:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Declare a freeze on new cvs updates - ie, you cannot run cvs update
+[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$</pre></li></ol></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="idp140717558177104"></a>Upgrading a Production Site Safely</h3></div></div></div><p>If you are upgrading a production OpenACS site which is on a private CVS tree, this process lets you do the upgrade without risking extended downtime or an unusable site:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Declare a freeze on new cvs updates - ie, you cannot run cvs update
    on the production site</p></li><li class="listitem"><p>
             Make a manual backup of the production site in addition to the
    automated backups</p></li><li class="listitem"><p>Import the new code (for example, OpenACS 5.0.4, openacs-5-0-compat versions of
Index: openacs-4/packages/acs-core-docs/www/upgrade-overview.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/upgrade-overview.html,v
diff -u -N -r1.26.2.1 -r1.26.2.2
--- openacs-4/packages/acs-core-docs/www/upgrade-overview.html	21 Aug 2013 10:19:34 -0000	1.26.2.1
+++ openacs-4/packages/acs-core-docs/www/upgrade-overview.html	24 Oct 2014 14:34:04 -0000	1.26.2.2
@@ -4,4 +4,4 @@
     or better, you should always be able to upgrade all of your core
     packages automatically.  If you haven't changed anything, no
     manual intervention should be required.  If you are running
-    OpenACS prior to 4.5, upgrading will require manual effort.</p><p>If all of these conditions are true:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Your OpenACS Core is 5.0.0 or later</p></li><li class="listitem"><p>You do not keep your OpenACS site in a local CVS repository</p></li><li class="listitem"><p>You do not have any custom code</p></li></ul></div><p>then you can upgrade automatically using the automated installer in the OpenACS Package Manager (APM), and you can probably skip the rest of this chapter.  To upgrade directly from the OpenACS repository using the APM:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Browse to the <a class="ulink" href="/acs-admin/install/" target="_top">Installer</a>.</p></li><li class="listitem"><p>Click install or upgrade under "Install from OpenACS Repository" and select the packages to install or upgrade.</p></li><li class="listitem"><p>The APM will download the requested packages from OpenACS.org, install the files on your hard drive, run any appropriate database upgrade scripts, and prompt you to restart the server.  After restarting the server again, the upgrade is complete.</p></li></ol></div><div class="figure"><a name="idp140726691636320"></a><p class="title"><b>Figure 5.1. Upgrading with the APM</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/upgrade-apm.png" align="middle" alt="Upgrading with the APM"></div></div></div><br class="figure-break"><p>It's always a good idea to precede an upgrade attempt with a <a class="link" href="snapshot-backup.html" title="Manual backup and recovery">snapshot backup</a>.</p><div class="table"><a name="idp140726694731168"></a><p class="title"><b>Table 5.1. Assumptions in this section</b></p><div class="table-contents"><table summary="Assumptions in this section" cellspacing="0" border="1"><colgroup><col><col></colgroup><tbody><tr><td>name of OpenACS user</td><td><span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td>OpenACS server name</td><td><span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td>Root of OpenACS file tree</td><td><span class="replaceable"><span class="replaceable">/var/lib/aolserver/$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td>Database backup directory</td><td><span class="replaceable"><span class="replaceable">/var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backup</span></span></td></tr></tbody></table></div></div><br class="table-break"></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="upgrade.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="upgrade-4.5-to-4.6.html">Next</a></td></tr><tr><td width="40%" align="left">Chapter 5. Upgrading </td><td width="20%" align="center"><a accesskey="u" href="upgrade.html">Up</a></td><td width="40%" align="right"> Upgrading 4.5 or higher to 4.6.3</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/upgrade-overview.html#comments">View comments on this page at openacs.org</a></center></body></html>
+    OpenACS prior to 4.5, upgrading will require manual effort.</p><p>If all of these conditions are true:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>Your OpenACS Core is 5.0.0 or later</p></li><li class="listitem"><p>You do not keep your OpenACS site in a local CVS repository</p></li><li class="listitem"><p>You do not have any custom code</p></li></ul></div><p>then you can upgrade automatically using the automated installer in the OpenACS Package Manager (APM), and you can probably skip the rest of this chapter.  To upgrade directly from the OpenACS repository using the APM:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Browse to the <a class="ulink" href="/acs-admin/install/" target="_top">Installer</a>.</p></li><li class="listitem"><p>Click install or upgrade under "Install from OpenACS Repository" and select the packages to install or upgrade.</p></li><li class="listitem"><p>The APM will download the requested packages from OpenACS.org, install the files on your hard drive, run any appropriate database upgrade scripts, and prompt you to restart the server.  After restarting the server again, the upgrade is complete.</p></li></ol></div><div class="figure"><a name="idp140717556838416"></a><p class="title"><b>Figure 5.1. Upgrading with the APM</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/upgrade-apm.png" align="middle" alt="Upgrading with the APM"></div></div></div><br class="figure-break"><p>It's always a good idea to precede an upgrade attempt with a <a class="link" href="snapshot-backup.html" title="Manual backup and recovery">snapshot backup</a>.</p><div class="table"><a name="idp140717558009040"></a><p class="title"><b>Table 5.1. Assumptions in this section</b></p><div class="table-contents"><table summary="Assumptions in this section" cellspacing="0" border="1"><colgroup><col><col></colgroup><tbody><tr><td>name of OpenACS user</td><td><span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td>OpenACS server name</td><td><span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td>Root of OpenACS file tree</td><td><span class="replaceable"><span class="replaceable">/var/lib/aolserver/$OPENACS_SERVICE_NAME</span></span></td></tr><tr><td>Database backup directory</td><td><span class="replaceable"><span class="replaceable">/var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backup</span></span></td></tr></tbody></table></div></div><br class="table-break"></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="upgrade.html">Prev</a> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right"> <a accesskey="n" href="upgrade-4.5-to-4.6.html">Next</a></td></tr><tr><td width="40%" align="left">Chapter 5. Upgrading </td><td width="20%" align="center"><a accesskey="u" href="upgrade.html">Up</a></td><td width="40%" align="right"> Upgrading 4.5 or higher to 4.6.3</td></tr></table><hr><address><a href="mailto:docs@openacs.org">docs@openacs.org</a></address></div><a name="comments"></a><center><a href="http://openacs.org/doc/current/upgrade-overview.html#comments">View comments on this page at openacs.org</a></center></body></html>
Index: openacs-4/packages/acs-core-docs/www/variables.html
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/variables.html,v
diff -u -N -r1.29.2.1 -r1.29.2.2
--- openacs-4/packages/acs-core-docs/www/variables.html	21 Aug 2013 10:19:34 -0000	1.29.2.1
+++ openacs-4/packages/acs-core-docs/www/variables.html	24 Oct 2014 14:34:04 -0000	1.29.2.2
@@ -4,7 +4,7 @@
           by OpenACS documentation staff.
         </div><p>Starting with OpenACS 5.0 and the introduction of acs-lang,
     we recommend retrieving date/time information from the database in
-    ANSI format and then using <a class="ulink" href="/api-doc/proc-view?proc=lc%5ftime%5ffmt" target="_top">lc_time_fmt</a> to format it for display.</p><div class="example"><a name="idp140726695125520"></a><p class="title"><b>Example 12.1. Getting datetime from the database ANSI-style</b></p><div class="example-contents"><pre class="programlisting">db_multirow -extend { mydate_pretty } {
+    ANSI format and then using <a class="ulink" href="/api-doc/proc-view?proc=lc%5ftime%5ffmt" target="_top">lc_time_fmt</a> to format it for display.</p><div class="example"><a name="idp140717563967264"></a><p class="title"><b>Example 12.1. Getting datetime from the database ANSI-style</b></p><div class="example-contents"><pre class="programlisting">db_multirow -extend { mydate_pretty } {
     select to_char(mydate, 'YYYY-MM-DD HH24:MI:SS') as mydate_ansi,
           ...
     ...
Index: openacs-4/packages/acs-core-docs/www/xml/Makefile
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/Makefile,v
diff -u -N -r1.15.10.1 -r1.15.10.2
--- openacs-4/packages/acs-core-docs/www/xml/Makefile	21 Aug 2013 10:18:44 -0000	1.15.10.1
+++ openacs-4/packages/acs-core-docs/www/xml/Makefile	24 Oct 2014 14:34:04 -0000	1.15.10.2
@@ -55,12 +55,11 @@
 
 prelim: images 
 	cp images/*.{pdf,png,gif,jpg} ../images/
+	# all non-regenerated html is kept in a sub-dir so that we can delete html
+	# in the main directory before regenerating
+	# this helps avoid meaningless cvs conflicts in second-hand files
+	rm -f ../*html
 
-# all non-regenerated html is kept in a sub-dir so that we can delete html
-# in the main directory before regenerating
-# this helps avoid meaningless cvs conflicts in second-hand files
-	rm ../*html
-
 target: non-xml
 # the dash u part of cp -u is redundant in the context of make/Makefile
 	cp non-xml/*.html ..
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 -N -r1.31 -r1.31.12.1
--- openacs-4/packages/acs-core-docs/www/xml/index.xml	17 Jul 2006 05:38:37 -0000	1.31
+++ openacs-4/packages/acs-core-docs/www/xml/index.xml	24 Oct 2014 14:34:04 -0000	1.31.12.1
@@ -1,100 +1,100 @@
 <?xml version='1.0'?>
 
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
-               "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
 <!-- Global variables are defined in variables.ent -->
 <!ENTITY % myvars SYSTEM "variables.ent">
 %myvars;
 
 ]>
 
 <book>
-  <title>OpenACS Core Documentation</title>
+<title>OpenACS Core Documentation</title>
 
-  <part id="for-everyone">
-    <title>OpenACS For Everyone</title>
+<part id="for-everyone">
+  <title>OpenACS For Everyone</title>
 
-    <chapter id="general-documents">
-      <title>High level information: What is OpenACS?</title>
+  <chapter id="general-documents">
+    <title>High level information: What is OpenACS?</title>
 
-      <sect1 id="openacs-overview" xreflabel="OpenACS Overview">
-        <title>Overview</title>
-        <para>
-          OpenACS (Open Architecture Community System) is an
-          advanced toolkit for building scalable, community-oriented
-          web applications.  If you're thinking of building an
-          enterprise-level web application, OpenACS is a solid,
-          scalable framework for building dynamic content driven
-          sites.
-        </para>
+    <sect1 id="openacs-overview" xreflabel="OpenACS Overview">
+      <title>Overview</title>
+      <para>
+        OpenACS (Open Architecture Community System) is an
+        advanced toolkit for building scalable, community-oriented
+        web applications.  If you're thinking of building an
+        enterprise-level web application, OpenACS is a solid,
+        scalable framework for building dynamic content driven
+        sites.
+      </para>
 
-        <para>
-          OpenACS is a collection of pre-built applications and
-          services that you can use to build your web
-          site/application. Through a modular architecture, OpenACS
-          has packages for user/groups management, content
-          management, e-commerce, news, FAQs, calendar, forums, bug
-          tracking, full-text searching, and <ulink
-            url="http://openacs.org/packages/">much
-            more</ulink>.
-        </para>
+      <para>
+        OpenACS is a collection of pre-built applications and
+        services that you can use to build your web
+        site/application. Through a modular architecture, OpenACS
+        has packages for user/groups management, content
+        management, e-commerce, news, FAQs, calendar, forums, bug
+        tracking, full-text searching, and <ulink
+        url="http://openacs.org/packages/">much
+        more</ulink>.
+      </para>
 
 
-        <para>
-          OpenACS relies on <ulink
-            url="http://www.aolserver.com/">AOLserver</ulink>, the
-          free, multithreaded, scalable, Tcl-enabled,
-          web/application server used by America Online for most of
-          its web sites, and a true ACID-compliant Relational
-          Database Management System (RDBMS). Currently OpenACS
-          supports PostgreSQL, an open source RDBMS, and Oracle and
-          is easily extensible to other databases which support a
-          comparable feature set.
-        </para>
+      <para>
+        OpenACS relies on <ulink
+        url="http://www.aolserver.com/">AOLserver</ulink>, the
+        free, multithreaded, scalable, Tcl-enabled,
+        web/application server used by America Online for most of
+        its web sites, and a true ACID-compliant Relational
+        Database Management System (RDBMS). Currently OpenACS
+        supports PostgreSQL, an open source RDBMS, and Oracle and
+        is easily extensible to other databases which support a
+        comparable feature set.
+      </para>
 
-        <para>
-          The OpenACS toolkit is derived from the ArsDigita
-          Community System (ACS). ArsDigita (now part of Red Hat,
-          Inc.) kindly made their work available under the <ulink
-            url="http://www.gnu.org/licenses/gpl.txt">GPL</ulink>,
-          making all of this possible.
-        </para>
+      <para>
+        The OpenACS toolkit is derived from the ArsDigita
+        Community System (ACS). ArsDigita (now part of Red Hat,
+        Inc.) kindly made their work available under the <ulink
+        url="http://www.gnu.org/licenses/gpl.txt">GPL</ulink>,
+        making all of this possible.
+      </para>
 
-        <para>
-          The OpenACS project was born when Don Baccus, Ben Adida, and
-          others decided to port ACS from Oracle to PostgreSQL, thus
-          making it a fully open-source solution.  With OpenACS 4,
-          Oracle and PostgreSQL support were combined in one code base
-          and with OpenACS 5, support for internationalization and
-          localization has been added.
-        </para>
+      <para>
+        The OpenACS project was born when Don Baccus, Ben Adida, and
+        others decided to port ACS from Oracle to PostgreSQL, thus
+        making it a fully open-source solution.  With OpenACS 4,
+        Oracle and PostgreSQL support were combined in one code base
+        and with OpenACS 5, support for internationalization and
+        localization has been added.
+      </para>
 
-        <para>
-          A vibrant and productive community has sprung up around the
-          OpenACS software and there are many volunteer contributors
-          as well as a commercial companies able to provide support,
-          hosting, and custom development.  Many of the production
-          users are actively funding and contributing work back to the
-          project.  Formal, consensus driven governance has been
-          established (with semi-annual elections) which ensures the
-          project serves the needs of it's constituents.
-        </para>
+      <para>
+        A vibrant and productive community has sprung up around the
+        OpenACS software and there are many volunteer contributors
+        as well as a commercial companies able to provide support,
+        hosting, and custom development.  Many of the production
+        users are actively funding and contributing work back to the
+        project.  Formal, consensus driven governance has been
+        established (with semi-annual elections) which ensures the
+        project serves the needs of it's constituents.
+      </para>
 
-        <para>
-          The OpenACS community would like to hear your comments and
-          can help you in your endeavors with the system. Visit our
-          <ulink url="http://openacs.org/">web site</ulink> and feel
-          free to <ulink url="http://openacs.org/forums/">ask questions or provide feedback</ulink>.
-        </para>
-      </sect1>
-      <xi:include href="for-everyone/release-notes.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Release Notes Section Missing</xi:fallback>
-      </xi:include>
-    </chapter>
-  </part>
+      <para>
+        The OpenACS community would like to hear your comments and
+        can help you in your endeavors with the system. Visit our
+        <ulink url="http://openacs.org/">web site</ulink> and feel
+        free to <ulink url="http://openacs.org/forums/">ask questions or provide feedback</ulink>.
+      </para>
+    </sect1>
+    <xi:include href="for-everyone/release-notes.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Release Notes Section Missing</xi:fallback>
+    </xi:include>
+  </chapter>
+</part>
 
-  <part id="acs-admin">
-    <title>Administrator's Guide</title>
+<part id="acs-admin">
+  <title>Administrator's Guide</title>
 
   <chapter id="install-overview">
     <title>Installation Overview</title>
@@ -106,318 +106,318 @@
     <xi:include href="install-guide/overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
       <xi:fallback>Overview Section Missing</xi:fallback>
     </xi:include>
-<!--
-    <xi:include href="install-guide/quick.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-      <xi:fallback><para>Quick Guide Missing</para></xi:fallback>
-    </xi:include>
--->
+    <!--
+	<xi:include href="install-guide/quick.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+	<xi:fallback><para>Quick Guide Missing</para></xi:fallback>
+	</xi:include>
+    -->
     <xi:include href="install-guide/software.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
       <xi:fallback>Section Missing</xi:fallback>
     </xi:include>
-    </chapter>
+  </chapter>
 
-    <chapter id="complete-install">
-      <title>Complete Installation</title>
-      <xi:include href="install-guide/os.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section Missing</xi:fallback>
-      </xi:include>
+  <chapter id="complete-install">
+    <title>Complete Installation</title>
+    <xi:include href="install-guide/os.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section Missing</xi:fallback>
+    </xi:include>
 
-      <xi:include href="install-guide/oracle.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback><para>Section Missing</para></xi:fallback>
-      </xi:include>
-      <xi:include  href="install-guide/postgres.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section Missing</xi:fallback>
-      </xi:include>
+    <xi:include href="install-guide/oracle.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback><para>Section Missing</para></xi:fallback>
+    </xi:include>
+    <xi:include  href="install-guide/postgres.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section Missing</xi:fallback>
+    </xi:include>
 
-      <xi:include href="install-guide/aolserver4.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section Missing</xi:fallback>
-      </xi:include>
+    <xi:include href="install-guide/aolserver4.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section Missing</xi:fallback>
+    </xi:include>
 
-      <xi:include href="install-guide/openacs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section Missing</xi:fallback>
-      </xi:include>
+    <xi:include href="install-guide/openacs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section Missing</xi:fallback>
+    </xi:include>
 
-      <xi:include href="install-guide/win2kinstall.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
+    <xi:include href="install-guide/win2kinstall.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
 
-      <xi:include href="install-guide/macinstall.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-    </chapter>
-
-    <xi:include href="install-guide/configuring.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:include href="install-guide/macinstall.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
       <xi:fallback>Section missing</xi:fallback>
     </xi:include>
+  </chapter>
 
-    <xi:include href="install-guide/upgrade.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+  <xi:include href="install-guide/configuring.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>Section missing</xi:fallback>
+  </xi:include>
+
+  <xi:include href="install-guide/upgrade.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>Section missing</xi:fallback>
+  </xi:include>
+  
+  <xi:include href="install-guide/maintenance.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>Section missing</xi:fallback>
+  </xi:include>
+
+  <xi:include href="install-guide/database-maintenance.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>Section missing</xi:fallback>
+  </xi:include>
+
+  <xi:include href="install-guide/recovery.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>Section missing</xi:fallback>
+  </xi:include>
+
+
+  <xi:include href="install-guide/red-hat.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>Section missing</xi:fallback>
+  </xi:include>
+
+  <xi:include href="install-guide/other-software.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>Section missing</xi:fallback>
+  </xi:include>
+
+  <xi:include href="install-guide/credits.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>Credits Section Missing</xi:fallback>
+  </xi:include>
+</part>
+
+<part id="acs-package-dev">
+  <title>For OpenACS Package Developers</title>
+  <partintro>
+    <para>Tutorials and reference material for creating new OpenACS packages.
+    </para>
+  </partintro>
+
+  <chapter id="tutorial"> 
+    <title>Development Tutorial</title>
+    <xi:include href="developers-guide/tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
       <xi:fallback>Section missing</xi:fallback>
     </xi:include>
-    
-    <xi:include href="install-guide/maintenance.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:include href="developers-guide/tutorial-db.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
       <xi:fallback>Section missing</xi:fallback>
     </xi:include>
-
-    <xi:include href="install-guide/database-maintenance.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:include href="developers-guide/tutorial-pages.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
       <xi:fallback>Section missing</xi:fallback>
     </xi:include>
-
-    <xi:include href="install-guide/recovery.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:include href="developers-guide/tutorial-debug.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
       <xi:fallback>Section missing</xi:fallback>
     </xi:include>
+  </chapter>
+  <xi:include href="developers-guide/tutorial-advanced.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>Section missing</xi:fallback>
+  </xi:include>
 
+  <chapter id="dev-guide">
+    <title>Development Reference</title>
 
-    <xi:include href="install-guide/red-hat.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:include href="developers-guide/packages.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
       <xi:fallback>Section missing</xi:fallback>
     </xi:include>
-
-    <xi:include href="install-guide/other-software.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:include href="developers-guide/objects.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
       <xi:fallback>Section missing</xi:fallback>
     </xi:include>
-
-    <xi:include href="install-guide/credits.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-      <xi:fallback>Credits Section Missing</xi:fallback>
+    <xi:include href="developers-guide/rp.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
     </xi:include>
-  </part>
+    <xi:include href="developers-guide/db-api.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="developers-guide/templates.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="developers-guide/permissions.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="developers-guide/subsites.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="developers-guide/parties.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="developers-guide/permissions-tediously-explained.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="developers-guide/object-identity.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="developers-guide/programming-with-aolserver.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="developers-guide/form-builder.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+  </chapter>
 
-  <part id="acs-package-dev">
-    <title>For OpenACS Package Developers</title>
-    <partintro>
-      <para>Tutorials and reference material for creating new OpenACS packages.
-      </para>
-    </partintro>
+  <chapter id="eng-standards">
+    <title>Engineering Standards</title>
 
-    <chapter id="tutorial"> 
-      <title>Development Tutorial</title>
-      <xi:include href="developers-guide/tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/tutorial-db.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/tutorial-pages.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/tutorial-debug.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-    </chapter>
-    <xi:include href="developers-guide/tutorial-advanced.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:include href="engineering-standards/style-guide.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
       <xi:fallback>Section missing</xi:fallback>
     </xi:include>
+    
+    <xi:include href="engineering-standards/cvs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="engineering-standards/eng-standards-versioning.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="engineering-standards/constraint-naming.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="engineering-standards/filenaming.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="engineering-standards/plsql.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="engineering-standards/variables.xml"  xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="engineering-standards/auto-testing.xml"  xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
 
-    <chapter id="dev-guide">
-      <title>Development Reference</title>
+  </chapter>
 
-      <xi:include href="developers-guide/packages.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/objects.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/rp.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/db-api.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/templates.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/permissions.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/subsites.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/parties.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/permissions-tediously-explained.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/object-identity.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/programming-with-aolserver.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="developers-guide/form-builder.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-    </chapter>
+  <chapter id="doc-standards">
+    <title>Documentation Standards</title>
+    <xi:include href="engineering-standards/docbook-primer.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="engineering-standards/psgml-mode.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="engineering-standards/nxml-mode.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="engineering-standards/design-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="engineering-standards/requirements-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+  </chapter>
 
-    <chapter id="eng-standards">
-      <title>Engineering Standards</title>
+  <xi:include href="developers-guide/i18n.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>Section missing</xi:fallback>
+  </xi:include>
 
-       <xi:include href="engineering-standards/style-guide.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
- 
-      <xi:include href="engineering-standards/cvs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="engineering-standards/eng-standards-versioning.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="engineering-standards/constraint-naming.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="engineering-standards/filenaming.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="engineering-standards/plsql.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="engineering-standards/variables.xml"  xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="engineering-standards/auto-testing.xml"  xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
+  <xi:include href="developers-guide/cvs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>CVS Section missing</xi:fallback>
+  </xi:include>
 
-    </chapter>
+</part>
 
-    <chapter id="doc-standards">
-      <title>Documentation Standards</title>
-      <xi:include href="engineering-standards/docbook-primer.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="engineering-standards/psgml-mode.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="engineering-standards/nxml-mode.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="engineering-standards/design-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="engineering-standards/requirements-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-    </chapter>
+<part id="acs-plat-dev">
+  <title>For OpenACS Platform Developers</title>
+  <chapter id="kernel-doc">
+    <title>Kernel Documentation</title>
 
-      <xi:include href="developers-guide/i18n.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
+    <sect1 id="kernel-overview">
+      <title>Overview</title>
 
-    <xi:include href="developers-guide/cvs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-      <xi:fallback>CVS Section missing</xi:fallback>
-    </xi:include>
+      <itemizedlist>
+        <listitem>
+          <para>
+            The <emphasis>OpenACS Kernel</emphasis>, which
+            handles system-wide necessities such as metadata,
+            security, users and groups, subsites, and package
+            management and deployment.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            The <emphasis>OpenACS Core</emphasis>, which
+            comprises all the other packages that ship with the
+            kernel and are most frequently needed by users, such as
+            templating, forums, and user
+            registration/management. The packages tend to be
+            developed and distributed with the kernel.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
 
-  </part>
+            <emphasis>OpenACS Application packages</emphasis>,
+            which typically provide user-level
+            web services built on top of the Kernel and Core.
+            Application packages are
+            developed separately from the Kernel, and are typically
+            released independently of it.
 
-  <part id="acs-plat-dev">
-    <title>For OpenACS Platform Developers</title>
-    <chapter id="kernel-doc">
-      <title>Kernel Documentation</title>
+          </para>
+        </listitem>
+      </itemizedlist>
+      <para>
+        This document provides a high level overview of the kernel
+        package. <ulink url="index.html">Documentation for other packages on this server</ulink>
+      </para>
+    </sect1>
 
-      <sect1 id="kernel-overview">
-        <title>Overview</title>
-
-        <itemizedlist>
-          <listitem>
-            <para>
-              The <emphasis>OpenACS Kernel</emphasis>, which
-              handles system-wide necessities such as metadata,
-              security, users and groups, subsites, and package
-              management and deployment.
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-              The <emphasis>OpenACS Core</emphasis>, which
-              comprises all the other packages that ship with the
-              kernel and are most frequently needed by users, such as
-              templating, forums, and user
-              registration/management. The packages tend to be
-              developed and distributed with the kernel.
-            </para>
-          </listitem>
-          <listitem>
-            <para>
-
-              <emphasis>OpenACS Application packages</emphasis>,
-              which typically provide user-level
-              web services built on top of the Kernel and Core.
-              Application packages are
-              developed separately from the Kernel, and are typically
-              released independently of it.
-
-            </para>
-          </listitem>
-        </itemizedlist>
-        <para>
-          This document provides a high level overview of the kernel
-          package. <ulink url="index.html">Documentation for other packages on this server</ulink>
-        </para>
-      </sect1>
-
-      <xi:include href="kernel/object-system-req.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/object-system-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/permissions-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/permissions-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/groups-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/groups-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/subsites-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/subsites-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/apm-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/apm-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/db-api.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/i18n-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/security-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/security-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/security-notes.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/rp-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/rp-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/tcl-doc.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/bootstrap-acs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-      <xi:include href="kernel/ext-auth.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-        <xi:fallback>Section missing</xi:fallback>
-      </xi:include>
-    </chapter>
-    <xi:include href="releasing-openacs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
-      <xi:fallback>'Releasing OpenACS' missing</xi:fallback>
+    <xi:include href="kernel/object-system-req.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
     </xi:include>
+    <xi:include href="kernel/object-system-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/permissions-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/permissions-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/groups-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/groups-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/subsites-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/subsites-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/apm-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/apm-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/db-api.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/i18n-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/security-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/security-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/security-notes.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/rp-requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/rp-design.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/tcl-doc.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/bootstrap-acs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+    <xi:include href="kernel/ext-auth.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+      <xi:fallback>Section missing</xi:fallback>
+    </xi:include>
+  </chapter>
+  <xi:include href="releasing-openacs.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:fallback>'Releasing OpenACS' missing</xi:fallback>
+  </xi:include>
 
-  </part>
+</part>
 <index></index>
 </book>
Index: openacs-4/packages/acs-core-docs/www/xml/for-everyone/release-notes.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/for-everyone/release-notes.xml,v
diff -u -N -r1.29.2.2 -r1.29.2.3
--- openacs-4/packages/acs-core-docs/www/xml/for-everyone/release-notes.xml	9 Sep 2014 08:31:58 -0000	1.29.2.2
+++ openacs-4/packages/acs-core-docs/www/xml/for-everyone/release-notes.xml	24 Oct 2014 14:34:04 -0000	1.29.2.3
@@ -33,11 +33,172 @@
   </sect2>
 END OF TEMPLATE -->
 
+<!--
 <para>The ChangeLogs include an annotated list of changes (<xref
 linkend="changelog-latest"></xref>) since the last release and in the
 entire &majorversion;.&minorversion; release sequence <xref linkend="changelog"></xref>.</para>
+-->
 
+<sect2  id="release-notes-5-8-1">
+  <title>Release 5.8.1</title>
+  <itemizedlist>
+    <listitem><para>
+      The release contains the 78 packages of the oacs-5-8 branch.
+      These packages contain the OpenACS core packages, major
+      application packages (e.g. most the ones used on OpenACS.org), and
+      DotLRN.
+    </para></listitem>
 
+    <listitem><para>
+      All packages have the following properties:
+      <itemizedlist>
+	<listitem><para>SQL:
+	<itemizedlist>
+
+	  <listitem><para>
+            All packages are PostgreSQL 9.1+ compatible 
+            (tested with PostgreSQL 9.3)
+	  </para></listitem>
+
+	  <listitem><para>
+            All SQL files with stored procedures use the
+            recommended $$ quoting
+	  </para></listitem>
+
+	  <listitem><para>
+            All SQL-functions have regular function arguments
+            instead of the old-style aliases
+	  </para></listitem>
+
+	  <listitem><para>
+            The function_args() (query-able meta-data) are
+            completed and fixed
+	  </para></listitem>
+
+	  <listitem><para>
+            Incompatible functions (e.g. for sequences) are
+            replaced.
+	  </para></listitem>
+	</itemizedlist>	    
+	</para></listitem>
+
+	<listitem><para>Tcl:
+	<itemizedlist>
+
+ 	  <listitem><para>
+            All packages were brought up Tcl 8.5, including
+            the actual Tcl idioms where appropriate (e.g.
+            using the safer expand operator, range indices,
+            dict, lassign, etc.)
+	  </para></listitem>
+
+ 	  <listitem><para>
+            The code was updated to prefer byte-compiled functions
+            instead of legacy functions from ancient Tcl versions.
+	  </para></listitem>
+
+ 	  <listitem><para>
+            The code works with NaviServer and AOLserver.
+	  </para></listitem>
+	</itemizedlist>
+	</para></listitem>
+
+	<listitem><para>API:
+	<itemizedlist>
+
+ 	  <listitem><para>
+            All packages are free from calls to deprecated code
+            (157 functions are marked as deprecated and will be
+            moved into an "outdated" package in the 5.9 or 6.0
+	    release)
+	  </para></listitem>
+
+ 	  <listitem><para>
+	    General overhaul of package management
+	  </para></listitem>
+
+ 	  <listitem><para>
+            Install-from-local and install-from-repository can be used
+            to install the provided packages based on a acs-core
+            installation. This means that also DotLRN can be
+            installed from repository or from
+            local into an existing OpenACS instance.
+	  </para></listitem>
+
+ 	  <listitem><para>
+            Install-from-repository offers filtering functions, allows
+            to install optionally from head-channel (for packages
+            not in the base channel of the installed instance).
+            Install-from-repository works more like an app-store,
+            showing as well vendor information
+	  </para></listitem>
+
+ 	  <listitem><para>
+            Packages can be equipped with configuration files
+            (e.g. changing parameters for style packages)
+	  </para></listitem>
+
+ 	  <listitem><para>
+            Package developers can upload .apm packages via workflow
+            for review by core members and for inclusion to the
+            repository. The option is integrated with package
+            management, the link is offered for local packages.
+            We hope to attract additional vendors (universities,
+            companies) to make their packages available on this
+	    path.
+	  </para></listitem>
+
+ 	  <listitem><para>
+            New management-functions for package instances
+            (list, create, delete package instances)
+	  </para></listitem>
+	  
+ 	  <listitem><para>
+            Substantially improved API browser:
+	    <itemizedlist>
+ 	      <listitem><para>
+		Show just relevant parts of .xql files for a function
+	      </para></listitem>
+
+ 	      <listitem><para>
+		Provide syntax-highlighting for www scripts as well
+	      </para></listitem>
+
+ 	      <listitem><para>
+		Handle more special cases like e.g. util_memoize
+	      </para></listitem>
+
+ 	      <listitem><para>
+		Provide links to Tcl functions depending on the installed
+		Tcl version
+	      </para></listitem>
+
+ 	      <listitem><para>
+		Provide links to NaviServer or OpenACS functions depending
+		on installed version
+	      </para></listitem>
+
+ 	      <listitem><para>
+		Syntax highlighter uses CSS rather than hard-coded markup
+	      </para></listitem>
+
+ 	      <listitem><para>
+		Significant performance improvement for large
+		installations
+	      </para></listitem>
+	    </itemizedlist>
+ 	  </para></listitem>
+	</itemizedlist>
+	</para></listitem>
+      </itemizedlist>
+    </para> </listitem>
+  </itemizedlist>
+  <para> Altogether, OpenACS 5.8.1 differs from OpenACS 5.8.0 in
+  about 100,000 modifications (6145 commits) contributed by 5
+  committers.
+  </para>
+</sect2>
+
   <sect2  id="release-notes-5-8-0">
     <title>Release 5.8.0</title>
     <itemizedlist>
@@ -47,17 +208,15 @@
 	  settings in new PostgreSQL versions. This makes it easier to use
 	  e.g. shared or packaged PostgreSQL installations.
       </para></listitem>
-      <listitem><para>Compatibility with NaviServer 4.99.5 or newer/para></listitem>
-      <listitem><para>Performance and scalability improvements/para></listitem>
+      <listitem><para>Compatibility with NaviServer 4.99.5 or newer</para></listitem>
+      <listitem><para>Performance and scalability improvements</para></listitem>
       <listitem><para>Various bug fixes </para></listitem>
     </itemizedlist>
     <para> Altogether, OpenACS 5.8.0 differs from OpenACS 5.7.0 in
     more than 18.000 modifications (781 commits) contributed by 7
     committers.
     </para>
-    <para> For details, see
-    <programlisting><xi:include href="../../../../../Announce-OpenACS-5.8.0" xi:parse="text" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback>Announcement missing</xi:fallback></xi:include></programlisting>
-    </para>
+
   </sect2>
     
   <sect2 id="release-notes-5-7-0">
@@ -604,24 +763,23 @@
      minor releases, changelog-latest = changelog
 -->
 
- 
-  <sect2 id="changelog-latest">
-    <title>Changelog (most recent release only)</title>
-    <programlisting><xi:include href="../../../../../ChangeLog" xi:parse="text" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback>ChangeLog missing</xi:fallback></xi:include></programlisting>
-
-  </sect2>
+<!--
+     <sect2 id="changelog-latest">
+       <title>Changelog (most recent release only)</title>
+       <programlisting><xi:include href="../../../../../ChangeLog" xi:parse="text" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback>ChangeLog missing</xi:fallback></xi:include></programlisting>
+     </sect2>
 -->
 
-
 <!-- &lt;if&gt; needs to be escaped, such as in changelog enteries 
      before processing will validate
 -->
+<!--
   <sect2 id="changelog">
     <title>Changelog for &releasebranch;</title>
 <programlisting>
 <xi:include href="../../../../../ChangeLog" xi:parse="text" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback>ChangeLog missing</xi:fallback></xi:include>
 </programlisting>
   </sect2>
+-->
 
-
 </sect1>