'used to print out a deprecation message.'

def deprecated(self, msg, version=None, removed=False):

    if ((not removed) and (not C.DEPRECATION_WARNINGS)):
        return
    if (not removed):
        if version:
            new_msg = ('[DEPRECATION    WARNING]:    %s.\nThis    feature    will    be    removed    in    version    %s.' % (msg, version))
        else:
            new_msg = ('[DEPRECATION    WARNING]:    %s.\nThis    feature    will    be    removed    in    a    future    release.' % msg)
        new_msg = (new_msg + '    Deprecation    warnings    can    be    disabled    by    setting    deprecation_warnings=False    in    ansible.cfg.\n\n')
    else:
        raise AnsibleError(('[DEPRECATED]:    %s.\nPlease    update    your    playbooks.' % msg))
    wrapped = textwrap.wrap(new_msg, self.columns, replace_whitespace=False, drop_whitespace=False)
    new_msg = ('\n'.join(wrapped) + '\n')
    if (new_msg not in self._deprecations):
        self.display(new_msg.strip(), color=C.COLOR_DEPRECATE, stderr=True)
        self._deprecations[new_msg] = 1
