Polish "Added support for devtools YAML configuration"

See gh-17915
This commit is contained in:
Madhura Bhave
2019-08-23 14:33:04 -07:00
parent 00a3ad0fd1
commit 48b5b6a24c
4 changed files with 97 additions and 110 deletions

View File

@@ -431,7 +431,7 @@ Spring Boot uses a very particular `PropertySource` order that is designed to al
sensible overriding of values. Properties are considered in the following order:
. <<using-boot-devtools-globalsettings,Devtools global settings properties>>
on your home directory (`~/.spring-boot-devtools.properties` when devtools is active).
in the `$HOME/.config/spring-boot` folder when devtools is active.
. {spring-javadoc}/test/context/TestPropertySource.{dc-ext}[`@TestPropertySource`]
annotations on your tests.
. `properties` attribute on your tests. Available on

View File

@@ -1018,20 +1018,30 @@ from your IDE, only the first has LiveReload support.
[[using-boot-devtools-globalsettings]]
=== Global Settings
You can configure global devtools settings by adding a file named
`.spring-boot-devtools.properties` to your `$HOME` folder (note that the filename starts
with "`.`"). Any properties added to this file apply to _all_ Spring Boot applications on
You can configure global devtools settings by adding any of the following files to the `$HOME/.config/spring-boot`
folder (note that the filenames startswith "`.`"):
. `.spring-boot-devtools.properties`
. `.spring-boot-devtools.yaml`
. `.spring-boot-devtools.yml`
Any properties added to these file apply to _all_ Spring Boot applications on
your machine that use devtools. For example, to configure restart to always use a
<<using-boot-devtools-restart-triggerfile, trigger file>>, you would add the following
property:
.~/.spring-boot-devtools.properties
.~/config/spring-boot/.spring-boot-devtools.properties
[source,properties,indent=0]
----
spring.devtools.reload.trigger-file=.reloadtrigger
----
NOTE: Profiles activated in `.spring-boot-devtools.properties` will not affect the
NOTE: If devtools configuration files are not found in `$HOME/.config/spring-boot`, the root of the `$HOME` folder
is searched for the presence of a `.spring-boot-devtools.properties` file. This allows you to share the devtools global
configuration with applications that are on an older version of Spring Boot that does not support the `$HOME/.config/spring-boot`
location.
NOTE: Profiles activated in the above files will not affect the
loading of <<spring-boot-features.adoc#boot-features-external-config-profile-specific-properties,
profile-specific configuration files>>.