docs: def wait(name, url='http://localhost:8080/manager', timeout=180):
      '''
      Wait for the Tomcat Manager to load.
  
      Notice that if tomcat is not running we won't wait for it start and the
      state will fail. This state can be required in the tomcat.war_deployed
      state to make sure tomcat is running and that the manager is running as
      well and ready for deployment.
  
      url : http://localhost:8080/manager
          The URL of the server with the Tomcat Manager webapp.
      timeout : 180
          Timeout for HTTP request to the Tomcat Manager.
  
      Example:
  
      .. code-block:: yaml
  
          tomcat-service:
            service.running:
              - name: tomcat
              - enable: True
  
          wait-for-tomcatmanager:
            tomcat.wait:
              - timeout: 300
              - require:
                - service: tomcat-service
  
          jenkins:
            tomcat.war_deployed:
              - name: /ran
              - war: salt://jenkins-1.2.4.war
              - require:
                - tomcat: wait-for-tomcatmanager
      '''
  
      result = __salt__['tomcat.status'](url, timeout)
      ret = {'name': name,
             'result': result,
             'changes': {},
             'comment': ('tomcat manager is ready' if result
                         else 'tomcat manager is not ready')
             }
  
      return ret