Closed d3xter666 closed 6 months ago
That's indeed a bug in the generator. In JSDoc comments, block tags (like @deprecated
, @param
etc.) should come after the description. Or, the description has to be prefixed with @desc
.
Fix by @d3xter666 was applied internally for 1.121 and is also being downported to 1.120.
Hello,
Currently
@deprecated
tag (if such) goes as the first occurence into the JSDoc block of the TS definitions. Please take a look at the currently generated definitions for UI5@1.120: https://www.unpkg.com/@sapui5/types@1.120.7/types/sap.ui.core.d.ts and search for@deprecated
tag.An example:
The issue is that this enforces the JSDoc parser to take not only the
@deprecated
line, but everything untill the next JSDoc tag (@link
s are not taken into account). In this case it's the whole descriptive JSDoc block.