Browse Source

Revise configuration for javadoc Gradle tasks

Closes gh-34766
pull/35405/head
Sam Brannen 8 months ago
parent
commit
f40d98668d
  1. 5
      framework-api/framework-api.gradle
  2. 28
      gradle/spring-module.gradle

5
framework-api/framework-api.gradle

@ -31,8 +31,9 @@ javadoc {
destinationDir = project.java.docsDir.dir("javadoc-api").get().asFile destinationDir = project.java.docsDir.dir("javadoc-api").get().asFile
splitIndex = true splitIndex = true
links(rootProject.ext.javadocLinks) links(rootProject.ext.javadocLinks)
addBooleanOption('Xdoclint:syntax,reference', true) // only check syntax and reference with doclint // Check for 'syntax' and 'reference' during linting.
addBooleanOption('Werror', true) // fail build on Javadoc warnings addBooleanOption('Xdoclint:syntax,reference', true)
addBooleanOption('Werror', true) // fail build on Javadoc warnings
} }
maxMemory = "1024m" maxMemory = "1024m"
doFirst { doFirst {

28
gradle/spring-module.gradle

@ -70,21 +70,19 @@ normalization {
javadoc { javadoc {
description = "Generates project-level javadoc for use in -javadoc jar" description = "Generates project-level javadoc for use in -javadoc jar"
options.encoding = "UTF-8" options {
options.memberLevel = JavadocMemberLevel.PROTECTED encoding = "UTF-8"
options.author = true memberLevel = JavadocMemberLevel.PROTECTED
options.header = project.name author = true
options.use = true header = project.name
options.links(project.ext.javadocLinks) use = true
// Check for syntax during linting. 'none' doesn't seem to work in suppressing links(project.ext.javadocLinks)
// all linting warnings all the time (see/link references most notably). // Check for 'syntax' during linting. Note that the global
options.addStringOption("Xdoclint:syntax", "-quiet") // 'framework-api:javadoc' task checks for 'reference' in addition
// to 'syntax'.
// Suppress warnings due to cross-module @see and @link references. addBooleanOption("Xdoclint:syntax,-reference", true)
// Note that global 'api' task does display all warnings, and addBooleanOption('Werror', true) // fail build on Javadoc warnings
// checks for 'reference' on top of 'syntax'. }
logging.captureStandardError LogLevel.INFO
logging.captureStandardOutput LogLevel.INFO // suppress "## warnings" message
} }
tasks.register('sourcesJar', Jar) { tasks.register('sourcesJar', Jar) {

Loading…
Cancel
Save