Fix Javadoc formatting issues for headings
Headings in method-level Javadoc must be h4 or higher in recent versions of Java.
This commit is contained in:
Sam Brannen
parent
428539f30d
commit
508d2c7a77
|
|
@ -529,7 +529,7 @@ public class AntPathMatcher implements PathMatcher {
|
|||
* the first pattern contains a file extension match (e.g., {@code *.html}).
|
||||
* In that case, the second pattern will be merged into the first. Otherwise,
|
||||
* an {@code IllegalArgumentException} will be thrown.
|
||||
* <h3>Examples</h3>
|
||||
* <h4>Examples</h4>
|
||||
* <table border="1">
|
||||
* <tr><th>Pattern 1</th><th>Pattern 2</th><th>Result</th></tr>
|
||||
* <tr><td>{@code null}</td><td>{@code null}</td><td> </td></tr>
|
||||
|
|
|
|||
|
|
@ -112,11 +112,11 @@ public @interface TestPropertySource {
|
|||
* {@code Environment}'s set of {@code PropertySources}. Each location
|
||||
* will be added to the enclosing {@code Environment} as its own property
|
||||
* source, in the order declared.
|
||||
* <h3>Supported File Formats</h3>
|
||||
* <h4>Supported File Formats</h4>
|
||||
* <p>Both traditional and XML-based properties file formats are supported
|
||||
* — for example, {@code "classpath:/com/example/test.properties"}
|
||||
* or {@code "file:/path/to/file.xml"}.
|
||||
* <h3>Path Resource Semantics</h3>
|
||||
* <h4>Path Resource Semantics</h4>
|
||||
* <p>Each path will be interpreted as a Spring
|
||||
* {@link org.springframework.core.io.Resource Resource}. A plain path
|
||||
* — for example, {@code "test.properties"} — will be treated as a
|
||||
|
|
@ -134,9 +134,9 @@ public @interface TestPropertySource {
|
|||
* in paths (i.e., <code>${...}</code>) will be
|
||||
* {@linkplain org.springframework.core.env.Environment#resolveRequiredPlaceholders(String) resolved}
|
||||
* against the {@code Environment}.
|
||||
* <h3>Default Properties File Detection</h3>
|
||||
* <h4>Default Properties File Detection</h4>
|
||||
* <p>See the class-level Javadoc for a discussion on detection of defaults.
|
||||
* <h3>Precedence</h3>
|
||||
* <h4>Precedence</h4>
|
||||
* <p>Properties loaded from resource locations have lower precedence than
|
||||
* inlined {@link #properties}.
|
||||
* <p>This attribute may <strong>not</strong> be used in conjunction with
|
||||
|
|
@ -209,7 +209,7 @@ public @interface TestPropertySource {
|
|||
* {@code ApplicationContext} is loaded for the test. All key-value pairs
|
||||
* will be added to the enclosing {@code Environment} as a single test
|
||||
* {@code PropertySource} with the highest precedence.
|
||||
* <h3>Supported Syntax</h3>
|
||||
* <h4>Supported Syntax</h4>
|
||||
* <p>The supported syntax for key-value pairs is the same as the
|
||||
* syntax defined for entries in a Java
|
||||
* {@linkplain java.util.Properties#load(java.io.Reader) properties file}:
|
||||
|
|
@ -218,7 +218,7 @@ public @interface TestPropertySource {
|
|||
* <li>{@code "key:value"}</li>
|
||||
* <li>{@code "key value"}</li>
|
||||
* </ul>
|
||||
* <h3>Precedence</h3>
|
||||
* <h4>Precedence</h4>
|
||||
* <p>Properties declared via this attribute have higher precedence than
|
||||
* properties loaded from resource {@link #locations}.
|
||||
* <p>This attribute may be used in conjunction with {@link #value}
|
||||
|
|
|
|||
|
|
@ -91,7 +91,7 @@ public @interface Sql {
|
|||
* {@link #value}, but it may be used instead of {@link #value}. Similarly,
|
||||
* this attribute may be used in conjunction with or instead of
|
||||
* {@link #statements}.
|
||||
* <h3>Path Resource Semantics</h3>
|
||||
* <h4>Path Resource Semantics</h4>
|
||||
* <p>Each path will be interpreted as a Spring
|
||||
* {@link org.springframework.core.io.Resource Resource}. A plain path
|
||||
* — for example, {@code "schema.sql"} — will be treated as a
|
||||
|
|
@ -103,7 +103,7 @@ public @interface Sql {
|
|||
* {@link org.springframework.util.ResourceUtils#CLASSPATH_URL_PREFIX classpath:},
|
||||
* {@link org.springframework.util.ResourceUtils#FILE_URL_PREFIX file:},
|
||||
* {@code http:}, etc.) will be loaded using the specified resource protocol.
|
||||
* <h3>Default Script Detection</h3>
|
||||
* <h4>Default Script Detection</h4>
|
||||
* <p>If no SQL scripts or {@link #statements} are specified, an attempt will
|
||||
* be made to detect a <em>default</em> script depending on where this
|
||||
* annotation is declared. If a default cannot be detected, an
|
||||
|
|
@ -127,7 +127,7 @@ public @interface Sql {
|
|||
* <em>Inlined SQL statements</em> to execute.
|
||||
* <p>This attribute may be used in conjunction with or instead of
|
||||
* {@link #scripts}.
|
||||
* <h3>Ordering</h3>
|
||||
* <h4>Ordering</h4>
|
||||
* <p>Statements declared via this attribute will be executed after
|
||||
* statements loaded from resource {@link #scripts}. If you wish to have
|
||||
* inlined statements executed before scripts, simply declare multiple
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2020 the original author or authors.
|
||||
* Copyright 2002-2022 the original author or authors.
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
|
|
@ -51,7 +51,7 @@ public interface TransactionManagementConfigurer {
|
|||
* Return the default transaction manager bean to use for annotation-driven database
|
||||
* transaction management, i.e. when processing {@code @Transactional} methods.
|
||||
* <p>There are two basic approaches to implementing this method:
|
||||
* <h3>1. Implement the method and annotate it with {@code @Bean}</h3>
|
||||
* <h4>1. Implement the method and annotate it with {@code @Bean}</h4>
|
||||
* In this case, the implementing {@code @Configuration} class implements this method,
|
||||
* marks it with {@code @Bean}, and configures and returns the transaction manager
|
||||
* directly within the method body:
|
||||
|
|
@ -61,8 +61,8 @@ public interface TransactionManagementConfigurer {
|
|||
* public PlatformTransactionManager annotationDrivenTransactionManager() {
|
||||
* return new DataSourceTransactionManager(dataSource());
|
||||
* }</pre>
|
||||
* <h3>2. Implement the method without {@code @Bean} and delegate to another existing
|
||||
* {@code @Bean} method</h3>
|
||||
* <h4>2. Implement the method without {@code @Bean} and delegate to another existing
|
||||
* {@code @Bean} method</h4>
|
||||
* <pre class="code">
|
||||
* @Bean
|
||||
* public PlatformTransactionManager txManager() {
|
||||
|
|
|
|||
Loading…
Reference in New Issue