[ZOOKEEPER-1336] javadoc for multi is confusing, references functionality that doesn't seem to exist

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.4.1
• Fix Version/s: 3.4.3, 3.5.0
• Component/s: java client
• Hadoop Flags: Reviewed
• Release Note: Improved Javadoc for multi API's.
• Assignee: Patrick D. Hunt
• Reporter: Patrick D. Hunt
• Created: 21/Dec/11 23:24
• Updated: 06/Feb/12 10:58
• Resolved: 06/Feb/12 08:58

Description

There's this in org.apache.zookeeper.ZooKeeper.multi(Iterable<Op>)

     * Executes multiple Zookeeper operations or none of them.  On success, a list of results is returned.
     * On failure, only a single exception is returned.  If you want more details, it may be preferable to
     * use the alternative form of this method that lets you pass a list into which individual results are
     * placed so that you can zero in on exactly which operation failed and why.

What is the "alternate form of this method" that's being referred to? Seems like we should add this functionality, or at the very least update the javadoc. (I don't think this is referring to Transaction, although the docs there are pretty thin)