rmuir opened a new issue, #14878:
URL: https://github.com/apache/lucene/issues/14878

   ### Description
   
   Recently the build logic has moved to java, which is a great improvement 
over the groovy from the accessibility perspective, tooling starts to work as 
you expect.
   
   The underlying apis to gradle are not so friendly and don't "fully work" in 
eclipse-based editor (eclipse or vscode/vim/etc using eclipse JDT language 
server), because the generated gradle-api.jar has no source attachment.
   Currently the classpath entry looks like this:
   
   ```xml
   <classpathentry 
    kind="lib" 
    
path="/home/rmuir/.gradle/caches/8.14/generated-gradle-jars/gradle-api-8.14.jar"
   />
   ```
   
   Simplest improvement we can do, is to attach javadocs. This isn't as good as 
attaching sources: e.g. parameter hints and other fancy features won't work. 
But it allows for hover documentation, completion, signature help, to work as 
expected, without downloading or manipulating additional data. We just attach 
the URL of javadocs to the entry:
   
   ```xml
   <classpathentry
   kind="lib"
   
path="/home/rmuir/.gradle/caches/8.14/generated-gradle-jars/gradle-api-8.14.jar">
     <attributes>
       <attribute 
        name="javadoc_location"
        value="https://docs.gradle.org/8.14.2/javadoc"/>
     </attributes>
   </classpathentry>
   ```
   
   Eclipse will fetch and cache the information on demand: it makes things 
easier to work with.
   
   If we want to get fancier, we have to do more complicated stuff (e.g. switch 
from `-bin` to `-all` in gradle-wrapper.properties. Because the sources are 
split into 20 subfolders (not by package), we'd have to combine them into one 
folder or jar, that can be set as the `sourcepath=`, either packing them or 
making symlinks or whatever.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org
For additional commands, e-mail: issues-h...@lucene.apache.org

Reply via email to