Sync documentation of main branch

Author: actions-user

_generated-doc/main/config/quarkus-all-config.adoc

@@ -19,6 +19,8 @@ endif::add-copy-button-to-config-props[]
  - If set to `none` (or `false`) no beans will ever be removed even if they are unused (according to the criteria set out below)
  - If set to `fwk`, then all unused beans will be removed, except the unused beans whose classes are declared in the application code
 
+
+
 An unused bean:
 
  - is not a built-in bean or interceptor,
@@ -143,7 +145,9 @@ An element value can be:
  - a fully qualified class name, i.e. `org.acme.Foo`
  - a simple class name as defined by `Class++#++getSimpleName()`, i.e. `Foo`
  - a package name with suffix `.++*++`, i.e. `org.acme.++*++`, matches a package
- - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value  Each element value is used to match an alternative bean class, an alternative stereotype annotation type or a bean class that declares an alternative producer. If any value matches then the priority of `Integer++#++MAX_VALUE` is used for the relevant bean. The priority declared via `jakarta.annotation.Priority` is overridden.
+ - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value
+
+Each element value is used to match an alternative bean class, an alternative stereotype annotation type or a bean class that declares an alternative producer. If any value matches then the priority of `Integer++#++MAX_VALUE` is used for the relevant bean. The priority declared via `jakarta.annotation.Priority` is overridden.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -192,7 +196,9 @@ An element value can be:
  - a fully qualified class name, i.e. `org.acme.Foo`
  - a simple class name as defined by `Class++#++getSimpleName()`, i.e. `Foo`
  - a package name with suffix `.++*++`, i.e. `org.acme.++*++`, matches a package
- - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value  If any element value matches a discovered type then the type is excluded from discovery, i.e. no beans and observer methods are created from this type.
+ - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value
+
+If any element value matches a discovered type then the type is excluded from discovery, i.e. no beans and observer methods are created from this type.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -220,7 +226,9 @@ An element value can be:
  - a fully qualified class name, i.e. `org.acme.Foo`
  - a simple class name as defined by `Class++#++getSimpleName()`, i.e. `Foo`
  - a package name with suffix `.++*++`, i.e. `org.acme.++*++`, matches a package
- - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value  If any element value matches a discovered bean, then such a bean is considered unremovable.
+ - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value
+
+If any element value matches a discovered bean, then such a bean is considered unremovable.
 
 
 ifdef::add-copy-button-to-env-var[]

_generated-doc/main/config/quarkus-arc.adoc

@@ -19,6 +19,8 @@ endif::add-copy-button-to-config-props[]
  - If set to `none` (or `false`) no beans will ever be removed even if they are unused (according to the criteria set out below)
  - If set to `fwk`, then all unused beans will be removed, except the unused beans whose classes are declared in the application code
 
+
+
 An unused bean:
 
  - is not a built-in bean or interceptor,
@@ -143,7 +145,9 @@ An element value can be:
  - a fully qualified class name, i.e. `org.acme.Foo`
  - a simple class name as defined by `Class++#++getSimpleName()`, i.e. `Foo`
  - a package name with suffix `.++*++`, i.e. `org.acme.++*++`, matches a package
- - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value  Each element value is used to match an alternative bean class, an alternative stereotype annotation type or a bean class that declares an alternative producer. If any value matches then the priority of `Integer++#++MAX_VALUE` is used for the relevant bean. The priority declared via `jakarta.annotation.Priority` is overridden.
+ - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value
+
+Each element value is used to match an alternative bean class, an alternative stereotype annotation type or a bean class that declares an alternative producer. If any value matches then the priority of `Integer++#++MAX_VALUE` is used for the relevant bean. The priority declared via `jakarta.annotation.Priority` is overridden.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -192,7 +196,9 @@ An element value can be:
  - a fully qualified class name, i.e. `org.acme.Foo`
  - a simple class name as defined by `Class++#++getSimpleName()`, i.e. `Foo`
  - a package name with suffix `.++*++`, i.e. `org.acme.++*++`, matches a package
- - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value  If any element value matches a discovered type then the type is excluded from discovery, i.e. no beans and observer methods are created from this type.
+ - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value
+
+If any element value matches a discovered type then the type is excluded from discovery, i.e. no beans and observer methods are created from this type.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -220,7 +226,9 @@ An element value can be:
  - a fully qualified class name, i.e. `org.acme.Foo`
  - a simple class name as defined by `Class++#++getSimpleName()`, i.e. `Foo`
  - a package name with suffix `.++*++`, i.e. `org.acme.++*++`, matches a package
- - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value  If any element value matches a discovered bean, then such a bean is considered unremovable.
+ - a package name with suffix `.++**++`, i.e. `org.acme.++**++`, matches a package that starts with the value
+
+If any element value matches a discovered bean, then such a bean is considered unremovable.
 
 
 ifdef::add-copy-button-to-env-var[]

_generated-doc/main/config/quarkus-arc_quarkus.arc.adoc

