This is an automated email from the ASF dual-hosted git repository.
rzo1 pushed a commit to branch tomee-10.x
in repository https://gitbox.apache.org/repos/asf/tomee.git
The following commit(s) were added to refs/heads/tomee-10.x by this push:
new 4a74cd7e6d Convert Markdown to AsciiDoc style (#2548)
4a74cd7e6d is described below
commit 4a74cd7e6d90116e700cf0f932daa4082208a096
Author: Martin Wiesner <[email protected]>
AuthorDate: Mon Mar 9 21:46:23 2026 +0100
Convert Markdown to AsciiDoc style (#2548)
(cherry picked from commit c7753cfa74414cd8905b257829dbf684a4bbc220)
---
.gitignore | 4 +-
docs/admin/configuration/log4j2.adoc | 82 ++++++++++++++++----------------
docs/configuring-datasources-xa.adoc | 90 ++++++++++++++++++++----------------
docs/containers-and-resources.adoc | 20 ++++----
docs/custom-injection.adoc | 6 +--
docs/deamon/lin-service.adoc | 5 +-
docs/deamon/win-service.adoc | 63 +++++++++++++------------
docs/jpa-concepts.adoc | 6 +--
docs/maven/index.adoc | 6 +--
docs/microprofile/jwt.adoc | 6 +--
docs/spring-and-openejb-3.0.adoc | 2 +-
docs/spring-ejb-and-jpa.adoc | 10 ++--
docs/tomee-maven-plugin.adoc | 6 +--
docs/validation-tool.adoc | 2 +-
14 files changed, 163 insertions(+), 145 deletions(-)
diff --git a/.gitignore b/.gitignore
index 76c4985205..e99f41dd79 100644
--- a/.gitignore
+++ b/.gitignore
@@ -21,4 +21,6 @@ tck/**/temp
examples/jaxrs-json-provider-jettison/temp/
transformer/jakartaee-prototype/
transformer/transformer-0.1.0-SNAPSHOT/
-*.zip
\ No newline at end of file
+*.zip
+.claude
+CLAUDE.md
\ No newline at end of file
diff --git a/docs/admin/configuration/log4j2.adoc
b/docs/admin/configuration/log4j2.adoc
index f3423a30ac..8f0f6f2bee 100644
--- a/docs/admin/configuration/log4j2.adoc
+++ b/docs/admin/configuration/log4j2.adoc
@@ -20,26 +20,29 @@
https://repo1.maven.org/maven2/org/apache/logging/log4j/log4j-jul/2.17.1/log4j-j
Add these to the TomEE bin directory. Add the following to setenv.sh on *nix:
-```
- JAVA_OPTS="$JAVA_OPTS
-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager"
- LOGGING_CONFIG="-DnoOp"
-
LOGGING_MANAGER="-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager"
-
CLASSPATH=".:$CATALINA_BASE/bin:$CATALINA_BASE/bin/log4j-core-2.17.1.jar:$CATALINA_BASE/bin/log4j-api-2.17.1.jar:$CATALINA_BASE/bin/log4j-jul-2.17.1.jar"
-```
+[source]
+----
+JAVA_OPTS="$JAVA_OPTS
-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager"
+LOGGING_CONFIG="-DnoOp"
+LOGGING_MANAGER="-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager"
+CLASSPATH=".:$CATALINA_BASE/bin:$CATALINA_BASE/bin/log4j-core-2.17.1.jar:$CATALINA_BASE/bin/log4j-api-2.17.1.jar:$CATALINA_BASE/bin/log4j-jul-2.17.1.jar"
+----
or add the following to setenv.bat on Windows:
-```
- @echo off
- set "JAVA_OPTS=%JAVA_OPTS%
-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager
- set LOGGING_CONFIG=-DnoOpp
- set
LOGGING_MANAGER=-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager
- set
"CLASSPATH=.;%CATALINA_BASE%\bin;%CATALINA_BASE%\bin\log4j-core-2.17.1.jar;%CATALINA_BASE%\bin\log4j-api-2.17.1.jar;%CATALINA_BASE%\bin\log4j-jul-2.17.1.jar"
-```
+[source]
+----
+@echo off
+set "JAVA_OPTS=%JAVA_OPTS%
-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager
+set LOGGING_CONFIG=-DnoOpp
+set
LOGGING_MANAGER=-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager
+set
"CLASSPATH=.;%CATALINA_BASE%\bin;%CATALINA_BASE%\bin\log4j-core-2.17.1.jar;%CATALINA_BASE%\bin\log4j-api-2.17.1.jar;%CATALINA_BASE%\bin\log4j-jul-2.17.1.jar"
+----
If you are using the TomEE Maven Plugin, it can be configured as follows:
-```
+[source]
+----
<plugin>
<groupId>org.apache.tomee.maven</groupId>
<artifactId>tomee-maven-plugin</artifactId>
@@ -58,7 +61,7 @@ If you are using the TomEE Maven Plugin, it can be configured
as follows:
</systemVariables>
</configuration>
</plugin>
-```
+----
Take care to match the jar filenames if you have downloaded jars for a
slightly different version of log4j2.
@@ -66,27 +69,28 @@ Take care to match the jar filenames if you have downloaded
jars for a slightly
Add your log4j2.xml config in the `bin` directory. Here's a simple config you
can use to help you get started:
-```
- <?xml version="1.0" encoding="UTF-8" ?>
- <Configuration status="warn" name="catalina" packages="">
- <Appenders>
- <Console name="console" target="SYSTEM_OUT">
- <PatternLayout pattern="%d %p %c{1.} [%t] %m%n" />
- </Console>
- <File name="catalina"
fileName="${sys:catalina.base}/logs/catalina.log">
- <PatternLayout>
- <Pattern>%d %p %c{1.} [%t] %m%n</Pattern>
- </PatternLayout>
- </File>
- <Async name="Async">
- <AppenderRef ref="catalina" />
- </Async>
- </Appenders>
- <Loggers>
- <Root level="info">
- <AppenderRef ref="Async" />
- <AppenderRef ref="console" />
- </Root>
- </Loggers>
- </Configuration>
-```
\ No newline at end of file
+[source]
+----
+<?xml version="1.0" encoding="UTF-8" ?>
+<Configuration status="warn" name="catalina" packages="">
+ <Appenders>
+ <Console name="console" target="SYSTEM_OUT">
+ <PatternLayout pattern="%d %p %c{1.} [%t] %m%n" />
+ </Console>
+ <File name="catalina"
fileName="${sys:catalina.base}/logs/catalina.log">
+ <PatternLayout>
+ <Pattern>%d %p %c{1.} [%t] %m%n</Pattern>
+ </PatternLayout>
+ </File>
+ <Async name="Async">
+ <AppenderRef ref="catalina" />
+ </Async>
+ </Appenders>
+ <Loggers>
+ <Root level="info">
+ <AppenderRef ref="Async" />
+ <AppenderRef ref="console" />
+ </Root>
+ </Loggers>
+</Configuration>
+----
\ No newline at end of file
diff --git a/docs/configuring-datasources-xa.adoc
b/docs/configuring-datasources-xa.adoc
index 17fb9a4462..76c0ebb361 100644
--- a/docs/configuring-datasources-xa.adoc
+++ b/docs/configuring-datasources-xa.adoc
@@ -45,17 +45,19 @@ or
This will give a complete list of paramaters that are available for the XA
datasource. We'll simply use the `URL` paramater for the datasource.
-```
- <Resource id="demo/jdbc/XADataSourceXA" type="XADataSource"
class-name="com.mysql.cj.jdbc.MysqlXADataSource">
+[source]
+----
+<Resource id="demo/jdbc/XADataSourceXA" type="XADataSource"
class-name="com.mysql.cj.jdbc.MysqlXADataSource">
Url jdbc:mysql://192.168.37.202:3306/movie
- </Resource>
-```
+</Resource>
+----
Next, we create a JtaManaged datasource as we normally would, and point it to
the
XA datasource using the `XaDataSource` attribute.
-```
- <Resource id="demo/jdbc/XADataSource" type="DataSource">
+[source]
+----
+<Resource id="demo/jdbc/XADataSource" type="DataSource">
XaDataSource demo/jdbc/XADataSourceXA
JdbcDriver com.mysql.cj.jdbc.Driver
JdbcUrl jdbc:mysql://192.168.37.202:3306/movie
@@ -72,13 +74,14 @@ XA datasource using the `XaDataSource` attribute.
TimeBetweenEvictionRuns 1 minute
MaxWaitTime 0 seconds
ValidationQuery select 1
- </Resource>
-```
+</Resource>
+----
And finally, a non-JTA managed datasource as well:
-```
- <Resource id="demo/jdbc/XADataSourceUnmanaged" type="DataSource">
+[source]
+----
+<Resource id="demo/jdbc/XADataSourceUnmanaged" type="DataSource">
JdbcDriver com.mysql.cj.jdbc.Driver
JdbcUrl jdbc:mysql://192.168.37.202:3306/movie
UserName root
@@ -94,15 +97,16 @@ And finally, a non-JTA managed datasource as well:
TimeBetweenEvictionRuns 1 minute
MaxWaitTime 0 seconds
ValidationQuery select 1
- </Resource>
-```
+</Resource>
+----
== Sample configs
=== Oracle
-```
- <Resource id="demo/jdbc/XADataSource" type="DataSource">
+[source]
+----
+<Resource id="demo/jdbc/XADataSource" type="DataSource">
XaDataSource demo/jdbc/XADataSourceXA
JdbcDriver oracle.jdbc.OracleDriver
JdbcUrl jdbc:oracle:thin:@//192.168.37.214:1521/XE
@@ -121,13 +125,13 @@ And finally, a non-JTA managed datasource as well:
PoolPreparedStatements true
MaxOpenPreparedStatements 1024
ValidationQuery select 1 from dual
- </Resource>
+</Resource>
- <Resource id="demo/jdbc/XADataSourceXA" type="XADataSource"
class-name="oracle.jdbc.xa.client.OracleXADataSource">
+<Resource id="demo/jdbc/XADataSourceXA" type="XADataSource"
class-name="oracle.jdbc.xa.client.OracleXADataSource">
Url jdbc:oracle:thin:@//192.168.37.214:1521/XE
- </Resource>
+</Resource>
- <Resource id="demo/jdbc/XADataSourceUnmanaged" type="DataSource">
+<Resource id="demo/jdbc/XADataSourceUnmanaged" type="DataSource">
JdbcDriver oracle.jdbc.OracleDriver
JdbcUrl jdbc:oracle:thin:@//192.168.37.214:1521/XE
UserName system
@@ -145,13 +149,14 @@ And finally, a non-JTA managed datasource as well:
PoolPreparedStatements true
MaxOpenPreparedStatements 1024
ValidationQuery select 1 from dual
- </Resource>
-```
+</Resource>
+----
=== Microsoft SQL Server
-```
- <Resource id="demo/jdbc/XADataSource" type="DataSource">
+[source]
+----
+<Resource id="demo/jdbc/XADataSource" type="DataSource">
XaDataSource demo/jdbc/XADataSourceXA
JdbcDriver com.microsoft.sqlserver.jdbc.SQLServerDriver
JdbcUrl jdbc:sqlserver://yourserver.database.windows.net:1433;database=test
@@ -170,13 +175,13 @@ And finally, a non-JTA managed datasource as well:
PoolPreparedStatements true
MaxOpenPreparedStatements 1024
ValidationQuery select 1
- </Resource>
+</Resource>
- <Resource id="demo/jdbc/XADataSourceXA" type="XADataSource"
class-name="com.microsoft.sqlserver.jdbc.SQLServerXADataSource">
+<Resource id="demo/jdbc/XADataSourceXA" type="XADataSource"
class-name="com.microsoft.sqlserver.jdbc.SQLServerXADataSource">
URL jdbc:sqlserver://yourserver.database.windows.net:1433;database=test
- </Resource>
+</Resource>
- <Resource id="demo/jdbc/XADataSourceUnmanaged" type="DataSource">
+<Resource id="demo/jdbc/XADataSourceUnmanaged" type="DataSource">
JdbcDriver com.microsoft.sqlserver.jdbc.SQLServerDriver
JdbcUrl jdbc:sqlserver://yourserver.database.windows.net:1433;database=test
UserName sa
@@ -194,15 +199,16 @@ And finally, a non-JTA managed datasource as well:
PoolPreparedStatements true
MaxOpenPreparedStatements 1024
ValidationQuery select 1
- </Resource>
-```
+</Resource>
+----
Please note that using XA with Microsoft SQL Server requires the MS DTC to be
configured correctly, and sqljdbc_xa.dll to be installed. For instructions,
please see this Microsoft article:
https://docs.microsoft.com/en-us/sql/connect/jdbc/understanding-xa-transactions?view=sql-server-2017
=== MySQL
-```
- <resources>
+[source]
+----
+<resources>
<Resource id="demo/jdbc/XADataSource" type="DataSource">
XaDataSource demo/jdbc/XADataSourceXA
JdbcDriver com.mysql.cj.jdbc.Driver
@@ -243,16 +249,17 @@ Please note that using XA with Microsoft SQL Server
requires the MS DTC to be co
MaxWaitTime 0 seconds
ValidationQuery select 1
</Resource>
- </resources>
-```
+</resources>
+----
=== PostgreSQL
-```
- <resources>
+[source]
+----
+<resources>
<Resource id="demo/jdbc/XADataSource" type="DataSource">
XaDataSource demo/jdbc/XADataSourceXA
- JdbcDriver org.postgresql.Driver
+ JdbcDriver org.postgresql.Driver
JdbcUrl jdbc:postgresql://192.168.37.200:5432/movie
username postgres
password mysecretpassword
@@ -294,13 +301,14 @@ Please note that using XA with Microsoft SQL Server
requires the MS DTC to be co
MaxOpenPreparedStatements 1024
ValidationQuery select 1
</Resource>
- </resources>
-```
+</resources>
+----
=== Derby
-```
- <resources>
+[source]
+----
+<resources>
<Resource id="movieDatabaseXA" type="javax.sql.XADataSource"
class-name="org.apache.derby.jdbc.ClientXADataSource">
DatabaseName=testdb
CreateDatabase=create
@@ -346,5 +354,5 @@ Please note that using XA with Microsoft SQL Server
requires the MS DTC to be co
MaxWaitTime=0 seconds
JtaManaged=false
</Resource>
- </resources>
-```
+</resources>
+----
diff --git a/docs/containers-and-resources.adoc
b/docs/containers-and-resources.adoc
index 77a3c1aca2..b229b0ba3b 100644
--- a/docs/containers-and-resources.adoc
+++ b/docs/containers-and-resources.adoc
@@ -29,7 +29,7 @@ Supports the following properties:
| Transaction manager used by the container.
|===
----
+'''
=== BMP_ENTITY
@@ -52,7 +52,7 @@ Supports the following properties:
Default value is `10`.
|===
----
+'''
=== STATELESS
@@ -86,7 +86,7 @@ If `false`, temporary instances are created for one
invocation and then discarde
Default value is `true`.
|===
----
+'''
=== STATEFUL
@@ -125,7 +125,7 @@ Default value is `1000`.
Default value is `100`.
|===
----
+'''
=== MESSAGE
@@ -160,7 +160,7 @@ Default value is
`org.apache.activemq.ra.ActiveMQActivationSpec`.
Default value is `10`.
|===
----
+'''
== Resources
@@ -276,7 +276,7 @@ Default value is `0`.
Default value is `false`.
|===
----
+'''
=== ActiveMQResourceAdapter
@@ -307,7 +307,7 @@ Default value is `vm://localhost?async=true`.
Default value is *Default Unmanaged JDBC Database*.
|===
----
+'''
=== jakarta.jms.ConnectionFactory
@@ -349,7 +349,7 @@ Default value is `5000`.
Default value is `15`.
|===
----
+'''
=== jakarta.jms.Queue
@@ -371,7 +371,7 @@ Supports the following properties:
| Name of the queue.
|===
----
+'''
=== jakarta.jms.Topic
@@ -393,7 +393,7 @@ Supports the following properties:
| Name of the topic.
|===
----
+'''
=== jakarta.mail.Session
diff --git a/docs/custom-injection.adoc b/docs/custom-injection.adoc
index 8b5ddc062f..dd5b3901fb 100644
--- a/docs/custom-injection.adoc
+++ b/docs/custom-injection.adoc
@@ -29,7 +29,7 @@ The source for this example is the "custom-injection"
directory located
in the link:downloads.html[openejb-examples.zip] available on the
http://tomee.apache.org/downloads.html[download page].
-# The Code
+= The Code
== Bean Class
@@ -133,7 +133,7 @@ public enum Pickup {
}
----
-# Test Case
+= Test Case
[source,java]
----
@@ -168,7 +168,7 @@ public class StratocasterTest extends TestCase {
}
----
-# Running it
+= Running it
Running the example is fairly simple. In the "custom-injection"
directory of the openejb:download.html[examples zip], just run:
diff --git a/docs/deamon/lin-service.adoc b/docs/deamon/lin-service.adoc
index c81db6e9b0..1876fbf139 100644
--- a/docs/deamon/lin-service.adoc
+++ b/docs/deamon/lin-service.adoc
@@ -11,7 +11,8 @@ This page demonstrates running as a service with systemd, and
has been tested wi
Create a file `/etc/systemd/system/tomee.service` with the following content:
-```
+[source]
+----
[Unit]
Description=Apache TomEE
After=network.target
@@ -31,7 +32,7 @@ KillSignal=SIGCONT
[Install]
WantedBy=multi-user.target
-```
+----
The file above assumes TomEE is extracted to `/opt/tomee`, and that
`JAVA_HOME` is at `/usr/lib/jvm/jre` - adjust these to match your installation.
diff --git a/docs/deamon/win-service.adoc b/docs/deamon/win-service.adoc
index c9bcd16df1..c2e360b5b5 100644
--- a/docs/deamon/win-service.adoc
+++ b/docs/deamon/win-service.adoc
@@ -33,22 +33,23 @@ credentials for a service user.
`service install [/service-user <user>] [/service-password <password>]
[service name]`
-For example:
-
-```
- C:\Java\apache-tomee-plus-10.0.0-M1-SNAPSHOT\bin>service install TomEE-DEV
- Installing the service 'TomEE-DEV' ...
- Using CATALINA_HOME: "C:\Java\apache-tomee-plus-10.0.0-M1-SNAPSHOT"
- Using CATALINA_BASE: "C:\Java\apache-tomee-plus-10.0.0-M1-SNAPSHOT"
- Using JAVA_HOME: "C:\Java\jdk-10.1.4+11
- Using JRE_HOME: "C:\Java\jdk-10.1.4+11"
- Using JVM: "C:\Java\jdk-10.1.4+11"\bin\server\jvm.dll"
- Using Service User: ""
- Installed, will now configure TomEE
- The service 'TomEE-DEV' has been installed.
-
- C:\Java\apache-tomee-plus-10.0.0-M1-SNAPSHOT\bin>
-```
+For example:
+
+[source]
+----
+C:\Java\apache-tomee-plus-10.1.4\bin>service install TomEE-DEV
+Installing the service 'TomEE-DEV' ...
+Using CATALINA_HOME: "C:\Java\apache-tomee-plus-10.1.4"
+Using CATALINA_BASE: "C:\Java\apache-tomee-plus-10.1.4"
+Using JAVA_HOME: "C:\Java\jdk-10.1.30+7
+Using JRE_HOME: "C:\Java\jdk-10.1.30+7"
+Using JVM: "C:\Java\jdk-10.1.30+7"\bin\server\jvm.dll"
+Using Service User: ""
+Installed, will now configure TomEE
+The service 'TomEE-DEV' has been installed.
+
+C:\Java\apache-tomee-plus-10.1.4\bin>
+----
== Removal
@@ -59,12 +60,13 @@ Removal is similar to installation. First, ensure the
service is stopped.
For example:
-```
- C:\Java\apache-tomee-plus-10.0.0-M1-SNAPSHOT\bin>service remove TomEE-DEV
- The service 'TomEE-DEV' has been removed
+[source]
+----
+C:\Java\apache-tomee-plus-10.1.4\bin>service remove TomEE-DEV
+The service 'TomEE-DEV' has been removed
- C:\Java\apache-tomee-plus-10.0.0-M1-SNAPSHOT\bin>
-```
+C:\Java\apache-tomee-plus-10.1.4\bin>
+----
== Service Accounts
@@ -76,20 +78,21 @@ has more privileges, use:
For example:
-```
-C:\Java\apache-tomee-plus-10.0.0-M1-SNAPSHOT\bin>service install /service-user
LocalSystem TomEE-DEV
+[source]
+----
+C:\Java\apache-tomee-plus-10.1.4\bin>service install /service-user LocalSystem
TomEE-DEV
Installing the service 'TomEE-DEV' ...
-Using CATALINA_HOME: "C:\Java\apache-tomee-plus-10.0.0-M1-SNAPSHOT"
-Using CATALINA_BASE: "C:\Java\apache-tomee-plus-10.0.0-M1-SNAPSHOT"
-Using JAVA_HOME: "C:\Java\jdk-10.1.4+11"
-Using JRE_HOME: "C:\Java\jdk-10.1.4+11"
-Using JVM: "C:\Java\jdk-10.1.4+11"\bin\server\jvm.dll"
+Using CATALINA_HOME: "C:\Java\apache-tomee-plus-10.1.4"
+Using CATALINA_BASE: "C:\Java\apache-tomee-plus-10.1.4"
+Using JAVA_HOME: "C:\Java\jdk-10.1.30+7"
+Using JRE_HOME: "C:\Java\jdk-10.1.30+7"
+Using JVM: "C:\Java\jdk-10.1.30+7"\bin\server\jvm.dll"
Using Service User: "LocalSystem"
Installed, will now configure TomEE
The service 'TomEE-DEV' has been installed.
-C:\Java\apache-tomee-plus-10.0.0-M1-SNAPSHOT\bin>
-```
+C:\Java\apache-tomee-plus-10.1.4\bin>
+----
Alternatively, you may have a specific local or domain user you wish to use
to run the service. You can specify the username and password for
diff --git a/docs/jpa-concepts.adoc b/docs/jpa-concepts.adoc
index 667f55dafb..430f6ca0ff 100644
--- a/docs/jpa-concepts.adoc
+++ b/docs/jpa-concepts.adoc
@@ -65,7 +65,7 @@ PersistenceContext/Cache*
* The PersistenceContext/Cache is *flushed* and cleared at JTA *commit*
time
-# Cache == PersistenceContext
+= Cache == PersistenceContext
The concept of a database cache is an extremely important concept to be
aware of. Without a copy of the data in memory (i.e. a cache) when you
@@ -90,7 +90,7 @@ use exactly one EntityManager instance in your transaction to
ensure
there is only one active PersistenceContext/Cache for the given set of
data active against the current transaction.
-# Caches and Detaching
+= Caches and Detaching
Detaching is the concept of a persistent object *leaving* the
PersistenceContext/Cache. Leaving means that any updates made to the
@@ -127,7 +127,7 @@ Detached object.
Calling EntityManager.merge() will re-attach a Detached object.
-# Valid RESOURCE_LOCAL Unit usage
+= Valid RESOURCE_LOCAL Unit usage
Servlets and EJBs can use RESOURCE_LOCAL persistence units through the
EntityManagerFactory as follows:
diff --git a/docs/maven/index.adoc b/docs/maven/index.adoc
index fba7cece18..22545403d2 100644
--- a/docs/maven/index.adoc
+++ b/docs/maven/index.adoc
@@ -61,7 +61,7 @@ archive, this must be relative to the TomEE server.
console to shut down the server correctly. `reload` is also available
when internal openejb application is deployed.
-### More Tweaks
+=== More Tweaks
The lib tag allows to enrich the container with some additional
libraries.
@@ -76,7 +76,7 @@ with the specified prefix
Note: the name tweak can be used to rename applications too
-### Provisioning Example
+=== Provisioning Example
This plugin is also usable in projects which are not war. For instance,
you can use it in a pom project to set up a TomEE installation, add libraries,
@@ -114,7 +114,7 @@ deploy apps then run the server.
</plugin>
----
-### Auto Reloading Example
+=== Auto Reloading Example
[source,xml]
----
diff --git a/docs/microprofile/jwt.adoc b/docs/microprofile/jwt.adoc
index 2a43a50807..099e0420a1 100644
--- a/docs/microprofile/jwt.adoc
+++ b/docs/microprofile/jwt.adoc
@@ -1,4 +1,4 @@
-# TomEE MicroProfile JWT
+= TomEE MicroProfile JWT
Apache TomEE supports
https://download.eclipse.org/microprofile/microprofile-jwt-auth-2.0/microprofile-jwt-auth-spec-2.0.html[MicroProfile
JWT 2.0], which allows applications to be secured using JWTs.
JWTs may be either:
@@ -36,7 +36,7 @@ Decryption algorithms supported:
- ECDH-ES+A192KW
- ECDH-ES+A256KW
-## MicroProfile JWT Configuration Properties
+== MicroProfile JWT Configuration Properties
Specifying the keys for verifying or decrypting JWTs is done via a
`META-INF/microprofile-config.properties` and the following MP JWT 2.0
Configuration Properties.
@@ -72,7 +72,7 @@ Specifying the keys for verifying or decrypting JWTs is done
via a `META-INF/mic
|===
-## TomEE JWT Configuration Properties
+== TomEE JWT Configuration Properties
In addition to the standard MicroProfile JWT configuration properties above,
the `META-INF/microprofile-config.properties` may contain any of the following
TomEE-specific configuration properties.
diff --git a/docs/spring-and-openejb-3.0.adoc b/docs/spring-and-openejb-3.0.adoc
index 47c8da44c6..6df9234181 100644
--- a/docs/spring-and-openejb-3.0.adoc
+++ b/docs/spring-and-openejb-3.0.adoc
@@ -8,7 +8,7 @@
NOTE: OpenEJB 3.1 and later users should refer to the link:spring.html[Spring]
page.
-# Bootstrapping OpenEJB in Spring
+= Bootstrapping OpenEJB in Spring
If you wish to use OpenEJB inside Spring you can do so pretty easily.
Include OpenEJB and its dependencies in your classpath as you would in a
diff --git a/docs/spring-ejb-and-jpa.adoc b/docs/spring-ejb-and-jpa.adoc
index 5836884e24..68528e8073 100644
--- a/docs/spring-ejb-and-jpa.adoc
+++ b/docs/spring-ejb-and-jpa.adoc
@@ -63,7 +63,7 @@ Spring bean
Simple object used as a clever way to seed the EntityManager (and
really, the database) with persistent _Movie_ objects
-# Required jars
+= Required jars
To set up the integration you'll need:
@@ -83,7 +83,7 @@ directory in your classpath. Then download and add the
[openejb-spring-3.1.jar|http://people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/openejb/openejb-spring/3.1/openejb-spring-3.1.jar]
along with your Spring jars.
-# The Spring xml
+= The Spring xml
Bootstrapping and Configuring OpenEJB is fairly simple.
\{snippet:id=bootstrapping|url=openejb3/examples/spring-integration/src/main/resources/movies.xml|lang=xml}
@@ -103,7 +103,7 @@ and `@PersistenceUnit` (if available). Alternatively, you
may choose to
activate the individual BeanPostProcessors for those annotations.
\{note}
-# The Code
+= The Code
In efforts to keep the example page somewhat short, we'll show just
three beans, each demonstrating a particular relationship.
@@ -118,7 +118,7 @@ The last is the AvailableMovies Spring bean which Shows
Spring -> EJB ->
JPA
\{snippet:id=code|url=openejb3/examples/spring-integration/src/main/java/org/superbiz/spring/AvailableMovies.java|lang=java}
-# The TestCase
+= The TestCase
The JUnit TestCase uses a ClassPathXmlApplicationContext to load the
Spring ApplicationContext. Anything that loads your Spring xml file
@@ -127,7 +127,7 @@ well.
\{snippet:id=code|url=openejb3/examples/spring-integration/src/test/java/org/superbiz/spring/MoviesTest.java|lang=java}
-# Running
+= Running
The source for this example can be downloaded from svn via:
diff --git a/docs/tomee-maven-plugin.adoc b/docs/tomee-maven-plugin.adoc
index fa63c427f6..aa42822697 100644
--- a/docs/tomee-maven-plugin.adoc
+++ b/docs/tomee-maven-plugin.adoc
@@ -61,7 +61,7 @@ archive, this must be relative to the TomEE server.
console to shut down the server correctly. `reload` is also available
when internal openejb application is deployed.
-### More Tweaks
+=== More Tweaks
The lib tag allows to enrich the container with some additional
libraries.
@@ -76,7 +76,7 @@ with the specified prefix
Note: the name tweak can be used to rename applications too
-### Provisioning Example
+=== Provisioning Example
This plugin is also usable in projects which are not war. For instance,
you can use it in a pom project to set up a TomEE installation, add libraries,
@@ -114,7 +114,7 @@ deploy apps then run the server.
</plugin>
----
-### Auto Reloading Example
+=== Auto Reloading Example
[source,xml]
----
diff --git a/docs/validation-tool.adoc b/docs/validation-tool.adoc
index 9b765a3c7a..8c16e3f5fa 100644
--- a/docs/validation-tool.adoc
+++ b/docs/validation-tool.adoc
@@ -99,7 +99,7 @@ Print this help message.
Show examples of how to use the options.
-# COMMON ISSUES
+= COMMON ISSUES
== Mislocated class or NoClassDefFoundError
