[DERBY-5938] Documentation says Derby works with Java 1.4.2

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 10.10.1.1
• Fix Version/s: 10.10.1.1
• Component/s: Documentation
• Urgency: Normal
• Assignee: Camilla Haase
• Reporter: Knut Anders Hatlen
• Created: 26/Sep/12 10:10
• Updated: 18/Mar/13 20:34
• Resolved: 15/Oct/12 14:51

Description

The documentation says that Derby works with Java 1.4.2. This is not true on trunk, as support for Java 1.4.2 is removed for Derby 10.10. A quick search came up with these places that need change:

• Getting started guide:

http://db.apache.org/derby/docs/dev/getstart/tgssetupverify.html
http://db.apache.org/derby/docs/dev/getstart/cgstutorialintro.html
http://db.apache.org/derby/docs/dev/getstart/tgssetupjavaenvir.html
http://db.apache.org/derby/docs/dev/getstart/cgsintsr.html

Need to change the above topics to say that you need JDK 1.5 or later installed to run the examples.

• Developer's guide:

http://db.apache.org/derby/docs/dev/devguide/rdevconcepts713.html

The cell for the combination Multi-User/Embedded mentions potential multi-boot problems in pre-1.4 JVMs. Derby doesn't run on pre-1.4 JVMs anymore (and hasn't done for a long time). However, the multi-boot problem is present on CDC/FP 1.1, which is still a supported platform, so maybe we should change "pre-1.4" to "J2ME" (or however we usually refer to that platform in the docs).

• Admin guide:

http://db.apache.org/derby/docs/dev/adminguide/cadminappsthenetworkserverandjvms.html

Should say that the server is compatible with Java 5 and above.

• Tools guide:

http://db.apache.org/derby/docs/dev/tools/ctools1003034.html

Although it's technically correct that the tools do run on Java 1.4, it's not possible to access a Derby database with them on Java 1.4 in any supported way (unsupported way: use derbytools.jar from 10.10 and derby.jar from 10.9). So we should change this topic to say Java 5 and above, perhaps also mentioning CDC/Foundation Profile 1.1.

Issue Links

• is related to: DERBY-5948 Update JVMInfo.java to include JDK 8