This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 74099 - Officialize Ant module API
Summary: Officialize Ant module API
Status: RESOLVED FIXED
Alias: None
Product: projects
Classification: Unclassified
Component: Ant (show other bugs)
Version: 5.x
Hardware: All All
: P2 blocker (vote)
Assignee: apireviews
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-03-28 15:25 UTC by Jesse Glick
Modified: 2006-10-23 16:39 UTC (History)
1 user (show)

See Also:
Issue Type: TASK
Exception Reporter:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Jesse Glick 2006-03-28 15:25:38 UTC 
It seems that the Ant module's API/SPI has been omitted from

http://www.netbeans.org/download/5_0/javadoc/

which is a serious omission since among other things this API is required in
order to write an Ant-based project type. nbbuild/build.properties lists it
under config.javadoc.devel but it should be under config.javadoc.stable I guess.

What do I need to change to have this API listed as stable? It has not been
changed incompatibly in a long time (last in 3.6), it should be fully documented
AFAIK, and there is a changelist.

ant/arch/arch-ant-main.xml uses "devel" as a category for exports currently,
probably because I don't understand the difference between "stable" and "official".
Comment 1 Jaroslav Tulach 2006-03-29 06:54:57 UTC 
Re: "What do I need to change to have this API listed as stable?"

Technically:
nbbuild/build.properties
ant/arch/arch-ant-main.xml

Organizationally:
Nothing right now. It is your commitment. In future, you guarantee to do 
compatible development, if needed invest in writing of bridges and properly 
end-of-lifeing the API.

Re. I don't understand the difference between "stable" and "official"

What package is your API in? org.netbeans.[as]pi or org.openide? I hope not, 
otherwise we violated some other guideline. So I guess you are going to be 
stable.
Comment 2 Jesse Glick 2006-03-29 15:56:22 UTC 
The public parts are in org.apache.tools.ant.module.[as]pi.**. So is that
"stable" then?
Comment 3 Jaroslav Tulach 2006-03-30 15:38:26 UTC 
It is not "official". So as soon as you decide it is more than "devel", it 
should become "stable".
Comment 4 Jaroslav Tulach 2006-04-03 07:26:32 UTC 
Btw. if you wish there is no problem in backporting this change to 5.0. It is 
only about commitment, which you seem to have. So if you want to have this API 
stable in 5.0, just change the arch.xml and build.properties and ask Ruda to 
republish javadoc, imho.
Comment 5 Jesse Glick 2006-04-03 17:34:59 UTC 
I do not especially want to bother with backporting to 5.0 (esp. since I do not
want to deal with the effect on 5.5) unless someone specifically requests it.
For 6.0 is OK, I think.
Comment 6 Jesse Glick 2006-04-04 01:28:33 UTC 
Checking in nbbuild/build.properties;
/shared/data/ccvs/repository/nbbuild/build.properties,v  <--  build.properties
new revision: 1.379; previous revision: 1.378
done
Checking in ant/arch/arch-ant-main.xml;
/shared/data/ccvs/repository/ant/arch/arch-ant-main.xml,v  <--  arch-ant-main.xml
new revision: 1.13; previous revision: 1.12
done