db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "John H. Embretsen (JIRA)" <j...@apache.org>
Subject [jira] Updated: (DERBY-3026) Remove deprecated frameworks directory and scripts
Date Mon, 01 Oct 2007 12:39:50 GMT

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

John H. Embretsen updated DERBY-3026:

    Attachment: releaseNote.html

Attaching a patch (d3026-fixFrameworksRefs.diff) which removes or alters references to the
frameworks directory and the warning file "frameworks.DEPRECATED.txt". Modified files are:

M      java/demo/simple/example.html
M      tools/release/build.xml

It would be good to have someone with experience building the release artifacts to review
this patch, since it includes changes to the release build script. 

I have not test driven the targets of the release build script after making these changes
(I guess one could say that the requirements, from the instructions on the wiki, scared me
off), but the changes seem rather harmless to my eyes (the patch removes the inclusion of
the frameworks directory and the frameworks.DEPRECATED.txt file in release builds).

The patch does not actually remove the files. In order to do so, a committer would need to:

   * svn delete frameworks/
   * svn delete frameworks.DEPRECATED.txt
   * commit the changes (and preferably the patch fixing the old references)

I have also included a first draft of release notes describing this change. Please review.

> Remove deprecated frameworks directory and scripts
> --------------------------------------------------
>                 Key: DERBY-3026
>                 URL: https://issues.apache.org/jira/browse/DERBY-3026
>             Project: Derby
>          Issue Type: Task
>          Components: Demos/Scripts
>    Affects Versions:
>         Environment: N/A
>            Reporter: John H. Embretsen
>            Assignee: John H. Embretsen
>             Fix For:
>         Attachments: d3026-fixFrameworksRefs.diff, releaseNote.html
> The release notes said:
> "New scripts have been added in the bin directory which follow Apache conventions. The
scripts in the frameworks directory are deprecated and may be removed in future releases."
> DERBY-1709 added a warning message in the scripts in the frameworks/ directory, as well
as a textual file (frameworks.DEPRECATED.txt) in the root of the installation tree warning
that the frameworks/ directory has been deprecated and that scripts in the bin/ directory
should be used instead. This was committed after the release, to both the trunk and
the 10.2 branch (before the 10.3 branch was created).
> The presence of both a frameworks/ directory and a bin/ directory is annoying to some
users, and confusing to others. There is obviously a balance to keep between pleasing such
users and other users who want backwards compatibility.
> Perhaps the next feature release (10.4?) is the right time to remove the frameworks/
directory once and for all, since deprecation warnings have been issued for the past two feature
releases (10.2 and 10.3, though stronger in 10.3 than 10.2), giving users time to adjust.
> Marking "Release Note Needed" since it is important to make such changes visible to users.
> This change may affect existing applications that are still using the deprecated scripts
in the frameworks/ directory.

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

View raw message