Package rife.bld.extension.dokka

Class SourceSet

java.lang.Object
rife.bld.extension.dokka.SourceSet
@NullMarked public class SourceSet extends Object
Configuration for a Dokka source set.
Since:
1.0
Author:
Erik C. Thauvin

  • Constructor Details

    • SourceSet

      public SourceSet()

  • Method Details

    • analysisPlatform

      public SourceSet analysisPlatform(AnalysisPlatform analysisPlatform)
      Sets the platform used for setting up analysis. Default is JVM

      Platform to be used for setting up code analysis and @sample environment.

      Parameters:
      analysisPlatform - the analysis platform
      Returns:
      this operation instance
      Throws:
      NullPointerException - if analysisPlatform is null

    • analysisPlatform

      public @Nullable AnalysisPlatform analysisPlatform()
      Retrieves the platform used for setting up analysis.
      Returns:
      the analysis platform, or null if not set

    • apiVersion

      public SourceSet apiVersion(int apiVersion)
      Sets the Kotlin API version used for setting up analysis and samples.
      Parameters:
      apiVersion - the api version
      Returns:
      this operation instance

    • apiVersion

      public SourceSet apiVersion(String apiVersion)
      Sets the Kotlin API version used for setting up analysis and samples.
      Parameters:
      apiVersion - the api version
      Returns:
      this operation instance
      Throws:
      NullPointerException - if apiVersion is null
      IllegalArgumentException - if apiVersion is empty

    • apiVersion

      public @Nullable String apiVersion()
      Retrieves the Kotlin API version used for setting up analysis and samples.
      Returns:
      the API version, or null if not set

    • args

      public List<String> args()
      Returns the formatted arguments.
      Returns:
      the arguments

    • classpath

      public SourceSet classpath(File... files)
      Sets classpath for analysis and interactive samples.

      This is useful if some types that come from dependencies are not resolved/picked up automatically.

      This option accepts both .jar and .klib files.

      Parameters:
      files - one or more file
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null
      IllegalArgumentException - If files is empty
      See Also:

    • classpath

      public final SourceSet classpath(Collection<File> files)
      Sets classpath for analysis and interactive samples.

      This is useful if some types that come from dependencies are not resolved/picked up automatically.

      This option accepts both .jar and .klib files.

      Parameters:
      files - the collection of files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null
      IllegalArgumentException - If files is empty
      See Also:

    • classpath

      public SourceSet classpath(String... files)
      Sets classpath for analysis and interactive samples.

      This is useful if some types that come from dependencies are not resolved/picked up automatically.

      This option accepts both .jar and .klib files.

      Parameters:
      files - one or more file
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null or contain null elements
      IllegalArgumentException - if files is empty or contains empty elements
      See Also:

    • classpath

      public SourceSet classpath(Path... files)
      Sets classpath for analysis and interactive samples.

      This is useful if some types that come from dependencies are not resolved/picked up automatically.

      This option accepts both .jar and .klib files.

      Parameters:
      files - one or more file
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null
      IllegalArgumentException - If files is empty
      See Also:

    • classpath

      public List<File> classpath()
      Retrieves the classpath for analysis and interactive samples.
      Returns:
      the classpath

    • classpathPaths

      public final SourceSet classpathPaths(Collection<Path> files)
      Sets classpath for analysis and interactive samples.

      This is useful if some types that come from dependencies are not resolved/picked up automatically.

      This option accepts both .jar and .klib files.

      Parameters:
      files - the collection of files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null
      IllegalArgumentException - If files is empty
      See Also:

    • classpathStrings

      public final SourceSet classpathStrings(Collection<String> files)
      Sets classpath for analysis and interactive samples.

      This is useful if some types that come from dependencies are not resolved/picked up automatically.

      This option accepts both .jar and .klib files.

      Parameters:
      files - the collection of files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null or contain null elements
      IllegalArgumentException - if files is empty or contains empty elements
      See Also:

    • dependentSourceSets

      public SourceSet dependentSourceSets(String moduleName, String sourceSetName)
      Sets the names of dependent source sets.
      Parameters:
      moduleName - the module name
      sourceSetName - the source set name
      Returns:
      this operation instance
      Throws:
      NullPointerException - if moduleName or sourceSetName is null
      IllegalArgumentException - if moduleName or sourceSetName is empty

    • dependentSourceSets

      public Map<String,String> dependentSourceSets()
      Retrieves the names of dependent source sets.
      Returns:
      the names

    • dependentSourceSets

      public SourceSet dependentSourceSets(Map<String,String> dependentSourceSets)
      Sets the names of dependent source sets.
      Parameters:
      dependentSourceSets - the map of dependent source set names
      Returns:
      this operation instance
      Throws:
      NullPointerException - if dependentSourceSets is null
      IllegalArgumentException - If dependentSourceSets is empty
      See Also:

    • displayName

      public SourceSet displayName(String displayName)
      Sets the display name of the source set, used both internally and externally.

      The name is used both externally (for example, the source set name is visible to documentation readers) and internally (for example, for logging messages of reportUndocumented).

      The platform name can be used if you don't have a better alternative.

      Parameters:
      displayName - the display name
      Returns:
      this operation instance
      Throws:
      NullPointerException - if displayName is null
      IllegalArgumentException - if displayName is empty

    • displayName

      public @Nullable String displayName()
      Retrieves the display name of the source set.
      Returns:
      the display name, or null if not set

    • documentedVisibilities

      public SourceSet documentedVisibilities(DocumentedVisibility... visibilities)
      Sets visibilities to be documented.

      This can be used if you want to document protected/internal/private declarations, as well as if you want to exclude public declarations and only document internal API.

      This can be configured on per-package basis.

      Parameters:
      visibilities - one or more visibilities
      Returns:
      this operation instance
      Throws:
      NullPointerException - if visibilities is null
      IllegalArgumentException - If visibilities is empty

    • documentedVisibilities

      public List<DocumentedVisibility> documentedVisibilities()
      Retrieves the visibilities to be documented.
      Returns:
      the documented visibilities

    • externalDocumentationLinks

      public SourceSet externalDocumentationLinks(String url, String packageListUrl)
      Sets the external documentation links.

      A set of parameters for external documentation links that is applied only for this source set.

      Parameters:
      url - the external documentation URL
      packageListUrl - the external documentation package list URL
      Returns:
      this operation instance
      Throws:
      NullPointerException - if url or packageListUrl is null
      IllegalArgumentException - if url or packageListUrl is empty

    • externalDocumentationLinks

      public Map<String,String> externalDocumentationLinks()
      Retrieves the external documentation links.
      Returns:
      the documentation links.

    • externalDocumentationLinks

      public SourceSet externalDocumentationLinks(Map<String,String> externalDocumentationLinks)
      Sets the external documentation links.

      A set of parameters for external documentation links that is applied only for this source set.

      Parameters:
      externalDocumentationLinks - the map of external documentation links
      Returns:
      this operation instance
      Throws:
      NullPointerException - if externalDocumentationLinks is null
      IllegalArgumentException - If externalDocumentationLinks is empty
      See Also:

    • includes

      public SourceSet includes(File... files)
      Sets the Markdown files that contain module and package documentation.

      The Markdown files that contain module and package documentation.

      The contents of the specified files are parsed and embedded into documentation as module and package descriptions.

      Parameters:
      files - one or more files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null
      IllegalArgumentException - If files is empty
      See Also:

    • includes

      public final SourceSet includes(Collection<File> files)
      Sets the Markdown files that contain module and package documentation.

      The Markdown files that contain module and package documentation.

      The contents of the specified files are parsed and embedded into documentation as module and package descriptions.

      Parameters:
      files - the collection of files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null
      IllegalArgumentException - If files is empty
      See Also:

    • includes

      public SourceSet includes(String... files)
      Sets the Markdown files that contain module and package documentation.

      The Markdown files that contain module and package documentation.

      The contents of the specified files are parsed and embedded into documentation as module and package descriptions.

      Parameters:
      files - one or more files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null or contain null elements
      IllegalArgumentException - if files is empty or contains empty elements
      See Also:

    • includes

      public SourceSet includes(Path... files)
      Sets the Markdown files that contain module and package documentation.

      The Markdown files that contain module and package documentation.

      The contents of the specified files are parsed and embedded into documentation as module and package descriptions.

      Parameters:
      files - one or more files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null
      IllegalArgumentException - If files is empty
      See Also:

    • includes

      public List<File> includes()
      Retrieves the Markdown files that contain module and package documentation.
      Returns:
      the Markdown files

    • includesPaths

      public final SourceSet includesPaths(Collection<Path> files)
      Sets the Markdown files that contain module and package documentation.

      The Markdown files that contain module and package documentation.

      The contents of the specified files are parsed and embedded into documentation as module and package descriptions.

      Parameters:
      files - the collection of files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null
      IllegalArgumentException - If files is empty
      See Also:

    • includesStrings

      public final SourceSet includesStrings(Collection<String> files)
      Sets the Markdown files that contain module and package documentation.

      The Markdown files that contain module and package documentation.

      The contents of the specified files are parsed and embedded into documentation as module and package descriptions.

      Parameters:
      files - the collection of files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if files is null or contain null elements
      IllegalArgumentException - if files is empty or contains empty elements
      See Also:

    • isEmpty

      public boolean isEmpty()
      Checks if this source set configuration is empty.
      Returns:
      true if no options are set, false otherwise

    • jdkVersion

      public @Nullable String jdkVersion()
      Retrieves the version of the JDK to use for linking to JDK Javadocs.
      Returns:
      the JDK version.

    • jdkVersion

      public SourceSet jdkVersion(int jdkVersion)
      Sets the version of JDK to use for linking to JDK Javadocs.

      The JDK version to use when generating external documentation links for Java types.

      For example, if you use UUID in some public declaration signature, and this option is set to 8, Dokka generates an external documentation link to JDK 8 Javadocs for it.

      Parameters:
      jdkVersion - the JDK version
      Returns:
      this operation instance

    • jdkVersion

      public SourceSet jdkVersion(String jdkVersion)
      Sets the version of JDK to use for linking to JDK Javadocs.

      The JDK version to use when generating external documentation links for Java types.

      For example, if you use UUID in some public declaration signature, and this option is set to 8, Dokka generates an external documentation link to JDK 8 Javadocs for it.

      Parameters:
      jdkVersion - the JDK version
      Returns:
      this operation instance
      Throws:
      NullPointerException - if jdkVersion is null
      IllegalArgumentException - if jdkVersion is empty

    • languageVersion

      public SourceSet languageVersion(int languageVersion)
      Sets the language version used for setting up analysis and samples.
      Parameters:
      languageVersion - the language version
      Returns:
      this operation instance

    • languageVersion

      public SourceSet languageVersion(String languageVersion)
      Sets the language version used for setting up analysis and samples.
      Parameters:
      languageVersion - the language version
      Returns:
      this operation instance
      Throws:
      NullPointerException - if languageVersion is null
      IllegalArgumentException - if languageVersion is empty

    • languageVersion

      public @Nullable String languageVersion()
      Retrieves the language version used for setting up analysis and samples.
      Returns:
      the language version, or null if not set

    • noJdkLink

      public SourceSet noJdkLink(boolean noJdkLink)
      Sets whether to generate links to JDK Javadocs.

      Whether to generate external documentation links to JDK's Javadocs.

      The version of JDK Javadocs is determined by the jdkVersion option.

      Note: Links are generated when noJdkLink is set to false.

      Parameters:
      noJdkLink - true or false
      Returns:
      this operation instance

    • noJdkLink

      public boolean noJdkLink()
      Retrieves whether to generate links to JDK Javadocs.
      Returns:
      true if JDK links are disabled, false otherwise

    • noSkipEmptyPackages

      public SourceSet noSkipEmptyPackages(boolean noSkipEmptyPackages)
      Sets whether to create pages for empty packages.

      Whether to skip packages that contain no visible declarations after various filters have been applied.

      Parameters:
      noSkipEmptyPackages - true or false
      Returns:
      this operation instance

    • noSkipEmptyPackages

      public boolean noSkipEmptyPackages()
      Retrieves whether to create pages for empty packages.
      Returns:
      true if empty packages should not be skipped, false otherwise

    • noStdlibLink

      public SourceSet noStdlibLink(boolean noStdlibLink)
      Sets whether to generate links to Standard library.

      Whether to generate external documentation links that lead to the API reference documentation of Kotlin's standard library.

      Note: Links are generated when noStdLibLink is set to false.

      Parameters:
      noStdlibLink - true or false
      Returns:
      this operation instance

    • noStdlibLink

      public boolean noStdlibLink()
      Retrieves whether to generate links to Standard library.
      Returns:
      true if stdlib links are disabled, false otherwise

    • perPackageOptions

      public List<String> perPackageOptions()
      Retrieves the package source set configuration.
      Returns:
      the package source set configuration

    • perPackageOptions

      public SourceSet perPackageOptions(String... perPackageOptions)
      Set the package source set configuration.

      A set of parameters specific to matched packages within this source set.

      Using format:

      • matchingRegexp
      • -deprecated
      • -privateApi
      • +warnUndocumented
      • +suppress
      • +visibility:PUBLIC
      • ...
      Parameters:
      perPackageOptions - the per package options
      Returns:
      this operation instance
      Throws:
      NullPointerException - if perPackageOptions is null or contain null elements
      IllegalArgumentException - if perPackageOptions is empty or contains empty elements

    • perPackageOptions

      public final SourceSet perPackageOptions(Collection<String> perPackageOptions)
      Set the package source set configuration.

      A set of parameters specific to matched packages within this source set.

      Using format:

      • matchingRegexp
      • -deprecated
      • -privateApi
      • +warnUndocumented
      • +suppress
      • +visibility:PUBLIC
      • ...
      Parameters:
      perPackageOptions - the per package options
      Returns:
      this operation instance
      Throws:
      NullPointerException - if perPackageOptions is null or contain null elements
      IllegalArgumentException - if perPackageOptions is empty or contains empty elements

    • reportUndocumented

      public SourceSet reportUndocumented(boolean reportUndocumented)
      Sets whether to report undocumented declarations.

      Whether to emit warnings about visible undocumented declarations, that is declarations without KDocs after they have been filtered by documentedVisibilities and other filters.

      This setting works well with DokkaOperation.failOnWarning(boolean).

      This can be configured on per-package basis.

      Parameters:
      reportUndocumented - true or false
      Returns:
      this operation instance

    • reportUndocumented

      public boolean reportUndocumented()
      Retrieves whether to report undocumented declarations.
      Returns:
      true if undocumented declarations should be reported, false otherwise

    • samples

      public List<File> samples()
      Retrieves the directories or files that contain sample functions.
      Returns:
      the directories or files

    • samples

      public SourceSet samples(File... samples)
      Set the directories or files that contain sample functions.

      The directories or files that contain sample functions which are referenced via the @sample KDoc tag.

      Parameters:
      samples - one or more samples
      Returns:
      this operation instance
      Throws:
      NullPointerException - if samples is null
      IllegalArgumentException - If samples is empty
      See Also:

    • samples

      public final SourceSet samples(Collection<File> samples)
      Set the directories or files that contain sample functions.

      The directories or files that contain sample functions which are referenced via the @sample KDoc tag.

      Parameters:
      samples - the samples
      Returns:
      this operation instance
      Throws:
      NullPointerException - if samples is null
      IllegalArgumentException - If samples is empty
      See Also:

    • samples

      public SourceSet samples(String... samples)
      Set the directories or files that contain sample functions.

      The directories or files that contain sample functions which are referenced via the @sample KDoc tag.

      Parameters:
      samples - one or more samples
      Returns:
      this operation instance
      Throws:
      NullPointerException - if samples is null or contain null elements
      IllegalArgumentException - if samples is empty or contains empty elements
      See Also:

    • samples

      public SourceSet samples(Path... samples)
      Set the directories or files that contain sample functions.

      The directories or files that contain sample functions which are referenced via the @sample KDoc tag.

      Parameters:
      samples - one or more samples
      Returns:
      this operation instance
      Throws:
      NullPointerException - if samples is null
      IllegalArgumentException - If samples is empty
      See Also:

    • samplesPaths

      public final SourceSet samplesPaths(Collection<Path> samples)
      Set the directories or files that contain sample functions.

      The directories or files that contain sample functions which are referenced via the @sample KDoc tag.

      Parameters:
      samples - the samples
      Returns:
      this operation instance
      Throws:
      NullPointerException - if samples is null
      IllegalArgumentException - If samples is empty
      See Also:

    • samplesStrings

      public final SourceSet samplesStrings(Collection<String> samples)
      Set the directories or files that contain sample functions.

      The directories or files that contain sample functions which are referenced via the @sample KDoc tag.

      Parameters:
      samples - the samples
      Returns:
      this operation instance
      Throws:
      NullPointerException - if samples is null or contain null elements
      IllegalArgumentException - if samples is empty or contains empty elements
      See Also:

    • skipDeprecated

      public SourceSet skipDeprecated(boolean skipDeprecated)
      Sets whether to skip deprecated declarations.

      Whether to document declarations annotated with @Deprecated.

      This can be configured on per-package basis.

      Parameters:
      skipDeprecated - true or false
      Returns:
      this operation instance

    • skipDeprecated

      public boolean skipDeprecated()
      Retrieves whether to skip deprecated declarations.
      Returns:
      true if deprecated declarations should be skipped, false otherwise

    • sourceSetName

      public SourceSet sourceSetName(String sourceSetName)
      Sets the name of the source set. Default is main.
      Parameters:
      sourceSetName - the source set name.
      Returns:
      this operation instance
      Throws:
      NullPointerException - if sourceSetName is null
      IllegalArgumentException - if sourceSetName is empty

    • sourceSetName

      public @Nullable String sourceSetName()
      Retrieves the name of the source set.
      Returns:
      the source set name, or null if not set

    • src

      public SourceSet src(File... src)
      Sets the source code roots to be analyzed and documented.

      The source code roots to be analyzed and documented. Acceptable inputs are directories and individual .kt / .java files.

      Parameters:
      src - one or more source code roots
      Returns:
      this operation instance
      Throws:
      NullPointerException - if src is null
      IllegalArgumentException - If src is empty
      See Also:

    • src

      public final SourceSet src(Collection<File> src)
      Sets the source code roots to be analyzed and documented.

      The source code roots to be analyzed and documented. Acceptable inputs are directories and individual .kt / .java files.

      Parameters:
      src - the source code roots
      Returns:
      this operation instance
      Throws:
      NullPointerException - if src is null
      IllegalArgumentException - If src is empty
      See Also:

    • src

      public SourceSet src(String... src)
      Sets the source code roots to be analyzed and documented.

      The source code roots to be analyzed and documented. Acceptable inputs are directories and individual .kt / .java files.

      Parameters:
      src - one or more source code roots
      Returns:
      this operation instance
      Throws:
      NullPointerException - if src is null or contain null elements
      IllegalArgumentException - if src is empty or contains empty elements
      See Also:

    • src

      public SourceSet src(Path... src)
      Sets the source code roots to be analyzed and documented.

      The source code roots to be analyzed and documented. Acceptable inputs are directories and individual .kt / .java files.

      Parameters:
      src - One or more source code roots
      Returns:
      this operation instance
      Throws:
      NullPointerException - if src is null
      IllegalArgumentException - If src is empty
      See Also:

    • src

      public List<File> src()
      Retrieves the source code roots to be analyzed and documented.
      Returns:
      the source code roots

    • srcLink

      public SourceSet srcLink(File srcPath, String remotePath, String lineSuffix)
      Sets the mapping between a source directory and a Web service for browsing the code.
      Parameters:
      srcPath - the source path
      remotePath - the remote path
      lineSuffix - the line suffix
      Returns:
      this operation instance
      Throws:
      NullPointerException - if srcPath, remotePath or lineSuffix are null
      IllegalArgumentException - if srcPath, remotePath or lineSuffix are empty

    • srcLink

      public SourceSet srcLink(String srcPath, String remotePath, String lineSuffix)
      Sets the mapping between a source directory and a Web service for browsing the code.
      Parameters:
      srcPath - the source path
      remotePath - the remote path
      lineSuffix - the line suffix
      Returns:
      this operation instance
      Throws:
      NullPointerException - if srcPath, remotePath or lineSuffix are null
      IllegalArgumentException - if srcPath, remotePath or lineSuffix are empty

    • srcLink

      public SourceSet srcLink(Path srcPath, String remotePath, String lineSuffix)
      Sets the mapping between a source directory and a Web service for browsing the code.
      Parameters:
      srcPath - the source path
      remotePath - the remote path
      lineSuffix - the line suffix
      Returns:
      this operation instance
      Throws:
      NullPointerException - if srcPath, remotePath or lineSuffix are null

    • srcLinks

      public Map<String,String> srcLinks()
      Retrieves the mapping between a source directory and a Web service for browsing the code.
      Returns:
      the source links

    • srcPaths

      public final SourceSet srcPaths(Collection<Path> src)
      Sets the source code roots to be analyzed and documented.

      The source code roots to be analyzed and documented. Acceptable inputs are directories and individual .kt / .java files.

      Parameters:
      src - the source code roots
      Returns:
      this operation instance
      Throws:
      NullPointerException - if src is null
      IllegalArgumentException - If src is empty
      See Also:

    • srcStrings

      public final SourceSet srcStrings(Collection<String> src)
      Sets the source code roots to be analyzed and documented.

      The source code roots to be analyzed and documented. Acceptable inputs are directories and individual .kt / .java files.

      Parameters:
      src - the source code roots
      Returns:
      this operation instance
      Throws:
      NullPointerException - if src is null or contain null elements
      IllegalArgumentException - if src is empty or contains empty elements
      See Also:

    • suppressAnnotatedWith

      public List<String> suppressAnnotatedWith()
      Retrieves the annotation fully qualified names (FQNs) to suppress declarations annotated with.
      Returns:
      the annotations

    • suppressAnnotatedWith

      public SourceSet suppressAnnotatedWith(String... annotations)
      Sets the annotation fully qualified names (FQNs) to suppress declarations annotated with.
      Parameters:
      annotations - one or more annotation
      Returns:
      this operation instance
      Throws:
      NullPointerException - if annotations is null or contain null elements
      IllegalArgumentException - if annotations is empty or contains blank elements

    • suppressAnnotatedWith

      public final SourceSet suppressAnnotatedWith(Collection<String> annotations)
      Sets the annotation fully qualified names (FQNs) to suppress declarations annotated with.
      Parameters:
      annotations - the annotations
      Returns:
      this operation instance
      Throws:
      NullPointerException - if annotations is null or contain null elements
      IllegalArgumentException - if annotations is empty or contains blank elements

    • suppressedFiles

      public List<File> suppressedFiles()
      Retrieves the paths to files to be suppressed.
      Returns:
      the paths

    • suppressedFiles

      public SourceSet suppressedFiles(String... suppressedFiles)
      Sets the paths to files to be suppressed.

      The files to be suppressed when generating documentation.

      Parameters:
      suppressedFiles - one or more suppressed files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if suppressedFiles is null or contain null elements
      IllegalArgumentException - if suppressedFiles is empty or contains empty elements
      See Also:

    • suppressedFiles

      public final SourceSet suppressedFiles(Collection<File> suppressedFiles)
      Sets the paths to files to be suppressed.

      The files to be suppressed when generating documentation.

      Parameters:
      suppressedFiles - the suppressed files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if suppressedFiles is null
      IllegalArgumentException - If suppressedFiles is empty
      See Also:

    • suppressedFiles

      public SourceSet suppressedFiles(File... suppressedFiles)
      Sets the paths to files to be suppressed.

      The files to be suppressed when generating documentation.

      Parameters:
      suppressedFiles - one or more suppressed files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if suppressedFiles is null
      IllegalArgumentException - If suppressedFiles is empty
      See Also:

    • suppressedFiles

      public SourceSet suppressedFiles(Path... suppressedFiles)
      Sets the paths to files to be suppressed.

      The files to be suppressed when generating documentation.

      Parameters:
      suppressedFiles - one or more suppressed files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if suppressedFiles is null
      IllegalArgumentException - If suppressedFiles is empty
      See Also:

    • suppressedFilesPaths

      public final SourceSet suppressedFilesPaths(Collection<Path> suppressedFiles)
      Sets the paths to files to be suppressed.

      The files to be suppressed when generating documentation.

      Parameters:
      suppressedFiles - the suppressed files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if suppressedFiles is null
      IllegalArgumentException - If suppressedFiles is empty
      See Also:

    • suppressedFilesStrings

      public final SourceSet suppressedFilesStrings(Collection<String> suppressedFiles)
      Sets the paths to files to be suppressed.

      The files to be suppressed when generating documentation.

      Parameters:
      suppressedFiles - the suppressed files
      Returns:
      this operation instance
      Throws:
      NullPointerException - if suppressedFiles is null or contain null elements
      IllegalArgumentException - if suppressedFiles is empty or contains empty elements
      See Also: