db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Rick Hillegas (JIRA)" <j...@apache.org>
Subject [jira] Updated: (DERBY-3985) Replace BUILDING.txt with a simlified up-to-date BUILDING.html
Date Tue, 06 Jan 2009 14:20:47 GMT

     [ https://issues.apache.org/jira/browse/DERBY-3985?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel

Rick Hillegas updated DERBY-3985:

    Attachment: derby-3985-04-aa-fixViewvcURLs.diff

Hi John,

Thanks for the tip about how to pull subversion-controlled html files through viewvc. That
trick works for me too using Firefox on Mac OS X. While I was in there, I also fixed the URL
to the testing README page.

By the way, do you have a pointer to documentation for Viewvc? The website is a little terse:

Attaching derby-3985-04-aa-fixViewvcURLs.diff, a patch which changes the URLs as you suggest.
Touches the following files, committed at subversion revision 731942:

M      build/site/dev/derby_source.html
M      src/documentation/content/xdocs/dev/derby_source.xml

> 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:
>            Reporter: Rick Hillegas
>            Assignee: Rick Hillegas
>         Attachments: derby-3985-01-aa-simplerBuildInstructions.diff, derby-3985-01-ab-simplerBuildInstructions.diff,
derby-3985-01-ac-simplerBuildInstructions.diff, derby-3985-02-aa-website.diff, derby-3985-03-aa-corrections.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.

View raw message