import org.w3c.dom.Node;
import org.w3c.dom.Text;

import java.util.*;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

/**
 * Converts raw javadoc comments into docbook.
 */
public class JavadocConverter {
    private static final Pattern HEADER_PATTERN = Pattern.compile("h(\\d)", Pattern.CASE_INSENSITIVE);

import gradlebuild.docs.dsl.docbook.model.ClassDoc;

public class ClassDocCommentBuilder {
    private final JavadocConverter javadocConverter;
    private final GenerationListener listener;

    public ClassDocCommentBuilder(JavadocConverter javadocConverter, GenerationListener listener) {
        this.javadocConverter = javadocConverter;
        this.listener = listener;
    }

    /**
     * Builds the class comment for the given class.

import java.util.Set;

public class ClassDocMethodsBuilder extends ModelBuilderSupport {
    private final JavadocConverter javadocConverter;
    private final GenerationListener listener;

    public ClassDocMethodsBuilder(JavadocConverter converter, GenerationListener listener) {
        this.javadocConverter = converter;
        this.listener = listener;
    }

    /**

import gradlebuild.docs.dsl.docbook.model.PropertyDoc

class ClassDocMethodsBuilderTest extends XmlSpecification {
    final JavadocConverter javadocConverter = Mock()
    final ClassDocMethodsBuilder builder = new ClassDocMethodsBuilder(javadocConverter, null)

    def buildsMethodsForClass() {
        ClassMetaData classMetaData = classMetaData()
        MethodMetaData methodA = method('a', classMetaData)

    public ClassDocBuilder(DslDocModel model, JavadocConverter javadocConverter) {
        commentBuilder = new ClassDocCommentBuilder(javadocConverter, listener);
        propertiesBuilder = new ClassDocPropertiesBuilder(javadocConverter, listener);
        methodsBuilder = new ClassDocMethodsBuilder(javadocConverter, listener);
        extensionsBuilder = new ClassDocExtensionsBuilder(model, listener);

    private final JavadocConverter javadocConverter;
    private final GenerationListener listener;
    private static final Logger LOG = Logging.getLogger(ClassDocPropertiesBuilder.class);

    public ClassDocPropertiesBuilder(JavadocConverter javadocConverter, GenerationListener listener) {
        this.javadocConverter = javadocConverter;
        this.listener = listener;
    }

    /**

import gradlebuild.docs.dsl.source.model.TypeMetaData

class ClassDocPropertiesBuilderTest extends XmlSpecification {
    final JavadocConverter javadocConverter = Mock()
    final GenerationListener listener = Mock()
    final ClassDocPropertiesBuilder builder = new ClassDocPropertiesBuilder(javadocConverter, listener)

    def buildsPropertiesForClass() {
        ClassMetaData classMetaData = classMetaData()

        this.classMetaData = classMetaData
        this.extensionMetaData = extensionMetaData
        javadocConverter = new JavadocConverter(document, new JavadocLinkConverter(document, new TypeNameResolver(classMetaData), new LinkRenderer(document, this), classMetaData))
        docBuilder = new ClassDocBuilder(this, javadocConverter)
    }

    Collection<gradlebuild.docs.dsl.docbook.model.ClassDoc> getClasses() {

        def type = args.type instanceof TypeMetaData ? args.type : new TypeMetaData(args.type ?: 'org.gradle.Type')
        _ * property.type >> type
        _ * property.signature >> "$name-signature"
        _ * javadocConverter.parse(property, !null) >> ({[parse("<para>${args.comment ?: 'comment'}</para>")]} as DocComment)
        return property
    }

    def propertyDoc(Map<String, ?> args = [:], String name) {

class JavadocConverterTest extends XmlSpecification {
    final ClassMetaData classMetaData = Mock()
    final JavadocLinkConverter linkConverter = Mock()
    final GenerationListener listener = Mock()
    final JavadocConverter parser = new JavadocConverter(document, linkConverter)

    def respectsLineIndentation() {
        _ * classMetaData.rawCommentText >> '''
 * x
 *   indented
'''
        when: