bug #6241
openfix java doc problems in projects
40%
Description
javadoc problems exist in the following projects and should be fixed (see also #6240 this is not a duplicate!). The reference on all existing javadoc tags: http://docs.oracle.com/javase/1.5.0/docs/tooldocs/windows/javadoc.html#javadoctags
IMPORTANT
In order to properly test for existing problems you may need to diable the fix applied in cdmlib|99f6d80
Projects with problems:
List of problems:
@date tag is not officially supported--> remove or replace?- broken @link references (151x in cdmlib) these should be fixed. Do not delete them!
Related issues
Updated by Andreas Kohlbecker over 7 years ago
- Related to bug #6240: maven javadoc plugin fails with java 1.8 added
Updated by Andreas Müller over 7 years ago
A solution might be to replace all "* @date " by "* @since "
Updated by Andreas Kohlbecker over 7 years ago
Andreas Müller wrote:
A solution might be to replace all "* @date " by "* @since "
The doc says the since text is free, so we could use it for the creation date, but usually one would rather expect a version number for since.
Updated by Andreas Müller over 7 years ago
Andreas Kohlbecker wrote:
Andreas Müller wrote:
A solution might be to replace all "* @date " by "* @since "
The doc says the since text is free, so we could use it for the creation date, but usually one would rather expect a version number for since.
That is true. But maybe we should start handling it this way. Version numbers are more useful than dates. However, the question is how we get eclipse to know the current version number and how if we want to update the existing tags.
I think we can live with existing tags being changed to @since with the given date.
For new tags it would be nice to have version number instead of date if possible.
Updated by Andreas Müller about 7 years ago
- Assignee changed from Andreas Kohlbecker to Patrick Plitzner
- Priority changed from New to Highest
- Target version changed from Unassigned CDM tickets to Release 4.6
Updated by Patrick Plitzner about 7 years ago
- Related to deleted (bug #6240: maven javadoc plugin fails with java 1.8)
Updated by Patrick Plitzner about 7 years ago
- Is duplicate of bug #6240: maven javadoc plugin fails with java 1.8 added
Updated by Andreas Müller about 7 years ago
- Target version changed from Release 4.6 to Release 4.7
Updated by Andreas Kohlbecker about 7 years ago
- Is duplicate of deleted (bug #6240: maven javadoc plugin fails with java 1.8)
Updated by Andreas Kohlbecker about 7 years ago
- Related to bug #6240: maven javadoc plugin fails with java 1.8 added
Updated by Andreas Müller about 7 years ago
AK: Ich habe auch nachgezählt bei den '@link reference not found' Problemen handelt es sich um 151 stellen die sich aber auf relativ wenige HotSpots konzentrieren, vom Aufwand halte ich das für absolut vertretbar.
Updated by Andreas Müller almost 7 years ago
- Target version changed from Release 4.7 to Release 4.8
Updated by Andreas Müller over 6 years ago
- Target version changed from Release 4.8 to Release 4.9
Updated by Andreas Müller over 6 years ago
- Target version changed from Release 4.9 to Release 4.10
Updated by Patrick Plitzner over 6 years ago
- Related to deleted (bug #6240: maven javadoc plugin fails with java 1.8)
Updated by Patrick Plitzner over 6 years ago
- Copied from bug #6240: maven javadoc plugin fails with java 1.8 added
Updated by Andreas Müller over 6 years ago
- Target version changed from Release 4.10 to Release 4.11
Updated by Andreas Müller over 6 years ago
- Target version changed from Release 4.11 to Release 4.12
Updated by Andreas Müller over 6 years ago
- Target version changed from Release 4.12 to Release 4.13
Updated by Andreas Müller about 6 years ago
- Target version changed from Release 4.13 to Release 4.14
Updated by Andreas Müller about 6 years ago
- Target version changed from Release 4.14 to Release 5.0
Updated by Andreas Müller almost 6 years ago
- Description updated (diff)
- % Done changed from 0 to 30
replaced @date by @since
Updated by Patrick Plitzner almost 6 years ago
- Target version changed from Release 5.0 to Release 5.1
Updated by Patrick Plitzner almost 6 years ago
- Status changed from New to Feedback
- Assignee changed from Patrick Plitzner to Andreas Müller
We should discuss if it is really necessary to fix the broken links. I also took a quick look and it seems that in most cases there is one broken link in one class file. I think this is too much work for a non critical issue
Updated by Andreas Müller almost 6 years ago
- Assignee changed from Andreas Müller to Andreas Kohlbecker
Andreas K., do you have an opinion on this?
Updated by Andreas Kohlbecker almost 6 years ago
There are far less problems as you've assumed after having a quick look. mvn javadoc:javadoc
reports 294 broken @links for which reference classes or methods. This does not include test classes.
Maven provides a tool to interactively fix problems in javadoc tags (https://maven.apache.org/plugins/maven-javadoc-plugin/fix-mojo.html) which is supposed to also fix @link tags.
mvn javadoc:fix
I did a test run of this tool. I did not fix the broken @links but it does a lot of other useful things. I think we should run this on our projects with selected parameters.
Updated by Andreas Kohlbecker almost 6 years ago
- Assignee changed from Andreas Kohlbecker to Andreas Müller
Updated by Andreas Müller over 5 years ago
- Target version changed from Release 5.1 to Release 5.2
Updated by Andreas Müller over 5 years ago
- Target version changed from Release 5.2 to Release 5.3
Updated by Andreas Müller over 5 years ago
- Target version changed from Release 5.3 to Release 5.5
Updated by Andreas Müller about 5 years ago
- Target version changed from Release 5.5 to Release 5.7
Updated by Andreas Müller almost 5 years ago
- Target version changed from Release 5.7 to Release 5.10
Updated by Andreas Müller over 4 years ago
- Target version changed from Release 5.10 to Release 5.11
Updated by Andreas Müller over 4 years ago
- Target version changed from Release 5.11 to Release 5.13
Updated by Andreas Müller about 4 years ago
- Target version changed from Release 5.13 to Reviewed Next Major Release
Updated by Andreas Müller about 4 years ago
- Copied to bug #8864: fix java doc problems in projects in vaadin, cdmserver and dataportal added
Updated by Andreas Müller about 4 years ago
- Description updated (diff)
we split this ticket to split workload => #8864