Skip to content

Commit c6b3462

Browse files
committed
Sync documentation of main branch
1 parent c6b4189 commit c6b3462

12 files changed

+48
-31
lines changed

_data/versioned/main/index/quarkus.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2991,7 +2991,7 @@ types:
29912991
- io.quarkus:quarkus-smallrye-stork
29922992
type: guide
29932993
url: /guides/stork-kubernetes
2994-
- title: Using WebSockets
2994+
- title: Using WebSockets with Undertow
29952995
filename: websockets.adoc
29962996
summary: This guide explains how your Quarkus application can utilize web sockets to create interactive web applications.
29972997
categories: web

_data/versioned/main/index/relations.yaml

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8655,7 +8655,7 @@
86558655
url: /guides/tls-registry-reference
86568656
type: reference
86578657
matches: 1
8658-
- title: Using WebSockets
8658+
- title: Using WebSockets with Undertow
86598659
url: /guides/websockets
86608660
type: guide
86618661
matches: 1
@@ -10944,7 +10944,7 @@
1094410944
url: /guides/reactive-routes
1094510945
type: guide
1094610946
matches: 1
10947-
- title: Using WebSockets
10947+
- title: Using WebSockets with Undertow
1094810948
url: /guides/websockets
1094910949
type: guide
1095010950
matches: 1
@@ -13882,7 +13882,7 @@
1388213882
url: /guides/tls-registry-reference
1388313883
type: reference
1388413884
matches: 1
13885-
- title: Using WebSockets
13885+
- title: Using WebSockets with Undertow
1388613886
url: /guides/websockets
1388713887
type: guide
1388813888
matches: 1
@@ -23372,7 +23372,7 @@
2337223372
url: /guides/tls-registry-reference
2337323373
type: reference
2337423374
matches: 1
23375-
- title: Using WebSockets
23375+
- title: Using WebSockets with Undertow
2337623376
url: /guides/websockets
2337723377
type: guide
2337823378
matches: 1
@@ -23426,7 +23426,7 @@
2342623426
url: /guides/tls-registry-reference
2342723427
type: reference
2342823428
matches: 1
23429-
- title: Using WebSockets
23429+
- title: Using WebSockets with Undertow
2343023430
url: /guides/websockets
2343123431
type: guide
2343223432
matches: 1
@@ -23470,7 +23470,7 @@
2347023470
url: /guides/websockets-next-tutorial
2347123471
type: tutorial
2347223472
matches: 2
23473-
- title: Using WebSockets
23473+
- title: Using WebSockets with Undertow
2347423474
url: /guides/websockets
2347523475
type: guide
2347623476
matches: 2
@@ -23501,7 +23501,7 @@
2350123501
matches: 1
2350223502
/guides/websockets-next-tutorial:
2350323503
sameTopics:
23504-
- title: Using WebSockets
23504+
- title: Using WebSockets with Undertow
2350523505
url: /guides/websockets
2350623506
type: guide
2350723507
matches: 2

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -83977,9 +83977,9 @@ endif::add-copy-button-to-config-props[]
8397783977
--
8397883978
The name of the TLS configuration to use.
8397983979

83980-
If not set and the default TLS configuration is configured (`quarkus.tls.++*++`) then that will be used. If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown.
83980+
If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown. The default TLS configuration will be ignored.
8398183981

83982-
If no TLS configuration is set, then the keys-tore, trust-store, etc. properties will be used.
83982+
If no named TLS configuration is set, then the key-store, trust-store, etc. properties will be used.
8398383983

8398483984
This property is not applicable to the RESTEasy Client.
8398583985

@@ -84725,9 +84725,9 @@ endif::add-copy-button-to-config-props[]
8472584725
--
8472684726
The name of the TLS configuration to use.
8472784727

84728-
If not set and the default TLS configuration is configured (`quarkus.tls.++*++`) then that will be used. If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown.
84728+
If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown. The default TLS configuration will be ignored.
8472984729

84730-
If no TLS configuration is set, then the keys-tore, trust-store, etc. properties will be used.
84730+
If no named TLS configuration is set, then the key-store, trust-store, etc. properties will be used.
8473184731

8473284732
This property is not applicable to the RESTEasy Client.
8473384733

_generated-doc/main/config/quarkus-rest-client-config.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -650,9 +650,9 @@ endif::add-copy-button-to-config-props[]
650650
--
651651
The name of the TLS configuration to use.
652652

653-
If not set and the default TLS configuration is configured (`quarkus.tls.++*++`) then that will be used. If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown.
653+
If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown. The default TLS configuration will be ignored.
654654

655-
If no TLS configuration is set, then the keys-tore, trust-store, etc. properties will be used.
655+
If no named TLS configuration is set, then the key-store, trust-store, etc. properties will be used.
656656

657657
This property is not applicable to the RESTEasy Client.
658658

@@ -1398,9 +1398,9 @@ endif::add-copy-button-to-config-props[]
13981398
--
13991399
The name of the TLS configuration to use.
14001400

1401-
If not set and the default TLS configuration is configured (`quarkus.tls.++*++`) then that will be used. If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown.
1401+
If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown. The default TLS configuration will be ignored.
14021402

1403-
If no TLS configuration is set, then the keys-tore, trust-store, etc. properties will be used.
1403+
If no named TLS configuration is set, then the key-store, trust-store, etc. properties will be used.
14041404

