[jboss-svn-commits] JBL Code SVN: r36393 - in labs/jbosstm/trunk: ArjunaCore/docs and 6 other directories.

jboss-svn-commits at lists.jboss.org jboss-svn-commits at lists.jboss.org
Mon Dec 13 08:30:21 EST 2010


Author: jhalliday
Date: 2010-12-13 08:30:21 -0500 (Mon, 13 Dec 2010)
New Revision: 36393

Added:
   labs/jbosstm/trunk/docs/
   labs/jbosstm/trunk/docs/build.xml
   labs/jbosstm/trunk/docs/release_notes/
   labs/jbosstm/trunk/docs/release_notes/en-US/
   labs/jbosstm/trunk/docs/release_notes/en-US/Article_Info.xml
   labs/jbosstm/trunk/docs/release_notes/en-US/Author_Group.xml
   labs/jbosstm/trunk/docs/release_notes/en-US/Release_Notes.ent
   labs/jbosstm/trunk/docs/release_notes/en-US/Release_Notes.xml
   labs/jbosstm/trunk/docs/release_notes/en-US/Revision_History.xml
   labs/jbosstm/trunk/docs/release_notes/en-US/images/
   labs/jbosstm/trunk/docs/release_notes/en-US/images/icon.svg
   labs/jbosstm/trunk/docs/release_notes/publican.cfg
Removed:
   labs/jbosstm/trunk/ArjunaCore/docs/release_notes/
   labs/jbosstm/trunk/ArjunaJTA/docs/release_notes/
   labs/jbosstm/trunk/ArjunaJTS/docs/release_notes/
Log:
Add new release notes structure


Added: labs/jbosstm/trunk/docs/build.xml
===================================================================
--- labs/jbosstm/trunk/docs/build.xml	                        (rev 0)
+++ labs/jbosstm/trunk/docs/build.xml	2010-12-13 13:30:21 UTC (rev 36393)
@@ -0,0 +1,52 @@
+<!--
+  JBoss, Home of Professional Open Source
+  Copyright 2010, Red Hat Middleware LLC, and individual contributors
+  as indicated by the @author tags.
+  See the copyright.txt in the distribution for a
+  full listing of individual contributors.
+  This copyrighted material is made available to anyone wishing to use,
+  modify, copy, or redistribute it subject to the terms and conditions
+  of the GNU Lesser General Public License, v. 2.1.
+  This program is distributed in the hope that it will be useful, but WITHOUT A
+  WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+  PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more details.
+  You should have received a copy of the GNU Lesser General Public License,
+  v.2.1 along with this distribution; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+  MA  02110-1301, USA.
+
+  (C) 2010,
+  @author JBoss, a division of Red Hat.
+-->
+<project name="module-docs" default="install.docs" basedir=".">
+
+    <property name="modulename" value="docs"/>
+
+    <import file="../sharedbuild.xml"/>
+
+    <target name="clean">
+        <delete dir="${build.dir}"/>
+    </target>
+
+    <target name="install.docs">
+
+        <property name="dest.dir" value="${build.dir}/install/docs"/>
+
+        <if>
+            <istrue value="${publican}" />
+            <then>
+                <exec dir="release_notes" executable="publican">
+                    <arg value="build"/>
+                    <arg value="--langs=en-US"/>
+                    <arg value="--formats=pdf,html"/>
+                </exec>
+            </then>
+        </if>
+
+        <copy todir="${dest.dir}/release_notes" overwrite="true" flatten="true">
+            <fileset dir="${build.dir}" includes="*/en-US/pdf/*.pdf"/>
+        </copy>
+
+    </target>
+
+</project>
\ No newline at end of file

Added: labs/jbosstm/trunk/docs/release_notes/en-US/Article_Info.xml
===================================================================
--- labs/jbosstm/trunk/docs/release_notes/en-US/Article_Info.xml	                        (rev 0)
+++ labs/jbosstm/trunk/docs/release_notes/en-US/Article_Info.xml	2010-12-13 13:30:21 UTC (rev 36393)
@@ -0,0 +1,28 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE articleinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<articleinfo id="arti-4.14_JBoss_Transactions_Release_Notes-a4.14_JBoss_Transactions_Release_Notes">
+   <title>Release Notes</title>
+   <subtitle>Release Notes for JBoss Transaction Manager</subtitle>
+   <productname>JBoss Transaction manager</productname>
+   <productnumber>4.14</productnumber>
+   <edition>0</edition>
+   <pubsnumber>0</pubsnumber>
+   <abstract>
+      <para>
+        Release notes for ArjunaCore, ArjunaJTA, ArjunaJTS, and XTS components of the JBoss Transaction Manager.
+      </para>
+   </abstract>
+   <corpauthor>
+      <inlinemediaobject>
+         <imageobject>
+            <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" />
+         </imageobject>
+      </inlinemediaobject>
+   </corpauthor>
+   <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+   <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</articleinfo>
+

