docker_container: deprecate trust_image_content (#63420)

* Deprecate trust_image_content.

* Add changelog.

* Mention it has never been used; removed test stub.

changelogs/fragments/63420-docker_container-trust_image_content.yml

@@ -0,0 +1,2 @@
+deprecated_features:
+- "docker_container - the ``trust_image_content`` option is now deprecated and will be removed in Ansible 2.14. It has never been used by the module."

docs/docsite/rst/porting_guides/porting_guide_2.10.rst

@@ -55,6 +55,8 @@ The following functionality will be removed in Ansible 2.14. Please update updat
 
 * The :ref:`openssl_csr <openssl_csr_module>` module's option ``version`` no longer supports values other than ``1`` (the current only standardized CSR version).
 
+* :ref:`docker_container <docker_container_module>`: the ``trust_image_content`` option will be removed. It has always been ignored by the module.
+
 
 Noteworthy module changes
 -------------------------

lib/ansible/modules/cloud/docker/docker_container.py

@@ -723,6 +723,7 @@ options:
   trust_image_content:
     description:
       - If C(yes), skip image verification.
+      - The option has never been used by the module. It will be removed in Ansible 2.14.
     type: bool
     default: no
   tmpfs:
@@ -3264,7 +3265,7 @@ def main():
         stop_timeout=dict(type='int'),
         sysctls=dict(type='dict'),
         tmpfs=dict(type='list', elements='str'),
-        trust_image_content=dict(type='bool', default=False),
+        trust_image_content=dict(type='bool', default=False, removed_in_version='2.14'),
         tty=dict(type='bool', default=False),
         ulimits=dict(type='list', elements='str'),
         user=dict(type='str'),

test/integration/targets/docker_container/tasks/tests/options.yml

@@ -3376,12 +3376,6 @@ avoid such warnings, please quote the value.' in log_options_2.warnings"
     - tmpfs_3 is not changed
     - tmpfs_4 is changed
 
-####################################################################
-## trust_image_content #############################################
-####################################################################
-
-# TODO: - trust_image_content
-
 ####################################################################
 ## tty #############################################################
 ####################################################################