Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 264262

Summary: Moving command framework to web services project
Product: [WebTools] WTP Webservices Reporter: Kathy Chan <kathy>
Component: wst.wsAssignee: Keith Chong <keith.chong.ca>
Status: CLOSED FIXED QA Contact: Kathy Chan <kathy>
Severity: enhancement    
Priority: P3 CC: david_williams, d_a_carver, keith.chong.ca, konstantin, webmaster
Version: 3.1Keywords: plan
Target Milestone: 3.1 M6   
Hardware: PC   
OS: Windows XP   
Whiteboard: Other
Bug Depends on:    
Bug Blocks: 266893    
Attachments:
Description Flags
Patch to remove plugins from Common features
none
Web Services Feature changes
none
Map Files patch (HEAD)
none
Web Services Feature changes none

Description Kathy Chan CLA 2009-02-09 17:17:58 EST
I'm proposing to move the command framework plugins from the webtools.common project to the webtools.webservices project.  These plugins are:

- org.eclipse.wst.command.env 
- org.eclipse.wst.command.env.core 
- org.eclipse.wst.command.env.ui 

These plugins contain the command framework used by the Web services tools currently but could potentially be used by other components.  That's why they reside in the webtools.common project.  These plugins was contributed by developers who currently also work on the Web services project and are actively maintained by them.  Since these plugins are currently only used by the Web services plugins (and I'm not aware of any team planning to use that framework), I propose to move these plugins to webtools.webservices project.  Note that the org.eclipse.wst.common.environment plugin which contains the environment frameswork will remain in webtools.common since the J2EE team is actively using it.
Comment 1 Konstantin Komissarchik CLA 2009-02-09 20:06:24 EST
+1
Comment 2 David Williams CLA 2009-02-09 20:36:06 EST
I'm in favor of this move. 

Just to document it explicitly, this would not involve changing package names, to avoid breaking adopters (and our own webservices code), and in addition leaving the names the same maintains the history in cvs. 

