Sync documentation of main branch

Author: actions-user

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

@@ -77608,6 +77608,27 @@ endif::add-copy-button-to-env-var[]
 |link:https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/nio/charset/Charset.html[Charset]
 |`UTF-8`
 
+a|icon:lock[title=Fixed at build time] [[quarkus-qute_quarkus-qute-duplicit-templates-strategy]] [.property-path]##link:#quarkus-qute_quarkus-qute-duplicit-templates-strategy[`quarkus.qute.duplicit-templates-strategy`]##
+ifdef::add-copy-button-to-config-props[]
+config_property_copy_button:+++quarkus.qute.duplicit-templates-strategy+++[]
+endif::add-copy-button-to-config-props[]
+
+
+[.description]
+--
+The strategy used when multiple templates with the same path are found in the application.
+
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_QUTE_DUPLICIT_TEMPLATES_STRATEGY+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_QUTE_DUPLICIT_TEMPLATES_STRATEGY+++`
+endif::add-copy-button-to-env-var[]
+--
+a|tooltip:prioritize[If multiple templates with the same path are found then determine the highest priority value and eliminate all templates with lowest priority. If there is exactly one template remaining then use this template. Otherwise, fail the build.  Templates from the root application archive have the priority `30`. Templates from other application archives have the priority `10`. Templates from build items can define any priority.], tooltip:fail[Fail the build if multiple templates with the same path are found.]
+|tooltip:prioritize[If multiple templates with the same path are found then determine the highest priority value and eliminate all templates with lowest priority. If there is exactly one template remaining then use this template. Otherwise, fail the build.  Templates from the root application archive have the priority {@code 30}. Templates from other application archives have the priority {@code 10}. Templates from build items can define any priority.]
+
 a|icon:lock[title=Fixed at build time] [[quarkus-qute_quarkus-qute-dev-mode-no-restart-templates]] [.property-path]##link:#quarkus-qute_quarkus-qute-dev-mode-no-restart-templates[`quarkus.qute.dev-mode.no-restart-templates`]##
 ifdef::add-copy-button-to-config-props[]
 config_property_copy_button:+++quarkus.qute.dev-mode.no-restart-templates+++[]

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

@@ -176,6 +176,27 @@ endif::add-copy-button-to-env-var[]
 |link:https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/nio/charset/Charset.html[Charset]
 |`UTF-8`
 
+a|icon:lock[title=Fixed at build time] [[quarkus-qute_quarkus-qute-duplicit-templates-strategy]] [.property-path]##link:#quarkus-qute_quarkus-qute-duplicit-templates-strategy[`quarkus.qute.duplicit-templates-strategy`]##
+ifdef::add-copy-button-to-config-props[]
+config_property_copy_button:+++quarkus.qute.duplicit-templates-strategy+++[]
+endif::add-copy-button-to-config-props[]
+
+
+[.description]
+--
+The strategy used when multiple templates with the same path are found in the application.
+
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_QUTE_DUPLICIT_TEMPLATES_STRATEGY+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_QUTE_DUPLICIT_TEMPLATES_STRATEGY+++`
+endif::add-copy-button-to-env-var[]
+--
+a|tooltip:prioritize[If multiple templates with the same path are found then determine the highest priority value and eliminate all templates with lowest priority. If there is exactly one template remaining then use this template. Otherwise, fail the build.  Templates from the root application archive have the priority `30`. Templates from other application archives have the priority `10`. Templates from build items can define any priority.], tooltip:fail[Fail the build if multiple templates with the same path are found.]
+|tooltip:prioritize[If multiple templates with the same path are found then determine the highest priority value and eliminate all templates with lowest priority. If there is exactly one template remaining then use this template. Otherwise, fail the build.  Templates from the root application archive have the priority {@code 30}. Templates from other application archives have the priority {@code 10}. Templates from build items can define any priority.]
+
 a|icon:lock[title=Fixed at build time] [[quarkus-qute_quarkus-qute-dev-mode-no-restart-templates]] [.property-path]##link:#quarkus-qute_quarkus-qute-dev-mode-no-restart-templates[`quarkus.qute.dev-mode.no-restart-templates`]##
 ifdef::add-copy-button-to-config-props[]
 config_property_copy_button:+++quarkus.qute.dev-mode.no-restart-templates+++[]

