• last updated 10 hours ago
Constraints
Constraints: committers
 
Constraints: files
Constraints: dates
updated index to include form-builder.xml

updated upgrading, added auto-test best practices

  1. … 109 more files in changeset.
Switch to DocBook 4.2

Add a lint target in Makefile which uses xmllint to validate source.

Add index generation to fo.xsl and openacs.xsl.

fix messed up use of literallayout.

Fix xrefs in permissions-tediously-explained.xml

Repair authorblurb which I broke.

Switch some tables w/o titles to informaltable

fix rollback-database xref.

  1. … 60 more files in changeset.
remove broken ad email addresses, fix links, talk about forums instead of bboard

  1. … 36 more files in changeset.
include the ext-auth-design chapter in index.xml

doc tweaks

  1. … 4 more files in changeset.
cleaning up installation docs for 5.0

  1. … 72 more files in changeset.
cleaning up installation docs for 5.0

  1. … 107 more files in changeset.
added notes on releasing openacs

  1. … 1 more file in changeset.
refactored from external entity to xinclude so that broken files don't kill overall make; added external authentication; brought i18n current; other smaller fixes

  1. … 158 more files in changeset.
added quick guide; removed www/xml/files in favor of just www/files

  1. … 116 more files in changeset.
medium post-4-6-3 changes, including moving optional stuff to appendicis; bugfixes

  1. … 26 more files in changeset.
trying to merge to HEAD

  1. … 3 more files in changeset.
Fixed:

> missing link to http://openacs.org/doc/openacs-4-6-2/files/analog-dev.cfg.txt

> http://openacs.org/doc/openacs-4-6-2/individual-programs.html

Removed the link altogether - removed all links to files actually in

the tarball

----------------------------------------------------------------------

> I'm running Mandrake 9.1 on my new workstation here, and when all the docbook

> stuff's installed there's a convenient "xsl-stylesheets" symbolic link to

Using symlink in openacs.xsl

----------------------------------------------------------------------

In qmail section, link to download page for ucspi and qmail

----------------------------------------------------------------------

>Which is the best keyword for "your service name?" in the docs. It should be

>easily recognized as a placeholder, easy to search-replace, and should

>be generic enough that most users can leave it unchanged. Currently we use

>"service0", which meets the last two of the three requirements.

>Earlier docs used "birdnotes," which met the first two requirements.

Decided I didn't care

----------------------------------------------------------------------

>Red Hat 9 issue:

>code change to compile daemontools and qmail

>http://www.riverside.org/archive/html/djbdns/2003-01/msg00307.html

>http://article.gmane.org/gmane.mail.qmail.general/13960

>put "#include <errno.h>" in /usr/local/src/postgresql-7.2.3/src/include/postgres.h

Added comment to instructions

----------------------------------------------------------------------

> Add text about which version of PostgreSQL works to top of that

section.

added.

----------------------------------------------------------------------

>First, in http://openacs.org/doc/openacs-4-6-2/postgres.html the make

>install didn't work for me when I used postgres so I had to use root and

>then do 'chown -R postgres.web /usr/local/pgsql'

Could not repro.

----------------------------------------------------------------------

> Second, in the [postgres.html] doc, in point 8 for Red Hat, why is

> there chmod 700 for the script? All the other scripts in

> /etc/rc.d/init.d are 755.

Changed to 755.

----------------------------------------------------------------------

>Optimizing Postgres:

>should optimize kernel settings for Postgres

>http://developer.postgresql.org/docs/postgres/kernel-resources.html

Added postgres tuning instructions

----------------------------------------------------------------------

>For compiling nsopenssl, this was necessary on Debian:

>apt-get install libssl-dev

>make OPENSSL=/usr/lib/ssl

>nsopenssl needs 0.9.6 or newer. Debian stable currently runs openssl

>0.9.6c

Added note.

----------------------------------------------------------------------

>If you are on Oracle, you have to su - oracle, then su to root to get

>your environment right. Otherwise, nsoracle won't compile.

Added note.

----------------------------------------------------------------------

>The web user wasn't added in the Oracle install step, so I added it