@@ -218,7 +218,11 @@ Description of each type can be found link:https://github.com/microsoft/azure-ma
  - *key* Password for _service_principal_ if using password authentication
  - *certificate* Path to PEM file if using _service_principal_
  - *certificate-password* Password for PEM file if it is password protected and if using _service_principal_
- - *environment* if using _service_principal_   Defaults to "azure_cli" for authentication
+ - *environment* if using _service_principal_
+
+
+
+Defaults to "azure_cli" for authentication
 
 
 ifdef::add-copy-button-to-env-var[]

_generated-doc/main/config/quarkus-azure-functions.adoc

@@ -218,7 +218,11 @@ Description of each type can be found link:https://github.com/microsoft/azure-ma
  - *key* Password for _service_principal_ if using password authentication
  - *certificate* Path to PEM file if using _service_principal_
  - *certificate-password* Password for PEM file if it is password protected and if using _service_principal_
- - *environment* if using _service_principal_   Defaults to "azure_cli" for authentication
+ - *environment* if using _service_principal_
+
+
+
+Defaults to "azure_cli" for authentication
 
 
 ifdef::add-copy-button-to-env-var[]

_generated-doc/main/config/quarkus-azure-functions_quarkus.azure-functions.adoc

@@ -125,7 +125,9 @@ If this is set, then it will be used as the entry point of the container image.
  - Entrypoint "INHERIT" means to inherit entrypoint from base image, `jvmArguments` field is used for arguments
  - A valid entrypoint is jar package specific (see `quarkus.package.jar.type`)
  - A valid entrypoint depends on the location of both the launching scripts and the application jar file. To that end it's helpful to remember that when `fast-jar` packaging is used (the default), all necessary application jars are added to the `/work` directory and that the same directory is also used as the working directory. When `legacy-jar` or `uber-jar` are used, the application jars are unpacked under the `/app` directory and that directory is used as the working directory.
- - Even if the `jvmArguments` field is set, it is ignored completely unless entrypoint is "INHERIT"  When this is not set, a proper default entrypoint will be constructed. As a final note, a very useful tool for inspecting container image layers that can greatly aid when debugging problems with endpoints is link:https://github.com/wagoodman/dive[dive]
+ - Even if the `jvmArguments` field is set, it is ignored completely unless entrypoint is "INHERIT"
+
+When this is not set, a proper default entrypoint will be constructed. As a final note, a very useful tool for inspecting container image layers that can greatly aid when debugging problems with endpoints is link:https://github.com/wagoodman/dive[dive]
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -150,7 +152,9 @@ If this is set, then it will be used as the entry point of the container image.
 
  - Entrypoint "INHERIT" means to inherit entrypoint from base image, `nativeArguments` field is used for arguments
  - A valid entrypoint depends on the location of both the launching scripts and the native binary file. To that end it's helpful to remember that the native application is added to the `/work` directory and that and the same directory is also used as the working directory
- - Even if the `nativeArguments` field is set, it is ignored completely unless entrypoint is "INHERIT"  When this is not set, a proper default entrypoint will be constructed. As a final note, a very useful tool for inspecting container image layers that can greatly aid when debugging problems with endpoints is link:https://github.com/wagoodman/dive[dive]
+ - Even if the `nativeArguments` field is set, it is ignored completely unless entrypoint is "INHERIT"
+
+When this is not set, a proper default entrypoint will be constructed. As a final note, a very useful tool for inspecting container image layers that can greatly aid when debugging problems with endpoints is link:https://github.com/wagoodman/dive[dive]
 
 
 ifdef::add-copy-button-to-env-var[]

_generated-doc/main/config/quarkus-container-image-jib.adoc

@@ -125,7 +125,9 @@ If this is set, then it will be used as the entry point of the container image.
  - Entrypoint "INHERIT" means to inherit entrypoint from base image, `jvmArguments` field is used for arguments
  - A valid entrypoint is jar package specific (see `quarkus.package.jar.type`)
  - A valid entrypoint depends on the location of both the launching scripts and the application jar file. To that end it's helpful to remember that when `fast-jar` packaging is used (the default), all necessary application jars are added to the `/work` directory and that the same directory is also used as the working directory. When `legacy-jar` or `uber-jar` are used, the application jars are unpacked under the `/app` directory and that directory is used as the working directory.
- - Even if the `jvmArguments` field is set, it is ignored completely unless entrypoint is "INHERIT"  When this is not set, a proper default entrypoint will be constructed. As a final note, a very useful tool for inspecting container image layers that can greatly aid when debugging problems with endpoints is link:https://github.com/wagoodman/dive[dive]
+ - Even if the `jvmArguments` field is set, it is ignored completely unless entrypoint is "INHERIT"
+
+When this is not set, a proper default entrypoint will be constructed. As a final note, a very useful tool for inspecting container image layers that can greatly aid when debugging problems with endpoints is link:https://github.com/wagoodman/dive[dive]
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -150,7 +152,9 @@ If this is set, then it will be used as the entry point of the container image.
 
  - Entrypoint "INHERIT" means to inherit entrypoint from base image, `nativeArguments` field is used for arguments
  - A valid entrypoint depends on the location of both the launching scripts and the native binary file. To that end it's helpful to remember that the native application is added to the `/work` directory and that and the same directory is also used as the working directory