Added: labs/jbosstm/trunk/docs/release_notes/en-US/Author_Group.xml
===================================================================
--- labs/jbosstm/trunk/docs/release_notes/en-US/Author_Group.xml	                        (rev 0)
+++ labs/jbosstm/trunk/docs/release_notes/en-US/Author_Group.xml	2010-12-13 13:30:21 UTC (rev 36393)
@@ -0,0 +1,16 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<authorgroup>
+   <author>
+      <firstname>Misty</firstname>
+      <surname>Stanley-Jones</surname>
+      <affiliation>
+         <orgname>JBoss.org</orgname>
+      </affiliation>
+      <email>misty at redhat.com</email>
+   </author>
+</authorgroup>
+

Added: labs/jbosstm/trunk/docs/release_notes/en-US/Release_Notes.ent
===================================================================
--- labs/jbosstm/trunk/docs/release_notes/en-US/Release_Notes.ent	                        (rev 0)
+++ labs/jbosstm/trunk/docs/release_notes/en-US/Release_Notes.ent	2010-12-13 13:30:21 UTC (rev 36393)
@@ -0,0 +1,4 @@
+<!ENTITY PRODUCT "JBoss Transaction Manager">
+<!ENTITY BOOKID "4.14_JBoss_Transactions_Release_Notes">
+<!ENTITY YEAR "2010">
+<!ENTITY HOLDER "JBoss.org">

