Bug 493788 - Comparator for ISV doc
Summary: Comparator for ISV doc
Status: NEW
Alias: None
Product: Platform
Classification: Eclipse Project
Component: Releng (show other bugs)
Version: 4.6   Edit
Hardware: All All
: P3 enhancement (vote)
Target Milestone: ---   Edit
Assignee: Platform-Releng-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2016-05-17 06:31 EDT by Dani Megert CLA
Modified: 2016-05-17 11:28 EDT (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Dani Megert CLA 2016-05-17 06:31:11 EDT
4.6 RC1.

Currently we have to remind ourselves to touch the ISV doc, so that the latest Javadoc and extension point doc gets generated.

Similar to the class file comparator we should have a comparator for ISV doc.

The comparator could first check, whether there was a change in the repo and if not, compare the built doc bundle with the previous one. This comparison will have to ignore some differences, like the date in the generated Javadoc files.
Comment 1 David Williams CLA 2016-05-17 11:28:39 EDT
If it helps, in the short run, remember the warnings about doc bundles are split out into their own file. Under "release engineering logs", near the bottom there is a link to "buildtimeComparatorDocBundle.log.txt". For example, 

http://download.eclipse.org/eclipse/downloads/drops4/I20160516-2000/buildlogs/comparatorlogs/buildtimeComparatorDocBundle.log.txt

And, while the Tycho comparator began with the one in JDT (which is one that p2 uses) Tycho's version is a little different now. (such as, I doubt they allow for "extensions" as the platform's/p2 one did). 

And if someone is going to invest in improving the comparator, I'd suggest the issue with "TSA" signatures be fixed too. 

(I don't mean to be sounding negative, just reminding that the comparator is actually in Tycho).