Preparing 3.2.3 release.

.gitignore

@@ -0,0 +1,6 @@
+build
+dist
+*.in
+*.prefs
+*.classpath
+*.project

README.md

@@ -19,6 +19,10 @@ The library requires a Servlet 2.5 or 3.0 container. When deployed in a
 servlet 3.0 container, it is able to use asynchronous I/O functionality
 to improve scalability when using server push features.
 
+If you want to use the PDF rendering support (the WPdfImage and
+WPdfRenderer classes), then you also need to add
+PdfJet[http://pdfjet.com/] to your project.
+
 Building
 --------
 
@@ -40,21 +44,21 @@ The ant build file has a separate target to generate maven pom files:
 
 To install the two artifacts in your local repository, do:
 
-    mvn install:install-file -Dfile=dist/jwt-3.2.2.jar -DpomFile=jwt-3.2.2.pom    
-    mvn install:install-file -Dfile=dist/jwt-auth-3.2.2.jar -DpomFile=jwt-auth-3.2.2.pom
+    mvn install:install-file -Dfile=dist/jwt-3.2.3.jar -DpomFile=jwt-3.2.3.pom
+    mvn install:install-file -Dfile=dist/jwt-auth-3.2.3.jar -DpomFile=jwt-auth-3.2.3.pom
 
 The corresponding dependency blocks are:
 
     <dependency>
       <groupId>eu.webtoolkit</groupId>
       <artifactId>jwt</artifactId>
-      <version>3.2.2</version>
+      <version>3.2.3</version>
     </dependency>
 
     <dependency>
       <groupId>eu.webtoolkit</groupId>
       <artifactId>jwt-auth</artifactId>
-      <version>3.2.2</version>
+      <version>3.2.3</version>
     </dependency>
 
     <dependency>
@@ -70,5 +74,6 @@ The corresponding dependency blocks are:
       <scope>provided</scope>
     </dependency>
 
-(Depending on the J2EE container, javax.mail may be included and provided by the container,
- and then the last dependency for org.apache.geronimo.javamail should be dropped)
+(Depending on the J2EE container, javax.mail may be included and provided
+by the container, and then the last dependency for
+org.apache.geronimo.javamail should be dropped)

build.xml

@@ -10,7 +10,7 @@
   <property name="archives.dir" value="archives"/>
   <property name="mvn.dir" value="mvn"/>
   <property name="javadoc.jwt.dir" value="doc/javadoc"/>
-  <property name="javadoc.jwt-auth.dir" value="doc/reference/jwt-auth"/>
+  <property name="javadoc.jwt-auth.dir" value="doc/auth/javadoc"/>
   <property name="userguide.dir" value="doc/userguide"/>
 
   <!-- Javadoc classpath declaration -->
@@ -86,6 +86,7 @@
 	<include name="eu/webtoolkit/jwt/*.xml"/>
 	<include name="eu/webtoolkit/jwt/servlet/*.java"/>
 	<include name="eu/webtoolkit/jwt/chart/*.java"/>
+	<include name="eu/webtoolkit/jwt/render/*.java"/>
 	<include name="eu/webtoolkit/jwt/auth/*.java"/>
 	<include name="eu/webtoolkit/jwt/auth/*.xml"/>
 	<include name="eu/webtoolkit/jwt/auth/jpa/*.java"/>
@@ -109,6 +110,7 @@
 	<include name="eu/webtoolkit/jwt/*.java"/>
 	<include name="eu/webtoolkit/jwt/servlet/*.java"/>
 	<include name="eu/webtoolkit/jwt/chart/*.java"/>
+	<include name="eu/webtoolkit/jwt/render/*.java"/>
 	<include name="eu/webtoolkit/jwt/utils/WebGraphics2D.java"/>
 	<exclude name="eu/webtoolkit/jwt/XSSFilter.java"/>
 	<exclude name="eu/webtoolkit/jwt/ServletApi25.java"/>
@@ -141,6 +143,7 @@
 	<include name="eu/webtoolkit/jwt/*.java"/>
 	<include name="eu/webtoolkit/jwt/servlet/*.java"/>
 	<include name="eu/webtoolkit/jwt/chart/*.java"/>
+	<include name="eu/webtoolkit/jwt/render/*.java"/>
 	<include name="eu/webtoolkit/jwt/utils/WebGraphics2D.java"/>
 	<exclude name="eu/webtoolkit/jwt/XSSFilter.java"/>
 	<exclude name="eu/webtoolkit/jwt/ServletApi25.java"/>
@@ -186,7 +189,7 @@
     <jar  destfile="dist/jwt-${proj.version}.jar" 
           basedir="${build.dir}" 
           defaultexcludes="yes" 
-          includes="eu/webtoolkit/jwt/* eu/webtoolkit/jwt/servlet/* eu/webtoolkit/jwt/chart/* eu/webtoolkit/jwt/utils/* net/n3/nanoxml/* eu/webtoolkit/jwt/skeletons/* eu/webtoolkit/jwt/wt-resources/**/*" />
+          includes="eu/webtoolkit/jwt/* eu/webtoolkit/jwt/servlet/* eu/webtoolkit/jwt/chart/* eu/webtoolkit/jwt/render/* eu/webtoolkit/jwt/utils/* net/n3/nanoxml/* eu/webtoolkit/jwt/skeletons/* eu/webtoolkit/jwt/wt-resources/**/*" />
     <jar  destfile="dist/jwt-auth-${proj.version}.jar" 
           basedir="${build.dir}" 
           defaultexcludes="yes" 
@@ -207,6 +210,7 @@
 	<include name="eu/webtoolkit/jwt/*.xml"/>
 	<include name="eu/webtoolkit/jwt/servlet/*.java"/>
 	<include name="eu/webtoolkit/jwt/chart/*.java"/>
+	<include name="eu/webtoolkit/jwt/render/*.java"/>
 	<include name="eu/webtoolkit/jwt/utils/*.java"/>
       </fileset>
     </jar>

overview.html

@@ -11,7 +11,7 @@
   dd p { margin-top: 0px; }
   dd div { margin: 10px 0px; }
 </style>
-<title>JWt 3.2.2</title>
+<title>JWt 3.2.3</title>
 </head>
 <body>
 
@@ -25,6 +25,50 @@ <h1>Release notes</h1>
 the way you build Wt, the way you configure Wt or the Wt API and
 behaviour.
 
+<h2>Release 3.2.3 (October ??, 2012)</h2>
+
+<p>
+  This release contains mostly bug fixes and one new feature: a payment
+  processing API.
+</p>
+
+<h3>A) New classes:</h3>
+
+<dl>
+  <dt>
+    <a href="eu/webtoolkit/jwt/render/package-summary.html">Render library:</a>
+    a library for rendering XHTML to (e.g.) PDF.
+  </dt>
+  <dd>
+    <p>
+      This library contains an XHTML parser and layout engine. It's
+      main purpose is simplifying PDF report generation. The library
+      uses PDFJet for low-level PDF functions. The layout engine does
+      not understand all HTML/CSS concepts, but it does a decent job
+      in static layout (blocks, inline elements, tables and floats) in
+      any arbitrary combination, multi-page rendering, and accurate
+      use of font metrics.
+    </p>
+  </dd>
+</dl>
+
+<h3>B) Main improvements:</h3>
+
+<dl>
+  <dt>
+    Layout improvements
+  </dt>
+  <dd>
+    If you had massive trouble migrating to 3.2.2 because of the
+    layout rewrite, then you'll appreciate the efforts we've made to
+    make the layout algorithms in 3.2.3 much more robust and
+    consistent.
+  </dd>
+
+</dl>
+
+<hr>
+
 <h2>Release 3.2.2 (July 23, 2012)</h2>
 
 <p>