Added: labs/jbosstm/trunk/docs/release_notes/en-US/Release_Notes.xml
===================================================================
--- labs/jbosstm/trunk/docs/release_notes/en-US/Release_Notes.xml	                        (rev 0)
+++ labs/jbosstm/trunk/docs/release_notes/en-US/Release_Notes.xml	2010-12-13 13:30:21 UTC (rev 36393)
@@ -0,0 +1,271 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<article>
+   <xi:include href="Article_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+   
+   <section>
+     <title>ArjunaCore</title>
+
+     <variablelist>
+       <title>New features</title>
+       <varlistentry>
+         <term>JBTM-573 ArjunaCore now includes a command-line tool for manually pruning log files.</term>
+         <listitem>
+           <para>
+             TBD
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>JBTM-796 All ObjectStore types supported by the ObjectStoreAPI are now supported by MBean
+         <classname>ObjStoreBrowserMBean</classname>.</term>
+         <listitem>
+           <para>
+             Originally, <classname>ObjStoreBrowserMBean</classname> was only known to support file-based
+             ObjectStores. It now implements the ObjectStoreAPI, and works with all types of ObjectStores supported by
+             the API.
+           </para>
+         </listitem>
+       </varlistentry>
+     </variablelist>
+     
+     <variablelist>
+       <title>Resolved issues</title>
+       <varlistentry>
+         <term>JBTM-575 <systemitem>RollbackException</systemitem> now behaves as it did in JBoss Application Server
+         4.3 and earlier, providing debugging information about the cause of the exception.</term>
+         <listitem>
+           <para>
+             In JBoss Application Server 4.2 and previous, when a transaction rolled back, the
+             <systemitem>RollbackException</systemitem> included the root cause of the exception. In JBoss Application
+             Server 5.1, the exception no longer included this information, even though the information can still be
+             found in a different area of the log file. Code which relied on the root cause information included in the
+             exception no longer worked as expected.
+           </para>
+           <para>
+             The debugging information has been put back into the exception, so that it works as it did previously. The
+             following algorithm is used:
+           </para>
+           <orderedlist>
+             <listitem>
+               <para>
+                 If <methodname>setRollbackOnly()</methodname> is called before <methodname>commit()</methodname>, the
+                 <parameter>initCause</parameter> is <literal>setRollbackOnly called from...</literal>, regardless of
+                 anything that may go wrong during the commit. <methodname>beforeCompletion</methodname>s are not
+                 called.
+               </para>
+             </listitem>
+             <listitem>
+               <para>
+                 If <varname>getDeferredThrowable</varname> is not <literal>null</literal>, the
+                 <parameter>initCause</parameter> is the <varname>deferredThrowable</varname>, even if
+                 <classname>setRollbackOnly</classname> is also called before the exception is received.
+               </para>
+             </listitem>
+             <listitem>
+               <para>
+                 If <classname>setRollbackOnly</classname> was called, it is the root cause. This covers the case where
+                 a <classname>beforeCompletion</classname> calls <methodname>setRollbackOnly</methodname> but does not
+                 throw an exception.
+               </para>
+             </listitem>
+           </orderedlist>
+           <para>
+             This fix allows you to code against the root cause of the <systemitem>RollbackException</systemitem>.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>JBTM-814 TSR implementations now implement <classname>ObjectFactory</classname>.</term>
+         <listitem>
+           <para>
+             TSR implementations have been modified to implement <classname>ObjectFactory</classname>.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>JBTM-811 The finalizer has been removed from the <classname>StateManager</classname>.</term>
+         <listitem>
+           <para>
+             The <classname>StateManager</classname> no longer includes the finalizer.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>JBTM-599 A synchronization in CacheStore has been fixed.</term>
+         <listitem>
+           <para>
+             Removing threads operating on AsyncStore did not check to see if the cache was full, and did not notify
+             AsyncCache to wake up. This could cause a stalling condition, if there were more removes than adds to the
+             cache. Removes now check to see if the cache is full, and notify AsyncCache accordingly.
+           </para>
+         </listitem>
+       </varlistentry>
+     </variablelist>
+   </section>
+   
+   <section>
+     <title>ArjunaJTA</title>
+     
+     <variablelist>
+       <title>New features</title>
+       <varlistentry>
+         <term>JBTM-77 <classname>UserTransaction</classname> is now serializable and referencable, in compliance wtih
+         the JTA.</term>
+         <listitem>
+           <para>
+             The Java Transactions API (JTA) specifies that <classname>UserTransaction</classname> needs to be
+             serializable and referenceable. JBossTA now complies with this requirement.
+           </para>
+         </listitem>
+       </varlistentry>
+     </variablelist>
+   </section>
+
+   <section>
+     <title>ArjunaJTS</title>
+     <variablelist>    
+       <title>Resolved issues</title>
+       <varlistentry>
+         <term>JBTM-816 Threads in several components have been given names, for easier profiling.</term>
+         <listitem>
+           <para>
+             The threads in the transaction reaper, reaper worker, action store scanner, and the XTS reaper worker have
+             been given names. This makes them easier to identify during profiling.
+           </para>
+         </listitem>
+       </varlistentry>
+     </variablelist>
+   </section>
+
+   <section>
+     <title>XTS</title>
+     <variablelist>
+       <title>New features</title>
+       <varlistentry>
+         <term>JBTM-798 XTS service and initialization classes are now packaged in a JAR, for easy deployment outside JBossAS.</term>
+         <listitem>
+           <para>
+             XTS service and initialization classes are now packaged into a separate JAR, to make it easier to deploy
+             XTS into other application servers, such as Tomcat.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>JBTM-799 You can now programmatically configure the WS-C and WS-T service endpoint URLs and paths.</term>
+         <listitem>
+           <para>
+             In the past, WS-C and WS-T service endpoint URLs were hard-coded to conform to the pattern
+             <literal>http://<replaceable>bindAddress</replaceable>:<replaceable>bindPort</replaceable>/<replaceable>war-name</replaceable>/<replaceable>service-name</replaceable></literal>. This
+             made it more difficult to deploy these services in different application servers. The path portion of the
+             URLs of the service endpoints are now configurable.
+           </para>
+         </listitem>
+       </varlistentry>
+     </variablelist>
+
+     <variablelist>
+       <title>Resolved issues</title>
+       <varlistentry>
+         <term>JBTM-518 WST 1.1 support is now included in the default configuration</term>
+         <listitem>
+           <para>
+             WS-BA 0.2.1 only imported the WST 1.0-compliant class libraries, and required a patch to import the WST
+             1.1-compliant class libraries. The BA framework now includes a <filename>libs/</filename> directory that
+             hosts the WST 1.1-compliant libraries, so WST 1.0 and 1.1 are both supported in the default configuration.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>JBTM-800 Deploying just the Coordinator component of XTS no longer causes an exception to be thrown.</term>
+         <listitem>
+           <para>
+             The configuration instructions for deploying just the Coordinator component of XTS used to cause an
+             exception, because the ATParticipantRecoveryModule was not available on the Participant component. he
+             Participant and Coordinator recovery modules now create and install a manager if one is not already found,
+             and the exception is no longer thrown.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>JBTM-803 WSDLs ares no longer duplicated in the WS-C and WS-TX JARs.</term>
+         <listitem>
+           <para>
+             The WSDLs have been removed from the WS-TX JAR. Both the WS-C and WS-TX JAR are needed by XTS, and the
+             duplicate information was causing confusion without serving a purpose.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>JBTM-804 The log of an invalid state SOAP fault now correctly reports that the participant is
+         compensated, not cancelled.</term>
+         <listitem>
+           <para>
+             An invalid state SOAP fault causes the participant to be compensated, but the log message used to report
+             that was cancelled. This has been fixed, so that the log message now agrees with the actual action.
+           </para>
+         </listitem>
+         
+       </varlistentry>
+       <varlistentry>
+         <term>JBTM-816 Threads in several components have been given names, for easier profiling.</term>
+         <listitem>
+           <para>
+             The threads in the transaction reaper, reaper worker, action store scanner, and the XTS reaper worker have
+             been given names. This makes them easier to identify during profiling.
+           </para>
+         </listitem>
+       </varlistentry>
+     </variablelist>
+   </section>
+   
+   <section>
+     <title>Recovery</title>
+     <variablelist>
+       <title>Resolved issues</title>
+       <varlistentry>
+         <term>JBTM-797 ORB setup now detects exceptions due to in-use ports.</term>
+         <listitem>
+           <para>
+             If the ORB was unable to bind to the specified port, it would print a warning to standard output and remain
+             in an unusable state. No exception was thrown and there was no mechanism for making the ORB try again to
+             bind to the port. The ORB now throws an exception and the developer can make the ORB try again to bind to
+             the port.
+           </para>
+         </listitem>
+       </varlistentry>
+       <varlistentry>
+         <term>JBTM-816 Threads in several components have been given names, for easier profiling.</term>
+         <listitem>
+           <para>
+             The threads in the transaction reaper, reaper worker, action store scanner, and the XTS reaper worker have
+             been given names. This makes them easier to identify during profiling.
+           </para>
+         </listitem>
+       </varlistentry>
+     </variablelist>
+   </section>
+   
+   <section>
+     <title>JCA</title>
+     <variablelist>
+       <title>Resolved issues</title>
+       <varlistentry>
+         <term>JBTM-812 JDBC3 code is no longer included.</term>
+         <listitem>
+           <para>
+             JDBC3 code was required for building on JDK 5, but this is no longer needed, and has been removed.
+           </para>
+         </listitem>
+       </varlistentry>
+     </variablelist>
+   </section>
+
+   <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+   <index />
+</article>
+

