Address maven build failures from 'checkstyle' and 'javadoc' plug-ins about microprofile-open-api

[mrglavas]

Errors and warnings from the Javadoc plug-in (from 2017/11/02):

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.4:jar (attach-javadocs) on project microprofile-openapi-api: MavenReportException: Error while generating Javadoc:
[ERROR] Exit code: 1 - C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\Operation.java:113: warning: no @return
[ERROR] SecurityRequirement[] security() default {};
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\headers\Header.java:37: warning: no @return
[ERROR] String name() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\ArraySchema.java:42: warning: no @return
[ERROR] int maxItems() default Integer.MIN_VALUE;
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\ArraySchema.java:47: warning: no @return
[ERROR] int minItems() default Integer.MAX_VALUE;
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\ArraySchema.java:52: warning: no @return
[ERROR] boolean uniqueItems() default false;
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Encoding.java:68: error: reference not found
[ERROR] * @see RFC3986 for full definition of reserved characters
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Encoding.java:70: warning: no @return
[ERROR] boolean allowReserved() default false;
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Encoding.java:50: warning: no @return
[ERROR] String contentType() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Encoding.java:63: warning: no @return
[ERROR] boolean explode() default false;
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Encoding.java:75: warning: no @return
[ERROR] Header[] headers() default {};
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Encoding.java:43: warning: no @return
[ERROR] String name() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Encoding.java:55: warning: no @return
[ERROR] String style() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\parameters\RequestBody.java:43: warning: no @return
[ERROR] Content[] content() default {};
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\parameters\RequestBody.java:38: warning: no @return
[ERROR] String description() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\parameters\RequestBody.java:48: warning: no @return
[ERROR] boolean required() default false;
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\responses\ApiResponse.java:61: warning: no @return
[ERROR] Content[] content() default {};
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\responses\ApiResponse.java:40: warning: no @return
[ERROR] String description() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\responses\ApiResponse.java:50: warning: no @return
[ERROR] Header[] headers() default {};
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\responses\ApiResponse.java:55: warning: no @return
[ERROR] Link[] links() default {};
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\responses\ApiResponse.java:45: warning: no @return
[ERROR] String responseCode() default "default";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthFlow.java:35: warning: no @return
[ERROR] String authorizationUrl() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthFlow.java:45: warning: no @return
[ERROR] String refreshUrl() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthFlow.java:50: warning: no @return
[ERROR] OAuthScope[] scopes() default {};
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthFlow.java:40: warning: no @return
[ERROR] String tokenUrl() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthFlows.java:51: warning: no @return
[ERROR] OAuthFlow authorizationCode() default @OAuthFlow();
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthFlows.java:46: warning: no @return
[ERROR] OAuthFlow clientCredentials() default @OAuthFlow();
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthFlows.java:36: warning: no @return
[ERROR] OAuthFlow implicit() default @OAuthFlow();
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthFlows.java:41: warning: no @return
[ERROR] OAuthFlow password() default @OAuthFlow();
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthScope.java:41: warning: no @return
[ERROR] String description() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthScope.java:36: warning: no @return
[ERROR] String name() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityRequirement.java:37: warning: no @return
[ERROR] String name();
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityRequirement.java:43: warning: no @return
[ERROR] String[] scopes() default {};
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityScheme.java:41: warning: no @return
[ERROR] String type();
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityScheme.java:71: warning: no @return
[ERROR] String bearerFormat() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityScheme.java:46: warning: no @return
[ERROR] String description() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityScheme.java:77: warning: no @return
[ERROR] OAuthFlows flows() default @OAuthFlows;
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityScheme.java:58: warning: no @return
[ERROR] String in() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityScheme.java:52: warning: no @return
[ERROR] String name() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityScheme.java:84: warning: no @return
[ERROR] String openIdConnectUrl() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityScheme.java:64: warning: no @return
[ERROR] String scheme() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\servers\Server.java:45: warning: no @return
[ERROR] String description() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\servers\Server.java:39: warning: no @return
[ERROR] String url() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\servers\Server.java:50: warning: no @return
[ERROR] ServerVariable[] variables() default {};
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\servers\ServerVariable.java:46: warning: no @return
[ERROR] String defaultValue();
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\servers\ServerVariable.java:35: warning: no @return
[ERROR] String name();
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\servers\ServerVariable.java:52: warning: no @return
[ERROR] String description() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\servers\ServerVariable.java:41: warning: no @return
[ERROR] String[] enumeration() default "";
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\callbacks\Callback.java:52: warning: no @return
[ERROR] Callback addPathItem(String name, PathItem item);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Extensible.java:37: error: @param name not found
[ERROR] * @param String name
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Extensible.java:38: error: @param name not found
[ERROR] * @param Object value
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Extensible.java:39: error: invalid use of @return
[ERROR] * @return Components
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Extensible.java:41: warning: no @param for name
[ERROR] void addExtension(String name, Object value);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Extensible.java:41: warning: no @param for value
[ERROR] void addExtension(String name, Object value);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Extensible.java:46: error: @param name not found
[ERROR] * @param Map<String, Object>extensions
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Extensible.java:48: warning: no @param for extensions
[ERROR] void setExtensions(Map<String, Object> extensions);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:59: error: @param name not found
[ERROR] * @param String contentType
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:62: warning: no @param for contentType
[ERROR] Encoding contentType(String contentType);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:82: error: @param name not found
[ERROR] * @param String contentType
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:84: warning: no @param for contentType
[ERROR] void setContentType(String contentType);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:92: error: @param name not found
[ERROR] * @param Map<String, Header> headers
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:95: warning: no @param for headers
[ERROR] Encoding headers(Map<String, Header> headers);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:111: error: @param name not found
[ERROR] * @param Map<String, Header> headers
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:113: warning: no @param for headers
[ERROR] void setHeaders(Map<String, Header> headers);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:121: error: @param name not found
[ERROR] * @param String style
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:124: warning: no @param for style
[ERROR] Encoding style(String style);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:132: error: reference not found
[ERROR] * @see Parameter for more details on style property
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:141: error: @param name not found
[ERROR] * @param String style
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:143: warning: no @param for style
[ERROR] void setStyle(String style);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:154: error: @param name not found
[ERROR] * @param Boolean explode
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:157: warning: no @param for explode
[ERROR] Encoding explode(Boolean explode);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:179: error: @param name not found
[ERROR] * @param Boolean explode
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:181: warning: no @param for explode
[ERROR] void setExplode(Boolean explode);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:189: error: @param name not found
[ERROR] * @param Boolean allowReserved
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:191: error: reference not found
[ERROR] * @see RFC3986 for full definition of reserved characters
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:193: warning: no @param for allowReserved
[ERROR] Encoding allowReserved(Boolean allowReserved);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:201: error: reference not found
[ERROR] * @see RFC3986 for full definition of reserved characters
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:210: error: @param name not found
[ERROR] * @param Boolean allowReserved
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:211: error: reference not found
[ERROR] * @see RFC3986 for full definition of reserved characters
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:213: warning: no @param for allowReserved
[ERROR] void setAllowReserved(Boolean allowReserved);
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:39: error: unexpected text
[ERROR] * @see https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "58" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "45" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "45" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:41: warning - Tag @see:illegal character: "45" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:50: warning: no description for @param
[ERROR] * @param name
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:51: error: unexpected text
[ERROR] * @see https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:49: warning: empty

