JvmFeatureInternal feature = getMainFeature();

        feature.withJavadocJar();

        Configuration javadocElements = feature.getJavadocElementsConfiguration();
        if (!isRegisteredAsLegacyVariant(javadocElements)) {
            addVariantsFromConfiguration(javadocElements, new JavaConfigurationVariantMapping("runtime", true));
        }
    }

    @Override
    public void withSourcesJar() {

    <conf name="javadocElements" visibility="public"/>
    <conf name="runtime" visibility="public"/>
    <conf name="sourcesElements" visibility="public"/>
  </configurations>
  <publications>
    <artifact name="project1" type="jar" ext="jar" conf="compile,runtime"/>
    <artifact name="project1" type="jar" ext="jar" conf="javadocElements" m:classifier="javadoc"/>

            expectedVariants.addAll([variantName(feature, 'apiElements'), variantName(feature, 'runtimeElements')])
            if (withDocumentation) {
                expectedVariants.addAll([variantName(feature, 'javadocElements'), variantName(feature, 'sourcesElements')])
            }
        }
        def parsedModuleVariants = mavenModule.parsedModuleMetadata.variants*.name as TreeSet
        assert parsedModuleVariants == expectedVariants

                    withJavadocJar()
                }
            }

            task verify {
                assert components.java instanceof DefaultJvmSoftwareComponent
                assert configurations.javadocElements
                assert sourceSets.main
            }
        """

        expect:
        succeeds "verify"
    }

        project1module.parsedIvy.configurations.keySet() == ['default', 'compile', 'runtime', 'javadocElements', 'sourcesElements'] as Set
        project1module.parsedIvy.description.text() == "The first project"
        project1module.parsedIvy.assertDependsOn("junit:junit:4.13@runtime", "org.gradle.sample:project2:1.0@runtime")

        file("build/repo/org.gradle/test/1.0/test-1.0-javadoc.jar.sha256").exists()
        file("build/repo/org.gradle/test/1.0/test-1.0-javadoc.jar.sha512").exists()
        publishedModule.parsedModuleMetadata.variant("javadocElements") {
            assert files*.name == ['test-1.0-javadoc.jar']
        }

        when:
        file("build/repo").deleteDir()
        succeeds "publish", "-PjavadocEnabled=false"

                    }

                    outgoing {
                        artifact(layout.projectDirectory.file(project.name + '-jar.txt'))
                    }
                }
                javadocElements {
                    canBeResolved = false
                    assert canBeConsumed
                    attributes {
                        attribute(Attribute.of('shared', String), 'shared-value')

            AdhocComponentWithVariants adhocComponent = (AdhocComponentWithVariants) component;
            Configuration javadocElements = feature.getJavadocElementsConfiguration();
            if (javadocElements != null) {
                adhocComponent.addVariantsFromConfiguration(javadocElements, new JavaConfigurationVariantMapping("runtime", true));
            }

        }
    }

    @Override
    public void withJavadocJar() {
        if (javadocElements != null) {
            return;
        }
        this.javadocElements = JvmPluginsHelper.createDocumentationVariantWithArtifact(
            sourceSet.getJavadocElementsConfigurationName(),
            SourceSet.isMain(sourceSet) ? null : name,

The only attribute distinguishing these variants is 'org.gradle.docstype'. Add this attribute to the consumer's configuration to resolve the ambiguity:
  - Value: 'javadoc' selects variant: 'javadocElements'
  - Value: 'sources' selects variant: 'sourcesElements'"""
    }