BUILDING.txt 3.4.6 refers to a readme file for testing that does not exist

• Key: DERBY-182
• Type: Bug
• Status: Closed
• Resolution: Fixed
• Priority: Major
• Assignee: Andrew McIntyre
• Reporter: David Van Couvering
• Component/s: Documentation
• Affects Version/s: 10.0.2.2
• Fix Version/s: 10.0.2.2, 10.1.1.0

Environment

------------------ Java Information ------------------
Java Version: 1.4.2_05
Java Vendor: Sun Microsystems Inc.
Java home: d:\j2sdk1.4.2_05\jre
Java classpath: classes
OS name: Windows XP
OS architecture: x86
OS version: 5.1
Java user name: davidvc
Java user home: C:\Documents and Settings\davidvc
Java user dir: d:\derby\src\10.0
--------- Derby Information --------
[D:\derby\src\10.0\classes] 10.0.2.2 - (158519)
------------------------------------------------------

Description

BUILDING.txt 3.4.6 says

"(6) Derby also includes a suite of tests for more comprehensive verification.
    Information on how to run these tests can be found in the source tree,
    in the file ${derby.source}/java/testing/org/apache/derbyTesting/readme.htm"

However, there is no such file in this location. The only instructions for testing I can find are on the web site where there are instructions on how to submit a patch.

Comments

[Andrew McIntyre]

There is a readme for testing checked into subversion, but the path in building.txt is in fact incorrect. The correct path is ${derby.source}/java/testing/readme.htm. I will update BUILDING.txt accordingly.

[Andrew McIntyre]

Updated BUILDING.txt with revisions 159083, 159084.

[David Van Couvering]

Thanks, looks good, although it's README.htm, not readme.htm...

[Bernt M. Johnsen]

Wouldn't say this one is fixed, as David commented, the case is wrong,and there is also another reference to the README.htm

This patch should fix it:

Index: BUILDING.txt
===================================================================
--- BUILDING.txt (revision 159352)
+++ BUILDING.txt (working copy)
@@ -458,7 +458,7 @@
  
 (6) Derby also includes a suite of tests for more comprehensive verification.
     Information on how to run these tests can be found in the source tree,
- in the file ${derby.source}/java/testing/readme.htm
+ in the file ${derby.source}/java/testing/README.htm
  
 ---------------------------------------------------------------
 4 Derby build miscellaneous information
@@ -480,7 +480,7 @@
   demo: builds the simple demos in java/demo
  
   testing: builds the tests in java/testing. For additional information on
- testing, please see java/testing/org/apache/derbyTesting/readme.htm
+ testing, please see java/testing/README.htm
  
   javadoc: to create javadoc for all source code.