JDK-8324783 : Fix javadoc issues reported by Eclipse
  • Type: Bug
  • Component: javafx
  • Sub-Component: other
  • Affected Version: jfx21
  • Priority: P4
  • Status: Open
  • Resolution: Unresolved
  • Submitted: 2024-01-26
  • Updated: 2024-02-28
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
tbdUnresolved
Related Reports
Relates :  
JDK-8314590 - ☂ Eliminate all javadoc warnings in JavaFX
Description
Enabled javadoc validation in Eclipse (see the screenshot), got 142 warnings:

Description	Resource	Location
Javadoc: Invalid reference	package-info.java	line 27
Javadoc: Invalid reference	package-info.java	line 27
Javadoc: Unexpected tag	Window.java	line 821
Javadoc: Missing #: "Platform.exit()}."	Util.java	line 381
Javadoc: Unexpected tag	TriangleMesh.java	line 854
Javadoc: Missing closing brace for inline tag	TreeView.java	line 146
Javadoc: Unexpected tag	TreeTableViewSkin.java	line 255
Javadoc: Missing closing brace for inline tag	TreeTableView.java	line 302
Javadoc: Description expected after @return	TraversalEngine.java	line 136
Javadoc: Unexpected tag	TestNodeBase.java	line 253
Javadoc: Invalid tag	TableViewTest.java	line 868
Javadoc: Invalid tag	TableViewTest.java	line 2055
Javadoc: Unexpected tag	TableViewSkin.java	line 204
Javadoc: Missing closing brace for inline tag	TableView.java	line 275
Javadoc: Description expected after @return	TableSkinShim.java	line 67
Javadoc: Description expected after @return	TableSkinShim.java	line 79
Javadoc: Description expected after @return	StyleManager.java	line 1933
Javadoc: Description expected after @return	StyleManager.java	line 1948
Javadoc: Description expected after @return	SkinStub.java	line 81
Javadoc: Unexpected tag	ShapeCacheTest.java	line 58
Javadoc: Unexpected tag	Shape.java	line 982
Javadoc: Missing #: "applies(Styleable)} method except it also returns"	Selector.java	line 110
Javadoc: Missing #: "managed()} method will only indicate the amount of the resource"	ResourcePool.java	line 37
Javadoc: Missing #: "max()}"	ResourcePool.java	line 34
Javadoc: Missing #: "max()} method, larger than the amount"	ResourcePool.java	line 131
Javadoc: Missing #: "max()} method, larger than the amount returned by the"	ResourcePool.java	line 110
Javadoc: Missing #: "max()} method."	ResourcePool.java	line 121
Javadoc: Missing #: "origTarget()} method, and may change over time."	ResourcePool.java	line 111
Javadoc: Missing #: "origTarget()} method."	ResourcePool.java	line 132
Javadoc: Missing #: "target()} method will return"	ResourcePool.java	line 38
Javadoc: Missing #: "used()}"	ResourcePool.java	line 92
Javadoc: Missing #: "used()} and {@link max()}"	ResourcePool.java	line 34
Javadoc: Unexpected tag	RepeatStructConverter.java	line 66
Javadoc: Missing #: "setCompositeRule(int), PiscesRenderer.setComposite(int, float)"	RendererBase.java	line 57
Javadoc: Missing #: "setCompositeRule(int), setComposite(int, float)"	RendererBase.java	line 44
Javadoc: Missing #: "setCompositeRule(int), setComposite(int, float)"	RendererBase.java	line 50
Javadoc: Missing #: "Effect.filter()} operation and it is queried for"	RenderState.java	line 34
Javadoc: Unexpected tag	Rectangle.java	line 661
Javadoc: Unexpected tag	Rectangle.java	line 639
Javadoc: Invalid param tag name	RadialGradientPaintContext.java	line 171
Javadoc: Invalid param tag name	RadialGradientContext.java	line 151
Javadoc: Description expected after @return	QuantumClipboard.java	line 148
Javadoc: Description expected after @return	QuantumClipboard.java	line 172
Javadoc: Unexpected tag	QuadCurve2D.java	line 138
Javadoc: Unexpected tag	QPathTest.java	line 62
Javadoc: Unexpected tag	PulseReceiver.java	line 42
Javadoc: Unexpected tag	PseudoClassImpl.java	line 39
Javadoc: Description expected after @return	PropertyReference.java	line 96
Javadoc: Description expected after @return	PluginListener.java	line 49
Javadoc: Unexpected tag	Platform.java	line 108
Javadoc: Missing #: "close()"	PickResultChooser.java	line 108
Javadoc: Description expected after @return	PickRay.java	line 240
Javadoc: Unexpected tag	Path2DGrowTest.java	line 34
Javadoc: Missing #: "Path2D(Shape, BaseTransform) Path2D}"	Path2D.java	line 1995
Javadoc: Missing closing brace for inline tag	Path2D.java	line 811
Javadoc: Missing closing brace for inline tag	Path2D.java	line 913
Javadoc: Unexpected tag	Path2D.java	line 1432
Javadoc: Unexpected tag	Path2D.java	line 1473
Javadoc: Unexpected tag	PNTMeshVertexBufferLengthTest.java	line 62
Javadoc: Unexpected text	Node.java	line 1175
Javadoc: Unexpected text	Node.java	line 1235
Javadoc: Unexpected text	Node.java	line 1275
Javadoc: Unexpected tag	MainThreadTest.java	line 37
Javadoc: Description expected after @return	Logging.java	line 44
Javadoc: Unexpected tag	LocalStorageAccessTest.java	line 40
Javadoc: Unexpected tag	ListViewSkin.java	line 450
Javadoc: Missing closing brace for inline tag	ListView.java	line 165
Javadoc: Invalid param tag name	LinearGradientContext.java	line 105
Javadoc: Unexpected tag	Line2D.java	line 133
Javadoc: Unexpected tag	Line2D.java	line 139
Javadoc: Unexpected tag	Line2D.java	line 145
Javadoc: Unexpected tag	Line2D.java	line 151
Javadoc: Unexpected tag	IosPlatformFactory.java	line 37
Javadoc: Unexpected tag	IosPlatformFactory.java	line 45
Javadoc: Unexpected tag	IosPlatformFactory.java	line 53
Javadoc: Unexpected tag	IosPlatformFactory.java	line 61
Javadoc: Unexpected tag	IosPlatformFactory.java	line 69
Javadoc: Unexpected tag	IosMenuDelegate.java	line 40
Javadoc: Unexpected tag	IosMenuDelegate.java	line 49
Javadoc: Unexpected tag	IosMenuDelegate.java	line 58
Javadoc: Unexpected tag	IosMenuDelegate.java	line 67
Javadoc: Unexpected tag	IosMenuDelegate.java	line 76
Javadoc: Unexpected tag	IosMenuDelegate.java	line 85
Javadoc: Unexpected tag	IosMenuDelegate.java	line 94
Javadoc: Unexpected tag	IosMenuDelegate.java	line 103
Javadoc: Unexpected tag	IosMenuDelegate.java	line 112
Javadoc: Unexpected tag	IosMenuDelegate.java	line 121
Javadoc: Unexpected tag	IosMenuDelegate.java	line 130
Javadoc: Unexpected tag	IosMenuDelegate.java	line 139
Javadoc: Unexpected tag	IosMenuBarDelegate.java	line 39
Javadoc: Unexpected tag	IosMenuBarDelegate.java	line 48
Javadoc: Unexpected tag	IosMenuBarDelegate.java	line 57
Javadoc: Unexpected tag	IosMenuBarDelegate.java	line 66
Javadoc: Unexpected tag	IosImageLoaderFactory.java	line 57
Javadoc: Unexpected tag	IosImageLoaderFactory.java	line 65
Javadoc: Unexpected tag	IosImageLoader.java	line 206
Javadoc: Unexpected tag	IosImageLoader.java	line 218
Javadoc: Unexpected tag	IosClipboardDelegate.java	line 33
Javadoc: Unexpected tag	IosApplication.java	line 51
Javadoc: Unexpected tag	IosApplication.java	line 61
Javadoc: Unexpected tag	IosApplication.java	line 75
Javadoc: Unexpected tag	IosApplication.java	line 83
Javadoc: Unexpected tag	IosApplication.java	line 91
Javadoc: Unexpected tag	IosApplication.java	line 99
Javadoc: Unexpected tag	IosApplication.java	line 116
Javadoc: Unexpected tag	IosApplication.java	line 129
Javadoc: Unexpected tag	IosApplication.java	line 147
Javadoc: Unexpected tag	IosApplication.java	line 161
Javadoc: Description expected after @return	InputMap.java	line 308
Javadoc: Description expected after @return	InputMap.java	line 678
Javadoc: Unexpected tag	HugePolygonClipTest.java	line 68
Javadoc: Malformed reference (missing end space separator)	GradientColorMap.java	line 33
Javadoc: Missing closing brace for inline tag	GlassRobot.java	line 168
Javadoc: Missing closing brace for inline tag	GlassRobot.java	line 168
Javadoc: Description expected after @return	GeneralTransform3D.java	line 136
Javadoc: Description expected after @return	FilterEffect.java	line 155
Javadoc: Unexpected tag	FXCanvas.java	line 275
Javadoc: Unexpected tag	FXCanvas.java	line 275
Javadoc: Description expected after @return	EmbeddedScene.java	line 225
Javadoc: Missing #: "getSourceRegion(Rectangle, Rectangle, Rectangle)} method."	EffectPeer.java	line 205
Javadoc: Missing #: "getTextureCoordinates(float[],float,float,float,float,Rectangle,BaseTransform)}."	EffectPeer.java	line 277
Javadoc: Description expected after @return	Direction.java	line 56
Javadoc: Description expected after @return	DefaultCancelButtonTestBase.java	line 93
Javadoc: Description expected after @return	DefaultCancelButtonTestBase.java	line 152
Javadoc: Unexpected tag	DashedRectTest.java	line 58
Javadoc: Description expected after @return	D3DContext.java	line 76
Javadoc: Unexpected tag	ClipShapeTest.java	line 91
Javadoc: Unexpected tag	BorderStyleConverter.java	line 159
Javadoc: Unexpected tag	BorderImageSliceConverter.java	line 76
Javadoc: Unexpected tag	BorderConverter.java	line 196
Javadoc: Invalid tag	BehaviorBase.java	line 163
Javadoc: Invalid tag	BehaviorBase.java	line 176
Javadoc: Invalid tag	BehaviorBase.java	line 190
Javadoc: Invalid tag	BehaviorBase.java	line 204
Javadoc: Invalid tag	BehaviorBase.java	line 218
Javadoc: Invalid tag	BehaviorBase.java	line 232
Javadoc: Missing #: "managed()} method and support for sharing"	BaseResourcePool.java	line 32
Javadoc: Unexpected tag	BackgroundSizeConverter.java	line 83
Javadoc: Unexpected tag	BackgroundPositionConverter.java	line 86
Javadoc: Description expected after @return	AudioClip.java	line 313
Javadoc: Unexpected tag	Arc2D.java	line 202
Javadoc: Invalid reference	AndroidFontFinder.java	line 52