Ticket #1793 (closed defect: fixed)
Opened 2013-04-10T10:30:45-05:00
Last modified 2013-06-13T13:03:44-05:00
Make sure that our main projects have Javadocs built by Jenkins jobs
| Reported by: | dscho | Owned by: | dscho |
|---|---|---|---|
| Priority: | major | Milestone: | imagej2-b8-analysis |
| Component: | Server Admin | Version: | |
| Severity: | serious | Keywords: | |
| Cc: | curtis | Blocked By: | |
| Blocking: | #1919 |
Description
So far, we build Javadocs for ImageJ 1.x, ImageJ2, ImgLib2 and Fiji. But most notably, scijava-common does not have any public javadocs.
Change History
comment:1 Changed 2013-04-10T10:31:34-05:00 by dscho
comment:2 Changed 2013-04-11T07:07:18-05:00 by curtis
Ideally, we would build the Javadocs for all projects that Jenkins handles. However, in general, building Javadocs is very slow, which is why there are separate ImageJ-daily and ImgLib-daily jobs. Maybe instead of calling them "*-daily" we could call them "*-docs" instead? Or I guess we could just combine them and always generate the docs with every commit. Originally that seemed like overkill though, resulting in much longer job times for little additional benefit.
comment:3 Changed 2013-04-11T09:59:29-05:00 by dscho
Yep, I agree, in general, javadocs are very slow. For example, for the Fiji sources it takes almost half an hour...
For scijava-common, it is fast, so I did not bother with an extra job.
It appears to me to be more important to identify the projects that need javadoc'ing, maybe SCIFIO?
comment:4 Changed 2013-04-11T10:49:47-05:00 by curtis
It appears to me to be more important to identify the projects that need javadoc'ing, maybe SCIFIO?
As I said, I think all projects that our Jenkins handles should be javadoc'ed. So yes, that would include SCIFIO.
comment:5 Changed 2013-04-13T14:37:08-05:00 by dscho
Indeed, I had to split off SciJava-common-javadoc because it took too long.
comment:6 Changed 2013-06-07T15:01:32-05:00 by bdezonia
- Blocking 1919 added; 1608 removed
- Milestone changed from imagej2-b7-ndim-data to imagej2-b8-analysis
comment:7 Changed 2013-06-13T13:03:44-05:00 by dscho
- Status changed from new to closed
- Resolution set to fixed
I also added a job for SCIFIO. It is time to close this ticket now because it is too open-ended.
scijava-common is fixed since build 118 of http://jenkins.imagej.net/job/SciJava-common/. What other projects do we need to think of? TrakEM2, mpicbg?