### Install SLEEF from Source

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.incubator.vector/unix/native/libsleef/upstream/README.md

Install the SLEEF library and headers to a specified directory using CMake's install command.

```bash
cmake --install build --prefix=<prefix>
```

--------------------------------

### Example Options File for jmod

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.jlink/share/man/jmod.md

This example shows how to structure an options file for the jmod command, allowing for multiple options to be specified on different lines. Lines starting with '#' are comments.

```shell
#Wed Dec 07 00:40:19 EST 2016
create --class-path mods/com.greetings --module-path mlib
  --cmds commands --config configfiles --header-files src/h
  --libs lib --main-class com.greetings.Main
  --man-pages man --module-version 1.0
  --os-arch "x86_x64" --os-name "macOS"
  --os-version "10.10.5" greetingsmod
```

--------------------------------

### UI Installation and Defaults

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/java.desktop-8.sym.txt

Methods for installing and managing default settings and listeners for UI components.

```APIDOC
## installDefaults

### Description
Installs the default properties and settings for the UI component.

### Method
installDefaults

### Response
#### Success Response (void)
- No return value.
```

```APIDOC
## installListeners

### Description
Installs the necessary listeners for the UI component.

### Method
installListeners

### Response
#### Success Response (void)
- No return value.
```

```APIDOC
## installKeyboardActions

### Description
Installs keyboard actions for the UI component.

### Method
installKeyboardActions

### Response
#### Success Response (void)
- No return value.
```

--------------------------------

### Install Cygwin Packages

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.html

Installs required packages for building the JDK using Cygwin. Ensure the path to the Cygwin setup executable is correct.

```bash
<path to Cygwin setup>/setup-x86_64 -q -P autoconf -P make -P unzip -P zip
```

--------------------------------

### Component Creation and Installation

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/java.desktop-8.sym.txt

Methods for creating and installing UI components and their associated defaults, listeners, and keyboard actions.

```APIDOC
## createScrollButton

### Description
Creates a scroll button.

### Method
createScrollButton

### Parameters
None

### Returns
javax.swing.JButton
```

```APIDOC
## uninstallComponents

### Description
Uninstalls components.

### Method
uninstallComponents

### Parameters
None

### Returns
void
```

```APIDOC
## installDefaults

### Description
Installs default settings for components.

### Method
installDefaults

### Parameters
None

### Returns
void
```

```APIDOC
## uninstallDefaults

### Description
Uninstalls default settings for components.

### Method
uninstallDefaults

### Parameters
None

### Returns
void
```

```APIDOC
## installListeners

### Description
Installs listeners for components.

### Method
installListeners

### Parameters
None

### Returns
void
```

```APIDOC
## uninstallListeners

### Description
Uninstalls listeners for components.

### Method
uninstallListeners

### Parameters
None

### Returns
void
```

```APIDOC
## createMouseListener

### Description
Creates a mouse listener.

### Method
createMouseListener

### Parameters
None

### Returns
java.awt.event.MouseListener
```

```APIDOC
## createFocusListener

### Description
Creates a focus listener.

### Method
createFocusListener

### Parameters
None

### Returns
java.awt.event.FocusListener
```

```APIDOC
## createChangeListener

### Description
Creates a change listener.

### Method
createChangeListener

### Parameters
None

### Returns
javax.swing.event.ChangeListener
```

```APIDOC
## createPropertyChangeListener

### Description
Creates a property change listener.

### Method
createPropertyChangeListener

### Parameters
None

### Returns
java.beans.PropertyChangeListener
```

```APIDOC
## installKeyboardActions

### Description
Installs keyboard actions for components.

### Method
installKeyboardActions

### Parameters
None

### Returns
void
```

```APIDOC
## uninstallKeyboardActions

### Description
Uninstalls keyboard actions for components.

### Method
uninstallKeyboardActions

### Parameters
None

### Returns
void
```

--------------------------------

### Install Autoconf on Windows with Cygwin

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs Autoconf on Windows using the Cygwin setup utility. Autoconf version 2.69 or higher is required.

```bash
<path to Cygwin setup>/setup-x86_64 -q -P autoconf
```

