rosjava / genjava

RosJava message definition and serialization artifact generators.
5 stars 32 forks source link

build.gradle to publish both sources and javadoc #16

Open gb96 opened 6 years ago

gb96 commented 6 years ago

Current gradle build only publishes compiled Java classes to maven repository.

It helps java developers if sources and javadoc are also published as most Java IDEs can leverage those to provide better assistance (particularly during run-time debugging, static code analysis, and also for developers learning new api).

I realise there is currently little or no javadoc tags in the generated java sources, however in future it might be possible for genjava to include some additional information via those tags.

googlebot commented 6 years ago

Thanks for your pull request. It looks like this may be your first contribution to a Google open source project (if not, look below for help). Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

:memo: Please visit https://cla.developers.google.com/ to sign.

Once you've signed (or fixed any issues), please reply here (e.g. I signed it!) and we'll verify it.


What to do if you already signed the CLA

Individual signers
Corporate signers
jubeira commented 6 years ago

Hi @gb96, thanks for the PR.

Please correct me if I'm mistaken, but genjava is mainly used to generate the artifacts for messages and services. Is that the documentation you would like to have in the JAR files?

That being said, I think it could be a good improvement; we should cherrypick the changes to Kinetic as well. @drigz any thoughts?

drigz commented 6 years ago

No comments from my side - I haven't been using the Gradle build much.