Added: labs/jbosstm/trunk/docs/release_notes/en-US/Revision_History.xml
===================================================================
--- labs/jbosstm/trunk/docs/release_notes/en-US/Revision_History.xml	                        (rev 0)
+++ labs/jbosstm/trunk/docs/release_notes/en-US/Revision_History.xml	2010-12-13 13:30:21 UTC (rev 36393)
@@ -0,0 +1,27 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+<appendix id="appe-4.14_JBoss_Transactions_Release_Notes-Revision_History">
+   <title>Revision History</title>
+   <simpara>
+      <revhistory>
+         <revision>
+            <revnumber>1.0</revnumber>
+            <date>Wed Dec 8 2010</date>
+            <author>
+               <firstname>Misty</firstname>
+               <surname>Stanley-Jones</surname>
+               <email>misty at redhat.com</email>
+            </author>
+            <revdescription>
+               <simplelist>
+                  <member>JBossTS 4.14 Release Notes</member>
+               </simplelist>
+            </revdescription>
+         </revision>
+      </revhistory>
+   </simpara>
+</appendix>
+

Added: labs/jbosstm/trunk/docs/release_notes/en-US/images/icon.svg
===================================================================
--- labs/jbosstm/trunk/docs/release_notes/en-US/images/icon.svg	                        (rev 0)
+++ labs/jbosstm/trunk/docs/release_notes/en-US/images/icon.svg	2010-12-13 13:30:21 UTC (rev 36393)
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg xmlns:svg="http://www.w3.org/2000/svg" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.0" width="32" height="32" id="svg3017">
+  <defs id="defs3019">
+    <linearGradient id="linearGradient2381">
+      <stop id="stop2383" style="stop-color:#ffffff;stop-opacity:1" offset="0"/>
+      <stop id="stop2385" style="stop-color:#ffffff;stop-opacity:0" offset="1"/>
+    </linearGradient>
+    <linearGradient x1="296.4996" y1="188.81061" x2="317.32471" y2="209.69398" id="linearGradient2371" xlink:href="#linearGradient2381" gradientUnits="userSpaceOnUse" gradientTransform="matrix(0.90776,0,0,0.90776,24.35648,49.24131)"/>
+  </defs>
+  <g transform="matrix(0.437808,-0.437808,0.437808,0.437808,-220.8237,43.55311)" id="g5089">
+    <path d="m 8.4382985,-6.28125 c -0.6073916,0 -4.3132985,5.94886271 -4.3132985,8.25 l 0,26.71875 c 0,0.846384 0.5818159,1.125 1.15625,1.125 l 25.5625,0 c 0.632342,0 1.125001,-0.492658 1.125,-1.125 l 0,-5.21875 0.28125,0 c 0.49684,0 0.906249,-0.409411 0.90625,-0.90625 l 0,-27.9375 c 0,-0.4968398 -0.40941,-0.90625 -0.90625,-0.90625 l -23.8117015,0 z" transform="translate(282.8327,227.1903)" id="path5091" style="fill:#5c5c4f;stroke:#000000;stroke-width:3.23021388;stroke-miterlimit:4;stroke-dasharray:none"/>
+    <rect width="27.85074" height="29.369793" rx="1.1414107" ry="1.1414107" x="286.96509" y="227.63805" id="rect5093" style="fill:#032c87"/>
+    <path d="m 288.43262,225.43675 25.2418,0 0,29.3698 -26.37615,0.0241 1.13435,-29.39394 z" id="rect5095" style="fill:#ffffff"/>
+    <path d="m 302.44536,251.73726 c 1.38691,7.85917 -0.69311,11.28365 -0.69311,11.28365 2.24384,-1.60762 3.96426,-3.47694 4.90522,-5.736 0.96708,2.19264 1.83294,4.42866 4.27443,5.98941 0,0 -1.59504,-7.2004 -1.71143,-11.53706 l -6.77511,0 z" id="path5097" style="fill:#a70000;fill-opacity:1;stroke-width:2"/>
+    <rect width="25.241802" height="29.736675" rx="0.89682275" ry="0.89682275" x="290.73544" y="220.92249" id="rect5099" style="fill:#809cc9"/>
+    <path d="m 576.47347,725.93939 6.37084,0.41502 0.4069,29.51809 c -1.89202,-1.31785 -6.85427,-3.7608 -8.26232,-1.68101 l 0,-26.76752 c 0,-0.82246 0.66212,-1.48458 1.48458,-1.48458 z" transform="matrix(0.499065,-0.866565,0,1,0,0)" id="rect5101" style="fill:#4573b3;fill-opacity:1"/>
+    <path d="m 293.2599,221.89363 20.73918,0 c 0.45101,0 0.8141,0.3631 0.8141,0.81411 0.21547,6.32836 -19.36824,21.7635 -22.36739,17.59717 l 0,-17.59717 c 0,-0.45101 0.3631,-0.81411 0.81411,-0.81411 z" id="path5103" style="opacity:0.65536726;fill:url(#linearGradient2371);fill-opacity:1"/>
+  </g>
+</svg>

Added: labs/jbosstm/trunk/docs/release_notes/publican.cfg
===================================================================
--- labs/jbosstm/trunk/docs/release_notes/publican.cfg	                        (rev 0)
+++ labs/jbosstm/trunk/docs/release_notes/publican.cfg	2010-12-13 13:30:21 UTC (rev 36393)
@@ -0,0 +1,7 @@
+# Config::Simple 4.59
+# Thu Dec  9 09:36:41 2010
+
+xml_lang: en-US
+type: Article
+brand: jboss-community
+tmp_dir: ../build/release_notes



More information about the jboss-svn-commits mailing list