Details
-
Improvement
-
Status: Resolved
-
Medium
-
Resolution: Done
-
None
Description
Modern default doclet generates this warning:
[WARNING] /home/nite/odl/mdsal/binding/mdsal-binding-test-model/target/generated-sources/BindingJavaFileGenerator/org/opendaylight/yang/gen/v1/bug8449/rev170516/ContInt32.java:44: warning: no comment [WARNING] public static final class RefUnionInt32 [WARNING] ^
This is because the union class does not have any javadoc at all. In this particular case the encapsulating type already javadoc:
/** * * <p> * This class represents the following YANG schema fragment defined in module <b>bug8449</b> * <pre> * container cont-int32 { * leaf ref-union-int32 { * type union { * type int32-ref; * } * } * } * </pre> * <p>To create instances of this class use {@link ContInt32Builder}. * @see ContInt32Builder * */
In this particular case we want to generate a similar comment and quote the 'leaf ref-union-int32' part of the YANG snippet.
Attachments
Issue Links
- split from
-
-
- Resolved
-