14051405
This property is not applicable to the RESTEasy Client.
14061406

_generated-doc/main/config/quarkus-rest-client-config_quarkus.rest-client.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -650,9 +650,9 @@ endif::add-copy-button-to-config-props[]
650650
--
651651
The name of the TLS configuration to use.
652652

653-
If not set and the default TLS configuration is configured (`quarkus.tls.++*++`) then that will be used. If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown.
653+
If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown. The default TLS configuration will be ignored.
654654

655-
If no TLS configuration is set, then the keys-tore, trust-store, etc. properties will be used.
655+
If no named TLS configuration is set, then the key-store, trust-store, etc. properties will be used.
656656

657657
This property is not applicable to the RESTEasy Client.
658658

@@ -1398,9 +1398,9 @@ endif::add-copy-button-to-config-props[]
13981398
--
13991399
The name of the TLS configuration to use.
14001400

1401-
If not set and the default TLS configuration is configured (`quarkus.tls.++*++`) then that will be used. If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown.
1401+
If a name is configured, it uses the configuration from `quarkus.tls.<name>.++*++` If a name is configured, but no TLS configuration is found with that name then an error will be thrown. The default TLS configuration will be ignored.
14021402

1403-
If no TLS configuration is set, then the keys-tore, trust-store, etc. properties will be used.
1403+
If no named TLS configuration is set, then the key-store, trust-store, etc. properties will be used.
14041404

14051405
This property is not applicable to the RESTEasy Client.
14061406

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9479,6 +9479,10 @@ This hold all files in the user's project root
94799479
94809480
_No Javadoc found_
94819481

9482+
`java.nio.file.Path rootPath`
9483+
9484+
_No Javadoc found_
9485+
94829486

94839487
|===
94849488
== Vert.x - HTTP - SPI

_versions/main/guides/building-native-image.adoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -75,10 +75,10 @@ This is particularly important when it comes to conformance and security.
7575

7676
* Mandrel is recommended for building native executables that target Linux containerized environments.
7777
This means that Mandrel users are encouraged to use containers to build their native executables.
78-
If you are building native executables for macOS,
78+
If you are building native executables for macOS on amd64/x86,
7979
you should consider using Oracle GraalVM instead,
8080
because Mandrel does not currently target this platform.
81-
Building native executables directly on bare metal Linux or Windows is possible,
81+
Building native executables directly on bare metal Linux, macOS (on M processors), or Windows is possible,
8282
with details available in the https://github.com/graalvm/mandrel/blob/default/README.md[Mandrel README]
8383
and https://github.com/graalvm/mandrel/releases[Mandrel releases].
8484

@@ -111,7 +111,7 @@ We recommend the _community edition_ of GraalVM. For example, install it with `s
111111
export GRAALVM_HOME=$HOME/Development/mandrel/
112112
----
113113
+
114-
On macOS (not supported by Mandrel), point the variable to the `Home` sub-directory:
114+
On macOS (amd64/x86 based Macs not supported), point the variable to the `Home` sub-directory:
115115
+
116116
[source,bash]
117117
----

_versions/main/guides/security-openid-connect-dev-services.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,11 @@ KeyCloak Dev Services Starting:
4242
2021-11-02 17:14:44,170 INFO [io.qua.oid.dep.dev.key.KeycloakDevServicesProcessor] (build-10) Dev Services for Keycloak started.
4343
----
4444

45+
[NOTE]
46+
====
47+
Adding the `quarkus.keycloak.devservices.java-opts=-XX:UseSVE=0` configuration property may help to workaround Keycloak Dev Services startup problems on some Mac OS systems.
48+
====
49+
4550
[IMPORTANT]
4651
====
4752
When logging in to the Keycloak admin console, the username is `admin`, and the password is `admin`.

_versions/main/guides/tls-registry-reference.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,12 @@ Each named TLS configuration, or "TLS bucket," must provide its own properties.
5555
For instance, `quarkus.tls.reload-period` will only be applied to the default TLS configuration.
5656
====
5757

58+
[IMPORTANT]
59+
====
60+
As described in detail link:https://github.com/quarkusio/quarkus/blob/main/adr/0004-using-the-tls-registry-for-clients.adoc#configuring-clients-with-the-tls-registry[here], Quarkus client extensions (REST, GRPC, etc) ignore properties, defined in default (ie unnamed) TLS configuration.
61+
The only exception is `quarkus.tls.trust-all` property.
62+
====
63+
5864
=== Configuring HTTPS for a HTTP server
5965

6066
To ensure secure client-server communication, the client is often required to verify the server's authenticity.

_versions/main/guides/websockets-next-reference.adoc

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ https://github.com/quarkusio/quarkus/tree/main/docs/src/main/asciidoc
55
////
66
[id="websockets-next-reference-guide"]
77
= WebSockets Next reference guide
8-
:extension-status: preview
98
include::_attributes.adoc[]
109
:numbered:
1110
:sectnums:
@@ -14,8 +13,6 @@ include::_attributes.adoc[]
1413
:topics: web,websockets
1514
:extensions: io.quarkus:quarkus-websockets-next
1615

17-
include::{includes}/extension-status.adoc[]
18-
1916
The `quarkus-websockets-next` extension provides a modern declarative API to define WebSocket server and client endpoints.
2017

2118
== The WebSocket protocol

0 commit comments

Comments
 (0)