def "formats signature"() {
        MethodMetaData method = Mock()
        def parameter = new ParameterMetaData('param')
        def type = new TypeMetaData('org.gradle.SomeType')
        parameter.type = type

        expect:
        parameter.signature == 'org.gradle.SomeType param'
    }

    final TypeMetaData type = new TypeMetaData('org.gradle.SomeType')

    def rawTypeForSimpleType() {
        expect:
        type.rawType.signature == 'org.gradle.SomeType'
    }

    def rawTypeForArrayType() {
        type.arrayDimensions = 2

        expect:
        type.rawType.signature == 'org.gradle.SomeType[][]'
    }

    def rawTypeForVarargsType() {
        when:

            <title>
                <classname>SomeType</classname>
                <literal>readWriteProperty</literal>
            </title>
            <para>comment</para>
        </section>
        <section id="readOnlyProperty" role="detail">
            <title><classname>SomeType</classname> <literal>readOnlyProperty</literal> (read-only)</title>
            <para>comment</para>