Re: Renaming modules

Petr Kuzel <[email protected]> Mon, 17 Jan 2005 11:01:53 +0100
Newsgroups gmane.comp.java.netbeans.modules.tasklist.devel
Organization Sun Microsystems
Message-ID <[email protected]>
Tor Norbye wrote:
> Tim Lebedkov wrote:
> 
>> Hi group,
>>
>> I plan the following changes on the trunk...
>>
>> 1. rename the module org.netbeans.tasklistapi to 
>> org.netbeans.modules.tasklist.api

api token used to be reserved for official APIs. Since project
introduction it's allowed for under development APIs too. I would
prefer more perspective org.netbeans.api.suggestions here.

>> 2. rename tasklist-docscan.jar to 
>> org-netbeans-modules-tasklist-docscan.jar

OK

>> 3. rename the module org.netbeans.modules.tasklist.suggestions to 
>> org.netbeans.modules.tasklist.problems
>> 4. move the code from org.netbeans.modules.tasklist.suggestions.ui 
>> into the new directory tasklist/problems
>> 5. rename the module org.netbeans.modules.suggestions_framework to 
>> org.netbeans.modules.tasklist.suggestions
>> 6. rename suggestions-framework.jar to 
>> org-netbeans-modules-tasklist-suggestions.jar
> 
> 
> 
> I agree with the renames that result from projectizing the modules, but 
> can you explain your rationale for renaming the suggestions ui module to 
> "problems" and the suggestions framework to "suggestions" ?
> 
> I didn't do the split into two halves and haven't studied it, but I 
> assume what Peter did was to put the suggestions "manager" part (the 
> provider registration and notification) into a "framework" module and 
> all the ui (window, node creation etc.) into a suggestions ui module. In 
> that case, framework and ui seems like good names, whereas "suggestions" 
> and "problems" seem like two different concepts. In fact they're pretty 
> similar - suggestions are often provided fixes for problems. I don't 
> think it will be clear how these two modules differ and what the 
> relationships between them are.

Yes that the case. Moreover reusing suggestions.jar name for
suggestions UI eliminated compatability problems on upgrade. Any
jar rename could cause situation where  user's instalation contained
two module versions. I have not tested recently but reusing jar
name (with possibly empty content)) was necessary to avoid such
situations.

   Cc.

-- 
<address>
<a href="mailto:[email protected]">Petr Kuzel</a> at Sun Microsystems :
<a href="http://www.netbeans.org/">NetBeans Java IDE</a></address>