drill-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Daniel Barclay (Drill) (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DRILL-3160) Make JDBC Javadoc documentation available to users
Date Thu, 16 Jul 2015 19:17:04 GMT

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

Daniel Barclay (Drill) commented on DRILL-3160:
-----------------------------------------------

We should consider including the tracing proxy driver (java.org.apache.drill.jdbc.proxy.TracingProxyDriver;
see DRILL-2343).

Issues to address:
- It isn't (or at least hasn't been) considered a supported feature.  (That's in part because
it doesn't yet support redirecting its output to anywhere other than System.err.)  Therefore,
it's not clear whether it should be exposed in the JDBC driver's documentation.
- Its interfaces and classes aren't (yet) split into interface vs. implementation packages
as the JDBC driver's types have now been.  The might complicate Maven configuration.
- On the other hand, its already-written documentation should be discoverable somehow by people
using the JDBC driver.



> Make JDBC Javadoc documentation available to users
> --------------------------------------------------
>
>                 Key: DRILL-3160
>                 URL: https://issues.apache.org/jira/browse/DRILL-3160
>             Project: Apache Drill
>          Issue Type: Bug
>          Components: Tools, Build & Test
>            Reporter: Daniel Barclay (Drill)
>            Assignee: Aditya Kishore
>             Fix For: 1.2.0
>
>
> The existing Javadoc documentation (source) for Drill JDBC classes/interfaces such as
org.apache.drill.jdbc.Driver and org.apache.drill.jdbc.DrillResultSet is not generated into
documentation pages and packaged for users by the current Maven build scripts.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message