[DERBY-3985] Replace BUILDING.txt with a simlified up-to-date BUILDING.html

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 10.5.1.1
• Fix Version/s: 10.5.1.1
• Component/s: Build tools
• Issue & fix info: Patch Available
• Assignee: Richard N. Hillegas
• Reporter: Richard N. Hillegas
• Created: 10/Dec/08 16:15
• Updated: 02/May/13 02:29
• Resolved: 20/Jan/09 21:13

Description

At this point, BUILDING.txt contains a number of mis-statements. It is structured in a way which makes the Derby build look complicated and intimidating. The build instructions need to be thoroughly overhauled and divided into two main sections:

1) The simple build instructions for people who are new to the community. This will be a build with few pre-requisites which just works out of the box.

2) Trickier build instructions for people who want compile-time checks for the different platforms which Derby supports.

While we're at it, I suggest that the revised instructions live in an html file rather than a flat text file. I think this will result in a document that is more readable and easier to navigate.

Issue Links

• depends upon: DERBY-3984 Separate out the small number of build targets which really require JDK1.4 features from the bulk of the targets which ought to compile cleanly against small device libraries