db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Andrew McIntyre (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-1709) Deprecate scripts in frameworks directory
Date Fri, 08 Dec 2006 05:08:21 GMT
    [ http://issues.apache.org/jira/browse/DERBY-1709?page=comments#action_12456696 ] 
            
Andrew McIntyre commented on DERBY-1709:
----------------------------------------

So, I think the two main things remaining for this issue are marking the frameworks scripts
in the tree as deprecated somehow and cleaning up references to the old scripts.

As far marking it deprecated, I thought that it might be best to have a DEPRECATED file at
the top of the tree which could then be used for other purposes as well. The thing is, I'm
not really sure what those other purposes would be.  Deprecation in public interfaces to the
engine, server, client, and tools would be in the javadoc. Would we ever need to deprecate
a demo? :-)

So, the second option I thought of was to have a file, frameworks.DEPRECATED(.txt), that describes
the scripts as deprecated and explains the usage of the new scripts that corresponds to each
old script. Less intrusive than having a big, glaring DEPRECATED file at the top of the tree
that really only applies to a small part of the distribution that isn't core functionality.

So, I'm currently leaning toward the second option, and will put that together tonight (or
in the next few days, anyway) if I don't hear any objections. Opinions on this part?

The 10.2.1.6 release page and release notes indicate that the frameworks are deprecated and
may be removed in a future release. So that is taken care of.

That leaves the docs. Found the following remaining references to the frameworks scripts in
the docs:

adminguide/tadminapps811302.dita
adminguide/tadminappschangingyourclasspath.dita
adminguide/tadmincbdjhhfd.dita
adminguide/tadminconfigshuttingdownthenetworkserver.dita
adminguide/tadminconfigsysteminformation.dita
devguide/cdevstart16043.dita
devguide/cdevstart813142.dita
tools/ttoolsij11815.dita
tuning/ctundepth14326.dita

and one in the code tree:

java/demo/simple/example.html

I will also take care of these shortly as well.

> Deprecate scripts in frameworks directory
> -----------------------------------------
>
>                 Key: DERBY-1709
>                 URL: http://issues.apache.org/jira/browse/DERBY-1709
>             Project: Derby
>          Issue Type: Improvement
>          Components: Demos/Scripts
>    Affects Versions: 10.2.1.6
>            Reporter: Andrew McIntyre
>             Fix For: 10.2.3.0
>
>
> With revision 432159, new scripts to be added to the -bin distribution as a part of DERBY-1032
were added to the distributions and snapshots. The old frameworks scripts should be marked
as deprecated where appropriate in the documentation, readme files, and release pages.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Mime
View raw message