private final Pattern javadocLinkPattern = Pattern.compile("link:\\{javadocPath\\}/(.*?\\.html)");

    @InputDirectory
    @PathSensitive(PathSensitivity.RELATIVE)
    public abstract DirectoryProperty getDocumentationRoot();

    @InputDirectory
    @PathSensitive(PathSensitivity.RELATIVE)
    public abstract DirectoryProperty getJavadocRoot();

    @OutputFile

For the input of our task, we use a `DirectoryProperty` from Gradle.
We annotate it with `@InputDirectory` to indicate that it is an input to the task:

====
[.multi-language-sample]
=====
.buildSrc/src/main/kotlin/GenerateReportTask.kt
[source,kotlin]
----
import org.gradle.api.DefaultTask
import org.gradle.api.tasks.InputDirectory

public abstract class GenerateReportTask : DefaultTask() {

    @get:InputDirectory

 * limitations under the License.
 */
package org.gradle.api.file

import org.gradle.api.tasks.Classpath
import org.gradle.api.tasks.CompileClasspath
import org.gradle.api.tasks.InputDirectory
import org.gradle.api.tasks.InputFile
import org.gradle.integtests.fixtures.AbstractIntegrationSpec
import org.gradle.internal.reflect.validation.ValidationMessageChecker
import org.gradle.test.precondition.Requires

 * limitations under the License.
 */

package gradlebuild.integrationtests.tasks

import org.gradle.api.file.FileCollection
import org.gradle.api.tasks.CacheableTask
import org.gradle.api.tasks.InputDirectory
import org.gradle.api.tasks.PathSensitive
import org.gradle.api.tasks.PathSensitivity


/**
 * Verifies the correct behavior of a feature, as opposed to just a small unit of code.

        succeeds("custom")
        then:
        result.assertTasksExecuted(":custom")

        where:
        inputType      | inputValue
        InputFile      | 'file("inputs/input")'
        InputDirectory | 'file("inputs")'
        InputFiles     | 'files("inputs")'
        Input          | '{ layout.projectDirectory.file("inputs/input").asFile.text }'
    }

abstract class MyCopyTask extends DefaultTask {

    @InputDirectory abstract DirectoryProperty getSource()

    @OutputDirectory abstract DirectoryProperty getDestination()

    @Inject abstract FileSystemOperations getFs()

    @TaskAction
    void action() {
        fs.copy {
            from source
            into destination
        }
    }
}

// tag::fixed-reuse[]
tasks.register('someTask', MyCopyTask) {

// tag::fixed[]
abstract class MyCopyTask extends DefaultTask { // <1>

    @InputDirectory abstract DirectoryProperty getSource() // <2>

    @OutputDirectory abstract DirectoryProperty getDestination() // <2>

    @Inject abstract FileSystemOperations getFs() // <3>

    @TaskAction
    void action() {
        fs.copy { // <3>
            from source
            into destination
        }
    }
}

        def inputDirectory = inputFilesDir.createDir('dir1')
        writeClass(inputDirectory, "org/gradle/MyFirstClass")
        writeClass(inputDirectory, "org/gradle/MyAClass")
        writeClass(inputDirectory, "org/gradle/MyBClass")

        when:
        relocatedJarCreator.create(outputJar, [jarFile1, jarFile2, jarFile3, jarFile4, jarFile5, jarFile6, inputDirectory])

        then:

}
// end::distributionPathInput[]

// tag::distributionDirInput[]
abstract class DistributionLocationProvider implements CommandLineArgumentProvider {  // <1>
    @InputDirectory
    @PathSensitive(PathSensitivity.RELATIVE)  // <2>
    abstract DirectoryProperty getDistribution()

    @Override
    Iterable<String> asArguments() {

            class MyTask extends DefaultTask {
                @Input String inputString
                @Nested MyConfig nested = new MyConfig()
                @InputFile File inputFile
                @InputDirectory File inputDirectory
                @InputFiles FileCollection inputFiles

                @OutputFile File outputFile
                @OutputFiles FileCollection outputFiles