include_tasks until contradictory documentation

[Keeper-of-the-Keys]

Summary

The attribute documentation of include_tasks lists until as "fully supported", the description there is "Denotes if this action obeys until/retry/poll keywords", however in the parameters section it says

The do-until loop is not supported.

How can both be true at the same time?

In practice include_tasks does not support until at this time and based on #83896 this is seen as a new feature

Issue Type

Documentation Report

Component Name

lib/ansible/modules/include_tasks.py

Ansible Version

"latest" on the docs website.

Configuration

not relevant

OS / Environment

not relevant

Additional Information

Right now the documentation seems to be self contradictory and I was only able to determine the "true" statement by trial and error, at first I thought maybe the do-until statement only applies when using the free-form but based on my observations and the issue mentioned before it is just not supported.

Code of Conduct

• I agree to follow the Ansible Code of Conduct

[ansibot]

Files identified in the description:

• lib/ansible/modules/include_tasks.py

If these files are incorrect, please update the component name section of the description or use the component bot command.

[sivel]

The documentation indicating full support is wrong. Just need to make the following change:

diff --git a/lib/ansible/plugins/doc_fragments/action_core.py b/lib/ansible/plugins/doc_fragments/action_core.py
index 9be51d7006..3cfc62dc69 100644
--- a/lib/ansible/plugins/doc_fragments/action_core.py
+++ b/lib/ansible/plugins/doc_fragments/action_core.py
@@ -76,4 +76,6 @@ attributes:
     tags:
       details: Tags are interpreted by this action but are not automatically inherited by the include tasks, see C(apply)
       support: partial
+    until:
+      support: none
 """