--------------------------------

### jlink Options Example

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.jlink/share/man/jlink.md

This example demonstrates how to use the jlink command with several options to create a compressed runtime image with a specific launcher.

```bash
jlink --module-path mlib --add-modules com.greetings --output greetingsapp
```

--------------------------------

### Build Corretto Installer

Source: https://github.com/corretto/corretto-25/blob/develop/installers/mac/pkg/README.md

Run this Gradle task from the repository root to build the Corretto installer.

```bash
./gradlew :installers:mac:pkg:generateInstaller
```

--------------------------------

### Setup Method

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/java.desktop-8.sym.txt

Method for setting up the file system view.

```APIDOC
## Setup Method

### Description
Sets up the file chooser with a specific `FileSystemView`.

### Method
- `void setup(FileSystemView fsv)`: Configures the file chooser with the provided `FileSystemView`.
```

--------------------------------

### Install SLEEF Quad Library and Headers

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.incubator.vector/unix/native/libsleef/upstream/src/quad/CMakeLists.txt

Configures the installation of the sleefquad library, its public headers, and related components to the appropriate directories.

```cmake
install(
    TARGETS sleefquad
    EXPORT sleefTargets
    PUBLIC_HEADER #
    DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
    COMPONENT sleef_Development
    LIBRARY #
    DESTINATION "${CMAKE_INSTALL_LIBDIR}"
    COMPONENT sleef_Runtime
    NAMELINK_COMPONENT sleef_Development
    ARCHIVE #
    DESTINATION "${CMAKE_INSTALL_LIBDIR}"
    COMPONENT sleef_Development
    RUNTIME #
    DESTINATION "${CMAKE_INSTALL_BINDIR}"
    COMPONENT sleef_Runtime
    INCLUDES #
    DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
)
```

--------------------------------

### jmod Create Example

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.jlink/share/man/jmod.md

A basic example demonstrating the creation of a JMOD file with various components specified, such as class paths, commands, configuration files, and header files.

```shell
jmod create --class-path mods/com.greetings --cmds commands
  --config configfiles --header-files src/h --libs lib
  --main-class com.greetings.Main --man-pages man --module-version 1.0
  --os-arch "x86_x64" --os-name "macOS"
  --os-version "10.10.5" greetingsmod
```

--------------------------------

### Install libdft Library and Components

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.incubator.vector/unix/native/libsleef/upstream/src/dft/CMakeLists.txt

Installs the libdft library, headers, and runtime components to their designated locations.

```cmake
install(
    TARGETS ${TARGET_LIBDFT}
    EXPORT sleefTargets
    PUBLIC_HEADER #
    DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
    COMPONENT sleef_Development
    LIBRARY #
    DESTINATION "${CMAKE_INSTALL_LIBDIR}"
    COMPONENT sleef_Runtime
    NAMELINK_COMPONENT sleef_Development
    ARCHIVE #
    DESTINATION "${CMAKE_INSTALL_LIBDIR}"
    COMPONENT sleef_Development
    RUNTIME #
    DESTINATION "${CMAKE_INSTALL_BINDIR}"
    COMPONENT sleef_Runtime
    INCLUDES #
    DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
)
```

--------------------------------

### jmod Create Example with Date

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.jlink/share/man/jmod.md

This example shows how to create a JMOD file while specifying a precise timestamp for the entries using the --date option in ISO-8601 format.

```shell
jmod create --class-path build/foo/classes --date 2022-03-15T00:00:00Z
   jmods/foo1.jmod
```

--------------------------------

### Install libffi Development Libraries on Debian/Ubuntu

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs the libffi development library on apt-based Linux systems. Use `--with-libffi=<path>` if configure cannot find this.

```bash
sudo apt-get install libffi-dev
```

--------------------------------

### Install X11 Development Libraries on Alpine Linux

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs essential X11 development libraries on Alpine Linux. Use `--with-x=<path>` if configure cannot find these.

```bash
sudo apk add libx11-dev libxext-dev libxrender-dev libxrandr-dev libxtst-dev libxt-dev
```

--------------------------------

### Install libffi Development Libraries on Alpine Linux

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs the libffi development library on Alpine Linux. Use `--with-libffi=<path>` if configure cannot find this.

```bash
sudo apk add libffi-dev
```

--------------------------------

### Install X11 Development Libraries on Debian/Ubuntu

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs essential X11 development libraries on apt-based Linux systems. Use `--with-x=<path>` if configure cannot find these.

```bash
sudo apt-get install libx11-dev libxext-dev libxrender-dev libxrandr-dev libxtst-dev libxt-dev
```

--------------------------------

### Install ALSA Development Libraries on Debian/Ubuntu

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs the ALSA development library on apt-based Linux systems. Use `--with-alsa=<path>` if configure cannot find this.

```bash
sudo apt-get install libasound2-dev
```

--------------------------------

### Install ALSA Development Libraries on Alpine Linux

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs the ALSA development library on Alpine Linux. Use `--with-alsa=<path>` if configure cannot find this.

```bash
sudo apk add alsa-lib-dev
```

--------------------------------

### Install X11 Development Libraries on Fedora/CentOS/RHEL

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs essential X11 development libraries on rpm-based Linux systems. Use `--with-x=<path>` if configure cannot find these.

```bash
sudo yum install libXtst-devel libXt-devel libXrender-devel libXrandr-devel libXi-devel
```

--------------------------------

### Start Simple Web Server with Options

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.httpserver/share/man/jwebserver.md

Starts the Simple Web Server, allowing customization of the bind address, port, and directory to serve. Use `-b 0.0.0.0` or `-b ::` to bind to all interfaces.

```bash
jwebserver [-b bind address] [-p port] [-d directory] [-o none|info|verbose] [-h to show options] [-version to show version information]
```

--------------------------------

### com.sun.source.util.DocSourcePositions Methods

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/jdk.compiler-9.sym.txt

Methods for getting the start and end positions of documentation elements.

```APIDOC
## DocSourcePositions

### Description
Provides methods to get the source code positions for documentation elements.

### Methods

#### getStartPosition
Gets the starting position of a documentation tree element within the source file.

- **Parameters**:
  - `compilationUnitTree` (com.sun.source.tree.CompilationUnitTree) - The compilation unit.
  - `docCommentTree` (com.sun.source.doctree.DocCommentTree) - The doc comment.
  - `docTree` (com.sun.source.doctree.DocTree) - The specific doc tree element.
- **Returns**: `long` - The starting position.

#### getEndPosition
Gets the ending position of a documentation tree element within the source file.

- **Parameters**:
  - `compilationUnitTree` (com.sun.source.tree.CompilationUnitTree) - The compilation unit.
  - `docCommentTree` (com.sun.source.doctree.DocCommentTree) - The doc comment.
  - `docTree` (com.sun.source.doctree.DocTree) - The specific doc tree element.
- **Returns**: `long` - The ending position.
```

--------------------------------

### getRowStart

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/java.desktop-8.sym.txt

Gets the starting position of the row containing the given document position.

```APIDOC
## getRowStart

### Description
Gets the starting position of the row containing the given document position within a text component.

### Method
(Implicitly a method call within the Utilities class)

### Parameters
* **`textComponent`** (javax.swing.text.JTextComponent) - The text component.
* **`position`** (int) - The document position.

### Throws
* **`javax.swing.text.BadLocationException`** - If the position is invalid.

### Returns
(int) - The starting position of the row.
```

--------------------------------

### Launch Simple Web Server

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.httpserver/share/man/jwebserver.md

Starts the Simple Web Server with default settings. The server will bind to the loopback address and serve files from the current directory on port 8000.

```bash
$ jwebserver
```

--------------------------------

### SourcePositions Interface

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/jdk.compiler-9.sym.txt

Provides methods to get the start and end positions of a Tree within a CompilationUnit.

