Packaging sources for indexing

[stonier]

I'm not sure how this is possible yet, just know that android studio has an option for going to the internet to associate classes with sources for indexing.

Perhaps if we package our sources in some ways in or with the jars, you get that indexing for free.

[lukehutch]

Seconding this. You just need to put -sources.jar (as well as ideally -javadoc.jar) into the Maven repo. For comparison:

$ ls -l ~/.m2/repository/org/ros/rosjava_core/rosjava/0.3.6
total 344
-rw-rw-r-- 1 luke luke    186 Sep  8 01:52 _remote.repositories
-rw-rw-r-- 1 luke luke 324317 Sep  8 01:52 rosjava-0.3.6.jar
-rw-rw-r-- 1 luke luke    556 Sep  8 01:52 rosjava-0.3.6.jar.lastUpdated
-rw-rw-r-- 1 luke luke     40 Sep  8 01:52 rosjava-0.3.6.jar.sha1
-rw-rw-r-- 1 luke luke   2948 Sep  8 01:51 rosjava-0.3.6.pom
-rw-rw-r-- 1 luke luke   1061 Sep  8 01:51 rosjava-0.3.6.pom.lastUpdated
-rw-rw-r-- 1 luke luke     40 Sep  8 01:51 rosjava-0.3.6.pom.sha1

vs. something like

total 324
-rw-rw-r-- 1 luke luke 111521 Oct 23  2018 joda-convert-1.8.1.jar
-rw-rw-r-- 1 luke luke    471 Oct 23  2018 joda-convert-1.8.1.jar.lastUpdated
-rw-rw-r-- 1 luke luke     40 Oct 23  2018 joda-convert-1.8.1.jar.sha1
-rw-rw-r-- 1 luke luke 101952 Oct 23  2018 joda-convert-1.8.1-javadoc.jar
-rw-rw-r-- 1 luke luke    480 Oct 23  2018 joda-convert-1.8.1-javadoc.jar.lastUpdated
-rw-rw-r-- 1 luke luke     40 Oct 23  2018 joda-convert-1.8.1-javadoc.jar.sha1
-rw-rw-r-- 1 luke luke  22908 Oct 23  2018 joda-convert-1.8.1.pom
-rw-rw-r-- 1 luke luke    471 Oct 23  2018 joda-convert-1.8.1.pom.lastUpdated
-rw-rw-r-- 1 luke luke     40 Oct 23  2018 joda-convert-1.8.1.pom.sha1
-rw-rw-r-- 1 luke luke  45686 Oct 23  2018 joda-convert-1.8.1-sources.jar
-rw-rw-r-- 1 luke luke    480 Oct 23  2018 joda-convert-1.8.1-sources.jar.lastUpdated
-rw-rw-r-- 1 luke luke     40 Oct 23  2018 joda-convert-1.8.1-sources.jar.sha1
-rw-rw-r-- 1 luke luke    492 Oct 23  2018 m2e-lastUpdated.properties
-rw-rw-r-- 1 luke luke    284 Oct 23  2018 _remote.repositories