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

Kim Haase commented on DERBY-6376:
----------------------------------

This is very helpful, Knut -- I will work on implementing these changes. Thanks!

It would be good to figure out which additional metadata methods return 
Derby-specific columns, if that's possible. 

> Revise DatabaseMetaData section of Reference Manual
> ---------------------------------------------------
>
>                 Key: DERBY-6376
>                 URL: https://issues.apache.org/jira/browse/DERBY-6376
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.10.1.1
>            Reporter: Kim Haase
>            Priority: Minor
>
> In a comment on DERBY-6369, Knut Anders Hatlen suggests that the topic 
> "Parameters to getProcedureColumns" 
> (http://db.apache.org/derby/docs/10.10/ref/rrefpgc1.html) might be removed. 
> The purpose of the topics under "JDBC Reference" is to provide Derby-specific 
> implementation information. In this topic, however, the Derby-specific 
> information seems to apply to other methods as well: the information on 
> catalogs and the information on name patterns.
> It may be that another topic in the same section, 
> "java.sql.DatabaseMetaData.getProcedureColumns method" 
> (http://db.apache.org/derby/docs/10.10/ref/rrefgpc1.html), could also be 
> removed. Derby presumably supports other DatabaseMetaData methods that are 
> not mentioned, such as getFunctionColumns and, more recently, getAttributes 
> (of UDTS) and getUDTs. Why mention this one only?
> The topic "Columns in the ResultSet returned by getProcedureColumns" 
> (http://db.apache.org/derby/docs/10.10/ref/rrefcrsrgpc1.html) does contain 
> Derby-specific information, listing a couple of columns that are not listed 
> in the Java SE documentation on this method (see 
> http://docs.oracle.com/javase/7/docs/api/java/sql/DatabaseMetaData.html). So 
> this topic needs to be retained.
> Some information could be added to the top-level "java.sql.DatabaseMetaData 
> interface" topic 
> (http://docs.oracle.com/javase/7/docs/api/java/sql/DatabaseMetaData.html) 
> about needing to specify null for catalog columns and perhaps about using the 
> "%" wildcard to obtain a list of all items in a particular namePattern field.
> Let me know if these changes don't make sense.



--
This message was sent by Atlassian JIRA
(v6.1#6144)

Reply via email to