Bug 148078 - @since 3.0/3.1 tags in Javadocs in DiagramDocumentEditor class
Summary: @since 3.0/3.1 tags in Javadocs in DiagramDocumentEditor class
Status: RESOLVED FIXED
Alias: None
Product: GMF-Runtime
Classification: Modeling
Component: General (show other bugs)
Version: 1.0   Edit
Hardware: PC Linux
: P3 normal
Target Milestone: 1.0.1   Edit
Assignee: Alex Boyko CLA
QA Contact:
URL:
Whiteboard:
Keywords: contributed
Depends on:
Blocks:
 
Reported: 2006-06-21 13:47 EDT by Christian Damus CLA
Modified: 2010-07-19 12:27 EDT (History)
0 users

See Also:

Attachments
No @since in GMF (38.35 KB, patch)
2006-07-28 15:50 EDT, Alex Boyko CLA 		no flags Details | Diff
WrpaLabel.java without @since (6.55 KB, patch)
2006-08-03 10:36 EDT, Alex Boyko CLA 		no flags Details | Diff
View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Christian Damus CLA 2006-06-21 13:47:17 EDT 
The org.eclipse.gmf.runtime.diagram.ui.resources.editor.parts.DiagramDocumentEditor class has Javadoc comments on a variety of methods that indicate

  @since 3.0
  @since 3.1

This is misleading, as there hasn't yet been a 1.0 release.
Comment 1 Frederic Plante CLA 2006-06-22 15:01:15 EDT 
Actually, we should revisit all API and add @since 1.0 tags
Comment 2 Christian Damus CLA 2006-06-22 15:21:47 EDT 
No, that isn't necessary.  @since is only needed to indicate in what version after the first release a particle of code was added.  Otherwise, every Javadoc comment will have an @since, and the noise will make it difficult to detect newer content.
Comment 3 Alex Boyko CLA 2006-07-28 15:50:17 EDT 
Created attachment 46979 [details]
No @since in GMF

Removed all "@since x.x" phrases in GMF project. (See the patch)
Comment 4 Anthony Hunter CLA 2006-08-02 13:04:51 EDT 
Committed the patch to R_1_0_maintenance.

You may send a delivery note.
Comment 5 Alex Boyko CLA 2006-08-03 10:36:48 EDT 
Created attachment 47323 [details]
WrpaLabel.java without @since

There is one file that in CVS that has @since - this is the patch to reupdate it
Comment 6 Eclipse Webmaster CLA 2010-07-19 12:27:07 EDT 
[GMF Restructure] Bug 319140 : product GMF and component
Runtime Diagram was the original product and component for this bug