From 4dcc5588f695dba5a04dfc4ebdbb73818a255f51 Mon Sep 17 00:00:00 2001 From: Brian Coca Date: Wed, 7 Feb 2018 11:06:53 -0500 Subject: [PATCH] undeprecate include defering deprecation until we are comfortable that the new actions cover most of the ground users need. --- .../modules/utilities/logic/{_include.py => include.py} | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) rename lib/ansible/modules/utilities/logic/{_include.py => include.py} (83%) diff --git a/lib/ansible/modules/utilities/logic/_include.py b/lib/ansible/modules/utilities/logic/include.py similarity index 83% rename from lib/ansible/modules/utilities/logic/_include.py rename to lib/ansible/modules/utilities/logic/include.py index 025b792184a..076a3428989 100644 --- a/lib/ansible/modules/utilities/logic/_include.py +++ b/lib/ansible/modules/utilities/logic/include.py @@ -19,10 +19,6 @@ DOCUMENTATION = ''' author: Ansible Core Team (@ansible) module: include short_description: Include a play or task list -deprecated: - removed_in: "2.8" - why: The include action was too confusing, dealing with both plays and tasks, being both dynamic and static. This module will be removed in version 2.8. - alternative: Use M(include_tasks), M(import_playbook), M(import_tasks). description: - Includes a file with a list of plays or tasks to be executed in the current playbook. - Files with a list of plays can only be included at the top level. Lists of tasks can only be included where tasks @@ -41,7 +37,10 @@ options: - This module allows you to specify the name of the file directly without any other options. notes: - This is a core feature of Ansible, rather than a module, and cannot be overridden like a module. - - This module is also supported for Windows targets. + - Include has some unintuitive behaviours depending on if it is running in a static or dynamic in play or in playbook context, + in an effort to clarify behaviours we are moving to a new set modules (M(include_tasks), M(include_role), M(import_playbook), M(import_tasks)) + that have well established and clear behaviours. + This module will still be supported for some time but we are looking at deprecating it in the near future. ''' EXAMPLES = """