Uploaded image for project: 'Derby'
  1. Derby
  2. DERBY-6236

Remove references to old JVMs (pre-Java 6) from the user guides

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Closed
    • Major
    • Resolution: Fixed
    • 10.11.1.1
    • 10.11.1.1
    • Documentation
    • None
    • Normal

    Description

      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.

      Attachments

        1. DERBY-6236-3.diff
          3 kB
          Camilla Haase
        2. DERBY-6236-3.stat
          0.1 kB
          Camilla Haase
        3. DERBY-6236-3.zip
          7 kB
          Camilla Haase
        4. DERBY-6236-4.diff
          1 kB
          Camilla Haase
        5. DERBY-6236-4.stat
          0.1 kB
          Camilla Haase
        6. DERBY-6236-5.diff
          6 kB
          Camilla Haase
        7. DERBY-6236-5.zip
          5 kB
          Camilla Haase
        8. DERBY-6236-adminguide.diff
          26 kB
          Camilla Haase
        9. DERBY-6236-adminguide.stat
          0.9 kB
          Camilla Haase
        10. DERBY-6236-adminguide.zip
          53 kB
          Camilla Haase
        11. DERBY-6236-dgt.diff
          20 kB
          Camilla Haase
        12. DERBY-6236-dgt.stat
          0.4 kB
          Camilla Haase
        13. DERBY-6236-dgt.zip
          27 kB
          Camilla Haase
        14. DERBY-6236-more.diff
          7 kB
          Camilla Haase
        15. DERBY-6236-more.stat
          0.2 kB
          Camilla Haase
        16. DERBY-6236-more.zip
          14 kB
          Camilla Haase
        17. DERBY-6236-ref.diff
          42 kB
          Camilla Haase
        18. DERBY-6236-ref.stat
          0.7 kB
          Camilla Haase
        19. DERBY-6236-ref.zip
          19 kB
          Camilla Haase
        20. DERBY-6236-ref-2.diff
          2 kB
          Camilla Haase
        21. DERBY-6236-ref-2.stat
          0.1 kB
          Camilla Haase
        22. DERBY-6236-ref-2.zip
          5 kB
          Camilla Haase
        23. rrefattribderegister.html
          6 kB
          Camilla Haase

        Issue Links

          There are no Sub-Tasks for this issue.

          Activity

            People

              chaase3 Camilla Haase
              rhillegas Richard N. Hillegas
              Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: