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 34471

Summary:	Use javadoctools to generate API
Product:	utilities	Reporter:	Jaroslav Tulach <jtulach>
Component:	Diff	Assignee:	Martin Entlicher <mentlicher>
Status:	VERIFIED FIXED
Severity:	blocker	Keywords:	API
Priority:	P4
Version:	3.x
Hardware:	All
OS:	All
Issue Type:	DEFECT	Exception Reporter:
Bug Depends on:	34382
Bug Blocks:

Description Jaroslav Tulach 2003-06-19 08:51:29 UTC

The current page with list of all API at
http://www.netbeans.org/download/dev/javadoc/
is ugly and shall be replaced by something nicer.
When issue 34382 is implemented only modules using
nbbuild/javadoctools/template.xml and providing
their arch.xml answers will be included in the
list. Please rewrite your module to use that
infrastructure to generate the javadoc. See 
http://openide.netbeans.org/tutorial/api.html
for more info.

Comment 1 Jaroslav Tulach 2003-06-19 09:02:22 UTC

I have made this issue depend on issue 34382, but only to track the
dependencies. You can switch to javadoctools at any time, just you should know
that when issue 34382 is implemented, your API will not be visible without using
javadoctools.

Comment 2 Martin Entlicher 2003-07-01 14:34:00 UTC

Starting to work on this...

Comment 3 Martin Entlicher 2003-07-01 18:02:51 UTC

Fixed in the main trunk and prj40_prototype branch:

Checking in build.xml;
/cvs/diff/build.xml,v  <--  build.xml
new revision: 1.24; previous revision: 1.23

Checking in build.xml;
/cvs/diff/build.xml,v  <--  build.xml
new revision: 1.18.2.6; previous revision: 1.18.2.5

Comment 4 Jaroslav Tulach 2003-07-03 09:23:22 UTC

It seems from the page
http://www.netbeans.org/download/dev/javadoc/
that there is still no description for diff module. Did you provide
api answers document with <api> tags?

Comment 5 Martin Entlicher 2003-07-08 13:15:59 UTC

The arch document updated to version 1.15 and referenced in the main
build script:

/cvs/diff/arch/arch-diff.xml,v  <--  arch-diff.xml
new revision: 1.3; previous revision: 1.2
/cvs/diff/arch/arch-diff.xml,v  <--  arch-diff.xml
new revision: 1.4; previous revision: 1.3
Checking in build.xml;
/cvs/diff/build.xml,v  <--  build.xml
new revision: 1.25; previous revision: 1.24

Comment 6 Jaroslav Tulach 2003-07-09 09:05:52 UTC

The summary page still does not list the API.

Comment 7 Martin Entlicher 2003-07-25 15:46:29 UTC

After the page was re-generated, this is fixed.

Comment 8 Jaroslav Tulach 2003-07-28 08:27:15 UTC

Excelent I see it there. I would also suggest to use at least one <api
type="export" name="Diff API" /> tag to export at least one Java API.
Maybe enhancement?

Comment 9 Martin Entlicher 2003-07-29 12:35:00 UTC

O.K. <api name="Diff API" type="export" category="official" ...> added
to the arch.
Will resolve as fixed after it appears on the web.

Checking in arch-diff.xml;
/cvs/diff/arch/arch-diff.xml,v  <--  arch-diff.xml
new revision: 1.5; previous revision: 1.4
done

Comment 10 Martin Entlicher 2003-08-06 09:58:55 UTC

Seems to be fixed on the web => resolving as "fixed".

Comment 11 Jaroslav Tulach 2003-08-06 16:41:22 UTC

It is there.