_generated-doc/main/config/quarkus-qute_quarkus.qute.adoc

@@ -176,6 +176,27 @@ endif::add-copy-button-to-env-var[]
 |link:https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/nio/charset/Charset.html[Charset]
 |`UTF-8`
 
+a|icon:lock[title=Fixed at build time] [[quarkus-qute_quarkus-qute-duplicit-templates-strategy]] [.property-path]##link:#quarkus-qute_quarkus-qute-duplicit-templates-strategy[`quarkus.qute.duplicit-templates-strategy`]##
+ifdef::add-copy-button-to-config-props[]
+config_property_copy_button:+++quarkus.qute.duplicit-templates-strategy+++[]
+endif::add-copy-button-to-config-props[]
+
+
+[.description]
+--
+The strategy used when multiple templates with the same path are found in the application.
+
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_QUTE_DUPLICIT_TEMPLATES_STRATEGY+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_QUTE_DUPLICIT_TEMPLATES_STRATEGY+++`
+endif::add-copy-button-to-env-var[]
+--
+a|tooltip:prioritize[If multiple templates with the same path are found then determine the highest priority value and eliminate all templates with lowest priority. If there is exactly one template remaining then use this template. Otherwise, fail the build.  Templates from the root application archive have the priority `30`. Templates from other application archives have the priority `10`. Templates from build items can define any priority.], tooltip:fail[Fail the build if multiple templates with the same path are found.]
+|tooltip:prioritize[If multiple templates with the same path are found then determine the highest priority value and eliminate all templates with lowest priority. If there is exactly one template remaining then use this template. Otherwise, fail the build.  Templates from the root application archive have the priority {@code 30}. Templates from other application archives have the priority {@code 10}. Templates from build items can define any priority.]
+
 a|icon:lock[title=Fixed at build time] [[quarkus-qute_quarkus-qute-dev-mode-no-restart-templates]] [.property-path]##link:#quarkus-qute_quarkus-qute-dev-mode-no-restart-templates[`quarkus.qute.dev-mode.no-restart-templates`]##
 ifdef::add-copy-button-to-config-props[]
 config_property_copy_button:+++quarkus.qute.dev-mode.no-restart-templates+++[]

_generated-doc/main/infra/quarkus-all-build-items.adoc

@@ -6166,6 +6166,18 @@ _No Javadoc found_
 
 
 
+a| https://github.com/quarkusio/quarkus/blob/main/extensions/qute/deployment/src/main/java/io/quarkus/qute/deployment/EffectiveTemplatePathsBuildItem.java[`io.quarkus.qute.deployment.EffectiveTemplatePathsBuildItem`, window="_blank"]
+[.description]
+--
+This build item represents all template paths of an application. 
+If `QuteConfig.DuplicitTemplatesStrategy#PRIORITIZE` is used then duplicit template paths with lower priority are not included.
+-- a|`java.util.List<TemplatePathBuildItem> templatePaths` 
+
+_No Javadoc found_
+
+
+
+
 a| https://github.com/quarkusio/quarkus/blob/main/extensions/qute/deployment/src/main/java/io/quarkus/qute/deployment/GeneratedValueResolverBuildItem.java[`io.quarkus.qute.deployment.GeneratedValueResolverBuildItem`, window="_blank"]
 [.description]
 --
@@ -6416,7 +6428,11 @@ a| https://github.com/quarkusio/quarkus/blob/main/extensions/qute/deployment/src
 [.description]
 --
 Discovered template. 
-Templates backed by files located in a template root are discovered automatically. Furthermore, extensions can produce this build item in order to provide a template that is not backed by a file.
+Templates backed by files located in a template root are discovered automatically. Furthermore, extensions can produce this build item in order to provide a template that is not backed by a file. 
+[discrete]
+== Warning
+
+Extensions should never _consume_ this build item directly. However, they may consume the `EffectiveTemplatePathsBuildItem` instead.
 @see TemplateRootBuildItem
 -- a|`java.lang.String path` 
 
@@ -6434,6 +6450,10 @@ _No Javadoc found_
 
 _No Javadoc found_
 
+`int priority` 
+
+_No Javadoc found_
+