_ * classMetaData.innerClassNames >> ['org.gradle.SomeClass.A']
        _ * classMetaData.className >> 'org.gradle.SomeClass'
        _ * metaDataRepository.get('org.gradle.SomeClass.A') >> innerClass
        _ * innerClass.innerClassNames >> ['org.gradle.SomeClass.A.B']
        _ * innerClass.className >> 'org.gradle.SomeClass.A'
    }

    def resolvesUnqualifiedNameToOuterClass() {
        when:

        _ * linkRenderer.link({it.name == 'org.gradle.SomeClass'}, listener) >> parse('<someLinkElement/>')
    }

    def resolvesUnknownFullyQualifiedClassName() {
        when:
        def link = converter.resolve('org.gradle.SomeClass', classMetaData, listener)

        then:
        format(link) == '''<UNHANDLED-LINK>org.gradle.SomeClass</UNHANDLED-LINK>'''
    }

        when:
        def link = renderer.link(type('org.gradle.SomeClass'), listener)

        then:
        format(link) == '<apilink class="org.gradle.SomeClass"/>'
        _ * model.isKnownType('org.gradle.SomeClass') >> true
    }

    def rendersLinkToApiClassArray() {
        when:
        def link = renderer.link(type('org.gradle.SomeClass', true), listener)

        then:

        def notDeprecated = new ClassMetaData("SomeClass")
        def deprecated = new ClassMetaData("SomeClass")
        deprecated.addAnnotationTypeName(Deprecated.class.name)

        expect:
        !notDeprecated.deprecated
        deprecated.deprecated
    }

    def "is incubating when @Incubating annotation is attached to class"() {
        def notIncubating = new ClassMetaData("SomeClass")

    def formatsSignature() {
        def type = new TypeMetaData('org.gradle.SomeClass')
        propertyMetaData.type = type

        expect:
        propertyMetaData.signature == 'org.gradle.SomeClass prop'
    }

    def usesGetterToLocateOverriddenProperty() {
        MethodMetaData getter = Mock()
        MethodMetaData overriddenGetter = Mock()

    }

    def convertsALinkTag() {
        _ * classMetaData.rawCommentText >> '{@link someClass} {@link otherClass#method(a, b) label}'

        when:
        def result = parser.parse(classMetaData, listener)

        then:
        format(result.docbook) == '''<para><xref/> <xref/></para>'''
        1 * linkConverter.resolve('someClass', classMetaData, listener) >> document.createElement("xref")