```APIDOC
## SourcePositions Interface

### Description
Provides methods to retrieve the starting and ending character offsets for a given Tree element within a CompilationUnit.

### Methods

#### getStartPosition

*   **Description**: Returns the starting position of the given Tree.
*   **Signature**: `long getStartPosition(CompilationUnitTree compilationUnit, Tree tree)`
*   **Parameters**:
    *   `compilationUnit` (CompilationUnitTree) - The compilation unit containing the tree.
    *   `tree` (Tree) - The tree element for which to find the start position.
*   **Returns**: `long` - The starting character offset.

#### getEndPosition

*   **Description**: Returns the ending position of the given Tree.
*   **Signature**: `long getEndPosition(CompilationUnitTree compilationUnit, Tree tree)`
*   **Parameters**:
    *   `compilationUnit` (CompilationUnitTree) - The compilation unit containing the tree.
    *   `tree` (Tree) - The tree element for which to find the end position.
*   **Returns**: `long` - The ending character offset.
```

--------------------------------

### Painter Precedence Example

Source: https://github.com/corretto/corretto-25/blob/develop/src/java.desktop/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html

Shows how painters are selected based on specificity, starting from state-specific painters to style-level painters.

```xml
<style id="test">
  <painter idref="fallbackPainter"/>
  <painter idref="styleButtonBackgroundPainter" method="buttonBackground"/>
  <state value="SELECTED">
    <painter idref="stateFallbackPainter"/>
    <painter idref="stateButtonBackgroundPainter" method="buttonBackground"/>
  </state>
</style>
```

--------------------------------

### Pre-configured Options File Example

Source: https://github.com/corretto/corretto-25/blob/develop/src/java.base/share/man/keytool.md

Defines default options for keytool commands. Properties like 'keytool.all' apply to all commands, while specific command properties override them. Values can include system properties and should be quoted if they contain whitespace.

```properties
# A tiny pre-configured options file
keytool.all = -keystore ${user.home}/ks
keytool.list = -v
keytool.genkeypair = -keyalg rsa
```

--------------------------------

### PixelGrabber

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/java.desktop-8.sym.txt

An image filter that allows you to grab pixels from an Image or ImageProducer. It provides methods to start and abort grabbing, retrieve pixel data, and get image dimensions and status.

```APIDOC
## Class: java.awt.image.PixelGrabber

### Description
An image filter that allows you to grab pixels from an Image or ImageProducer. It provides methods to start and abort grabbing, retrieve pixel data, and get image dimensions and status.

### Methods
- **<init>(Image, int, int, int, int, int[], int, int)**: Constructor for PixelGrabber.
- **<init>(ImageProducer, int, int, int, int, int[], int, int)**: Constructor for PixelGrabber.
- **<init>(Image, int, int, int, int, boolean)**: Constructor for PixelGrabber.
- **startGrabbing()**: Starts the pixel grabbing process.
- **abortGrabbing()**: Aborts the pixel grabbing process.
- **grabPixels()**: Grabs the pixels and returns true if successful, false otherwise. Throws InterruptedException.
- **grabPixels(long)**: Grabs the pixels with a timeout and returns true if successful, false otherwise. Throws InterruptedException.
- **getStatus()**: Gets the status of the grabbing process.
- **getWidth()**: Gets the width of the image.
- **getHeight()**: Gets the height of the image.
- **getPixels()**: Gets the pixel data.
- **getColorModel()**: Gets the ColorModel of the image.
- **setDimensions(int, int)**: Sets the dimensions of the image.
- **setHints(int)**: Sets the hints for the image.
- **setProperties(Hashtable)**: Sets the properties of the image.
- **setColorModel(ColorModel)**: Sets the ColorModel for the image.
- **setPixels(int, int, int, int, ColorModel, byte[], int, int)**: Sets the pixel data.
- **setPixels(int, int, int, int, ColorModel, int[], int, int)**: Sets the pixel data.
- **imageComplete(int)**: Called when the image is complete.
- **status()**: Gets the status of the grabbing process.

```

--------------------------------

### jlink Options File Example

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.jlink/share/man/jlink.md

This example shows how to use an options file to configure the jlink command. The file contains the module path, modules to add, and the output directory.

```properties
#Wed Dec 07 00:40:19 EST 2016
--module-path mlib
--add-modules com.greetings
--output greetingsapp
```

--------------------------------

### AWT Frame Visibility Example

Source: https://github.com/corretto/corretto-25/blob/develop/src/java.desktop/share/classes/java/awt/doc-files/AWTThreadIssues.html

Demonstrates how creating and displaying an AWT Frame prevents JVM exit due to AWT's internal event dispatch machinery starting non-daemon threads.

```Java
public static void main(String[] args) {
    Frame frame = new Frame();
    frame.setVisible(true);
 }
```

--------------------------------

### Run Commands on Irrecoverable Error (Linux)

Source: https://github.com/corretto/corretto-25/blob/develop/src/java.base/share/man/java.md

Use the -XX:OnError option to specify commands to run when an irrecoverable error occurs. This example shows how to generate a core dump and start GDB on Linux.

```bash
-XX:OnError="gcore %p;gdb -p %p"
```

--------------------------------

### java.awt.geom.CubicCurve2D$Float

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/java.desktop-8.sym.txt

Represents a cubic curve segment defined by four points: a start point, two control points, and an end point. It provides methods to access and set these points, as well as to get the curve's bounding box.

```APIDOC
## Class: java/awt/geom/CubicCurve2D$Float

### Description
Represents a cubic curve segment defined by four points: a start point, two control points, and an end point. It provides methods to access and set these points, as well as to get the curve's bounding box.

### Fields
- `x1` (F)
- `y1` (F)
- `ctrlx1` (F)
- `ctrly1` (F)
- `ctrlx2` (F)
- `ctrly2` (F)
- `x2` (F)
- `y2` (F)

### Constructors
- `<init>()V`
- `<init>(FFFFFFFF)V`

### Methods
- `getX1()D`
- `getY1()D`
- `getP1()Ljava/awt/geom/Point2D;`
- `getCtrlX1()D`
- `getCtrlY1()D`
- `getCtrlP1()Ljava/awt/geom/Point2D;`
- `getCtrlX2()D`
- `getCtrlY2()D`
- `getCtrlP2()Ljava/awt/geom/Point2D;`
- `getX2()D`
- `getY2()D`
- `getP2()Ljava/awt/geom/Point2D;`
- `setCurve(DDDDDDDD)V`
- `setCurve(FFFFFFFF)V`
- `getBounds2D()Ljava/awt/geom/Rectangle2D;`
```

--------------------------------

### Server Startup Confirmation

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.httpserver/share/man/jwebserver.md

Example output upon successful startup of the jwebserver. It indicates the address and port the server is listening on, and the directory it is serving.

```bash
Binding to loopback by default. For all interfaces use "-b 0.0.0.0" or "-b ::".
Serving /cwd and subdirectories on 127.0.0.1 port 8000
URL http://127.0.0.1:8000/
```

--------------------------------

### Display All Configure Options

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.html

Run this command to view a comprehensive list of all available configuration options for the JDK build. This is essential for understanding the full range of customization possibilities.

```bash
bash configure --help
```

--------------------------------

### Install SLEEF using Spack

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.incubator.vector/unix/native/libsleef/upstream/README.md

Install the SLEEF library directly using the Spack package manager. This command installs the master branch.

```bash
spack install sleef@master
```

--------------------------------

### Basic Compile Framework Usage

Source: https://github.com/corretto/corretto-25/blob/develop/test/hotspot/jtreg/compiler/lib/compile_framework/README.md

Demonstrates the fundamental steps of using the Compile Framework: instantiation, adding a Java source, compiling, and invoking a method.

```Java
CompileFramework compileFramework = new CompileFramework();

compileFramework.addJavaSourceCode("XYZ", "<your XYZ definition string>");

compileFramework.compile();

Object returnValue = compileFramework.invoke("XYZ", "test", new Object[] {5});
```

--------------------------------

### Start jstatd with External RMI Registry

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.jstatd/share/man/jstatd.md

Starts the jstatd server using an external RMI registry. Ensure the rmiregistry is started first.

```shell
rmiregistry&
jstatd
```

--------------------------------

### Equivalent Compilation and Launch Commands

Source: https://github.com/corretto/corretto-25/blob/develop/src/java.base/share/man/java.md

This demonstrates the two-step process that is informally equivalent to launching a Java source file directly. It involves compiling to memory and then launching from memory.

```bash
javac -d <memory> --source-path <source-root> HelloWorld.java
java --class-path <memory> HelloWorld
```

--------------------------------

### SocketImpl Get Option

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/java.base-9.sym.txt

Gets the value of a socket option for the SocketImpl.

```APIDOC
## SocketImpl.getOption

### Description
Gets the value of a socket option for the SocketImpl.

### Signature
<T:Ljava/lang/Object;>(Ljava/net/SocketOption<TT;>;)TT;

### Thrown Types
java/io/IOException
```

--------------------------------

### Show All Settings (Java)

Source: https://github.com/corretto/corretto-25/blob/develop/src/java.base/share/man/java.md

Displays all JVM settings and then continues execution.

```java
-XshowSettings
```

--------------------------------

### MetalRootPaneUI Methods

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/java.desktop-8.sym.txt

Provides methods for installing and uninstalling the UI delegate for Metal root panes.

```APIDOC
## MetalRootPaneUI

### Description
Provides methods for managing the UI of a Metal-designed root pane, including installation and uninstallation of the UI delegate and handling property changes.

### Methods

#### `createUI(JComponent c)`
- **Description**: Creates a new UI delegate for the given component.
- **Parameters**:
  - `c` (JComponent) - The component to create the UI for.
- **Returns**: `ComponentUI` - The created UI delegate.

#### `installUI(JComponent c)`
- **Description**: Installs the UI delegate for the given component.
- **Parameters**:
  - `c` (JComponent) - The component to install the UI for.

#### `uninstallUI(JComponent c)`
- **Description**: Uninstalls the UI delegate for the given component.
- **Parameters**:
  - `c` (JComponent) - The component to uninstall the UI from.

#### `propertyChange(PropertyChangeEvent evt)`
- **Description**: Handles property change events for the root pane.
- **Parameters**:
  - `evt` (PropertyChangeEvent) - The property change event.

```

--------------------------------

### OpenJDK Build Instructions

Source: https://github.com/corretto/corretto-25/blob/develop/README.md

Provides links to HTML and Markdown files for building the OpenJDK. Refer to these for detailed build instructions.

```text
Welcome to the JDK!
===================

For build instructions, please see either of these files:

  * doc/building.html   (html version)
  * doc/building.md     (markdown version)

See <https://openjdk.org/> for more information about the OpenJDK
Community and the JDK and see <https://bugs.openjdk.org> for JDK issue
tracking.
```

--------------------------------

### View J2D Demo Command Line Options

Source: https://github.com/corretto/corretto-25/blob/develop/src/demo/share/jfc/J2Ddemo/README.txt

Display all available command-line options for customizing J2D demo runs.

```bash
java -jar J2Ddemo.jar -help
```

--------------------------------

### Show Version Information

Source: https://github.com/corretto/corretto-25/blob/develop/src/java.base/share/man/java.md

Use `--show-version` to print the product version to the output stream and continue. Use `-showversion` for the error stream.

```bash
java --show-version
```

```bash
java -showversion
```

--------------------------------

### Install AArch64 Cross-Compiler on Debian/Ubuntu

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.html

Installs the necessary GCC cross-compiler for AArch64 architecture on a Debian-based system.

```bash
apt install g++-aarch64-linux-gnu gcc-aarch64-linux-gnu
```

--------------------------------

### URLConnection Get Default Use Caches

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/java.base-9.sym.txt

Gets the default value of the useCaches field for a given protocol.

```APIDOC
## URLConnection.getDefaultUseCaches

### Description
Gets the default value of the useCaches field for a given protocol.

### Signature
(Ljava/lang/String;)Z
```

--------------------------------

### Socket Get Option

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/java.base-9.sym.txt

Gets the value of a socket option. This method returns the value of the specified option.

```APIDOC
## Socket.getOption

### Description
Gets the value of a socket option.

### Signature
<T:Ljava/lang/Object;>(Ljava/net/SocketOption<TT;>;)TT;

### Thrown Types
java/io/IOException
```

--------------------------------

### Example Build Failure Summary

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.html

