[opencms-dev] Ver. 6 documentation - How to generate (was "File encoding")

[Paul D. Bain]

Joe Desbonnet wrote:
> Agreed, V6 needs a lot more documentation. The doc shipped with the
> software just scratches the surface. I hope Alkacon and others have
> plans in this regard. It's a possible revenue source for them also. I
> would certainly buy a book, and I'd probably buy a copy for each of my
> customers who will be using the system.  Ideally there should be two
> books: OpenCms for users and OpenCms for developers. I would kill for
> a O'Reilly style book documenting the software architecture right now.

Joe,

	As you probably already know, you can generate javaDocs from the source
code for OpenCms. That documentation may help a bit, and then there's
the first edition of Matt Butcher's book, "Building Websites with
OpenCms," which covers version 5 of OpenCms. When referring to Matt's
book, beware that, among other things, several package names have
changed. Several package names from ver. 5 have disappeared and new
names have appeared to take their place. For example, the package
org.opencms.main has replaced the package com.opencms.core (from ver.
5), and the package org.opencms.setup has replaced com.opencms.boot.

> On 7/15/05, Ronald Schouten <rschouten at abebooks.com> wrote:
> 
>>I am running into the same problem with the exact same environment as Jason.
>>
>>My reason for selecting OpenCms 5.0 at the beginning of a new project is
>>because much more documentation is available compared to 6.0. I have not come
>>across any getting started guides for 6.0 otherwise I would pursue that
>>version further.
>>
>>Ron
>>
>>-----Original Message-----
>>From: opencms-dev-bounces at opencms.org
>>[mailto:opencms-dev-bounces at opencms.org] On Behalf Of Joe Desbonnet
>>Sent: Friday, July 15, 2005 12:08 PM
>>To: The OpenCms mailing list
>>Subject: Re: [opencms-dev] File encoding issue with 5.0,Tomcat 5.5 on Windows
>>2003
>>
>>See this re -Dfile.encoding:
>>
>>http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4163515
>>
>>Have you tried JDK1.5.0?
>>
>>Also remember that OpenCms 6 has just been released and there are
>>substantial changes. So if you are starting a project I would suggest
>>you start with OpenCms 6 unless you have a good reason to choose
>>version 5.

	That is probably sound advice.

Sincerely,
Paul Bain