Fixup removed and deprecated modules

* Removed modules no longer have documentation
  Decided this was causing people to think that modules were supported
  even after being removed.  This change is a new strategy to have the
  error message trying to use a removed module point people to the older
  documentation.

* Add stubs for modules removed in 2.7
  These are freshly removed so we want people who are still using them
  when they upgrade Ansible to have a hint as to where to find information
  on how to port.

* Finish properly undeprecating include
  include was undeprecated earlier but not all of the pieces that marked
  it as deprecated were reverted.  This change fixes the remaining
  pieces

lib/ansible/modules/network/cumulus/_cl_license.py

@@ -9,101 +9,12 @@ __metaclass__ = type
 
 
 ANSIBLE_METADATA = {'metadata_version': '1.1',
-                    'status': ['deprecated'],
+                    'status': ['removed'],
                     'supported_by': 'community'}
 
 
-DOCUMENTATION = '''
----
-module: cl_license
-version_added: "2.1"
-author: "Cumulus Networks (@CumulusNetworks)"
-short_description: Install licenses for Cumulus Linux
-deprecated:
-  why: The M(nclu) module is designed to be easier to use for individuals who are new to Cumulus Linux by exposing the NCLU interface in an automatable way.
-  removed_in: "2.5"
-  alternative: Use M(nclu) instead.
-description:
-    - Installs a Cumulus Linux license. The module reports no change of status
-      when a license is installed.
-      For more details go the Cumulus Linux License Documentation at
-      U(http://docs.cumulusnetwork.com) and the Licensing KB Site at
-      U(https://support.cumulusnetworks.com/hc/en-us/sections/200507688)
-notes:
-    - To activate a license for the FIRST time, the switchd service must be
-      restarted. This action is disruptive. The license renewal process occurs
-      via the Cumulus Networks Customer Portal -
-      U(http://customers.cumulusnetworks.com).
-    - A non-EULA license is REQUIRED for automation. Manually install the
-      license on a test switch, using the command "cl-license -i <license_file>"
-      to confirm the license is a Non-EULA license.
-      See EXAMPLES, for the proper way to issue this notify action.
-options:
-    src:
-        description:
-            - The full path to the license. Can be local path or HTTP URL.
-        required: true
-    force:
-        description:
-            - Force installation of a license. Typically not needed.
-              It is recommended to manually run this command via the ansible
-              command. A reload of switchd is not required. Running the force
-              option in a playbook will break the idempotent state machine of
-              the module and cause the switchd notification to kick in all the
-              time, causing a disruption.
-        choices:
-            - yes
-            - no
-
-'''
-EXAMPLES = '''
-# Example playbook using the cl_license module to manage licenses on Cumulus Linux
-
-- hosts: all
-  tasks:
-    - name: install license using http url
-      cl_license:
-        src: http://10.1.1.1/license.txt
-      notify: restart switchd
-
-    - name: Triggers switchd to be restarted right away, before play, or role
-            is over. This is desired behaviour
-      meta: flush_handlers
-
-    - name: Configure interfaces
-      template:
-        src: interfaces.j2
-        dest: /etc/network/interfaces
-      notify: restart networking
-
-  handlers:
-   - name: restart switchd
-     service:
-      name: switchd
-      state: restarted
-   - name: restart networking
-     service:
-      name: networking
-      state: reloaded
-
-# Force all switches to accept a new license. Typically not needed
-# ansible -m cl_license -a "src='http://10.1.1.1/new_lic' force=yes" -u root all
-'''
-
-RETURN = '''
-changed:
-    description: whether the interface was changed
-    returned: changed
-    type: bool
-    sample: True
-msg:
-    description: human-readable report of success or failure
-    returned: always
-    type: string
-    sample: "interface bond0 config updated"
-'''
-
 from ansible.module_utils.common.removed import removed_module
 
+
 if __name__ == '__main__':
-    removed_module()
+    removed_module(removed_in="2.5")