Thank you Ian. I've made updates that Linda caught (below) along with these that you've sent.
I actually couldn't find the "occurence in the where an @Transactional annotation had mistakenly got a "mailto:Transactional.If" hyperlink associated with it. " you mention though. Sorry, can you be more specific? I'm asking other internally to check as well as it's quite likely I'm just missing it somehow.
I'm also just updating the footer to "Maintenance Review"
Thanks,
Paul
LIndas
"
P. 8 still has the local variable inconsistency in the last line of the
example.
p. 22 code at top of page belongs on previous page.
p. 25 3rd line from bottom: something went wrong with the line breaks here
p.29-32 formatting problems. (Ditto.)
Javadocs for the Transactional annotation would benefit from some paragraph
breaks.
"
On Mar 25, 2013, at 6:06 PM, Ian Robinson wrote:
> Paul. I noticed an inconsistency between the PDF and the Javadoc for @Transactional.
> The Javadoc states:
> If an attempt is made to call any method of the UserTransaction interface from within the scope of a bean or method annotated with @Transactional and a Transactional.TxType other than NOT_SUPPORTED or NEVER, an IllegalStateException must be thrown.
>
> The PDF states:
> If an attempt is made to call any method of the UserTransaction interface from within a bean or method annotated with @Transactional and a Transactional.TxType other than NOT_SUPPORTED or NEVER, an IllegalStateException must be thrown.
>
> I think the Javadoc version better conveys the intention and so the PDF is the one I'd recommend changing to become consistent.
>
> I also found an occurence in the where an @Transactional annotation had mistakenly got a "mailto:Transactional.If" hyperlink associated with it.
>
> I noticed that the pseudo-code on P8 has regressed - you fixed it in an earlier draft:
>
> public void updateData() {
> // Obtain the default initial JNDI context.
> Context context = new InitialContext();
> // Look up the UserTransaction object.
> UserTransaction userTransaction = (UserTransaction)
> context.lookup("java:comp/UserTransaction");
> // Start a transaction.
> userTransaction.begin();
> // ...
> // Perform transactional operations on data
> // Commit the transaction.
> tx.commit();
>
>
>
>
> Regards,
> Ian
>
>
>
>
> From: Paul Parkinson <paul.parkinson_at_oracle.com>
> To: users_at_jta-spec.java.net,
> Cc: Bill Shannon <bill.shannon_at_oracle.com>, Kevin Sutter <sutter_at_us.ibm.com>, Joseph Bergmark <bergmark_at_us.ibm.com>
> Date: 24/03/2013 16:27
> Subject: [jta-spec users] latest/final rev of JTA 1.2 spec and Javadoc
>
>
>
> http://java.net/projects/jta-spec/sources/spec-source-repository/content/JTA1.2Specification.pdf?rev=10
> http://java.net/projects/jta-spec/sources/spec-source-repository/content/JTA1.2Javadoc.zip?rev=10
>
> Regards,
> Paul
>
>
> Unless stated otherwise above:
> IBM United Kingdom Limited - Registered in England and Wales with number 741598.
> Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU