[GR-47942] [GR-48011] Required Updates for the 23.1.0 version.

PullRequest: graal/15277

Author: olyagpl

docs/enterprise-overview/support.md

@@ -7,14 +7,14 @@ permalink: /support/
 
 ## Available Distributions
 
-Oracle GraalVM distributions are based on Oracle JDK 17 and Oracle JDK 20.
-Oracle GraalVM releases include all Oracle Java critical patch updates (CPUs), which are released on a regular schedule to remedy defects and known vulnerabilities.
+Oracle GraalVM for JDK 21 is based on Oracle JDK 21. 
+Each release of Oracle GraalVM for JDK 21 includes all Oracle Java critical patch updates (CPUs), which are provided on a regular schedule to remedy defects and known vulnerabilities.
 
-Oracle GraalVM is available for Linux, macOS, and Windows platforms on x64 systems, for Linux and macOS on AArch64 architecture.
+Oracle GraalVM for JDK 21 is available for Linux, macOS, and Windows on the x64 architecture, and for Linux and macOS on the AArch64 architecture.
 
 ## Certified Platforms
 
-The following platforms are certified for Oracle GraalVM:
+Oracle GraalVM for JDK 21 is certified on the following platforms:
 
 | Operating System 	| Version 	| Architecture 	| Installation Guide 	|
 |------------------------------------	|--------------	|--------------	|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------	|
@@ -23,41 +23,32 @@ The following platforms are certified for Oracle GraalVM:
 | macOS 	| 11 (Big Sur), 12.4 (Monterey), 13.3 (Ventura)	| x64, AArch64	| [Installation Guide for macOS](../getting-started/graalvm-enterprise/macos.md) 	|
 | Microsoft Windows 	| Server 2016, 2019, 2022	| x64 	| [Installation Guide for Windows](../getting-started/graalvm-enterprise/windows.md) 	|
 
-## Features Support
+## Experimental Components
 
-Oracle GraalVM features are distributed as _fully supported_ or _experimental_.
+Oracle GraalVM for JDK 21 includes some components that are considered experimental. 
+These components are not meant for use in production and are not supported by Oracle. 
+Some components are considered experimental on specific platforms. 
+The GraalVM team welcomes feedback on these components, but users should be aware that the components may not be included in a future release or may change significantly before being considered production-ready:
+* Java on Truffle (Espresso) is _supported_ on Linux x64 only and is experimental on other certified platforms. 
+* The GraalVM Python runtime (GraalPy) is _experimental_ on all certified platforms.
 
-_Experimental_ features are being considered for future versions of Oracle GraalVM.
-They are not meant for use in production and are **not** supported by Oracle.
-The development team welcomes feedback on experimental features, but users should be aware that experimental features may not be included in a final version, or may change significantly before being considered production-ready.
+## Deprecated Components
 
