Polish one sentence per line in the reference docs

Author: wilkinsona

spring-boot-project/spring-boot-docs/src/main/asciidoc/appendix-application-properties.adoc

@@ -10,7 +10,8 @@ TIP: Spring Boot provides various conversion mechanism with advanced value forma
 NOTE: Property contributions can come from additional jar files on your classpath, so you should not consider this an exhaustive list.
 Also, you can define your own properties.
 
-WARNING: This sample file is meant as a guide only. Do **not** copy and paste the entire content into your application.
+WARNING: This sample file is meant as a guide only.
+Do **not** copy and paste the entire content into your application.
 Rather, pick only the properties that you need.
 
 

spring-boot-project/spring-boot-docs/src/main/asciidoc/appendix-configuration-metadata.adoc

@@ -88,7 +88,8 @@ For example, `server.port` and `server.address` might be specified in `applicati
 The "`groups`" are higher level items that do not themselves specify a value but instead provide a contextual grouping for properties.
 For example, the `server.port` and `server.address` properties are part of the `server` group.
 
-NOTE: It is not required that every "`property`" has a "`group`". Some properties might exist in their own right.
+NOTE: It is not required that every "`property`" has a "`group`".
+Some properties might exist in their own right.
 
 Finally, "`hints`" are additional information used to assist the user in configuring a given property.
 For example, when a developer is configuring the `spring.jpa.hibernate.ddl-auto` property, a tool can use the hints to offer some auto-completion help for the `none`, `validate`, `update`, `create`, and `create-drop` values.
@@ -105,7 +106,8 @@ The JSON object contained in the `groups` array can contain the attributes shown
 
 | `name`
 | String
-| The full name of the group. This attribute is mandatory.
+| The full name of the group.
+  This attribute is mandatory.
 
 | `type`
 | String
@@ -315,7 +317,8 @@ The JSON object contained in the `providers` attribute of each `hint` element ca
 
 [[configuration-metadata-repeated-items]]
 ==== Repeated Metadata Items
-Objects with the same "`property`" and "`group`" name can appear multiple times within a metadata file. For example, you could bind two separate classes to the same prefix, with each having potentially overlapping property names.
+Objects with the same "`property`" and "`group`" name can appear multiple times within a metadata file.
+For example, you could bind two separate classes to the same prefix, with each having potentially overlapping property names.
 While the same names appearing in the metadata multiple times should not be common, consumers of metadata should take care to ensure that they support it.
 
 

spring-boot-project/spring-boot-docs/src/main/asciidoc/build-tool-plugins.adoc

@@ -3,7 +3,8 @@
 
 [partintro]
 --
-Spring Boot provides build tool plugins for Maven and Gradle. The plugins offer a variety of features, including the packaging of executable jars.
+Spring Boot provides build tool plugins for Maven and Gradle.
+The plugins offer a variety of features, including the packaging of executable jars.
 This section provides more details on both plugins as well as some help should you need to extend an unsupported build system.
 If you are just getting started, you might want to read "`<<using-spring-boot.adoc#using-boot-build-systems>>`" from the "`<<using-spring-boot.adoc#using-boot>>`" section first.
 --

spring-boot-project/spring-boot-docs/src/main/asciidoc/deployment.adoc

@@ -402,7 +402,8 @@ A fully executable jar can be executed like any other executable binary or it ca
 This makes it very easy to install and manage Spring Boot applications in common production environments.
 
 CAUTION: Fully executable jars work by embedding an extra script at the front of the file.
-Currently, some tools do not accept this format, so you may not always be able to use this technique. For example, `jar -xf` may silently fail to extract a jar or war that has been made fully executable.
+Currently, some tools do not accept this format, so you may not always be able to use this technique.
+For example, `jar -xf` may silently fail to extract a jar or war that has been made fully executable.
 It is recommended that you make your jar or war fully executable only if you intend to execute it directly, rather than running it with `java -jar`or deploying it to a servlet container.
 
 To create a '`fully executable`' jar with Maven, use the following plugin configuration:
@@ -522,7 +523,8 @@ One way to protect against this is to make it immutable by using `chattr`, as sh
 This will prevent any user, including root, from modifying the jar.
 
 If root is used to control the application's service and you <<deployment-script-customization-conf-file, use a `.conf` file>> to customize its startup, the `.conf` file is read and evaluated by the root user.
-It should be secured accordingly. Use `chmod` so that the file can only be read by the owner and use `chown` to make root the owner, as shown in the following example:
+It should be secured accordingly.
+Use `chmod` so that the file can only be read by the owner and use `chown` to make root the owner, as shown in the following example:
 
 [indent=0,subs="verbatim,quotes,attributes"]
 ----
@@ -652,17 +654,20 @@ The following property substitutions are supported with the default script:
 |
 
 | `logFolder`
-| Default value for `LOG_FOLDER`. Only valid for an `init.d` service
+| Default value for `LOG_FOLDER`.
+  Only valid for an `init.d` service
 |
 |
 
 | `logFilename`
