Bug 991510

Summary:	MeasurementAggregate in remote API but is missing JavaDoc for inclusion in API docs
Product:	[JBoss] JBoss Operations Network	Reporter:	Larry O'Leary <loleary>
Component:	CLI	Assignee:	Heiko W. Rupp <hrupp>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Garik Khachikyan <gkhachik>
Severity:	low	Docs Contact:	Jared MORGAN <jmorgan>
Priority:	unspecified
Version:	JON 3.1.2	CC:	gkhachik, jshaughn, mkoci, mmurray
Target Milestone:	ER05
Target Release:	JON 3.3.0
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2014-12-11 14:03:29 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	880359
Bug Blocks:

Description Larry O'Leary 2013-08-02 15:35:57 UTC

Description of problem:
org.rhq.core.domain.measurement.MeasurementAggregate is referenced and exposed in the remote API but contains no javadoc comments or annotations. The result is that it is missing from the API documentation.

Version-Release number of selected component (if applicable):
4.4.0.JON312GA

See https://git.fedorahosted.org/cgit/rhq/rhq.git/tree/modules/core/domain/src/main/java/org/rhq/core/domain/measurement/MeasurementAggregate.java

Comment 1 Jay Shaughnessy 2014-09-03 20:54:47 UTC

I agree it has minimal jdoc but it's very straightforward.  The lack of jdoc should not omit it from the Javadoc.  We need to generate the 3.3 javadoc and see if it shows up. Setting blocked by Bug 880359, which is about generating the Javadoc.

Comment 2 Simeon Pinder 2014-09-29 08:12:26 UTC

Moving into ER05 as didn't make the ER04 cut.

Comment 3 Heiko W. Rupp 2014-10-13 10:59:30 UTC

master ea7d2356 adds javadoc.

Comment 4 Heiko W. Rupp 2014-10-13 11:17:41 UTC

release branch cec5c09f511

Comment 8 Simeon Pinder 2014-10-21 20:23:59 UTC

Moving to ON_QA as available to test with the latest brew build:
https://brewweb.devel.redhat.com//buildinfo?buildID=394734

Comment 10 Garik Khachikyan 2014-10-29 15:46:44 UTC

# VERIFIED

doing: `javadoc -sourcepath `pwd` -d `pwd`/javadoc org.rhq.core.domain.measurement` in /home/hudson/current-jon/modules/org/rhq/server-startup/main/deployments/rhq.ear/rhq-core-domain-ejb3.jar makes the javadoc tree and it contains info about: MeasurementAggregate class.

version: JON 3.3 ER05