[ 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