- - Even if the `nativeArguments` field is set, it is ignored completely unless entrypoint is "INHERIT"  When this is not set, a proper default entrypoint will be constructed. As a final note, a very useful tool for inspecting container image layers that can greatly aid when debugging problems with endpoints is link:https://github.com/wagoodman/dive[dive]
+ - Even if the `nativeArguments` field is set, it is ignored completely unless entrypoint is "INHERIT"
+
+When this is not set, a proper default entrypoint will be constructed. As a final note, a very useful tool for inspecting container image layers that can greatly aid when debugging problems with endpoints is link:https://github.com/wagoodman/dive[dive]
 
 
 ifdef::add-copy-button-to-env-var[]

_generated-doc/main/config/quarkus-container-image-jib_quarkus.jib.adoc

@@ -677,13 +677,47 @@ quarkus.native.resources.includes = foo/**,bar/**/*.txt
 
 the files `src/main/resources/foo/selected.png` and `bar/some.txt` will be included in the native image, while `src/main/resources/ignored.png` will not be included.
 
-Supported glob features   Feature Description   `++*++` Matches a (possibly empty) sequence of characters that does not contain slash (`/`)   `++**++` Matches a (possibly empty) sequence of characters that may contain slash (`/`)   `?` Matches one character, but not slash   `++[++abc++]++` Matches one character given in the bracket, but not slash   `++[++a-z++]++` Matches one character from the range given in the bracket, but not slash   `++[++!abc++]++` Matches one character not named in the bracket; does not match slash   `++[++a-z++]++` Matches one character outside the range given in the bracket; does not match slash   `++{++one,two,three++}++` Matches any of the alternating tokens separated by comma; the tokens may contain wildcards, nested alternations and ranges   `++\++` The escape character
+Supported glob features
+
+!===
+!Feature !Description
+
+!`++*++`
+!Matches a (possibly empty) sequence of characters that does not contain slash (`/`)
+
+!`++**++`
+!Matches a (possibly empty) sequence of characters that may contain slash (`/`)
+
+!`?`
+!Matches one character, but not slash
+
+!`++[++abc++]++`
+!Matches one character given in the bracket, but not slash
+
+!`++[++a-z++]++`
+!Matches one character from the range given in the bracket, but not slash
+
+!`++[++\!abc++]++`
+!Matches one character not named in the bracket; does not match slash
+
+!`++[++a-z++]++`
+!Matches one character outside the range given in the bracket; does not match slash
+
+!`++{++one,two,three++}++`
+!Matches any of the alternating tokens separated by comma; the tokens may contain wildcards, nested alternations and ranges
+
+!`++\++`
+!The escape character
+!===
+
 
 Note that there are three levels of escaping when passing this option via `application.properties`:
 
  . `application.properties` parser
- - MicroProfile Config list converter that splits the comma separated list
- - Glob parser  All three levels use backslash (`++\++`) as the escaping character. So you need to use an appropriate number of backslashes depending on which level you want to escape.
+ . MicroProfile Config list converter that splits the comma separated list
+ . Glob parser
+
+All three levels use backslash (`++\++`) as the escaping character. So you need to use an appropriate number of backslashes depending on which level you want to escape.
 
 Note that Quarkus extensions typically include the resources they require by themselves. This option is useful in situations when the built-in functionality is not sufficient.
 

_generated-doc/main/config/quarkus-core_quarkus.native.adoc

@@ -44,7 +44,9 @@ Specify the dependencies that are allowed to have proto files that can be import
 
  - _none_ - default - don't scan dependencies
  - a comma separated list of _groupId:artifactId_ coordinates to scan
- - _all_ - scan all dependencies  By default, _com.google.protobuf:protobuf-java_.
+ - _all_ - scan all dependencies
+
+By default, _com.google.protobuf:protobuf-java_.
 
 
 ifdef::add-copy-button-to-env-var[]

_generated-doc/main/config/quarkus-grpc_quarkus.generate-code.adoc

@@ -119,7 +119,9 @@ A valid prefix consists of alphanumeric characters and underscores. Three specia
 
  - `<alias_>` - the alias of an iterated element suffixed with an underscore is used, e.g. `item_hasNext` and `it_count`
  - `<alias?>` - the alias of an iterated element suffixed with a question mark is used, e.g. `item?hasNext` and `it?count`
- - `<none>` - no prefix is used, e.g. `hasNext` and `count`  By default, the `<alias_>` constant is set.
+ - `<none>` - no prefix is used, e.g. `hasNext` and `count`
+
+By default, the `<alias_>` constant is set.
 
 
 ifdef::add-copy-button-to-env-var[]