Derby
  1. Derby
  2. DERBY-5047

Documentation links to java.sun.com should be updated

    Details

    • Type: Bug Bug
    • Status: Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 10.7.1.1
    • Fix Version/s: 10.8.1.2
    • Component/s: Documentation
    • Labels:
      None

      Description

      The Admin, Dev, Reference, and Tools manuals all contain links to java.sun.com URLs that need to be updated to go to the appropriate Oracle URLs. I believe that most of these if not all currently redirect to the equivalent Oracle page, but I haven't verified this. There appear to be about 23 instances currently.

      1. DERBY-5047.zip
        28 kB
        Kim Haase
      2. DERBY-5047.stat
        0.5 kB
        Kim Haase
      3. DERBY-5047.diff
        19 kB
        Kim Haase

        Activity

        Hide
        Kim Haase added a comment -

        Fixing the java.sun.com links will involve changes to the following topics:

        crefjdbc12657.dita: JDBC reference
        rrefjta16677.dita: J2EE Compliance: Java Transaction API and javax.sql Interfaces
        rrefjta18596.dita: javax.sql: JDBC Interfaces

        cadminconfig86869.dita: Managing the Derby Network Server
        tadminconfigsysteminformation.dita: Obtaining system information

        rtoolsijpropref97949.dita: derby.ui.codeset property

        cdevcsecure90988.dita: Signed jar files
        cdevcsecure96815.dita: Requirements for Derby encryption
        cdevresman19524.dita: Using Derby as a J2EE resource manager
        cdevsetprop824983.dita: Verifying system properties
        cdevstandardsxml.dita: XML data types and operators

        I am not going to change the link in cdevspecialudt.dita (Programming user-defined types), because the old URL is still current and the content is not available anywhere on the Oracle site yet.

        rrefjta16677.dita and cdevresman19524.dita contain some duplicated language that provides an opportunity to update some old crufty Java EE and Java SE terminology.

        Show
        Kim Haase added a comment - Fixing the java.sun.com links will involve changes to the following topics: crefjdbc12657.dita: JDBC reference rrefjta16677.dita: J2EE Compliance: Java Transaction API and javax.sql Interfaces rrefjta18596.dita: javax.sql: JDBC Interfaces cadminconfig86869.dita: Managing the Derby Network Server tadminconfigsysteminformation.dita: Obtaining system information rtoolsijpropref97949.dita: derby.ui.codeset property cdevcsecure90988.dita: Signed jar files cdevcsecure96815.dita: Requirements for Derby encryption cdevresman19524.dita: Using Derby as a J2EE resource manager cdevsetprop824983.dita: Verifying system properties cdevstandardsxml.dita: XML data types and operators I am not going to change the link in cdevspecialudt.dita (Programming user-defined types), because the old URL is still current and the content is not available anywhere on the Oracle site yet. rrefjta16677.dita and cdevresman19524.dita contain some duplicated language that provides an opportunity to update some old crufty Java EE and Java SE terminology.
        Hide
        Kim Haase added a comment -

        Attaching DERBY-5047.diff, DERBY-5047.stat, and DERBY-5047.zip, with changes to the following topics:

        M src/tools/rtoolsijpropref97949.dita
        M src/adminguide/cadminconfig86869.dita
        M src/adminguide/tadminconfigsysteminformation.dita
        M src/devguide/cdevstandardsxml.dita
        M src/devguide/cdevcsecure96815.dita
        M src/devguide/cdevcsecure90988.dita
        M src/devguide/cdevresman19524.dita
        M src/devguide/cdevsetprop824983.dita
        M src/ref/crefjdbc12657.dita
        M src/ref/rrefjta16677.dita
        M src/ref/rrefjta18596.dita

        I linked to the Java SE 6 version of a document where several versions were available, except in a case where the topic specifically referred to 1.4.2.

        For a couple of topics I also updated some ancient Java EE terminology (changed J2EE to Java EE, etc.), observing trademark rules where this was needed. I also removed a reference to "Chapter 6", left over from before the DITA conversion of these files.

        I plan to commit this patch shortly, but feel free to suggest additional changes.

        Show
        Kim Haase added a comment - Attaching DERBY-5047 .diff, DERBY-5047 .stat, and DERBY-5047 .zip, with changes to the following topics: M src/tools/rtoolsijpropref97949.dita M src/adminguide/cadminconfig86869.dita M src/adminguide/tadminconfigsysteminformation.dita M src/devguide/cdevstandardsxml.dita M src/devguide/cdevcsecure96815.dita M src/devguide/cdevcsecure90988.dita M src/devguide/cdevresman19524.dita M src/devguide/cdevsetprop824983.dita M src/ref/crefjdbc12657.dita M src/ref/rrefjta16677.dita M src/ref/rrefjta18596.dita I linked to the Java SE 6 version of a document where several versions were available, except in a case where the topic specifically referred to 1.4.2. For a couple of topics I also updated some ancient Java EE terminology (changed J2EE to Java EE, etc.), observing trademark rules where this was needed. I also removed a reference to "Chapter 6", left over from before the DITA conversion of these files. I plan to commit this patch shortly, but feel free to suggest additional changes.
        Hide
        Kim Haase added a comment -

        Committed patch DERBY-5047.diff to documentation trunk at revision 1076847.

        Show
        Kim Haase added a comment - Committed patch DERBY-5047 .diff to documentation trunk at revision 1076847.
        Hide
        Kim Haase added a comment -

        Closing, since fixes have appeared in latest alpha docs.

        Show
        Kim Haase added a comment - Closing, since fixes have appeared in latest alpha docs.

          People

          • Assignee:
            Kim Haase
            Reporter:
            Kim Haase
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development