Bug #45758 Documentation for 'holdResultsOpenOverStatementClose' is confusing

• Submitted: 25 Jun 2009 16:12
• Modified: 19 Jan 2010 16:32
• Reporter: Christopher Schultz
• Status: Closed
• Category: Connector / J Documentation
• Severity: S3 (Non-critical)
• Version: 5.1.7
• OS: Any
• Assigned to: Tony Bedford
• CPU Architecture: Any

[25 Jun 2009 16:12] Christopher Schultz

Description:
The documentation for the 'holdResultsOpenOverStatementClose' connection property says
"
Should the driver close result sets on Statement.close() as required by the JDBC specification?
". The property name and the description seem conflict.

How to repeat:
1. Read the documentation for 'holdResultsOpenOverStatementClose'
2. Scratch your head

Suggested fix:
The description should probably read:

"
Should the driver /leave result sets open/ on Statement.close() (violates JDBC specification)
"

[25 Jun 2009 16:52] Valeriy Kravchuk

Thank you for the documentation request.

[16 Dec 2009 3:40] Chris Price

Could you please update your online documentation?  I just wasted time trying to figure out why the property name and description conflict.  It should be as easy as copy/paste from this ticket into your Wiki.

[18 Jan 2010 14:00] Tony Bedford

I cannot fix this as the offending text is located in Java source code from which the XML file connector-j-connprops.xml is generated. I believe Mark Matthews would have to fix this in his source code?

[19 Jan 2010 16:32] MC Brown

The properties files that contain this information have been updated. The updated versions should appear in overnight rebuilds of the documentation.