Issue Details (XML | Word | Printable)

Key: DERBY-3985
Type: Improvement Improvement
Status: Resolved Resolved
Resolution: Fixed
Priority: Major Major
Assignee: Rick Hillegas
Reporter: Rick Hillegas
Votes: 0
Watchers: 0
Operations

If you were logged in you would be able to see more operations.
Derby

Replace BUILDING.txt with a simlified up-to-date BUILDING.html

Created: 10/Dec/08 04:15 PM   Updated: 04/May/09 06:22 PM
Component/s: Build tools
Affects Version/s: 10.5.1.1
Fix Version/s: 10.5.1.1

Time Tracking:
Not Specified

File Attachments:
  Size
File Licensed for inclusion in ASF works derby-3985-01-aa-simplerBuildInstructions.diff 2008-12-22 08:06 PM Rick Hillegas 42 kB
File Licensed for inclusion in ASF works derby-3985-01-ab-simplerBuildInstructions.diff 2008-12-23 05:10 PM Rick Hillegas 43 kB
File Licensed for inclusion in ASF works derby-3985-01-ac-simplerBuildInstructions.diff 2008-12-23 05:49 PM Rick Hillegas 45 kB
File Licensed for inclusion in ASF works derby-3985-02-aa-website.diff 2009-01-05 04:42 PM Rick Hillegas 9 kB
File Licensed for inclusion in ASF works derby-3985-03-aa-corrections.diff 2009-01-05 07:20 PM Rick Hillegas 2 kB
File Licensed for inclusion in ASF works derby-3985-04-aa-fixViewvcURLs.diff 2009-01-06 02:19 PM Rick Hillegas 3 kB
File Licensed for inclusion in ASF works derby-3985-05-aa-junitVersion.diff 2009-01-06 02:41 PM Rick Hillegas 0.6 kB
Issue Links:
Dependants
 

Issue & fix info: Patch Available
Resolution Date: 20/Jan/09 09:13 PM


 Description  « Hide
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.


 All   Comments   Work Log   Change History   Subversion Commits      Sort Order: Ascending order - Click to sort in descending order
Repository Revision Date User Message
ASF #731605 Mon Jan 05 16:09:30 UTC 2009 rhillegas DERBY-3985: Replace BUILDING.txt with a simpler BUILDING.html which reflects recent changes to the Derby build.
Files Changed
ADD /db/derby/code/trunk/BUILDING.html
MODIFY /db/derby/code/trunk/java/testing/org/apache/derbyTesting/functionTests/tests/junitTests/compatibility/testScript.xml
MODIFY /db/derby/code/trunk/java/build/org/apache/derbyPreBuild/PropertySetter.java
MODIFY /db/derby/code/trunk/tools/release/build.xml
MODIFY /db/derby/code/trunk/java/testing/org/apache/derbyTesting/functionTests/tests/jdbc4/README.html
MODIFY /db/derby/code/trunk/java/testing/README.htm
DEL /db/derby/code/trunk/BUILDING.txt

Repository Revision Date User Message
ASF #731614 Mon Jan 05 16:39:07 UTC 2009 rhillegas DERBY-3985: Update the website so that the build instructions reflect the recent changes to the build and the conversion of BUILDING.txt to BUILDING.html.
Files Changed
MODIFY /db/derby/site/trunk/build/site/dev/derby_source.html
MODIFY /db/derby/site/trunk/src/documentation/content/xdocs/dev/derby_source.xml

Repository Revision Date User Message
ASF #731650 Mon Jan 05 19:18:41 UTC 2009 rhillegas DERBY-3985: Polish BUILDING.html a bit.
Files Changed
MODIFY /db/derby/code/trunk/BUILDING.html

Repository Revision Date User Message
ASF #731942 Tue Jan 06 14:11:51 UTC 2009 rhillegas DERBY-3985: On the website's build instructions page, fix the urls which point into the subversion repository.
Files Changed
MODIFY /db/derby/site/trunk/build/site/dev/derby_source.html
MODIFY /db/derby/site/trunk/src/documentation/content/xdocs/dev/derby_source.xml

Repository Revision Date User Message
ASF #731958 Tue Jan 06 14:38:52 UTC 2009 rhillegas DERBY-3985: Update BUILDING.html to recommend junit 3.8.2 rather than 3.8.1.
Files Changed
MODIFY /db/derby/code/trunk/BUILDING.html

Repository Revision Date User Message
ASF #731962 Tue Jan 06 14:50:10 UTC 2009 rhillegas DERBY-3985: Correct typo in BUILDING.html.
Files Changed
MODIFY /db/derby/code/trunk/BUILDING.html

Repository Revision Date User Message
ASF #734746 Thu Jan 15 16:31:54 UTC 2009 rhillegas DERBY-3985: Fix a typo in BUILDING.html.
Files Changed
MODIFY /db/derby/code/trunk/BUILDING.html