For Review: Change 20070416-jgrandyw-u Summary: Add docbook builds for Java sources und

Change 20070416-jgrandyw-u by jgrandywjgrandy-mbp.local on  
2007-04-16 12:31:44 PDT
     in /Users/jgrandyw/dev/svn/openlaszlo/branches/legals
     for 
http://svn.openlaszlo.org/openlaszlo/branches/legals

Summary: Add docbook builds for documentation of Java
sources under  
WEB-INF/lps/server/src.

New Features:

Bugs Fixed:

Technical Reviewer: pbr
QA Reviewer: jcrowley
Doc Reviewer:

Documentation:

Release Notes:

Details:Add two new docbook-formatted reference books,
server and
compiler. Neither is enabled in any automatic build right
now. To build
them, cd to docs/src, and execute 'ant
reference.server.build' or 'ant
reference.compiler.build'. You'll also need a copy of
dbdoclet.jar
copied into 3rd-party/jars/dev -- I haven't checked that jar
in pending
license approval. (dbdoclet is a javadoc plugin that
generates
docbook-formatted output instead of the html that javadoc
generates by
default.)

Note that there are a number of non-fatal errors and
warnings during the
javadoc phase of these builds. These are primarily due to
stale
javadoc-formatted comments in the source.

Tests: Please check to make sure that 'ant clean build doc
test'
executes as expected with these changes. Again, the 'server'
and
'compiler' reference books will not be generated, but
everything else
should work as before.

If you would like to build the 'compiler' or 'server'
references, let me
know and I'll send you a copy of the necessary jar.

Files:
M      WEB-INF/lps/server/build.xml
M      docs/src/build.xml
M      build.xml

Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20070416-

jgrandyw-u.tar

Approved.  Everything appears to have compiled properly.

On Apr 16, 2007, at 3:42 PM, Jim Grandy wrote:

> Change 20070416-jgrandyw-u by jgrandywjgrandy-mbp.local on  
> 2007-04-16 12:31:44 PDT
>     in
/Users/jgrandyw/dev/svn/openlaszlo/branches/legals
>     for 
http://svn.openlaszlo.org/openlaszlo/branches/legals
>
> Summary: Add docbook builds for documentation of Java
sources under  
> WEB-INF/lps/server/src.
>
> New Features:
>
> Bugs Fixed:
>
> Technical Reviewer: pbr
> QA Reviewer: jcrowley
> Doc Reviewer:
>
> Documentation:
>
> Release Notes:
>
> Details:Add two new docbook-formatted reference books,
server and
> compiler. Neither is enabled in any automatic build
right now. To  
> build
> them, cd to docs/src, and execute 'ant
reference.server.build' or 'ant
> reference.compiler.build'. You'll also need a copy of
dbdoclet.jar
> copied into 3rd-party/jars/dev -- I haven't checked
that jar in  
> pending
> license approval. (dbdoclet is a javadoc plugin that
generates
> docbook-formatted output instead of the html that
javadoc generates by
> default.)
>
> Note that there are a number of non-fatal errors and
warnings  
> during the
> javadoc phase of these builds. These are primarily due
to stale
> javadoc-formatted comments in the source.
>
> Tests: Please check to make sure that 'ant clean build
doc test'
> executes as expected with these changes. Again, the
'server' and
> 'compiler' reference books will not be generated, but
everything else
> should work as before.
>
> If you would like to build the 'compiler' or 'server'
references,  
> let me
> know and I'll send you a copy of the necessary jar.
>
> Files:
> M      WEB-INF/lps/server/build.xml
> M      docs/src/build.xml
> M      build.xml
>
> Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20070416-

> jgrandyw-u.tar