[ 
https://issues.apache.org/jira/browse/DERBY-1934?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12484905
 ] 

Kim Haase commented on DERBY-1934:
----------------------------------

Uh-oh, we've got colliding JIRAs. DERBY-2090 (fixed recently) was actually a 
duplicate of this issue, I believe, but we didn't catch this. Which solution is 
preferable? The thing is, the JDBC 2.0 Optional Package API is very old -- that 
API has been folded into the JDK for some time (it is part of JDK 1.4.2 and 
every JDK since). So I would suggest that the current wording --

"(For more details about these extensions, see the API documentation for your 
version of the Java Development Kit, which you can find at 
http://java.sun.com/javase/reference/api.jsp)."

may be preferable. Lance Andersen may be the best authority on which reference 
to use.

I agree that the following sentence is ambiguous:

"Derby's implementation of DataSource means that it supports JNDI; as a 
resource manager, it allows a database to be named and registered within a JNDI 
server."

I think that "it" means "Derby" in the first clause and "DataSource" in the 
second. Maybe it could be rephrased as follows:

"By implementing DataSource, Derby provides support for the Java Naming and 
Directory Interface (JNDI). As a resource manager, the Datasource interface 
allows ..."


> Reference Manual updates - J2EE Compliance: Java Transaction API and 
> javax.sql Extensions
> -----------------------------------------------------------------------------------------
>
>                 Key: DERBY-1934
>                 URL: https://issues.apache.org/jira/browse/DERBY-1934
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.2.1.6
>            Reporter: Laura Stewart
>         Assigned To: Laura Stewart
>         Attachments: derby1934_1.diff, rrefjta18596.html
>
>
> J2EE Compliance: Java Transaction API and javax.sql Extensions: 
>  
> Section = javax.sql:JDBC Extensions 
> File = http://db.apache.org/derby/docs/dev/ref/rrefjta18596.html 
> Update = 
> This URL no longer exists: (For more details about these extensions, see  
> http://java.sun.com/products/jdbc/jdbc20.stdext.javadoc/javax/sql/package-summary.html).
>  The page that has this information, although you have to browse to the 
> section called JDBC 2.0 Optional Package API is  
> http://java.sun.com/products/jdbc/download.html  

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to