On Sat, Nov 21, 2009 at 1:18 PM, Bryan = Pendleton (JIRA) <j= ira@apache.org> wrote:

=A0 =A0 [ https://issues.apache.org/jira/browse/DERBY-3225?page=3Dcom.atlassi= an.jira.plugin.system.issuetabpanels:all-tabpanel ]

Bryan Pendleton updated DERBY-3225:
-----------------------------------

=A0 =A0Attachment: 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 bin= ary release distribution.
=A0 (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
=A0 readme.html, to give some overview to the user about what is to be fou= nd 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 t= he <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 simpl= e 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/pro= grams/readme.html
> ----------------------------------------------------------------------= -----------------
>
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 Key: DERBY-3225
> =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 URL: https://issues.apache.org/jir= a/browse/DERBY-3225
> =A0 =A0 =A0 =A0 =A0 =A0 Project: Derby
> =A0 =A0 =A0 =A0 =A0Issue Type: Improvement
> =A0 =A0 =A0 =A0 =A0Components: Demos/Scripts
> =A0 =A0Affects Versions: 10.3.1.4
> =A0 =A0 =A0 =A0 Environment: Derby -bin distributions
> =A0 =A0 =A0 =A0 =A0 =A0Reporter: John H. Embretsen
> =A0 =A0 =A0 =A0 =A0 =A0Assignee: Bryan Pendleton
> =A0 =A0 =A0 =A0 Attachments: derby-3225.diff
>
>
> Currently in trunk, there are 8 demo (sub)directories in the demo/prog= rams directory scheduled to be included in -bin distributions, each contain= ing one or more demo or sample applications:
> =A0 localcal/
> =A0 nserverdemo/
> =A0 scores/
> =A0 simple/
> =A0 simplemobile/
> =A0 toursdb/
> =A0 vtis/
> =A0 workingwithderby/
> With a -bin distribution of Derby, a user should be able to get an ove= rview 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.ht= ml file). In trunk, we are currently missing short descriptions of and link= s to:
> =A0- localcal (see DERBY-1936) [also in 10.3]
> =A0- scores (see DERBY-1993) [also in 10.3]
> =A0- vtis (see DERBY-3129)
> Each of these demos have a README file in their respective subdirector= ies, 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 description= s 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 instruction= s are suitable for -bin distributions, not only -src distributions or SVN w= orking copies. Otherwise, these particular demos should not be included in = -bin distributions. For example both localcal/README, scores/README and vti= s/README currently refer to build scripts that are not scheduled for inclus= ion in -bin distros.

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