It's my opinion this would not have to go forward for "move review" with Eclipse Foundation, since there's no real change of scope or mission of either Project ... it's more of a correction of decisions made long ago ... but I'll sanity check with some in Eclipse Foundation. (If it is recommended to have a move review, it'd be a pretty simple one). 

Accordingly, I think the mechanical items that have to occur (assuming there's no objections) are 

1. get the webmasters to do a "move" of the cvs directories. 

2. change some feature definitions to include these in webservice features -- at least, do that in HEAD ... I think it's debatable if we should change maintenance stream features ... technically we should not, but doubt it would impact anyone.  

3. update the map files to point to the new cvs locations (and, move them into webservices maps). NOTE: these map locations have to be changed in current and past maps. I suggest we do the HEAD and 3.0.x maintenance ones ... but leave other steams as is, until we need some new build from some old stream. 

I suggest we aim to do this after "3.0.4" is released (2/25) but before M6 (3/20) ... so, pretty small window. 

Comment 3 Kathy Chan CLA 2009-02-10 11:11:15 EST
I would suggest putting these plugins in their own feature so that whoever needs this do not necessarily need to pull in other Web services plugins.  I suggest org.eclipse.wst.command_core.feature and org.eclipse.wst.command_ui.feature.  We should limit the change in HEAD.
Comment 4 Konstantin Komissarchik CLA 2009-02-10 12:09:54 EST
I think that in general, we are trying to move away from core/ui split at feature level. Unlike the split at the plugin level, such a split hasn't proven to be valuable either to end users or downstream adopters. I would suggest a single feature for all of the command framework plugins.

Also, I would highly recommend that the feature id include "webservices" in it. 
Comment 5 David Williams CLA 2009-02-11 23:16:09 EST
I also see 
org.eclipse.wst.command.env.doc.user
org.eclipse.wst.command.env.infopop
that on the surface would appear related to these being moved ... 
so should they be moved too? Or are the names deceptive? 

I looked for JUnit test bundles that might be for these "command.env" bundles and did not see any, but will you please confirm? 
Comment 6 David Williams CLA 2009-02-11 23:17:19 EST
And, to be explicit, I have confirmed with EMO that no move review is required for this case. 

Comment 7 Kathy Chan CLA 2009-02-11 23:37:00 EST
Yes.  These plugins should be moved as well: 

org.eclipse.wst.command.env.doc.user
org.eclipse.wst.command.env.infopop

There are no JUnit plugin.

We are currently checking with users of these plugins in adoptor product to see what would be the best feature structure for these plugins.
Comment 8 David Williams CLA 2009-02-12 23:25:07 EST
Webmasters, can we get your help moving this CVS code? 

To be exact, we need to move 

common/plugins/org.eclipse.wst.command.env
common/plugins/org.eclipse.wst.command.env.core
common/plugins/org.eclipse.wst.command.env.ui
common/docs/org.eclipse.wst.command.env.doc.user
common/docs/org.eclipse.wst.command.env.infopop

to, respectively, 

webservices/plugins/org.eclipse.wst.command.env
webservices/plugins/org.eclipse.wst.command.env.core
webservices/plugins/org.eclipse.wst.command.env.ui
webservices/docs/org.eclipse.wst.command.env.doc.user
webservices/docs/org.eclipse.wst.command.env.infopop

We want to do it in a way that maintains the cvs history, of course. 

If I recall, last time we did something similar, we just had to do something like 
rsync --recursive $FROMDIR $TODIR
but you'd know best
(and, delete the old directory, once confirmed all verifies). 

and, if I recall you subsequently had to fix permissions so they had the correct group associated with it. In this case, that new group id would be 
webtools.webservices-dev
(you can use my id for user owner, if it matters ... or, anyone in the webtools.weservices-dev group (probably shouldn't leave 'root' as the owner I'd guess?) 


Now ... for schedule ... Monday March 2 would probably be the ideal day if you can reserve a few hours then. But, a few days plus or minus would work fine too. 

Sound doable? Any suggestions to improve the process outlined above? 
Would you prefer me to do the "copy" as long as you were available to change the group ID? (That's the way we did it last time, but then there were scores to move, and I think you didn't trust yourselves to run my script :)  

Much thanks, 

Comment 9 Eclipse Webmaster CLA 2009-02-19 14:05:31 EST
Ok, I've set a reminder for 9am Monday March 2nd.  This seems like a fairly straight forward move.

-M.
Comment 10 Keith Chong CLA 2009-02-27 17:36:01 EST
The org.eclipse.wst.command.env.doc.user plugin is in the org.eclipse.wst.ws_userdoc.feature
Comment 11 Keith Chong CLA 2009-02-27 17:38:58 EST
Created attachment 127060 [details]
Patch to remove plugins from Common features

This patch affects the two Common features:

org.eclipse.wst.common_core.feature
org.eclipse.wst.common_ui.feature
Comment 12 Keith Chong CLA 2009-02-27 18:03:48 EST
Created attachment 127062 [details]
Web Services Feature changes

This patch affects org.eclipse.wst.ws_core.feature and org.eclipse.wst.ws_ui.feature.
Comment 13 Keith Chong CLA 2009-03-02 08:30:11 EST
Created attachment 127159 [details]
Map Files patch (HEAD)
Comment 14 Eclipse Webmaster CLA 2009-03-02 09:08:43 EST
I've copied the data and changed the group.  When everything checks out let me know and I'll remove the 'old' data.

-M.
Comment 15 Keith Chong CLA 2009-03-02 09:42:38 EST
Created attachment 127165 [details]
Web Services Feature changes

Reversion web service features to 3.1.0 to match release
Comment 16 Keith Chong CLA 2009-03-02 14:30:04 EST
Comment on attachment 127159 [details]
Map Files patch (HEAD)

Entries should be moved to the web services maps.  The changes have been checked in.
Comment 17 Keith Chong CLA 2009-03-04 15:46:07 EST
(In reply to comment #14)
> I've copied the data and changed the group.  When everything checks out let me
> know and I'll remove the 'old' data.
> -M.

Hi Matt, other Eclipse Web Masters,

Go ahead and remove the 'old' data.  Also, can you please update the MODULES file so that the top level plugins are correctly linked?  Should be like this:

org.eclipse.wst.command.env                             webservices/plugins/org.eclipse.wst.command.env

org.eclipse.wst.command.env.core                        webservices/plugins/org.eclipse.wst.command.env.core

org.eclipse.wst.command.env.doc.user                    webservices/docs/org.eclipse.wst.command.env.doc.user

org.eclipse.wst.command.env.infopop                     webservices/docs/org.eclipse.wst.command.env.infopop

org.eclipse.wst.command.env.ui                          webservices/plugins/org.eclipse.wst.command.env.ui

Comment 18 Eclipse Webmaster CLA 2009-03-04 16:03:37 EST
Done.

-M.
Comment 19 Keith Chong CLA 2009-03-05 09:37:14 EST
Resolving bug as fixed.
Comment 20 Keith Chong CLA 2009-03-16 14:41:26 EDT
Verified during 3.1 M6.  Closing bug.