[
https://issues.apache.org/jira/browse/DERBY-3985?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12658899#action_12658899
]
myrna edited comment on DERBY-3985 at 12/23/08 9:31 AM:
---------------------------------------------------------------------
I haven't applied the patch & read the doc yet, but I wanted to mention:
1. I believe building.txt is referenced on the main derby site; at least on:
http://db.apache.org/derby/dev/derby_source.html#How+to+build+Derby
Probably also mentioned on the wiki too.
These references need to get changed.
2. building.txt is part of the src. distribution during a release build. We
need to make sure building.htm goes in its place.
was (Author: myrna):
I haven't applied the patch & read the doc yet, but I wanted to mention:
1. I believe building.txt is referenced on the main derby site; at least on:
http://db.apache.org/derby/dev/derby_source.html#How+to+build+Derby
Probably also mentioned on the wiki too.
These references need to get changed.
2. building.txt is part of the src. tree during a release build. We need to
make sure building.htm goes in its place.
> Replace BUILDING.txt with a simlified up-to-date BUILDING.html
> --------------------------------------------------------------
>
> Key: DERBY-3985
> URL: https://issues.apache.org/jira/browse/DERBY-3985
> Project: Derby
> Issue Type: Improvement
> Components: Build tools
> Affects Versions: 10.5.0.0
> Reporter: Rick Hillegas
> Assignee: Rick Hillegas
> Attachments: derby-3985-01-aa-simplerBuildInstructions.diff,
> derby-3985-01-ab-simplerBuildInstructions.diff
>
>
> 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.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
