db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Bryan Pendleton (JIRA)" <j...@apache.org>
Subject [jira] Updated: (DERBY-3225) Some demo programs in -bin distributions are not mentioned in demo/programs/readme.html
Date Sat, 21 Nov 2009 18:18:39 GMT

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

Bryan Pendleton updated DERBY-3225:

    Attachment: derby-3225.diff

As I understand it, there are two changes needed:

1) Ensure that localcal/build.xml and scores/build.xml make it into the binary release distribution.
   (VTIs does not seem to have a separate build script)
2) Ensure that localcal, scores, and vtis are mentioned, at least briefly, in the top-level
   readme.html, to give some overview to the user about what is to be found there.

Attached is a simple patch proposal to perform these two changes.

I didn't build an entire release (don't know how), but I did test the <zipfileset> changes
in a separate standalone Ant test, and they seemed to work fine.

The README files in localcal, scores, and vtis are not HTML, but just simple text, so
they don't display very well in browsers, but at least they are better than nothing,
and the motivated user can do more work themselves.

Please let me know what you think.

> Some demo programs in -bin distributions are not mentioned in demo/programs/readme.html
> ---------------------------------------------------------------------------------------
>                 Key: DERBY-3225
>                 URL: https://issues.apache.org/jira/browse/DERBY-3225
>             Project: Derby
>          Issue Type: Improvement
>          Components: Demos/Scripts
>    Affects Versions:
>         Environment: Derby -bin distributions
>            Reporter: John H. Embretsen
>            Assignee: Bryan Pendleton
>         Attachments: derby-3225.diff
> Currently in trunk, there are 8 demo (sub)directories in the demo/programs directory
scheduled to be included in -bin distributions, each containing one or more demo or sample
>   localcal/
>   nserverdemo/
>   scores/
>   simple/
>   simplemobile/
>   toursdb/
>   vtis/
>   workingwithderby/
> With a -bin distribution of Derby, a user should be able to get an overview of the included
demo program offering by opening demo/programs/readme.html in a web browser (there is a link
to this from the top-level index.html file). In trunk, we are currently missing short descriptions
of and links to:
>  - localcal (see DERBY-1936) [also in 10.3]
>  - scores (see DERBY-1993) [also in 10.3]
>  - vtis (see DERBY-3129)
> Each of these demos have a README file in their respective subdirectories, that could
easily be linked to.*
> The remaining 5 demos are accessible from and described by the readme.html file (readme.html
is a frameset; the actual references and descriptions are in navbar.html and demo.html. These
files are placed in the java/demo directory in the source tree).
> *)
> Also, one should make sure that the README files and other instructions are suitable
for -bin distributions, not only -src distributions or SVN working copies. Otherwise, these
particular demos should not be included in -bin distributions. For example both localcal/README,
scores/README and vtis/README currently refer to build scripts that are not scheduled for
inclusion in -bin distros.

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

View raw message