Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.
Bug 328736 - Description for API Use Reports is empty
Summary: Description for API Use Reports is empty
Status: RESOLVED INVALID
Alias: None
Product: PDE
Classification: Eclipse Project
Component: API Tools (show other bugs)
Version: 3.7   Edit
Hardware: PC Windows XP
: P3 normal (vote)
Target Milestone: 3.7 M3   Edit
Assignee: Olivier Thomann CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-10-26 12:17 EDT by Darin Wright CLA
Modified: 2010-10-26 12:55 EDT (History)
2 users (show)

See Also:


Attachments
HTML page (3.98 KB, text/plain)
2010-10-26 12:17 EDT, Darin Wright CLA
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Darin Wright CLA 2010-10-26 12:17:01 EDT
I created API use reports (consumer and producer based) from an API use scan. In both cases the ant tasks provided a "description" attribute, but the description appeared empty in the HTML output.

Example target:

<target name="Consumer Report" description="Geneates consumer based report">
	<apitooling.apiconsumer_reportconversion
		xmlfiles="${xmlDir}"
		htmlfiles="${consumerDir}"
		description="This Is Just A Test"
	/>
</target>
Comment 1 Darin Wright CLA 2010-10-26 12:17:52 EDT
Created attachment 181743 [details]
HTML page
Comment 2 Olivier Thomann CLA 2010-10-26 12:31:26 EDT
I'll fix it.
Comment 3 Olivier Thomann CLA 2010-10-26 12:37:58 EDT
I think this is invalid.
The description passed to the apitooling.apiconsumer_reportconversion task is not the one that ends up being generated in the report.

In the report, the description should come from the xml report.
Did I miss something ?

The method setDescription(..) used in this case is:
org.apache.tools.ant.ProjectComponent.setDescription(String)
Comment 4 Darin Wright CLA 2010-10-26 12:38:39 EDT
Note: I added the description field to the report conversion targets cause the Ant Editor gave me code assist for it... perhaps this is an Ant Editor bug if the attribute is not supported on the report conversion tasks.
Comment 5 Olivier Thomann CLA 2010-10-26 12:43:44 EDT
I think you would need the setDescription(..) method to be used when the xml file was created, not when it is converted to html.
Comment 6 Curtis Windatt CLA 2010-10-26 12:45:32 EDT
The documentation for the tasks does not list description as a parameter for either the use task or the report conversion task.

The parameter probably should not be available on the report task, as Olivier pointed out the description should be coming from the xml.  However, I would have expected the description element in the xml to be taken from a parameter.
Comment 7 Olivier Thomann CLA 2010-10-26 12:48:00 EDT
If you want the description from the apitooling.apiconsumer_reportconversion
 ant task over the description inside the xml report, it must be clearly described.

This would be easy to fix. I just want to make sure this is exactly what you want.

What description should be dumped into the html report if the xml report has a description and the ant task has a description ?
Comment 8 Olivier Thomann CLA 2010-10-26 12:55:08 EDT
Closing as INVALID as the description for the ant task should not have any effect on the description dumped into the html report.
The description inside the html report must come from the description saved inside the xml report.