Bug 103959 - Proposal for an Incremental Javadoc Builder
Summary: Proposal for an Incremental Javadoc Builder
Status: NEW
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 3.1   Edit
Hardware: PC Windows 2000
: P3 enhancement (vote)
Target Milestone: ---   Edit
Assignee: JDT-Core-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-07-15 00:23 EDT by Will Hains CLA
Modified: 2005-07-15 00:23 EDT (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Will Hains CLA 2005-07-15 00:23:23 EDT
As a Java developer that has passed through several IDEs before reaching the 
promised land of Eclipse (;P), one of the most appealing features for me was 
the lightning-fast incremental compiler that makes automatic building possible.

I would like to see a similar incremental builder for Javadoc added to the 
platform, so consciencious developers that take the time to write good quality 
Javadoc comments in their code can see the fruits of their labour immediately.

The Javadoc View that is already part of the platform could be used to display 
the actual HTML built by the Javadoc builder, as well as to display the 
external Javadoc of libraries that have had their Javadoc location set in the 
project properties. The current contents of the Javadoc View are not bad, but 
not a very faithful representation of what you would see in the real Javadocs.

The builder in Eclipse now already includes functionality that covers most 
Javadoc errors/warnings - so either these could be extracted out into the new 
incremental Javadoc builder, or the incremental Javadoc building functionality 
could be added to the current incremental Java builder.