Remove useless and empty Javadoc

[jlupi]

Hi

The generated javadoc is useless if no description is provided in the json schema.
Additionally an empty javadoc appears on properties which doesnt make sense.

"via": {
   "type": "string"
},

/**
 * 
 */
private String via;

/**
 * 
 * @return
 *     The via
 */
public String getVia() {
     return via;
}

/**
 * 
 * @param via
 *     The via
 */
public void setVia(String via) {
    this.via = via;
}

For such cases the javadoc generation should be disabled.

Aditionally a toggle could be added for the javadoc generation.

[joelittlejohn]

Yes agreed. I feel like this is a problem that hasn't always existed.

Let's definitely sort this out for the next version. I'm not interested in adding a config property for this, the javadoc just shouldn't be added if there is no useful information.

[joelittlejohn]

It looks like the empty javadoc has been introduced for all fields by #645.

[joelittlejohn]

The @param and @return were added to avoid Javadoc warnings in Java 8 by 6e5ace7. I would prefer to remove these as this is useless noise in the source code.

[jlupi]

@joelittlejohn I fully agree. Thanks.

[annawinkler]

Without the javadoc being generated, there are warnings in Java 8 for missing @return and @param docs. What's the workaround for that?

[joelittlejohn]

@annawinkler Hopefully this link will help: http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html

[annawinkler]

That helped - thanks! Anna

…

On Fri, Mar 3, 2017 at 5:15 PM, Joe Littlejohn ***@***.***> wrote: @annawinkler <https://github.com/annawinkler> Hopefully this link will help: http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8- javadoc.html — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#659 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/ADXPezEfsi_9o3yip5uJpOA22Grj5kZdks5riK0NgaJpZM4LJL1C> .