You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Bryan Pendleton (JIRA)" <ji...@apache.org> on 2009/11/21 19:18:39 UTC

[jira] Updated: (DERBY-3225) Some demo programs in -bin distributions are not mentioned in demo/programs/readme.html

     [ 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: 10.3.1.4
>         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 applications:
>   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.


Re: [jira] Updated: (DERBY-3225) Some demo programs in -bin distributions are not mentioned in demo/programs/readme.html

Posted by George Bova <gs...@archivex.net>.
unsubscribe grscott@archivex.net

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

>
>     [
> 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: 10.3.1.4
> >         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 applications:
> >   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.
>
>