Derby
  1. Derby
  2. DERBY-4592

Documentation: Update Sun trademarks in manuals

    Details

    • Type: Task Task
    • Status: Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 10.6.1.0
    • Fix Version/s: 10.6.1.0
    • Component/s: Documentation
    • Labels:
      None

      Description

      The Trademarks topic in each manual mentions Sun trademarks. It needs to be changed to specify Oracle trademarks. I have obtained the legal language from the appropriate Oracle documentation manager.

      1. DERBY-4592.diff
        5 kB
        Kim Haase
      2. DERBY-4592.stat
        0.2 kB
        Kim Haase
      3. DERBY-4592.zip
        9 kB
        Kim Haase
      4. DERBY-4592-2.diff
        19 kB
        Kim Haase
      5. DERBY-4592-2.stat
        0.7 kB
        Kim Haase
      6. DERBY-4592-2.zip
        35 kB
        Kim Haase
      7. DERBY-4592-3.diff
        19 kB
        Kim Haase
      8. DERBY-4592-3.zip
        35 kB
        Kim Haase

        Issue Links

          Activity

          Hide
          Kim Haase added a comment -

          Attaching DERBY-4592.diff, DERBY-4592.stat, and DERBY-4592.zip, with changes to the following files:

          M src/adminguide/radmintrademderby.dita
          M src/devguide/rdevtrademderby.dita
          M src/getstart/rgstrademderby.dita
          M src/ref/rreftrademderby.dita
          M src/tools/rtoolstrademderby.dita
          M src/tuning/rtuntrademderby.dita

          You may notice that we now have catch-all boilerplate in two different places, the Oracle paragraph and the last paragraph. I pointed this out but was told it needed to be in the Oracle paragraph too.

          I will commit this patch in a few days unless I hear otherwise.

          Show
          Kim Haase added a comment - Attaching DERBY-4592 .diff, DERBY-4592 .stat, and DERBY-4592 .zip, with changes to the following files: M src/adminguide/radmintrademderby.dita M src/devguide/rdevtrademderby.dita M src/getstart/rgstrademderby.dita M src/ref/rreftrademderby.dita M src/tools/rtoolstrademderby.dita M src/tuning/rtuntrademderby.dita You may notice that we now have catch-all boilerplate in two different places, the Oracle paragraph and the last paragraph. I pointed this out but was told it needed to be in the Oracle paragraph too. I will commit this patch in a few days unless I hear otherwise.
          Hide
          Kim Haase added a comment -

          I'm expanding the scope of this issue to cover changes to Sun trademarks in other topics where these occur. I will file a revised patch in due course.

          Show
          Kim Haase added a comment - I'm expanding the scope of this issue to cover changes to Sun trademarks in other topics where these occur. I will file a revised patch in due course.
          Hide
          Kim Haase added a comment -

          Attaching DERBY-4592-2.diff, DERBY-4592-2.stat, and DERBY-4592-2.zip, with changes to 11 additional files:

          M src/tools/rtoolstrademderby.dita
          M src/tuning/rtuntrademderby.dita
          M src/adminguide/cadminapps811695.dita
          M src/adminguide/cadminssl.dita
          M src/adminguide/cadminappsthenetworkserverandjvms.dita
          M src/adminguide/cadminappsclientsecurity.dita
          M src/adminguide/radmintrademderby.dita
          M src/devguide/cdevcsecure67151.dita
          M src/devguide/cdevstandardsxml.dita
          M src/devguide/cdevsetprop11561.dita
          M src/devguide/cdevdvlp14839.dita
          M src/devguide/rdevtrademderby.dita
          M src/ref/crefjdbc12657.dita
          M src/ref/rreftrademderby.dita
          M src/ref/rrefproper81359.dita
          M src/getstart/cgsintro.dita
          M src/getstart/rgstrademderby.dita

          This patch fixes the Trademarks topics in the manuals and removes most references to Sun elsewhere in the Derby docs. Most such references are in trademark elements, which are not really necessary because of the Trademarks topic. I've also taken the opportunity to correct some trademark usages (JVM, for example) in the topics that needed changes anyway.

          Some of the changes involved replacing specific references to the Sun JDK with more general statements about the JDK. I'd be grateful if someone from IBM would take a look at these to make sure that they apply to both JDKs. For example, does IBM's JDK have a keytool utility as Sun's does?

          In a few cases, I've left the Sun name in: one Developer's Guide topic draws a specific contrast between the IBM and Sun JDK behavior. I put Sun in the past tense here.

          I also left in a couple of references to "com.sun.crypto.provider.SunJCE" because I understand these package names are not changing. I also left the output of the sysinfo command as is in the Tools manual, because an Oracle-branded JVM is not available yet.

          The Reference Manual topic on the derby.storage.pageCacheSize property has long contained an extremely obsolete paragraph about the 1.1.7 JVM. I think I asked a while ago, when I moved these topics to the Reference Manual, if anyone could provide information to update this. I didn't get any, so I left it as is. This seems to be a good time to remove it entirely, though it leaves us without any advice as to what a suitable page cache size might be. I'm still open to update suggestions.

          Another Ref Man topic talked about the 4 JDBC driver types "defined by Sun" but didn't say where they are defined. I found the reference. Links to java.sun.com web pages will be valid for quite a while (though they will be redirected at some point).

          I will commit this in 2-3 days if I don't hear of any needed changes.

          Show
          Kim Haase added a comment - Attaching DERBY-4592 -2.diff, DERBY-4592 -2.stat, and DERBY-4592 -2.zip, with changes to 11 additional files: M src/tools/rtoolstrademderby.dita M src/tuning/rtuntrademderby.dita M src/adminguide/cadminapps811695.dita M src/adminguide/cadminssl.dita M src/adminguide/cadminappsthenetworkserverandjvms.dita M src/adminguide/cadminappsclientsecurity.dita M src/adminguide/radmintrademderby.dita M src/devguide/cdevcsecure67151.dita M src/devguide/cdevstandardsxml.dita M src/devguide/cdevsetprop11561.dita M src/devguide/cdevdvlp14839.dita M src/devguide/rdevtrademderby.dita M src/ref/crefjdbc12657.dita M src/ref/rreftrademderby.dita M src/ref/rrefproper81359.dita M src/getstart/cgsintro.dita M src/getstart/rgstrademderby.dita This patch fixes the Trademarks topics in the manuals and removes most references to Sun elsewhere in the Derby docs. Most such references are in trademark elements, which are not really necessary because of the Trademarks topic. I've also taken the opportunity to correct some trademark usages (JVM, for example) in the topics that needed changes anyway. Some of the changes involved replacing specific references to the Sun JDK with more general statements about the JDK. I'd be grateful if someone from IBM would take a look at these to make sure that they apply to both JDKs. For example, does IBM's JDK have a keytool utility as Sun's does? In a few cases, I've left the Sun name in: one Developer's Guide topic draws a specific contrast between the IBM and Sun JDK behavior. I put Sun in the past tense here. I also left in a couple of references to "com.sun.crypto.provider.SunJCE" because I understand these package names are not changing. I also left the output of the sysinfo command as is in the Tools manual, because an Oracle-branded JVM is not available yet. The Reference Manual topic on the derby.storage.pageCacheSize property has long contained an extremely obsolete paragraph about the 1.1.7 JVM. I think I asked a while ago, when I moved these topics to the Reference Manual, if anyone could provide information to update this. I didn't get any, so I left it as is. This seems to be a good time to remove it entirely, though it leaves us without any advice as to what a suitable page cache size might be. I'm still open to update suggestions. Another Ref Man topic talked about the 4 JDBC driver types "defined by Sun" but didn't say where they are defined. I found the reference. Links to java.sun.com web pages will be valid for quite a while (though they will be redirected at some point). I will commit this in 2-3 days if I don't hear of any needed changes.
          Hide
          Rick Hillegas added a comment -

          Thanks for these improvements, Kim. I have some comments:

          General Comments:

          o The (TM) symbol has been stripped from Java references. Can you reassure me that that is legally ok?

          Specific Comments:

          cadminapps811695

          o I think that the change is not correct. The IBM 1.4 VM lets you specify 256 bit primes. It is just the Sun VM which requires bigger primes.

          o While I was in there, I couldn't help noticing some pre-existing typos: "whith an JCE" should be "with a JCE".

          cadminssl

          o For what it's worth, I have an IBM Java 5 JDK for Linux. It contains the keytool program.

          cdevcsecure67151

          o The following clarification would help: Change

          "implemented in the Java Cryptography Extension (JCE) package"

          to

          "implemented in the Java Cryptography Extension (JCE) packages (javax.crypto.*)"

          cdevstandardsxml

          o I would reword the leading sentences of the last paragraph:

          "After JVM version 1.4, Sun renamed the JAXP packages. Derby cannot find these renamed packages. If you are using a JVM later than version 1.4 ..."

          Show
          Rick Hillegas added a comment - Thanks for these improvements, Kim. I have some comments: General Comments: o The (TM) symbol has been stripped from Java references. Can you reassure me that that is legally ok? Specific Comments: cadminapps811695 o I think that the change is not correct. The IBM 1.4 VM lets you specify 256 bit primes. It is just the Sun VM which requires bigger primes. o While I was in there, I couldn't help noticing some pre-existing typos: "whith an JCE" should be "with a JCE". cadminssl o For what it's worth, I have an IBM Java 5 JDK for Linux. It contains the keytool program. cdevcsecure67151 o The following clarification would help: Change "implemented in the Java Cryptography Extension (JCE) package" to "implemented in the Java Cryptography Extension (JCE) packages (javax.crypto.*)" cdevstandardsxml o I would reword the leading sentences of the last paragraph: "After JVM version 1.4, Sun renamed the JAXP packages. Derby cannot find these renamed packages. If you are using a JVM later than version 1.4 ..."
          Hide
          Kim Haase added a comment -

          Thanks, Rick – I have made those edits and will do a revised patch. I put "Sun" back in cadminapps811695 since the reference is to 1.4.

          As for this one –

          o The (TM) symbol has been stripped from Java references. Can you reassure me that that is legally ok?

          I have been going back and forth with our Oracle contact on this, and she says they only put trademarks in book titles – after that they rely on the wording in the legal statement (our trademarks topic). I am triple-checking this.

          Show
          Kim Haase added a comment - Thanks, Rick – I have made those edits and will do a revised patch. I put "Sun" back in cadminapps811695 since the reference is to 1.4. As for this one – o The (TM) symbol has been stripped from Java references. Can you reassure me that that is legally ok? I have been going back and forth with our Oracle contact on this, and she says they only put trademarks in book titles – after that they rely on the wording in the legal statement (our trademarks topic). I am triple-checking this.
          Hide
          Kim Haase added a comment -

          Attaching DERBY-4592-3.diff and DERBY-4592-3.zip, with further corrections to trademarks. I hope these are okay. Thanks for any feedback.

          Show
          Kim Haase added a comment - Attaching DERBY-4592 -3.diff and DERBY-4592 -3.zip, with further corrections to trademarks. I hope these are okay. Thanks for any feedback.
          Hide
          Kim Haase added a comment -

          Having received no comments, committed patch DERBY-4592-3.diff to documentation trunk at revision 930280.

          Show
          Kim Haase added a comment - Having received no comments, committed patch DERBY-4592 -3.diff to documentation trunk at revision 930280.
          Hide
          Kim Haase added a comment -

          Changes hae appeared in Latest Alpha Manuals, so closing.

          Show
          Kim Haase added a comment - Changes hae appeared in Latest Alpha Manuals, so closing.

            People

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

              Dates

              • Created:
                Updated:
                Resolved:

                Development