doc: improve ALS.enterWith and exit descriptions #36705
Merged
+15
−10
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Refs: #36683
Aims to add more clarity into ALS'
enterWith
andexit
method docs in order to avoid confusion around their behavior.Also includes the following:
als.enterWith()
mentioning in parallel withals.run()
where necessary (e.g. inals.disable()
's doc)als.enterWith()
's in a way which is more consistent with other methods' docsChecklist
make -j4 test
(UNIX), orvcbuild test
(Windows) passes