-| Default value for `LOG_FILENAME`. Only valid for an `init.d` service
+| Default value for `LOG_FILENAME`.
+  Only valid for an `init.d` service
 |
 |
 
 | `pidFolder`
-| Default value for `PID_FOLDER`. Only valid for an `init.d` service
+| Default value for `PID_FOLDER`.
+  Only valid for an `init.d` service
 |
 |
 
@@ -678,7 +683,8 @@ The following property substitutions are supported with the default script:
 | `true`
 
 | `stopWaitTime`
-| Default value for `STOP_WAIT_TIME` in seconds. Only valid for an `init.d` service
+| Default value for `STOP_WAIT_TIME` in seconds.
+  Only valid for an `init.d` service
 | 60
 | 60
 |===
@@ -740,7 +746,8 @@ The following environment properties are supported with the default script:
 | The time in seconds to wait when stopping the application before forcing a shutdown (`60` by default).
 |===
 
-NOTE: The `PID_FOLDER`, `LOG_FOLDER`, and `LOG_FILENAME` variables are only valid for an `init.d` service. For `systemd`, the equivalent customizations are made by using the '`service`' script.
+NOTE: The `PID_FOLDER`, `LOG_FOLDER`, and `LOG_FILENAME` variables are only valid for an `init.d` service.
+For `systemd`, the equivalent customizations are made by using the '`service`' script.
 See the https://www.freedesktop.org/software/systemd/man/systemd.service.html[service unit configuration man page] for more details.
 
 

spring-boot-project/spring-boot-docs/src/main/asciidoc/howto.adoc

@@ -212,7 +212,8 @@ You can then refer to your Gradle project's properties by using placeholders, as
 	app.description=${description}
 ----
 
-NOTE: Gradle's `expand` method uses Groovy's `SimpleTemplateEngine`, which transforms `${..}` tokens. The `${..}` style conflicts with Spring's own property placeholder mechanism.
+NOTE: Gradle's `expand` method uses Groovy's `SimpleTemplateEngine`, which transforms `${..}` tokens.
+The `${..}` style conflicts with Spring's own property placeholder mechanism.
 To use Spring property placeholders together with automatic expansion, escape the Spring property placeholders as follows: `\${..}`.
 
 
@@ -648,7 +649,8 @@ Generally, you should first consider using one of the many available configurati
 The `server.{asterisk}` namespace is quite useful here, and it includes namespaces like `server.tomcat.{asterisk}`, `server.jetty.{asterisk}` and others, for server-specific features.
 See the list of <<common-application-properties>>.
 
-The previous sections covered already many common use cases, such as compression, SSL or HTTP/2. However, if a configuration key doesn't exist for your use case, you should then look at {spring-boot-module-api}/web/server/WebServerFactoryCustomizer.html[`WebServerFactoryCustomizer`].
+The previous sections covered already many common use cases, such as compression, SSL or HTTP/2.
+However, if a configuration key doesn't exist for your use case, you should then look at {spring-boot-module-api}/web/server/WebServerFactoryCustomizer.html[`WebServerFactoryCustomizer`].
 You can declare such a component and get access to the server factory relevant to your choice: you should select the variant for the chosen Server (Tomcat, Jetty, Reactor Netty, Undertow) and the chosen web stack (Servlet or Reactive).
 
 The example below is for Tomcat with the `spring-boot-starter-web` (Servlet stack):
@@ -1147,7 +1149,8 @@ If you add your own, you have to be aware of the order and in which position you
   There is a useful https://spring.io/blog/2013/06/03/content-negotiation-using-views[blog about `ContentNegotiatingViewResolver`] that you might like to study to learn more, and you might also look at the source code for detail.
   You can switch off the auto-configured `ContentNegotiatingViewResolver` by defining a bean named '`viewResolver`'.
 * If you use Thymeleaf, you also have a `ThymeleafViewResolver` named '`thymeleafViewResolver`'.
-  It looks for resources by surrounding the view name with a prefix and suffix. The prefix is `spring.thymeleaf.prefix`, and the suffix is `spring.thymeleaf.suffix`.
+  It looks for resources by surrounding the view name with a prefix and suffix.
+  The prefix is `spring.thymeleaf.prefix`, and the suffix is `spring.thymeleaf.suffix`.
   The values of the prefix and suffix default to '`classpath:/templates/`' and '`.html`', respectively.
   You can override `ThymeleafViewResolver` by providing a bean of the same name.
 * If you use FreeMarker, you also have a `FreeMarkerViewResolver` named '`freeMarkerViewResolver`'.
@@ -1495,7 +1498,8 @@ The following example shows how to define a JDBC data source by setting properti
 
 However, there is a catch.
 Because the actual type of the connection pool is not exposed, no keys are generated in the metadata for your custom `DataSource` and no completion is available in your IDE (because the `DataSource` interface exposes no properties).
-Also, if you happen to have Hikari on the classpath, this basic setup does not work, because Hikari has no `url` property (but does have a `jdbcUrl` property). In that case, you must rewrite your configuration as follows:
+Also, if you happen to have Hikari on the classpath, this basic setup does not work, because Hikari has no `url` property (but does have a `jdbcUrl` property).
+In that case, you must rewrite your configuration as follows:
 
 [source,properties,indent=0]
 ----
