Resolves Issue #92: Clarified JavaDoc specifically for using transactions and store-by-reference