>now: groupadd web

Already mentioned in the doc.

----------------------------------------------------------------------

>For some reason, the include and sample-config.tcl files were owned by

>500.500 instead of root root. So:

>chown -R root.root include sample.config.tcl

owned by remadmin in reference platform. Seems harmless so didn't add anything to instructions.

----------------------------------------------------------------------

>bin and lib were group owned by staff. I changed that to root as well:

>chown -R root.root bin lib modules

could not repro

----------------------------------------------------------------------

> We should be recommending at least ANALYZE (by itself). If we are

> going to recommend VACUUM, we should recommend VACUUM ANALYZE once an

> hour (or so) and a VACUUM FULL ANALYZE once a night.

Changed default suggestion to --analyze (once per day) to be conservative due to forum thread about full analyze affecting performance due to locking

----------------------------------------------------------------------

> Red hat 9: Stock SSL doesn't work - kerberos problem and also not compiled with

> thread support. (there's an OpenACS thread to fix this)

>http://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=84331

> edit nsopenssl Makefile to say

> CFLAGS += -I$(OPENSSL)/include <b>-I/usr/kerberos/include<b>

Added pointer to thread

  1. … 54 more files in changeset.
updated version number to 4.6.3, fixed a few typos, changed doc email address to docs@openacs.org alias

  1. … 78 more files in changeset.
linked tutorial back in

Placeholders for tutorial and submissions sections; integrated upgrade, tutorial, submissions, and i18n; tweaked css and xsl

  1. … 10 more files in changeset.
merge from oacs-4-6

  1. … 110 more files in changeset.
- Updated Docs for 4.6. Changes include:

- Use PG 7.2.3

- Use OpenFTS 0.3.2

- Major changes to AOLserver install

- Install AOLserver as root (so webserver cracker can't modify nsd)

- AOLServer now run as 'nobody.web'; regular user owns pages; pages are in user dir

- no more nsadmin account

- Add link at bottom of each page pointing to same page at openacs.org

- modified PG backup script to use defaults set in install guide

- modified export-oracle script to use 8.1.7

- added LD_ASSUME_KERNEL=2.2.5 to nsd-oracle script

- modified openacs4.tcl.txt config to set serverroot appropriately, set debug false

- incorporated lots of comments & emails (typos, URLs, etc)

  1. … 82 more files in changeset.
PM: adding I18N requirements and developers guide documents. Those are drafts, revisions to follow shortly. Will add design doc soon

  1. … 2 more files in changeset.
- Added a real OpenACS overview in the overview page, instead of just

"this is the place to start if you want a soft introduction", which

wasn't true since the "for everyone" chapter only has release notes.

1) re-added changes that didn't get merged in from the 4.5 release

2) Added comments to the XSL stylesheet

3) Added a Makefile, so you can simply do 'make' and the HTML docs will be regenerated

  1. … 2 more files in changeset.

1) Added local vars to end of each xml file so that psgml-mode works properly

2) Added disclaimer to authorblurb stylesheet

3) Minor fixes to install guide

  1. … 115 more files in changeset.
Fixed a couple of broken and/or hard-wired links on the installation guides,

including the Windows 2000 install guide.

  1. … 40 more files in changeset.
Re-added 1-phrase overview pages.

  1. … 45 more files in changeset.
* Added "version" and "majorversion" entities to top-level index.xml

so document writers can just use "&version;" or "&majorversion;"

to have that automatically substituted during the output to other

formats.

* Updated most documents to make use of these new entities. Left some

unchanged documents under the kernel documentation.

* Updated the openacs.xsl to take my e-mail off the mailto. I get too

much spam already.

* Changed to "Open Architecture Community System" wherever I could find

(thank goodness for M-x query-replace :-))

* Regenerated the html docs.

  1. … 82 more files in changeset.
beta version of install docs

  1. … 26 more files in changeset.
Initial shot at getting documentation.

  1. … 10 more files in changeset.
OpenACS 4.x

  1. … 1321 more files in changeset.
Initial revision

  1. … 1321 more files in changeset.