< prev index next >

./build.gradle

Print this page
rev 10428 : 8091730: Enable -Xdoclint:all to treat all javadoc warnings as errors
Reviewed-by:


 426 // These tests should be protected with :
 427 //    assumeTrue(Boolean.getBoolean("unstable.test"));
 428 defineProperty("UNSTABLE_TEST", "false")
 429 ext.IS_UNSTABLE_TEST = Boolean.parseBoolean(UNSTABLE_TEST);
 430 
 431 // Toggle diagnostic output from the Gradle workaround and the Sandbox test apps.
 432 defineProperty("WORKER_DEBUG", "false")
 433 ext.IS_WORKER_DEBUG = Boolean.parseBoolean(WORKER_DEBUG);
 434 
 435 // Specify the build configuration (Release, Debug, or DebugNative)
 436 defineProperty("CONF", "Debug")
 437 ext.IS_DEBUG_JAVA = CONF == "Debug" || CONF == "DebugNative"
 438 ext.IS_DEBUG_NATIVE = CONF == "DebugNative"
 439 
 440 // Defines the compiler warning levels to use. If empty, then no warnings are generated. If
 441 // not empty, then the expected syntax is as a space or comma separated list of names, such
 442 // as defined in the javac documentation.
 443 defineProperty("LINT", "none")
 444 ext.IS_LINT = LINT != "none"
 445 
 446 defineProperty("DOC_LINT", "none")
 447 ext.IS_DOC_LINT = DOC_LINT != "none"
 448 
 449 // Specifies whether to use the "useDepend" option when compiling Java sources
 450 defineProperty("USE_DEPEND", "true")
 451 ext.IS_USE_DEPEND = Boolean.parseBoolean(USE_DEPEND)
 452 
 453 // Specifies whether to use the "incremental" option when compiling Java sources
 454 defineProperty("INCREMENTAL", "false")
 455 ext.IS_INCREMENTAL = Boolean.parseBoolean(INCREMENTAL)
 456 
 457 // Specifies whether to include the Null3D pipeline (for perf debugging)
 458 defineProperty("INCLUDE_NULL3D", "false")
 459 ext.IS_INCLUDE_NULL3D = Boolean.parseBoolean(INCLUDE_NULL3D)
 460 
 461 // Specifies whether to include the ES2 pipeline if available
 462 defineProperty("INCLUDE_ES2", IS_WINDOWS ? "false" : "true")
 463 ext.IS_INCLUDE_ES2 = Boolean.parseBoolean(INCLUDE_ES2)
 464 
 465 // Specifies whether to generate code coverage statistics when running tests
 466 defineProperty("JCOV", "false")
 467 ext.DO_JCOV = Boolean.parseBoolean(JCOV)