tag
[ERROR] *

[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "58" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "45" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "45" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:53: warning - Tag @see:illegal character: "45" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:62: warning: no description for @param
[ERROR] * @param name
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:64: error: unexpected text
[ERROR] * @see https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "58" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "45" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "45" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "47" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:66: warning - Tag @see:illegal character: "45" in "https://github.com/OAI/OpenAPI-Specification/blob/3.0.0-rc2/versions/3.0.md#xml-object"
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:85: warning: no description for @param
[ERROR] * @param namespace
[ERROR] ^
[ERROR] C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\security\OAuthFlow.java:90: error: @param name not found
[ERROR] * @param tokenkUrl
[ERROR] ^

[mrglavas]

Errors from the 'checkstyle' plug-in (2017/11/02):

[INFO] --- maven-checkstyle-plugin:2.17:check (verify-style) @ microprofile-openapi-api ---
[INFO] Starting audit...
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\ExternalDocumentation.java:34:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\headers\Header.java:68: error: Line is longer than 150 characters (found 174).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\links\Link.java:30: error: Line is longer than 150 characters (found 267).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\links\Link.java:46: error: Line is longer than 150 characters (found 314).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\links\Link.java:52: error: Line is longer than 150 characters (found 153).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Encoding.java:48:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\ExampleObject.java:47: error: Line is longer than 150 characters (found 273).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Schema.java:29: error: Line is longer than 150 characters (found 218).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Schema.java:39: error: Line is longer than 150 characters (found 204).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Schema.java:51: error: Line is longer than 150 characters (found 187).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Schema.java:57: error: Line is longer than 150 characters (found 163).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Schema.java:63: error: Line is longer than 150 characters (found 162).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Schema.java:159: error: Line is longer than 150 characters (found 378).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\media\Schema.java:189: error: Line is longer than 150 characters (found 175).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\parameters\Parameter.java:58: error: Line is longer than 150 characters (found 215).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\parameters\Parameter.java:70: error: Line is longer than 150 characters (found 200).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\parameters\Parameter.java:76: error: Line is longer than 150 characters (found 278).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\parameters\Parameter.java:82: error: Line is longer than 150 characters (found 366).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\parameters\Parameter.java:88: error: Line is longer than 150 characters (found 255).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\parameters\Parameter.java:119: error: Line is longer than 150 characters (found 241).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\parameters\Parameter.java:125: error: Line is longer than 150 characters (found 244).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\parameters\Parameters.java:35:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthFlow.java:38: error: Line is longer than 150 characters (found 159).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\OAuthScope.java:33:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityRequirement.java:34:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityScheme.java:29: error: Line is longer than 150 characters (found 227).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\security\SecurityScheme.java:38:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\annotations\servers\Server.java:35: error: Line is longer than 150 characters (found 170).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\callbacks\Callback.java:39:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Components.java:58:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\examples\Example.java:40:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Extensible.java:26:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\ExternalDocumentation.java:32:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\headers\Header.java:40:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\info\Contact.java:30:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\info\Info.java:31:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\info\License.java:30:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\links\Link.java:52:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\ArraySchema.java:25:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\BinarySchema.java:27:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\BooleanSchema.java:27:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\ByteArraySchema.java:27:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\ComposedSchema.java:29:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Content.java:32:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\DateSchema.java:28:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Discriminator.java:38:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\EmailSchema.java:26:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Encoding.java:33:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\FileSchema.java:25:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\IntegerSchema.java:27:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\MapSchema.java:25:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\MediaType.java:39:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\NumberSchema.java:28:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\ObjectSchema.java:25:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\PasswordSchema.java:27:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\Schema.java:52:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\StringSchema.java:27:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\UUIDSchema.java:28:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\media\XML.java:32:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\OpenAPI.java:41:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Operation.java:42:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\parameters\Parameter.java:61:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\parameters\RequestBody.java:32:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\PathItem.java:43:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\PathItem.java:121:18: error: Name 'GET' must match pattern '^?[a-z][a-zA-Z0-9]*$'.
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\PathItem.java:143:18: error: Name 'PUT' must match pattern '^?[a-z][a-zA-Z0-9]$'.
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\PathItem.java:165:18: error: Name 'POST' must match pattern '^_?[a-z][a-zA-Z0-9]$'.
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\PathItem.java:187:18: error: Name 'DELETE' must match pattern '^?[a-z][a-zA-Z0-9]*$'.
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\PathItem.java:209:18: error: Name 'OPTIONS' must match pattern '^?[a-z][a-zA-Z0-9]$'.
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\PathItem.java:231:18: error: Name 'HEAD' must match pattern '^_?[a-z][a-zA-Z0-9]$'.
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\PathItem.java:253:18: error: Name 'PATCH' must match pattern '^?[a-z][a-zA-Z0-9]*$'.
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\PathItem.java:275:18: error: Name 'TRACE' must match pattern '^?[a-z][a-zA-Z0-9]$'.
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Paths.java:38:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\Reference.java:24:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\responses\ApiResponse.java:37:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\responses\ApiResponses.java:32:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\responses\ApiResponses.java:52:37: error: Name '_default' must match pattern '^[a-z][a-zA-Z0-9]$'.
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\responses\ApiResponses.java:62:43: error: Name '_default' must match pattern '^[a-z][a-zA-Z0-9]*$'.
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\security\OAuthFlow.java:30:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\security\OAuthFlows.java:30:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\security\Scopes.java:33:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\security\SecurityRequirement.java:32:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\security\SecurityScheme.java:31:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\servers\Server.java:30:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\servers\ServerVariable.java:32:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\servers\ServerVariables.java:32:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\models\tags\Tag.java:35:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\OASFactory.java:22:1: error: Utility classes should not have a public or default constructor.
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\OASFactory.java:23:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\spi\OASFactoryResolver.java:27:1: error: File contains tab characters (this is the first instance).
C:\mp\microprofile-open-api\api\src\main\java\org\eclipse\microprofile\openapi\spi\OASFactoryResolver.java:74:33: error: '}' at column 5 should be alone on a line.
Audit done.

[a-saf]

Looking into the errors and warnings from JavaDoc plug-in, as those are related to models and annotations I worked on.

[a-saf]

Javadoc issues fixed, PR created

[mrglavas]

Running 'mvn install' from arthurdm/master now completes cleanly, so I can confirm that all of these issues have been resolved. Thanks @a-saf and @arturdzm for fixing these problems.