@@ -1551,7 +1555,8 @@ See "`<<spring-boot-features.adoc#boot-features-configure-datasource>>`" in the
 If you need to configure multiple data sources, you can apply the same tricks that are described in the previous section.
 You must, however, mark one of the `DataSource` instances as `@Primary`, because various auto-configurations down the road expect to be able to get one by type.
 
-If you create your own `DataSource`, the auto-configuration backs off. In the following example, we provide the _exact_ same feature set as the auto-configuration provides on the primary data source:
+If you create your own `DataSource`, the auto-configuration backs off.
+In the following example, we provide the _exact_ same feature set as the auto-configuration provides on the primary data source:
 
 [source,java,indent=0,subs="verbatim,quotes,attributes"]
 ----
@@ -1560,7 +1565,8 @@ include::{code-examples}/jdbc/SimpleTwoDataSourcesExample.java[tag=configuration
 
 TIP: `firstDataSourceProperties` has to be flagged as `@Primary` so that the database initializer feature uses your copy (if you use the initializer).
 
-Both data sources are also bound for advanced customizations. For instance, you could configure them as follows:
+Both data sources are also bound for advanced customizations.
+For instance, you could configure them as follows:
 
 [source,properties,indent=0]
 ----
@@ -1699,7 +1705,8 @@ See {spring-boot-autoconfigure-module-code}/orm/jpa/HibernateJpaAutoConfiguratio
 Hibernate {hibernate-docs}#caching[second-level cache] can be configured for a range of cache providers.
 Rather than configuring Hibernate to lookup the cache provider again, it is better to provide the one that is available in the context whenever possible.
 
-If you're using JCache, this is pretty easy. First, make sure that `org.hibernate:hibernate-jcache` is available on the classpath.
+If you're using JCache, this is pretty easy.
+First, make sure that `org.hibernate:hibernate-jcache` is available on the classpath.
 Then, add a `HibernatePropertiesCustomizer` bean as shown in the following example:
 
 [source,java,indent=0]
@@ -1879,7 +1886,8 @@ This is controlled through two external properties:
 You can set `spring.jpa.hibernate.ddl-auto` explicitly and the standard Hibernate property values are `none`, `validate`, `update`, `create`, and `create-drop`.
 Spring Boot chooses a default value for you based on whether it thinks your database is embedded.
 It defaults to `create-drop` if no schema manager has been detected or `none` in all other cases.
-An embedded database is detected by looking at the `Connection` type. `hsqldb`, `h2`, and `derby` are embedded, and others are not.
+An embedded database is detected by looking at the `Connection` type.
+`hsqldb`, `h2`, and `derby` are embedded, and others are not.
 Be careful when switching from in-memory to a '`real`' database that you do not make assumptions about the existence of the tables and data in the new platform.
 You either have to set `ddl-auto` explicitly or use one of the other mechanisms to initialize the database.
 
@@ -2090,7 +2098,8 @@ See {spring-boot-autoconfigure-module-code}/batch/BatchAutoConfiguration.java[Ba
 
 [[howto-actuator]]
 == Actuator
-Spring Boot includes the Spring Boot Actuator. This section answers questions that often arise from its use.
+Spring Boot includes the Spring Boot Actuator.
+This section answers questions that often arise from its use.
 
 
 
@@ -2169,7 +2178,8 @@ You can switch on the valve by adding some entries to `application.properties`,
 	server.tomcat.protocol-header=x-forwarded-proto
 ----
 
-(The presence of either of those properties switches on the valve. Alternatively, you can add the `RemoteIpValve` by adding a `TomcatServletWebServerFactory` bean.)
+(The presence of either of those properties switches on the valve.
+Alternatively, you can add the `RemoteIpValve` by adding a `TomcatServletWebServerFactory` bean.)
 
 To configure Spring Security to require a secure channel for all (or some) requests, consider adding your own `WebSecurityConfigurerAdapter` that adds the following `HttpSecurity` configuration:
 
@@ -2191,7 +2201,8 @@ To configure Spring Security to require a secure channel for all (or some) reque
 
 [[howto-hotswapping]]
 == Hot Swapping
-Spring Boot supports hot swapping. This section answers questions about how it works.
+Spring Boot supports hot swapping.
+This section answers questions about how it works.
 
 
 
@@ -2760,7 +2771,8 @@ See the <<howto-build-an-application-context-hierarchy, entry on building a hier
 An existing parent context that contains web-specific features usually needs to be broken up so that all the `ServletContextAware` components are in the child context.
 
 Applications that are not already Spring applications might be convertible to Spring Boot applications, and the previously mentioned guidance may help.
-However, you may yet encounter problems. In that case, we suggest https://stackoverflow.com/questions/tagged/spring-boot[asking questions on Stack Overflow with a tag of `spring-boot`].
+However, you may yet encounter problems.
+In that case, we suggest https://stackoverflow.com/questions/tagged/spring-boot[asking questions on Stack Overflow with a tag of `spring-boot`].