apache / apache/netbeans

Support formatting in `@value` tag

Open
#4,932 0 comments 0 reactions 0 assignees View on GitHub
Java JavaDoc kind:feature
Dominant language
Java
Stars
3.1k
Forks
935
Avg merge
2d 3h
Merged PRs (30d)
17

Description

### Description

Add support for the extended `@value` **Javadoc** tag available since **OpenJDK 20** ([JDK‑8286101]):
```javadoc
{@value optional‑format‑string optional‑reference}
```

[JDK‑8286101]: https://bugs.openjdk.org/browse/JDK-8286101
[JDK‑8286264]: https://bugs.openjdk.org/browse/JDK-8286264

### Use case/motivation

_No response_

### Related issues

- [JDK‑8286101]
- [JDK‑8286264] (**CSR**)

### Are you willing to submit a pull request?

No

### Code of Conduct

Yes

Contributor guide

Open the contributing guide

Research direction

Start by reading the extended @value syntax in JDK-8286101 and the CSR in JDK-8286264, then locate NetBeans' Javadoc handling for @value tags. Done means the OpenJDK 20 optional format string and reference form is supported.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
devtools
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.