Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
Reply-To: <derby-dev@db.apache.org>
Date: Thu, 23 Jan 2014 18:42:39 +0000 (UTC)
From: "Kim Haase (JIRA)" <jira@apache.org>
To: derby-dev@db.apache.org
Message-ID: <JIRA.12649919.1369835194259.2223.1390502559704@arcas>
In-Reply-To: <JIRA.12649919.1369835194259@arcas>
References: <JIRA.12649919.1369835194259@arcas>
Subject: [jira] [Commented] (DERBY-6236) Remove references to old JVMs
 (pre-Java 6) from the user guides
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


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

Kim Haase commented on DERBY-6236:
----------------------------------

Here are some to-do list additions and a question about the Admin Guide:

"Differences in JDBC 3.0 methods" already had a title and content change as part of DERBY-6389. I think it is okay now.

The following paragraph appears in 4 topics:

"Derby provides three ClientDataSource implementations. You can use the org.apache.derby.jdbc.ClientDataSource class on Java SE 5 and above (except Java SE 8 Compact Profiles), in applications that call JDBC 3 or JDBC 4.0 methods. You can use the org.apache.derby.jdbc.ClientDataSource40 class on Java SE 6 and above (except Java SE 8 Compact Profiles), in applications that call JDBC 4.1 or JDBC 4.2 methods. You must use the org.apache.derby.jdbc.BasicClientDataSource40 class on Java SE 8 Compact Profile 2 or 3."

I think the only two we now need to mention are ClientDataSource and BasicClientDataSource40 (I assume that is not being changed to just BasicClientDataSource? or is it?), so the paragraph would change to

"Derby provides two ClientDataSource implementations. Use the org.apache.derby.jdbc.ClientDataSource class on Java SE 6 and above (except Java SE 8 Compact Profiles). On Java SE 8 Compact Profile 2 or 3, use the org.apache.derby.jdbc.BasicClientDataSource40 class."

"Using XA with the network client driver" (cadminappsxawthdriver.dita) and "Accessing the Network Server by using a DataSource object" (cadminnsdatasources.dita): In addition to the above change, remove the paragraph after it beginning "If your client".


> Remove references to old JVMs (pre-Java 6) from the user guides
> ---------------------------------------------------------------
>
>                 Key: DERBY-6236
>                 URL: https://issues.apache.org/jira/browse/DERBY-6236
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.11.0.0
>            Reporter: Rick Hillegas
>            Assignee: Kim Haase
>
> DERBY-6213 removed support for Java 5 and CDC. We need to scour references to these platforms from our user documentation. This includes scouring references to JDBC 3.0 and JSR 169. Changes include the following:
> -------- Admin Guide -------------
> o "Differences in JDBC 3.0 methods": The section should be renamed to "Differences in JDBC methods" and references to JDBC 3.0 should be removed from its text.
> -------- Developer's Guide -------------
> o "Derby and Java Virtual Machines (JVMs)": the lowest supported JVM level should be changed from 5 to 6.
> -------- Getting Started Guide -------------
> o "System requirements": the lowest supported JVM level should be changed from 5 to 6.
> o"Verifying the Derby system configuration": bullet 1, references to Java version 5 should be changed to 6.
> o "Self-study tutorial for users new to Derby": references to JDK version 5 should be changed to 6.
> -------- Reference Guide -------------
> o "JDBC reference": Change "JDBC 3.0 and 4.0 APIs" -> "JDBC API"
> o "java.sql.Driver interface": This section gives instructions on how to load the JDBC driver if you are running on an old (pre-Java 6) JVM. The section is almost vacuous now. It can be collapsed to the following summary:
> "The class that loads Derby's local JDBC driver is the class org.apache.derby.jdbc.EmbeddedDriver. The class that loads Derby's network client driver is the class org.apache.derby.jdbc.ClientDriver."
> o "JDBC Package for Connected Device Configuration/Foundation Profile (JSR 169)": Remove this section.
> o "Features supported on all JDBC 4 releases": This section should be removed and its material should be merged into the preceding sections.
> o "DataSource classes": The following changes should be made.
> "Embedded environment, for applications running on JDK 5 or higher and using JDBC 3 and JDBC 4.0 methods:" -> "Embedded environment, for applications running on Java 6 or higher:"
> Remove the following paragraph and the list of *40 DataSources which it introduces:
> "Embedded environment, for applications running on JDK 6 or higher and using methods specific to JDBC 4.1 or JDBC 4.2:"
> "Client-server environment, for applications running on JDK 5 or higher and using JDBC 3 and JDBC 4.0 methods:" -> "Client-server environment, for applications running on Java 6 or higher:"
> Remove the following paragraph and the list of *40 DataSources which it introduces:
> "Client-server environment, for applications running on JDK 6 or higher and using methods specific to JDBC 4.1 or JDBC 4.2:"
> -------- Tools Guide -------------
> o "Environment setup and the Derby tools": The minimum Java level is 6, not 5.


--
This message was sent by Atlassian JIRA
(v6.1.5#6160)