zserio icon indicating copy to clipboard operation
zserio copied to clipboard

Consider to propagate deprecated tag into generated code

Open mikir opened this issue 2 years ago • 0 comments

Deprecated tag in classic documentation comment is currently not propagated into generated code. Example:

/**
 * This is some structure.
 *
 * @deprecated
 */
struct DirectionStructure
{
};

Generated Java code (with comments):

/**
 * This is some structure.
 * <p>
 * <b>Deprecated</b>
 */
public class DirectionStructure implements zserio.runtime.io.InitializeOffsetsWriter, zserio.runtime.SizeOf
{
}

Javadoc annotation @deprecated is not used because Java will fire warning that Java annotation @Deprecated should be used as well.

The similar problem is in C++ for clang.

Python Sphinx deprecated tag is not used because it requires version.

mikir avatar Oct 07 '22 10:10 mikir