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 - Use javadoctools to generate API
Summary: Use javadoctools to generate API
Status: VERIFIED FIXED
Alias: None
Product: utilities
Classification: Unclassified
Component: Diff (show other bugs)
Version: 3.x
Hardware: All All
: P4 blocker (vote)
Assignee: Martin Entlicher
URL:
Keywords: API
Depends on: 34382
Blocks:
  Show dependency tree
 
Reported: 2003-06-19 08:51 UTC by Jaroslav Tulach
Modified: 2003-12-11 14:20 UTC (History)
0 users

See Also:
Issue Type: DEFECT
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 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.