This is an example of a build failure summary that appears at the end of a failed build process. It highlights the error, output from failing commands, make failed targets, and provides help hints for diagnosis.

```text
ERROR: Build failed for target 'hotspot' in configuration 'linux-x64' (exit code 2)

    === Output from failing command(s) repeated here ===
    * For target hotspot_variant-server_libjvm_objs_psMemoryPool.o:
    /src/jdk/hotspot/src/share/vm/services/psMemoryPool.cpp:1:1: error: 'failhere' does not name a type
       ... (rest of output omitted)
    
    * All command lines available in /src/jdk/build/linux-x64/make-support/failure-logs.
    === End of repeated output ===
    
    === Make failed targets repeated here ===
    lib/CompileJvm.gmk:207: recipe for target '/src/jdk/build/linux-x64/hotspot/variant-server/libjvm/objs/psMemoryPool.o' failed
    make/Main.gmk:263: recipe for target 'hotspot-server-libs' failed
    === End of repeated output ===
    
    HELP: Try searching the build log for the name of the first failed target.
    HELP: Run 'make doctor' to diagnose build problems.
```

--------------------------------

### ServerSocket Get Option

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.compiler/share/data/symbols/java.base-9.sym.txt

Gets the value of a socket option. This method returns the value of the specified option.

```APIDOC
## ServerSocket.getOption

### Description
Gets the value of a socket option.

### Signature
<T:Ljava/lang/Object;>(Ljava/net/SocketOption<TT;>;)TT;

### Thrown Types
java/io/IOException
```

--------------------------------

### Platform Documentation Properties Example

Source: https://github.com/corretto/corretto-25/blob/develop/src/jdk.javadoc/share/man/javadoc.md

An example of a properties file used with --link-platform-properties, providing URLs for platform API documentation for versions 15, 16, and 17.

```properties
doclet.platform.docs.15=https://example.com/api/15/
doclet.platform.docs.16=https://example.com/api/16/
doclet.platform.docs.17=https://example.com/api/17/
```

--------------------------------

### Install Autoconf on macOS

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs Autoconf on macOS using Homebrew. Autoconf version 2.69 or higher is required.

```bash
brew install autoconf
```

--------------------------------

### Install Autoconf on Alpine Linux

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs Autoconf on Alpine Linux. Autoconf version 2.69 or higher is required.

```bash
sudo apk add autoconf
```

--------------------------------

### Basic Configure Script Invocation

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.html

Use this command to start the JDK build configuration process. It creates an output directory and sets up the build environment.

```bash
bash configure [options]
```

--------------------------------

### Install Autoconf on Fedora/CentOS/RHEL

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs Autoconf on rpm-based Linux systems. Autoconf version 2.69 or higher is required.

```bash
sudo yum install autoconf
```

--------------------------------

### Install Autoconf on Debian/Ubuntu

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.md

Installs Autoconf on apt-based Linux systems. Autoconf version 2.69 or higher is required.

```bash
sudo apt-get install autoconf
```

--------------------------------

### Configure for 32-bit Windows Build with FreeType2

Source: https://github.com/corretto/corretto-25/blob/develop/doc/building.html

Example of configuring a 32-bit build for Windows, specifying a custom path for FreeType2. This is useful for targeting specific architectures or using external libraries.

```bash
bash configure --with-freetype=/cygdrive/c/freetype-i586 --with-target-bits=32
```

--------------------------------

### RSAES-OAEP Encryption Example 10.6

Source: https://github.com/corretto/corretto-25/blob/develop/test/jdk/com/sun/crypto/provider/Cipher/RSA/oaep-vect.txt

This snippet presents the final RSAES-OAEP encryption example, useful for comprehensive testing and validation.

```text
# Message to be encrypted:
ea f1 a7 3a 1b 0c 46 09 53 7d e6 9c d9 22 8b bc 
fb 9a 8c a8 c6 c3 ef af 05 6f e4 a7 f4 63 4e d0 
0b 7c 39 ec 69 22 d7 b8 ea 2c 04 eb ac 

# Seed:
9f 47 dd f4 2e 97 ee a8 56 a9 bd bc 71 4e b3 ac 
22 f6 eb 32 

```