src/eu/webtoolkit/jwt/SoundManager.java

@@ -25,6 +25,7 @@ class SoundManager extends WMediaPlayer {
 	public SoundManager(WContainerWidget parent) {
 		super(WMediaPlayer.MediaType.Audio, parent);
 		this.resize(new WLength(0), new WLength(0));
+		this.setAttributeValue("style", "overflow: hidden");
 		this.getControlsWidget().hide();
 		this.getDecorationStyle().setBorder(new WBorder());
 		StringBuilder ss = new StringBuilder();

src/eu/webtoolkit/jwt/render/WPdfRenderer.java

@@ -36,31 +36,6 @@
  * {@link WTextRenderer#setFontScale(double factor)
  * WTextRenderer#setFontScale()} to scale the font size differently than other
  * content.
- * <p>
- * Usage example:
- * <p>
- * 
- * <pre>
- * {@code
- *  extern "C" {
- *    HPDF_STATUS HPDF_UseUTFEncodings(HPDF_Doc pdf);
- *  }
- * 	
- *  HPDF_Doc pdf = HPDF_New(error_handler, 0);
- *  HPDF_UseUTFEncodings(pdf); // enables UTF-8 encoding with true type fonts
- *  HPDF_Page page = HPDF_AddPage(pdf);
- *  HPDF_Page_SetSize(page, HPDF_PAGE_SIZE_A4, HPDF_PAGE_PORTRAIT);
- * 
- *  Render::WPdfRenderer renderer(pdf, page);
- *  renderer.setMargin(2.54);
- *  renderer.setDpi(96);
- * 
- *  renderer.render("<p style=\"background-color: #c11\">Hello, world !</p>");
- * 
- *  HPDF_SaveToFile(pdf, "hello.pdf");
- *  HPDF_Free(pdf);
- * }
- * </pre>
  */
 public class WPdfRenderer extends WTextRenderer {
 	private static Logger logger = LoggerFactory.getLogger(WPdfRenderer.class);

src/eu/webtoolkit/jwt/render/package.html

@@ -0,0 +1,9 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<html>
+<head>
+</head>
+<body bgcolor="white">
+JWt Render package, this package contains all widgets and classes
+related to JWt's XHTML rendering module.
+</body>
+</html>