## Status

ACCEPTED

## Consequences

* If we would have used `Closure`, we must instead use `Action<T>`, `Spec<T>`, `Callable<T>`, or `Transformer<OUT, IN>`.
* We need to ensure all APIs that are exposed in the Groovy DSL go through runtime decoration.
Runtime decoration mixes in methods that use Groovy Closures to maintain consistent behavior in Groovy DSL.

func (listener *httpListener) start() {
	// Closure to send acceptResult to acceptCh.
	// It returns true if the result is sent else false if returns when doneCh is closed.
	send := func(result acceptResult) bool {
		select {
		case listener.acceptCh <- result:
			// Successfully written to acceptCh
			return true
		case <-listener.ctx.Done():
			return false
		}
	}

	// Closure to handle TCPListener until done channel is closed.

    }

    public static void setChildren(Node element, Closure cl) {
        while (element.hasChildNodes()) {
            element.removeChild(element.getFirstChild())
        }
        leftShift(element, cl)
    }

    public static def leftShift(Node parent, Closure cl) {
        DomBuilder builder = new DomBuilder(parent)
        cl.delegate = builder
        cl.call()

        when:
        def link = renderer.link(type('groovy.lang.Closure'), listener)

        then:
        format(link) == '<ulink url="https://docs.groovy-lang.org/groovyVersion/html/gapi/groovy/lang/Closure.html"><classname>Closure</classname></ulink>'
    }

    def rendersLinkToGroovyClassArray() {
        when:
        def link = renderer.link(type('groovy.lang.Closure', true), listener)

        then:

        MethodMetaData blockMethod = method('block', classMetaData, paramTypes: [Closure.class.name])
        PropertyMetaData compositeBlockProperty = property('listBlock', classMetaData, type: new TypeMetaData('java.util.List').addTypeArg(new TypeMetaData('BlockType')))
        MethodMetaData compositeBlockMethod = method('listBlock', classMetaData, paramTypes: [Closure.class.name])

 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package gradlebuild.docs.dsl.docbook;

import groovy.lang.Closure;
import gradlebuild.docs.dsl.docbook.model.*;
import gradlebuild.docs.dsl.source.model.MethodMetaData;
import gradlebuild.docs.dsl.source.model.PropertyMetaData;
import gradlebuild.docs.dsl.source.model.TypeMetaData;

        expect:
        typeNameResolver.resolve('Set', classMetaData) == 'java.util.Set'
        typeNameResolver.resolve('File', classMetaData) == 'java.io.File'
        typeNameResolver.resolve('Closure', classMetaData) == 'groovy.lang.Closure'
        typeNameResolver.resolve('BigDecimal', classMetaData) == 'java.math.BigDecimal'
        typeNameResolver.resolve('BigInteger', classMetaData) == 'java.math.BigInteger'
    }

 */
package gradlebuild.docs.model;

import groovy.lang.Closure;
import org.gradle.api.UnknownDomainObjectException;

public interface ClassMetaDataRepository<T> {
    T get(String fullyQualifiedClassName) throws UnknownDomainObjectException;

    T find(String fullyQualifiedClassName);

    void put(String fullyQualifiedClassName, T metaData);

    void each(Closure cl);

        return document ? document.importNode(parsed, true) : parsed
    }

    def formatTree(Closure cl) {
        withCategories {
            return formatTree(cl.call())
        }
    }

    def withCategories(Closure cl) {
        use(BuildableDOMCategory) {
            return cl.call()
        }
    }

    def format(Node... nodes) {

 * systems and high-level APIs that provide autoescaping.
 * One Google-authored templating system available for external use is <a
 * href="https://developers.google.com/closure/templates/">Closure Templates</a>.
 *
 * <p>HTML escaping is particularly tricky: For example, <a
 * href="https://www.w3.org/TR/html4/types.html#h-6.2">some elements' text contents must not be HTML