Documentation: for consistency, convert "JETTY_HOME" attribute to "jetty-home" (#9152)

This commit is contained in:
Greg Poulos 2023-01-17 09:44:11 -05:00 committed by GitHub
parent a4ee42944b
commit e9f31157ad
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
23 changed files with 30 additions and 30 deletions

View File

@ -2,4 +2,4 @@
// See https://github.com/asciidoctor/asciidoctor-intellij-plugin/wiki/Support-project-specific-configurations // See https://github.com/asciidoctor/asciidoctor-intellij-plugin/wiki/Support-project-specific-configurations
:experimental: :experimental:
:imagesdir: images :imagesdir: images
:JETTY_HOME: ../../../../../../../jetty-home/target/jetty-home :jetty-home: ../../../../../../../jetty-home/target/jetty-home

View File

@ -39,7 +39,7 @@ own custom link:https://docs.oracle.com/javase/7/docs/api/javax/security/auth/sp
Enable the `ee{8,9,10}-jaas` module appropriate for your EE platform: Enable the `ee{8,9,10}-jaas` module appropriate for your EE platform:
---- ----
include::{JETTY_HOME}/modules/ee10-jaas.mod[] include::{jetty-home}/modules/ee10-jaas.mod[]
---- ----
The configurable items in the resulting `$jetty.base/start.d/jaas.ini` file are: The configurable items in the resulting `$jetty.base/start.d/jaas.ini` file are:

View File

@ -27,7 +27,7 @@ Only modules conforming to the "Servlet Container Profile" with the ServerAuthMo
Enable the `jaspi` module: Enable the `jaspi` module:
---- ----
include::{JETTY_HOME}/modules/ee10-jaspi.mod[] include::{jetty-home}/modules/ee10-jaspi.mod[]
---- ----
[[og-jaspi-xml]] [[og-jaspi-xml]]
@ -48,7 +48,7 @@ The following example uses Jetty's EE10 implementation of `AuthConfigProvider` t
[source, xml] [source, xml]
---- ----
include::{JETTY_HOME}/etc/jaspi/jetty-ee10-jaspi-demo.xml[] include::{jetty-home}/etc/jaspi/jetty-ee10-jaspi-demo.xml[]
---- ----
Other custom or 3rd party modules that are compatible with the `ServerAuthModule` interface in JASPI can be registered in the same way. Other custom or 3rd party modules that are compatible with the `ServerAuthModule` interface in JASPI can be registered in the same way.
@ -66,5 +66,5 @@ This custom module must reference an XML file which sets a new instance of the `
For an example of this see the `ee{9,10}-jaspi-default-auth-config-factory` module, which provides the default implementation used by Jetty. For an example of this see the `ee{9,10}-jaspi-default-auth-config-factory` module, which provides the default implementation used by Jetty.
---- ----
include::{JETTY_HOME}/modules/ee10-jaspi-default-auth-config-factory.mod[] include::{jetty-home}/modules/ee10-jaspi-default-auth-config-factory.mod[]
---- ----

View File

@ -17,7 +17,7 @@
Jetty supports JSP via the `ee{8,9,10}-jsp` modules, which are based on Apache Jasper: Jetty supports JSP via the `ee{8,9,10}-jsp` modules, which are based on Apache Jasper:
---- ----
include::{JETTY_HOME}/modules/ee10-jsp.mod[] include::{jetty-home}/modules/ee10-jsp.mod[]
---- ----
Logging has been bridged to Jetty logging, so you can enable logging for the `org.apache.jasper` package, subpackages and classes as usual. Logging has been bridged to Jetty logging, so you can enable logging for the `org.apache.jasper` package, subpackages and classes as usual.
@ -175,7 +175,7 @@ If the value you set doesn't take effect, try using all lower case instead of ca
The JavaServer Pages Standard Tag Library (JSTL) is part of the Jetty distribution, and is available via the `ee{8,9,10}-jstl` modules: The JavaServer Pages Standard Tag Library (JSTL) is part of the Jetty distribution, and is available via the `ee{8,9,10}-jstl` modules:
---- ----
include::{JETTY_HOME}/modules/ee10-jstl.mod[] include::{jetty-home}/modules/ee10-jstl.mod[]
---- ----
When enabled, Jetty will make the JSTL tags available for your webapps. When enabled, Jetty will make the JSTL tags available for your webapps.

View File

@ -21,5 +21,5 @@ You can configure the list of application protocols negotiated by the ALPN mecha
The module properties are: The module properties are:
---- ----
include::{JETTY_HOME}/modules/alpn.mod[tags=documentation] include::{jetty-home}/modules/alpn.mod[tags=documentation]
---- ----

View File

@ -28,7 +28,7 @@ Excess buffers will not be pooled and will be eventually garbage collected.
The module file is `$JETTY_HOME/modules/bytebufferpool.mod`: The module file is `$JETTY_HOME/modules/bytebufferpool.mod`:
---- ----
include::{JETTY_HOME}/modules/bytebufferpool.mod[] include::{jetty-home}/modules/bytebufferpool.mod[]
---- ----
Among the configurable properties, the most relevant are: Among the configurable properties, the most relevant are:

View File

@ -22,5 +22,5 @@ Old, rolled files are kept for the number of days specified by the `jetty.consol
The module properties are: The module properties are:
---- ----
include::{JETTY_HOME}/modules/console-capture.mod[tags=documentation] include::{jetty-home}/modules/console-capture.mod[tags=documentation]
---- ----

View File

@ -21,7 +21,7 @@ Files or directories added in this monitored directory cause the `DeploymentMana
The module file is `$JETTY_HOME/modules/deploy.mod`: The module file is `$JETTY_HOME/modules/deploy.mod`:
---- ----
include::{JETTY_HOME}/modules/deploy.mod[] include::{jetty-home}/modules/deploy.mod[]
---- ----
Among the configurable properties, the most relevant are: Among the configurable properties, the most relevant are:

View File

@ -19,5 +19,5 @@ The `http-forwarded` module provides support for processing the `Forwarded` HTTP
The module properties are: The module properties are:
---- ----
include::{JETTY_HOME}/modules/http-forwarded.mod[tags=documentation] include::{jetty-home}/modules/http-forwarded.mod[tags=documentation]
---- ----

View File

@ -19,7 +19,7 @@ The `http` module provides the clear-text connector and support for the clear-te
The module properties to configure the clear-text connector are: The module properties to configure the clear-text connector are:
---- ----
include::{JETTY_HOME}/modules/http.mod[tags=documentation] include::{jetty-home}/modules/http.mod[tags=documentation]
---- ----
Among the configurable properties, the most relevant are: Among the configurable properties, the most relevant are:

View File

@ -19,7 +19,7 @@ The `http2` module enables support for the secure HTTP/2 protocol.
The module properties are: The module properties are:
---- ----
include::{JETTY_HOME}/modules/http2.mod[tags=documentation] include::{jetty-home}/modules/http2.mod[tags=documentation]
---- ----
// tag::rate-control[] // tag::rate-control[]

View File

@ -19,7 +19,7 @@ The `http2c` module enables support for the clear-text HTTP/2 protocol.
The module properties are: The module properties are:
---- ----
include::{JETTY_HOME}/modules/http2c.mod[tags=documentation] include::{jetty-home}/modules/http2c.mod[tags=documentation]
---- ----
include::module-http2.adoc[tags=rate-control] include::module-http2.adoc[tags=rate-control]

View File

@ -19,5 +19,5 @@ The `http3` module enables support for the HTTP/3 protocol.
The module properties are: The module properties are:
---- ----
include::{JETTY_HOME}/modules/http3.mod[tags=documentation] include::{jetty-home}/modules/http3.mod[tags=documentation]
---- ----

View File

@ -19,5 +19,5 @@ The `https` module provides the HTTP/1.1 protocol to the xref:og-module-ssl[`ssl
The module file is `$JETTY_HOME/modules/https.mod`: The module file is `$JETTY_HOME/modules/https.mod`:
---- ----
include::{JETTY_HOME}/modules/https.mod[] include::{jetty-home}/modules/https.mod[]
---- ----

View File

@ -19,7 +19,7 @@ The `jmx-remote` module provides remote access to JMX clients.
The module properties to configure remote JMX connector are: The module properties to configure remote JMX connector are:
---- ----
include::{JETTY_HOME}/modules/jmx-remote.mod[tags=documentation] include::{jetty-home}/modules/jmx-remote.mod[tags=documentation]
---- ----
The system property `java.rmi.server.hostname` is specified with the usual notation, prepending a `-D` in front of the system property name. The system property `java.rmi.server.hostname` is specified with the usual notation, prepending a `-D` in front of the system property name.

View File

@ -19,7 +19,7 @@ The `requestlog` module provides HTTP request/response logging in the standard l
The module properties are: The module properties are:
---- ----
include::{JETTY_HOME}/modules/requestlog.mod[tags=documentation] include::{jetty-home}/modules/requestlog.mod[tags=documentation]
---- ----
The property `jetty.requestlog.formatString` can be customized using format codes. The property `jetty.requestlog.formatString` can be customized using format codes.

View File

@ -31,7 +31,7 @@ See also the xref:og-protocols[protocols section] for more information about the
The module properties to configure generic HTTP properties are listed below. Mostly they frequently apply to HTTP/1, HTTP/2 and HTTP/3, but some parameters are version specific: The module properties to configure generic HTTP properties are listed below. Mostly they frequently apply to HTTP/1, HTTP/2 and HTTP/3, but some parameters are version specific:
---- ----
include::{JETTY_HOME}/modules/server.mod[tags=documentation-http-config] include::{jetty-home}/modules/server.mod[tags=documentation-http-config]
---- ----
Among the configurable properties, the most relevant are: Among the configurable properties, the most relevant are:
@ -58,7 +58,7 @@ Server: Jetty({version})
The module properties to configure the Jetty server are: The module properties to configure the Jetty server are:
---- ----
include::{JETTY_HOME}/modules/server.mod[tags=documentation-server-config] include::{jetty-home}/modules/server.mod[tags=documentation-server-config]
---- ----
Among the configurable properties, the most relevant are: Among the configurable properties, the most relevant are:
@ -83,7 +83,7 @@ The Jetty server strives to keep up with the latest link:https://en.wikipedia.or
The module properties to configure the Jetty server compliance are: The module properties to configure the Jetty server compliance are:
---- ----
include::{JETTY_HOME}/modules/server.mod[tags=documentation-server-compliance] include::{jetty-home}/modules/server.mod[tags=documentation-server-compliance]
---- ----
Among the configurable properties, the most relevant are: Among the configurable properties, the most relevant are:
@ -128,5 +128,5 @@ For more information about `CookieCompliance` see also xref:{prog-guide}#pg-serv
The module properties to configure the Jetty server scheduler are: The module properties to configure the Jetty server scheduler are:
---- ----
include::{JETTY_HOME}/modules/server.mod[tags=documentation-scheduler-config] include::{jetty-home}/modules/server.mod[tags=documentation-scheduler-config]
---- ----

View File

@ -20,5 +20,5 @@ When the scanning detects a change to the KeyStore file, the correspondent `SslC
The module properties are: The module properties are:
---- ----
include::{JETTY_HOME}/modules/ssl-reload.mod[tags=documentation] include::{jetty-home}/modules/ssl-reload.mod[tags=documentation]
---- ----

View File

@ -22,7 +22,7 @@ The `ssl` module provides the secure connector, and allows you to configure the
The module properties to configure the secure connector are: The module properties to configure the secure connector are:
---- ----
include::{JETTY_HOME}/modules/ssl.mod[tags=documentation-connector] include::{jetty-home}/modules/ssl.mod[tags=documentation-connector]
---- ----
Among the configurable properties, the most relevant are: Among the configurable properties, the most relevant are:
@ -41,7 +41,7 @@ Refer to xref:og-module-http-selectors[this section] for more information about
The module properties to configure the KeyStore and TLS parameters are: The module properties to configure the KeyStore and TLS parameters are:
---- ----
include::{JETTY_HOME}/modules/ssl.mod[tags=documentation-ssl-context] include::{jetty-home}/modules/ssl.mod[tags=documentation-ssl-context]
---- ----
[[og-module-ssl-keystore-tls]] [[og-module-ssl-keystore-tls]]

View File

@ -20,7 +20,7 @@ The KeyStore file is automatically deleted when the JVM exits, and re-created wh
The module file is `$JETTY_HOME/modules/test-keystore.mod`: The module file is `$JETTY_HOME/modules/test-keystore.mod`:
---- ----
include::{JETTY_HOME}/modules/test-keystore.mod[] include::{jetty-home}/modules/test-keystore.mod[]
---- ----
Note how properties `jetty.sslContext.keyStorePath` and `jetty.sslContext.keyStorePassword` are configured, only if not already set (via the `?=` operator), directly in the module file, rather than in a `+*.ini+` file. Note how properties `jetty.sslContext.keyStorePath` and `jetty.sslContext.keyStorePassword` are configured, only if not already set (via the `?=` operator), directly in the module file, rather than in a `+*.ini+` file.

View File

@ -23,7 +23,7 @@ Refer to the xref:og-module-threadpool[`threadpool`] Jetty module for the genera
The module properties to configure the thread pool are: The module properties to configure the thread pool are:
---- ----
include::{JETTY_HOME}/modules/threadpool-virtual-preview.mod[tags=documentation] include::{jetty-home}/modules/threadpool-virtual-preview.mod[tags=documentation]
---- ----
The specific properties to configure virtual threads are: The specific properties to configure virtual threads are:

View File

@ -24,7 +24,7 @@ Start with the default value of `maxThreads`, and tune for larger values if need
The module properties to configure the thread pool are: The module properties to configure the thread pool are:
---- ----
include::{JETTY_HOME}/modules/threadpool.mod[tags=documentation] include::{jetty-home}/modules/threadpool.mod[tags=documentation]
---- ----
Among the configurable properties, the most relevant are: Among the configurable properties, the most relevant are:

View File

@ -25,5 +25,5 @@ See link:https://www.iana.org/assignments/well-known-uris/well-known-uris.xhtml[
The module properties are: The module properties are:
---- ----
include::{JETTY_HOME}/modules/well-known.mod[tags=documentation] include::{jetty-home}/modules/well-known.mod[tags=documentation]
---- ----