-For more information, check the [GraalVM Free Terms and Conditions including License for Early Adopter Versions](https://www.oracle.com/downloads/licenses/graal-free-license.html).
+The following components are deprecated and will be removed in Oracle GraalVM for JDK 23:
+* LLVM Runtime
+* LLVM Toolchain
+* Node.js
 
+## Related Technologies
 
-The following table lists supported and experimental features in Oracle GraalVM by platform.
-
-| Feature         | Linux x64     | Linux AArch64 | macOS x64     | macOS AArch64 | Windows x64   |
-|-----------------|---------------|---------------|---------------|---------------|---------------|
-| Native Image    | supported     | supported     | supported     | supported     | supported     |
-| LLVM runtime    | deprecated<sup>(1)</sup> | deprecated<sup>(1)</sup> | deprecated<sup>(1)</sup> | deprecated <sup>(1)</sup>| deprecated <sup>(1)</sup> |
-| LLVM toolchain  | supported     | supported     | supported     | supported     | experimental  |
-| JavaScript      | supported     | supported     | supported     | supported     | supported     |
-| Node.js         | deprecated<sup>(1)</sup> | deprecated<sup>(1)</sup> | deprecated<sup>(1)</sup> | deprecated <sup>(1)</sup>| deprecated <sup>(1)</sup> |
-| Java on Truffle | supported     | experimental  | experimental  | experimental  | experimental  |
-| Python          | experimental  | experimental  | experimental  | experimental  | not available |
-| Ruby            | experimental  | experimental  | experimental  | experimental  | not available |
-| WebAssembly     | experimental  | experimental  | experimental  | experimental  | experimental  |
-
-**(1)** This functionality has been deprecated and will be removed in Oracle GraalVM for JDK 23.
+Additional open source language runtimes designed for use with Oracle GraalVM for JDK 21 are available on [graalvm.org](https://www.graalvm.org/reference-manual/languages/).
 
 ## Licensing and Support
 
-Oracle GraalVM is licensed under [GraalVM Free Terms and Conditions (GFTC) including License for Early Adopter Versions](https://www.oracle.com/downloads/licenses/graal-free-license.html).
-Subject to the conditions in the license, including the License for Early Adopter Versions, the GFTC is intended to permit use by any user including commercial and production use. Redistribution is permitted as long as it is not for a fee.
-Oracle GraalVM is also free to use on Oracle Cloud Infrastructure.
-For more information about Oracle GraalVM licensing, see the [Oracle Java SE Licensing FAQ](https://www.oracle.com/java/technologies/javase/jdk-faqs.html#GraalVM-licensing).
-
-Oracle GraalVM is available as part of the [Oracle Java SE Subscription](https://www.oracle.com/java/java-se-subscription/) which includes 24x7x365 [Oracle premier support](https://www.oracle.com/support/premier/) and access to [My Oracle Support (MOS)](https://www.oracle.com/support/).
+Oracle GraalVM is licensed under [GraalVM Free Terms and Conditions (GFTC) including License for Early Adopter Versions](https://www.oracle.com/downloads/licenses/graal-free-license.html). 
+Subject to the conditions in the license, including the License for Early Adopter Versions, the GFTC is intended to permit use by any user including commercial and production use. 
+Redistribution is permitted as long as it is not for a fee. 
+Oracle GraalVM is also free to use on Oracle Cloud Infrastructure. 
+For more information about Oracle GraalVM licensing, see the [Oracle Java SE Licensing FAQ](https://www.oracle.com/java/technologies/javase/jdk-faqs.html#GraalVM-licensing).
 
-Oracle GraalVM focuses on support for Java LTS releases for production deployments.
-See the [release calendar](../../release-notes/enterprise/oracle-graalvm-release-calendar.md) for more information.
+Oracle GraalVM is available as part of the [Oracle Java SE Subscription](https://www.oracle.com/java/java-se-subscription/) which includes 24x7x365 [Oracle premier support](https://www.oracle.com/support/premier/) and access to [My Oracle Support (MOS)](https://www.oracle.com/support/).

docs/getting-started/graalvm-community/get-started-graalvm-community.md

@@ -24,7 +24,7 @@ Choose your operating system and proceed to the installation steps for your spec
 
 ## Start Running Applications
 
-The core distribution of GraalVM includes the Java Development Kit (JDK), the just-in-time compiler (the Graal compiler), Native Image, and others.
+GraalVM includes the Java Development Kit (JDK), the just-in-time compiler (the Graal compiler), Native Image, and standard JDK tools.
 You can use the GraalVM JDK just like any other JDK in your IDE, so having installed GraalVM, you can run any Java application unmodified.
 
 The `java` launcher runs the JVM with Graal as the last-tier compiler.
@@ -72,7 +72,7 @@ Larger Java examples can be found in the [GraalVM Demos repository on GitHub](ht
 
 ### Advanced Users
 
-Developers who are more experienced with GraalVM or want to do more with GraalVM can proceed directly to [Reference Manuals](../../reference-manual/reference-manuals.md) for in-depth documentation. 
+Developers who are more experienced with GraalVM or want to do more with GraalVM can proceed directly to [Reference Manuals](../../reference-manual/reference-manuals.md) for in-depth documentation.
 
 You can find information on GraalVM's security model in the [Security Guide](../../security/security-guide.md), and rich API documentation in the [GraalVM SDK Javadoc](https://www.graalvm.org/sdk/javadoc/) and [Truffle Javadoc](https://www.graalvm.org/truffle/javadoc/).
 

docs/getting-started/graalvm-community/linux.md

@@ -13,7 +13,7 @@ You can install GraalVM on Linux from an archive (_.tar.gz_) for the current use
 
 Follow these steps to install GraalVM: 
 
-1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **17** or **20** for the Java version, **Linux** for the operating system, **x64** or **aarch64** for the architecture, and download.
+1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **21** for the Java version, **Linux** for the operating system, **x64** or **aarch64** for the architecture, and download.
 
 2. Change to directory where you want to install GraalVM, then move the _.tar.gz_ file to that directory.
 
@@ -22,14 +22,14 @@ Follow these steps to install GraalVM:
     tar -xzf graalvm-jdk-<version>_linux-<architecture>.tar.gz
     ```
 4. There can be multiple JDKs installed on the machine. The next step is to configure the runtime environment:
-  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
-    ```shell
-    export PATH=/path/to/<graalvm>/bin:$PATH
-    ```
   - Set the value of the `JAVA_HOME` environment variable to the installation directory:
     ```shell
     export JAVA_HOME=/path/to/<graalvm>
     ```
+  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
+    ```shell
+    export PATH=/path/to/<graalvm>/bin:$PATH
+    ```  
 5. To confirm that the installation was successful, run the `java -version` command.
 
 Optionally, you can specify GraalVM as the default JRE or JDK installation in your Java IDE.

docs/getting-started/graalvm-community/macos.md

@@ -13,7 +13,7 @@ Note that on macOS the JDK installation path is: _/Library/Java/JavaVirtualMachi
 
 Follow these steps to install GraalVM: 
 
-1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **17** or **20** for the Java version, **macOS** for the operating system, **x64** or **aarch64** for the architecture, and download.
+1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **21** for the Java version, **macOS** for the operating system, **x64** or **aarch64** for the architecture, and download.
 
 2. Unzip the archive.
     ```shell
@@ -32,14 +32,14 @@ Follow these steps to install GraalVM:
     To verify if the move is successful and to get a list of all installed JDKs, run `/usr/libexec/java_home -V`.
 
 4. There can be multiple JDKs installed on the machine. The next step is to configure the runtime environment:
-  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
-    ```shell
-    export PATH=/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home/bin:$PATH
-    ```
   - Set the `JAVA_HOME` environment variable to resolve to the GraalVM installation directory:
     ```shell
     export JAVA_HOME=/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home
     ```
+  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
+    ```shell
+    export PATH=/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home/bin:$PATH
+    ```  
 
 5. To check whether the installation was successful, run the `java -version` command.
 
@@ -48,7 +48,7 @@ Optionally, you can specify GraalVM as the default JRE or JDK installation in yo
 ## Installation Notes
 
 ### On JAVA_HOME Command
-The information property file, _Info.plist_, is in the top level _Contents_ folder.
-This means that GraalVM participates in the macOS-specific `/usr/libexec/java_home` mechanism. Depending on other JDK installation(s) available, it is now possible that `/usr/libexec/java_home -v17` returns `/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home`.
-You can run `/usr/libexec/java_home -v17 -V` to see the complete list of JDK 17 JVMs available to the `java_home` command. This command sorts the JVMs in decreasing version order and chooses the top one as the default for the specified version.
+The information property file, _Info.plist_, is in the top level _Contents_ directory.
+This means that GraalVM participates in the macOS-specific `/usr/libexec/java_home` mechanism. Depending on other JDK installation(s) available, it is now possible that `/usr/libexec/java_home -v21` returns `/Library/Java/JavaVirtualMachines/<graalvm>/Contents/Home`.
+You can run `/usr/libexec/java_home -v21 -V` to see the complete list of JVMs available to the `java_home` command. This command sorts the JVMs in decreasing version order and chooses the top one as the default for the specified version.
 Within a specific version, the sort order appears to be stable but is unspecified.

docs/getting-started/graalvm-community/windows.md

@@ -12,21 +12,21 @@ You can install it on Windows from an archive file (_zip_).
 
 Follow these steps to install GraalVM:
 
-1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **17** or **20** for the Java version, **Windows** for the operating system, and download.
+1. Navigate to the [GraalVM Downloads page](https://www.graalvm.org/downloads/). Select **21** for the Java version, **Windows** for the operating system, and download.
 
 2. Change to the directory where you want to install GraalVM, then move the _.zip_ archive file to it.
 
 3. Unzip the archive to your file system.
 
 4. There can be multiple JDKs installed on the machine. The next step is to configure the runtime environment. Setting environment variables via the command line will work the same way for Windows 8, 10, and 11.
-  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
-    ```shell
-    setx /M PATH "C:\Progra~1\Java\<graalvm>\bin;%PATH%"
-    ```
   - Set the `JAVA_HOME` environment variable to resolve to the GraalVM installation directory:
     ```shell
     setx /M JAVA_HOME "C:\Progra~1\Java\<graalvm>"
     ```
+  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
+    ```shell
+    setx /M PATH "C:\Progra~1\Java\<graalvm>\bin;%PATH%"
+    ```
   Note that the `/M` flag, equivalent to `-m`, requires elevated user privileges.
 
 5. Restart Command Prompt to reload the environment variables. Then use the following command to check whether the variables were set correctly:

docs/getting-started/graalvm-enterprise/get-started-graalvm-enterprise.md

@@ -33,7 +33,7 @@ Choose your operating system and proceed to the installation steps for your spec
 
 ## Start Running Applications
 
-The core distribution of Oracle GraalVM includes the Java Development Kit (JDK), the just-in-time compiler (the Graal compiler), Native Image, and others.
+Oracle GraalVM includes the Java Development Kit (JDK), the just-in-time compiler (the Graal compiler), Native Image, and other regular Java tools.
 You can use the GraalVM JDK just like any other JDK in your IDE, so having installed Oracle GraalVM, you can run any Java application unmodified.
 
 The `java` launcher runs the JVM with Graal as the last-tier compiler.
@@ -88,6 +88,6 @@ This page focuses on using Oracle GraalVM with an Oracle Cloud Infrastructure Co
 
 Developers who are more experienced with GraalVM or want to do more with GraalVM can proceed directly to [Reference Manuals](../../reference-manual/reference-manuals.md) for in-depth documentation. 
 
-You can find information on GraalVM's security model in the [Security Guide](../../security/security-guide.md), and rich API documentation in the [Oracle GraalVM Java API Reference](https://docs.oracle.com/en/graalvm/jdk/17/sdk/).
+You can find information on GraalVM's security model in the [Security Guide](../../security/security-guide.md), and rich API documentation in the [Oracle GraalVM Java API Reference](https://docs.oracle.com/en/graalvm/jdk/21/sdk/index.html).
 
 We also recommend checking the [GraalVM Team Blog](https://medium.com/graalvm).

docs/getting-started/graalvm-enterprise/linux.md

@@ -14,7 +14,7 @@ This distribution can be installed on Oracle Linux and Red Hat Enterprise Linux
 Follow these steps to install Oracle GraalVM:
 
 1. Navigate to [Oracle Java Downloads](https://www.oracle.com/java/technologies/downloads/). 
-Select the preferred Oracle GraalVM version, **17** or **20** for the Java version, **Linux** for the operating system, and the architecture. Start downloading.
+Select the preferred Oracle GraalVM version, **21** for the Java version, **Linux** for the operating system, and the architecture. Start downloading.
 
 2. Change directory to the location where you want to install Oracle GraalVM, then move the _.tar.gz_ file to that directory.
 
@@ -23,14 +23,14 @@ Select the preferred Oracle GraalVM version, **17** or **20** for the Java versi
     tar -xzf graalvm-jdk-<version>_linux-<architecture>.tar.gz
     ```
 4. There can be multiple JDKs installed on your machine. The next step is to configure your runtime environment:
-  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
-    ```shell
-    export PATH=/path/to/<graalvm>/bin:$PATH
-    ```
   - Set the `JAVA_HOME` environment variable to resolve to the installation directory:
     ```shell
     export JAVA_HOME=/path/to/<graalvm>
     ```
+  - Set the value of the `PATH` environment variable to the GraalVM _bin_ directory:
+    ```shell
+    export PATH=/path/to/<graalvm>/bin:$PATH
+    ```
 5. To check whether the installation was successful, run the `java -version` command.
 
 Optionally, you can use Oracle GraalVM as the default JRE or JDK installation in your Java IDE.