[BUG][okhttp-gson] can not generate javadoc

Created by: jmini

Description

Introduced with issue #2994 (closed) / PR #2995 the generated javadoc now contains @http.response.details. Example from our the samples:

https://github.com/OpenAPITools/openapi-generator/blob/51e7005373fdb55daa1c253f36fb6267a64a7bf7/samples/client/petstore/java/okhttp-gson/src/main/java/org/openapitools/client/api/StoreApi.java#L63-L68

When trying to generate the javadoc artifact for the project, you get tons of errors:

cd samples/client/petstore/java/okhttp-gson
mvn javadoc:javadoc

INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  4.419 s
[INFO] Finished at: 2019-07-08T10:44:48+02:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.4:javadoc (default-cli) on project petstore-okhttp-gson: An error has occurred in JavaDocs report generation: 
[ERROR] Exit code: 1 - /____/openapi-generator/samples/client/petstore/java/okhttp-gson/src/main/java/org/openapitools/client/api/AnotherFakeApi.java:63: error: unknown tag: http.response.details
[ERROR]      * @http.response.details
[ERROR]        ^
[ERROR] /____/openapi-generator/samples/client/petstore/java/okhttp-gson/src/main/java/org/openapitools/client/api/AnotherFakeApi.java:117: error: unknown tag: http.response.details
[ERROR]      * @http.response.details
[ERROR]        ^
[ERROR] /____/openapi-generator/samples/client/petstore/java/okhttp-gson/src/main/java/org/openapitools/client/api/AnotherFakeApi.java:134: error: unknown tag: http.response.details
[ERROR]      * @http.response.details
[ERROR]        ^

openapi-generator version

4.0.2

Suggest a fix

We can keep the table, but remove the @http.response.details and just put "Response details:"

@saigiridhar21, @wing328 what do you think?