Skip to content

Commit b8ac9a2

Browse files
authored
docs: move the unreleased changes under 0.6.6 and bring the dated claims up to date (#129)
After the release: - docs/changes.md and its translation: Unreleased becomes 0.6.6 (2026-11-10). - Verified against Foojay on 2026-11-10: platform table, JavaFX table, mirror hosts, checksum table, Intel Mac Java 27, Windows ARM64 list, Temurin 21 newest (21.0.13+9), SDKMAN short names and 31 distributions are unchanged; dates move from 2026-11-03 to 2026-11-10. - Updated quotes that name the newest release of something: Temurin search now starts with 27.0.1, EA newest is 28-ea+23, GraalVM feature releases add 25.5.5.0.3 and graalce newest is 25.5.5.0.3-graalce.
1 parent 03d01ab commit b8ac9a2

22 files changed

Lines changed: 52 additions & 50 deletions

‎docs/changes.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
What changed in each release, as a user notices it. GitHub's release pages list the pull requests.
66

7-
## Unreleased
7+
## 0.6.6 (2026-11-10)
88

99
- `vfox link --detect java` adopts the JDKs that are already on the machine instead of downloading another copy: Gradle's, IntelliJ IDEA's, the system directories, SDKMAN, asdf, mise, jabba, Homebrew, Scoop, the CI runner tool cache and `JAVA_HOME`. It needs vfox 1.1.0 or later. See [link.md](link.md).
1010

‎docs/development.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@ The documentation marks what is newer than the last release with "Unreleased" ("
173173

174174
1. Move those entries in [changes.md](changes.md) under the new version, with the date of the release, and take the remarks out, in both languages: `grep -rn -i -e unreleased -e 未发布 docs README*`.
175175
2. Search for the number of the previous release: a few sentences compare against it without saying "Unreleased".
176-
3. Pages that quote Foojay give the day the data was taken. Bring up to date the quotes that name the newest release of something (`21.0.13+9-tem` on 2026-11-03), and check the tables against Foojay again, see [Refreshing the platform table](#refreshing-the-platform-table).
176+
3. Pages that quote Foojay give the day the data was taken. Bring up to date the quotes that name the newest release of something (`21.0.13+9-tem` on 2026-11-10), and check the tables against Foojay again, see [Refreshing the platform table](#refreshing-the-platform-table).
177177

178178
## Writing the docs
179179

‎docs/distributions.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
[中文](zh-CN/distributions.md) | [English](distributions.md)
44

5-
The plugin gets the releases and download links of these 31 distributions from [Foojay](foojay.md), all that Foojay lists on 2026-11-03. The short name or the long name goes wherever a distribution does: `21-tem`, `21-temurin`, `temurin-21`, `vfox search java tem`.
5+
The plugin gets the releases and download links of these 31 distributions from [Foojay](foojay.md), all that Foojay lists on 2026-11-10. The short name or the long name goes wherever a distribution does: `21-tem`, `21-temurin`, `temurin-21`, `vfox search java tem`.
66

77
| Short name | Long name | Distribution | Maintained by |
88
| --- | --- | --- | --- |
@@ -44,7 +44,7 @@ Which operating systems and CPUs each distribution covers is in [platforms.md](p
4444

4545
## Short names and SDKMAN
4646

47-
The short names follow the identifiers of [SDKMAN](https://sdkman.io/), where Temurin 21.0.8 is `21.0.8-tem` too. These are the differences, against SDKMAN's list of 2026-11-03:
47+
The short names follow the identifiers of [SDKMAN](https://sdkman.io/), where Temurin 21.0.8 is `21.0.8-tem` too. These are the differences, against SDKMAN's list of 2026-11-10:
4848

4949
- JetBrains Runtime is `jb`, which SDKMAN calls `jbr`, and BiSheng is `bsg`, which SDKMAN calls `bisheng`, the plugin's long name for it. A `.sdkmanrc` takes SDKMAN's spellings, see [sdkmanrc.md](sdkmanrc.md).
5050
- SDKMAN no longer lists Dragonwell, TravaOpenJDK, AdoptOpenJDK, Gluon GraalVM or the GraalVM CE builds numbered after GraalVM. It called the last three `adpt`, `gln` and `grl`, and wrote the virtual machine or the JDK into the version: `11.0.10.hs-adpt` with HotSpot, `11.0.10.j9-adpt` with OpenJ9, `22.3.3.r17-grl` on JDK 17. Here each Foojay distribution has a name of its own, so that part moved into the name: `11.0.10-adpt`, `11.0.10-adptj9`, `22.3.3-grl17`. A `.sdkmanrc` with SDKMAN's spelling selects them.
@@ -154,11 +154,11 @@ GraalVM Community Edition up to 22.3, from before it numbered its releases after
154154

155155
### Behavior of Oracle GraalVM and GraalVM Community
156156

157-
- Since 25.1 (June 2026) GraalVM puts out a feature release every month next to its 25.0 line: `25.1.3`, `25.2.4`, `25.3.4.1`, `25.4.4.1.1`. Each is replaced within about a month. Foojay marks Oracle GraalVM's STS, but GraalVM Community's LTS where it lists them the old way round (see below), as the JDK they build on is LTS. `vfox search` leaves the LTS note off them all.
157+
- Since 25.1 (June 2026) GraalVM puts out a feature release every month next to its 25.0 line: `25.1.3`, `25.2.4`, `25.3.4.1`, `25.4.4.1.1`, `25.5.5.0.3`. Each is replaced within about a month. Foojay marks Oracle GraalVM's STS, but GraalVM Community's LTS where it lists them the old way round (see below), as the JDK they build on is LTS. `vfox search` leaves the LTS note off them all.
158158
- Releases are named after GraalVM's own version, which Foojay gives as `distribution_version`. Foojay's `java_version` is the JDK's version, which a feature release shares with the 25.0 line: `25.4.4.1.1-graal`, `25.3.4.1-graal`, `25.0.4.1.1-graal` and `25.0.4.1-graal` all have the `java_version` 25.0.4.1.
159159
- Foojay lists GraalVM Community's feature releases under GraalVM's version too, as it did before October 2026, with downloads from GitHub. So `java@25.4.4.1-graalce`, the name release 0.6.2 gives the 25.4.4.1.1 build, still installs it from GitHub, while `java@25.4.4.1.1-graalce` gets the same file from Oracle's GraalVM Download Service.
160-
- `java@25-graal` installs the newest build of the 25.0 line (`25.0.5.0.3-graal` on 2026-11-03), the line Oracle's own `25/latest` download follows. A feature release needs its full version: `java@25.4.4.1.1-graal`. `vfox use java@25-graal` and `java=25-graal` in a `.sdkmanrc` select the newest installed build of that line too, and a feature release only where nothing else of 25 is installed.
161-
- GraalVM Community's 25.0 line ended with `25.0.2`, and the feature releases are all it still ships. `java@25-graalce` installs the newest of them, `25.4.4.1.1-graalce` on 2026-11-03.
160+
- `java@25-graal` installs the newest build of the 25.0 line (`25.0.5.0.3-graal` on 2026-11-10), the line Oracle's own `25/latest` download follows. A feature release needs its full version: `java@25.5.5.0.3-graal`. `vfox use java@25-graal` and `java=25-graal` in a `.sdkmanrc` select the newest installed build of that line too, and a feature release only where nothing else of 25 is installed.
161+
- GraalVM Community's 25.0 line ended with `25.0.2`, and the feature releases are all it still ships. `java@25-graalce` installs the newest of them, `25.5.5.0.3-graalce` on 2026-11-10.
162162
- The plugin sets `JAVA_HOME` and `PATH`, and no `GRAALVM_HOME`. A `GRAALVM_HOME` that points at a GraalVM of your own stays as it is, and the native-image build plugins fall back to `JAVA_HOME` when it is unset.
163163
- There is no Windows ARM64 and no Alpine build, and Intel Macs get nothing after 25.0.1. See [platforms.md](platforms.md#graalvm).
164164

‎docs/e2e.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -286,7 +286,7 @@ JDK, so `java` can only come from what vfox installs:
286286
and no mirror that works is run.
287287
3. On the GraalVM Community rows, Oracle GraalVM's bare major `25-graal`
288288
installs the newest build of its 25.0 line (`25.0.5.0.3-graal` on
289-
2026-11-03), the line Oracle's own `25/latest` download follows, not one
289+
2026-11-10), the line Oracle's own `25/latest` download follows, not one
290290
of the monthly feature releases listed before it (`25.4.4.1.1-graal`).
291291
`vfox search java graal` must list those under GraalVM's own version,
292292
and mark the other releases of 25 alike, as in item 5. The plugin used to
@@ -360,7 +360,7 @@ JDK, so `java` can only come from what vfox installs:
360360

361361
The install itself must also have verified the download. Foojay lists a
362362
checksum for the pinned release of every default distribution on every
363-
runner (2026-11-03), and `vfox install` must print `Verifying checksum
363+
runner (2026-11-10), and `vfox install` must print `Verifying checksum
364364
<digest>...` with a digest of a length vfox supports, not `WARNING:
365365
Checksum is not provided, skip verify...`, which every install ended with
366366
until the plugin passed Foojay's checksums on. The digests come in four

‎docs/foojay.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ curl -s 'https://api.foojay.io/disco/v3.0/packages/jdks?version=27&latest=availa
4646
| jq -r '.result[].distribution' | sort -u
4747
```
4848

49-
On 2026-11-03 this printed `corretto liberica oracle semeru zulu`. Temurin and OpenJDK were not among them: they stopped at 26 there. Use `latest=available` for a bare major, as the plugin does, and leave it out for a longer version.
49+
On 2026-11-10 this printed `corretto liberica oracle semeru zulu`. Temurin and OpenJDK were not among them: they stopped at 26 there. Use `latest=available` for a bare major, as the plugin does, and leave it out for a longer version.
5050

5151
## The versions of one distribution
5252

@@ -153,7 +153,7 @@ So the plugin asks for every package of these two, as `vfox search` does, and pi
153153

154154
## Checksums
155155

156-
The record that `links.pkg_info_uri` points to also says how to check the download. `checksum_type` is the algorithm, and the digest is in the record as `checksum`, or in a file of the vendor that `checksum_uri` points to. GraalVM Community 25.0.2 has the file only (2026-11-03):
156+
The record that `links.pkg_info_uri` points to also says how to check the download. `checksum_type` is the algorithm, and the digest is in the record as `checksum`, or in a file of the vendor that `checksum_uri` points to. GraalVM Community 25.0.2 has the file only (2026-11-10):
157157

158158
```bash
159159
curl -s 'https://api.foojay.io/disco/v3.0/packages/jdks?distribution=graalvm_community&version=25.0.2&architecture=amd64&operating_system=linux&lib_c_type=glibc&archive_type=tar.gz&directly_downloadable=true' \
@@ -176,7 +176,7 @@ The digest in Foojay's record goes first. It comes from Foojay and not from the
176176

177177
A file that lists several packages gives the line of the one being installed. One that lists others only gives none: Microsoft's file for its EA build of 11.0.14 for macOS names the GA build, and that digest would fail an install that is fine.
178178

179-
Which packages come with a checksum varies by release, and Foojay holds none for some distributions. For the newest releases (2026-11-03):
179+
Which packages come with a checksum varies by release, and Foojay holds none for some distributions. For the newest releases (2026-11-10):
180180

181181
| Foojay lists | Short names |
182182
| --- | --- |

‎docs/install-from-source.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ vfox use --global java@21-tem
4040
java -version
4141
```
4242

43-
`vfox install java@21-tem` installs the newest Temurin 21, `21.0.13+9-tem` on 2026-11-03.
43+
`vfox install java@21-tem` installs the newest Temurin 21, `21.0.13+9-tem` on 2026-11-10.
4444

4545
## When java is already added
4646

‎docs/javafx.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ A build with JavaFX lists `javafx.base` and the others, one without lists none.
3333

3434
## Where JavaFX builds exist
3535

36-
As of 2026-11-03 four distributions have them, and not for every platform. The table lists the LTS releases that have a JavaFX build. The releases in between have some too, with gaps. For Liberica NIK it gives the Java version, not the GraalVM version in its names (see [distributions.md](distributions.md#behavior-of-mandrel-and-liberica-nik)): its JavaFX builds for Java 21 are `23.1.x-nik-fx`.
36+
As of 2026-11-10 four distributions have them, and not for every platform. The table lists the LTS releases that have a JavaFX build. The releases in between have some too, with gaps. For Liberica NIK it gives the Java version, not the GraalVM version in its names (see [distributions.md](distributions.md#behavior-of-mandrel-and-liberica-nik)): its JavaFX builds for Java 21 are `23.1.x-nik-fx`.
3737

3838
| Distribution | Linux x64 | Linux arm64 | Alpine x64 | macOS Intel | macOS Apple silicon | Windows x64 | Windows arm64 |
3939
| --- | --- | --- | --- | --- | --- | --- | --- |

‎docs/mirror.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Then install as usual, `vfox install java@21-tem`. To go back to github.com, uns
3939

4040
Only requests for `https://github.com/`: the downloads, and the checksum files on GitHub that the plugin reads for them (see [Notes](#notes)). A JDK on any other host downloads from there as before, and the requests to Foojay do not change.
4141

42-
Where Foojay links each distribution (2026-11-03):
42+
Where Foojay links each distribution (2026-11-10):
4343

4444
| Short names | Download from |
4545
| --- | --- |

‎docs/platforms.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ The plugin asks Foojay for packages of the platform it runs on: the operating sy
88
No JDK found for 21-bsg on darwin/arm64. Please check available versions with 'vfox search java'
99
```
1010

11-
The table shows which platforms each distribution has packages for, as Foojay lists them on 2026-11-03. ✅ means Foojay lists at least one package the plugin can install there, ❌ means none.
11+
The table shows which platforms each distribution has packages for, as Foojay lists them on 2026-11-10. ✅ means Foojay lists at least one package the plugin can install there, ❌ means none.
1212

1313
| Distribution | Linux x64 | Linux arm64 | Alpine x64 | Alpine arm64 | macOS Intel | macOS Apple silicon | Windows x64 | Windows arm64 |
1414
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
@@ -50,7 +50,7 @@ Foojay changes, and the table with it. To get the current one, ask Foojay the wa
5050

5151
## Only some releases
5252

53-
A ✅ does not mean every release is there. As of 2026-11-03:
53+
A ✅ does not mean every release is there. As of 2026-11-10:
5454

5555
- Windows on ARM64 has no Java 8 from anyone. Temurin has 21 and 23 there, Zulu 16 to 19, 21, 25 and 27, Liberica 11 and 16 to 27, Microsoft 11, 16, 17, 21 and 25, and JetBrains Runtime 17, 21 and 25.
5656
- On Apple silicon Java 8 comes from Zulu, Liberica, Corretto and Kona. Temurin and Semeru have 11 and 17 to 27 there, and OpenJDK 17 to 27. Mandrel has releases 23.1 to 25, for Java 21 to 25, and Liberica NIK 22.2 to 25, for Java 11, 17 and 20 to 25 (see [their numbers](distributions.md#behavior-of-mandrel-and-liberica-nik)). Gluon GraalVM has 22.1.0.1 and 23+25, GraalVM CE 11 and 17 have GraalVM 22.1 to 22.3.1, and GraalVM CE 19 has 22.3 and 22.3.1.

‎docs/sdkman.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,8 @@ The scopes of `vfox use` correspond to SDKMAN's: `--session`, the default, to `s
3939
## What differs
4040

4141
- **Identifiers.** SDKMAN's `21.0.8-tem` goes after `java@` as it is, and the short names are SDKMAN's, with a few exceptions such as `jb`, which SDKMAN calls `jbr`, see [distributions.md](distributions.md#short-names-and-sdkman). A release padded with a zero, as in SDKMAN's current identifiers (`25.0.5.0+8-tem`), is accepted. JavaFX is `-fx` at the end, `21.0.12-zulu-fx`. SDKMAN's `21.0.12.fx-zulu` is not a spec that `vfox install` takes, though a `.sdkmanrc` can hold it, see [sdkmanrc.md](sdkmanrc.md#sdkmans-spellings).
42-
- **A bare major.** `vfox install java@21-tem` installs the newest Temurin 21, `21.0.13+9-tem` on 2026-11-03. SDKMAN's `21-tem` is one release, the GA build `21+35`.
43-
- **No default JDK.** `sdk install java` installs SDKMAN's default, a Temurin LTS release (`25.0.5.0+8-tem` on 2026-11-03). `vfox install java` has none: in a terminal it asks you to pick a version, in a script it fails. A version without a distribution (`java@21`) is OpenJDK from jdk.java.net, which has nothing newer than 21.0.2 for 21. Write `java@21-tem`, see [versions.md](versions.md#without-a-distribution).
42+
- **A bare major.** `vfox install java@21-tem` installs the newest Temurin 21, `21.0.13+9-tem` on 2026-11-10. SDKMAN's `21-tem` is one release, the GA build `21+35`.
43+
- **No default JDK.** `sdk install java` installs SDKMAN's default, a Temurin LTS release (`25.0.5.0+8-tem` on 2026-11-10). `vfox install java` has none: in a terminal it asks you to pick a version, in a script it fails. A version without a distribution (`java@21`) is OpenJDK from jdk.java.net, which has nothing newer than 21.0.2 for 21. Write `java@21-tem`, see [versions.md](versions.md#without-a-distribution).
4444
- **Installing does not select.** After `sdk install`, SDKMAN asks whether the JDK becomes the default. `vfox install` only installs, and `vfox use` selects.
4545
- **Two lists.** `sdk list java` shows every vendor's JDKs. `vfox search java` lists OpenJDK only, so name a distribution (`vfox search java tem`) or write `all`. `vfox list java` shows what is installed. The versions come from [Foojay](foojay.md).
4646
- **Installed names carry the build number.** `vfox list java` shows `21.0.8+9-tem`, which `vfox uninstall` and `vfox info` need in full, while `vfox use java@21.0.8-tem` finds it without the build, see [versions.md](versions.md#installed-names).

0 commit comments

Comments
 (0)