jsampson/prevayler — pull request #4 by Navigateur (2011-11-10 09:15:04+00:00)
Title: Some javadoc changes, please review, including output

Made a bold change to Transaction javadoc. "Transactions CANNOT reference business objects directly" confused me at first because I thought it meant the transaction execution body even though it meant the transaction's instance members. This threw me off the rest of the explanation so I couldn't figure out the "baptism problem" from this. When I did, via the mailing list, I found it was unbelievably straightforward, and confirmed what I already knew, not a "problem" as suggested: "This is known as the prevalence baptism problem because everyone comes across it, despite of this warning." What's sillier is I've read someone on a forum avoiding Prevayler because they were worried about the "baptism problem" as though it's a tricky problem. I'd prefer it not to be pessimistic.

Anyway I put 2 rules which cover all cases of unrecoverability in Prevayler, including the case where unrecoverable reference equality might be depended upon to change (or not change) the prevalent system. Please review, including output.

Other, smaller javadoc changes:
Type @params in to explain "P" and "R" on the front-end classes.
Other neatness things.