3495     executable = JAVADOC
3496     def projectsToDocument = [
3497             project(":base"), project(":graphics"), project(":controls"), project(":media"),
3498             project(":swing"), /*project(":swt"),*/ project(":fxml"), project(":web")]
3499     source(projectsToDocument.collect({
3500         [it.sourceSets.main.java]
3501     }));
3502     setDestinationDir(new File(buildDir, 'javadoc'));
3503 
3504     exclude("com/**/*", "Compile*", "javafx/builder/**/*", "javafx/scene/accessibility/**/*");
3505     options.tags("moduleGraph:X")
3506     options.windowTitle("${javadocTitle}")
3507     options.header("${javadocHeader}")
3508     options.bottom("${javadocBottom}")
3509     if (BUILD_CLOSED) {
3510         options.linksOffline(JDK_DOCS, JDK_DOCS_CLOSED);
3511     } else {
3512         options.links(JDK_DOCS);
3513     }
3514     options.addBooleanOption("XDignore.symbol.file").setValue(true);
3515     options.addBooleanOption("Xdoclint:none").setValue(!IS_DOC_LINT);
3516     options.addBooleanOption("javafx").setValue(true);
3517     options.addBooleanOption("use").setValue(true);
3518 
3519     options.setOptionFiles([
3520         new File(rootProject.buildDir,MODULESOURCEPATH)
3521         ]);
3522 
3523     doLast {
3524         projectsToDocument.each { p ->
3525             copy {
3526                 from "$p.projectDir/src/main/docs"
3527                 into "$buildDir/javadoc"
3528             }
3529         }
3530     }
3531 
3532     dependsOn(projectsToDocument.collect { project -> project.getTasksByName("classes", true)});
3533 }
3534 
3535 task sdk() {




 426 // These tests should be protected with :
 427 //    assumeTrue(Boolean.getBoolean("unstable.test"));
 428 defineProperty("UNSTABLE_TEST", "false")
 429 ext.IS_UNSTABLE_TEST = Boolean.parseBoolean(UNSTABLE_TEST);
 430 
 431 // Toggle diagnostic output from the Gradle workaround and the Sandbox test apps.
 432 defineProperty("WORKER_DEBUG", "false")
 433 ext.IS_WORKER_DEBUG = Boolean.parseBoolean(WORKER_DEBUG);
 434 
 435 // Specify the build configuration (Release, Debug, or DebugNative)
 436 defineProperty("CONF", "Debug")
 437 ext.IS_DEBUG_JAVA = CONF == "Debug" || CONF == "DebugNative"
 438 ext.IS_DEBUG_NATIVE = CONF == "DebugNative"
 439 
 440 // Defines the compiler warning levels to use. If empty, then no warnings are generated. If
 441 // not empty, then the expected syntax is as a space or comma separated list of names, such
 442 // as defined in the javac documentation.
 443 defineProperty("LINT", "none")
 444 ext.IS_LINT = LINT != "none"
 445 
 446 defineProperty("DOC_LINT", "all")
 447 ext.IS_DOC_LINT = DOC_LINT != ""
 448 
 449 // Specifies whether to use the "useDepend" option when compiling Java sources
 450 defineProperty("USE_DEPEND", "true")
 451 ext.IS_USE_DEPEND = Boolean.parseBoolean(USE_DEPEND)
 452 
 453 // Specifies whether to use the "incremental" option when compiling Java sources
 454 defineProperty("INCREMENTAL", "false")
 455 ext.IS_INCREMENTAL = Boolean.parseBoolean(INCREMENTAL)
 456 
 457 // Specifies whether to include the Null3D pipeline (for perf debugging)
 458 defineProperty("INCLUDE_NULL3D", "false")
 459 ext.IS_INCLUDE_NULL3D = Boolean.parseBoolean(INCLUDE_NULL3D)
 460 
 461 // Specifies whether to include the ES2 pipeline if available
 462 defineProperty("INCLUDE_ES2", IS_WINDOWS ? "false" : "true")
 463 ext.IS_INCLUDE_ES2 = Boolean.parseBoolean(INCLUDE_ES2)
 464 
 465 // Specifies whether to generate code coverage statistics when running tests
 466 defineProperty("JCOV", "false")
 467 ext.DO_JCOV = Boolean.parseBoolean(JCOV)


3495     executable = JAVADOC
3496     def projectsToDocument = [
3497             project(":base"), project(":graphics"), project(":controls"), project(":media"),
3498             project(":swing"), /*project(":swt"),*/ project(":fxml"), project(":web")]
3499     source(projectsToDocument.collect({
3500         [it.sourceSets.main.java]
3501     }));
3502     setDestinationDir(new File(buildDir, 'javadoc'));
3503 
3504     exclude("com/**/*", "Compile*", "javafx/builder/**/*", "javafx/scene/accessibility/**/*");
3505     options.tags("moduleGraph:X")
3506     options.windowTitle("${javadocTitle}")
3507     options.header("${javadocHeader}")
3508     options.bottom("${javadocBottom}")
3509     if (BUILD_CLOSED) {
3510         options.linksOffline(JDK_DOCS, JDK_DOCS_CLOSED);
3511     } else {
3512         options.links(JDK_DOCS);
3513     }
3514     options.addBooleanOption("XDignore.symbol.file").setValue(true);
3515     options.addBooleanOption("Xdoclint:${DOC_LINT}").setValue(IS_DOC_LINT);
3516     options.addBooleanOption("javafx").setValue(true);
3517     options.addBooleanOption("use").setValue(true);
3518 
3519     options.setOptionFiles([
3520         new File(rootProject.buildDir,MODULESOURCEPATH)
3521         ]);
3522 
3523     doLast {
3524         projectsToDocument.each { p ->
3525             copy {
3526                 from "$p.projectDir/src/main/docs"
3527                 into "$buildDir/javadoc"
3528             }
3529         }
3530     }
3531 
3532     dependsOn(projectsToDocument.collect { project -> project.getTasksByName("classes", true)});
3533 }
3534 
3535 task sdk() {


< prev index next >