Ticket #246 (closed defect: fixed)

Opened 3 years ago

Last modified 3 years ago

Javadoc warnings for roles

Reported by: mosconi Owned by: stephan
Priority: minor Milestone: OTDT_1.3.0_M4
Component: compiler Version: 1.2.8
Keywords: Cc:

Description

I encountered the following issues with Javadoc checking for missing comments enabled (for public elements only):

For a public role class with playedBy and missing Javadoc comment, 4 identical Warnings are generated: 3 for the role class and 1 for the base class. With a comment added, 3 of the Warnings remain (2 for role, 1 for base).

In case of a protected role class (which should give no Warning at all), there is 1 Warning for the role class. With comment added, the Warning remains.

Change History

Changed 3 years ago by stephan

  • milestone set to OTDT_1.3.0

I guess spurious warnings come from the generated role interface.

Shouldn't be too hard to fix.

Changed 3 years ago by stephan

  • status changed from new to closed
  • resolution set to fixed
  • milestone changed from OTDT_1.3.0 to OTDT_1.3.0_M4

My guess was right, but not complete. These generated elements are public and must be excluded from error reporting:

  • role interface part
  • cache field (reported against the playedBy position ;-)
  • lifting constructors (role class position)

Test and fix are in r21654.

Note: See TracTickets for help on using tickets.