Skip to content

Commit 9df19de

Browse files
committed
Revise wording for PauseMode documentation
See gh-36044
1 parent 01a57a7 commit 9df19de

1 file changed

Lines changed: 10 additions & 11 deletions

File tree

framework-docs/modules/ROOT/pages/testing/testcontext-framework/ctx-management/context-pausing.adoc

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ will be in a "stopped" state until the context is used again by a test. Note, ho
1313
that `SmartLifecycle` components can opt out of pausing by returning `false` from
1414
`SmartLifecycle#isPauseable()`.
1515

16-
You can control whether unused application contexts should be paused by setting the
16+
You can control whether inactive application contexts should be paused by setting the
1717
`PauseMode` to one of the following supported values.
1818

1919
`ALWAYS` :: Always pause inactive application contexts.
@@ -28,19 +28,18 @@ line or a build script by setting a JVM system property named
2828
an alternative, you can set the property via the
2929
xref:appendix.adoc#appendix-spring-properties[`SpringProperties`] mechanism.
3030

31-
For example, if you encounter issues with `Lifecycle` components that cannot or should
32-
not opt out of pausing, or if you discover that your test suite runs more slowly due to
33-
the pausing and restarting of application contexts, you can disable the pausing feature
34-
by setting the `spring.test.context.cache.pause` property to `never`.
31+
For example, if you want inactive application contexts to always be paused, you can
32+
switch from the default `ON_CONTEXT_SWITCH` mode to `ALWAYS` by setting the
33+
`spring.test.context.cache.pause` system property to `always`.
3534

3635
```shell
37-
-Dspring.test.context.cache.pause=never
36+
-Dspring.test.context.cache.pause=always
3837
```
39-
40-
Although `ON_CONTEXT_SWITCH` is the default pause mode, you still have the option to
41-
enable context pausing for all usage scenarios (including context switches) by setting
42-
the `spring.test.context.cache.pause` property to `always`.
38+
Similarly, if you encounter issues with `Lifecycle` components that cannot or should not
39+
opt out of pausing, or if you discover that your test suite runs more slowly due to the
40+
pausing and restarting of application contexts, you can disable the pausing feature by
41+
setting the `spring.test.context.cache.pause` system property to `never`.
4342

4443
```shell
45-
-Dspring.test.context.cache.pause=always
44+
-Dspring.test.context.cache.pause=never
4645
```

0 commit comments

Comments
 (0)