aniani/vim
0
0
Fork 1
mirror of https://github.com/vim/vim.git synced 2025-11-13 22:54:27 -05:00
Code Activity

runtime(java): Recognise all available standard doclet tags

Browse Source 
* Complement the tag set with @spec, {@systemProperty},
  {@summary}, @provides, @uses, @hidden, and {@index}.
* Do not hoard all tags under a single highlighting group.
* Skip over nested balanced braces in inline tags.
* Observe that tag names are case sensitive: both {@docRoot}
  and {@inheritDoc} are valid, whereas {@inheritdoc} and
  {@docroot} are not.
* In the @see tag arguments, allow for:
  - module name prefixes (e.g. java.base/java.lang.String);
  - references to arbitrary URI fragments (e.g. ##foo);
  - matching any tag variation arguments on the next line.
* Test directives and tags for Java module declarations.
* Enforce the word end for "module-info" candidates.

References:
https://bugs.openjdk.org/browse/JDK-8226279 (@spec)
https://bugs.openjdk.org/browse/JDK-8214559 ({@systemProperty})
https://bugs.openjdk.org/browse/JDK-8173425 ({@summary})
https://bugs.openjdk.org/browse/JDK-8160196 (@provides & @uses)
https://bugs.openjdk.org/browse/JDK-8073100 (@hidden)
https://bugs.openjdk.org/browse/JDK-8044243 ({@index})
https://docs.oracle.com/en/java/javase/21/docs/specs/javadoc/doc-comment-spec.html
https://github.com/openjdk/jdk/blob/jdk-21-ga/src/jdk.compiler/share/classes/com/sun/source/doctree/DocTree.java

closes: #15652

Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
Aliaksei Budavei
2024-09-10 21:00:33 +02:00
committed by Christian Brabandt
parent 508403687d
commit a9ae38dc3f
15 changed files with 417 additions and 143 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
runtime/syntax/testdir/input/java_module_info.java Normal file
View File

@@ -0,0 +1,35 @@
// This module declaration belongs to the sample project published at
// https://github.com/zzzyxwvut/module-info.git .
import java.util.ServiceLoader;
/**
* Defines demo related support.
*
* Note that the {@code Testable} service is not exported.
*
* @uses org.demo.internal.Testable
* @provides org.demo.internal.Testable
* @see ServiceLoader
*/
module org.module.info.demo
{
requires static jdk.jfr;
requires java.base;
requires transitive java.logging;
requires transitive static org.module.info.tester;
exports org.demo;
exports org.demo.internal to
org.module.info.demo;
opens org.demo.internal to
org.module.info.demo;
opens org.demo.tests to
org.module.info.demo, org.module.info.tester;
uses org.demo.internal.Testable;
provides org.demo.internal.Testable with
org.demo.tests.ArithmeticOperationTests;
}