Add a hook to the build to disable doc publishing and genjavadoc

Handy when varying other build parameters, such as `scalaVersion`,
results in unavailabilty of genjavadoc or in a Scaladoc bug.

Author: retronym

build.sbt

@@ -69,9 +69,13 @@ initialize := {
     sys.error("Java 8 or higher is required for this project.")
 }
 
+val disableDocs = sys.props("nodocs") == "true"
+
+publishArtifact in packageDoc := !disableDocs
+
 lazy val JavaDoc = config("genjavadoc") extend Compile
 
-inConfig(JavaDoc)(Defaults.configSettings) ++ Seq(
+inConfig(JavaDoc)(Defaults.configSettings) ++ (if (disableDocs) Nil else Seq(
   packageDoc in Compile <<= packageDoc in JavaDoc,
   sources in JavaDoc <<= (target, compile in Compile, sources in Compile) map ((t, c, s) =>
     (t / "java" ** "*.java").get ++ s.filter(_.getName.endsWith(".java"))
@@ -80,7 +84,7 @@ inConfig(JavaDoc)(Defaults.configSettings) ++ Seq(
   artifactName in packageDoc in JavaDoc := ((sv, mod, art) => "" + mod.name + "_" + sv.binary + "-" + mod.revision + "-javadoc.jar"),
   libraryDependencies += compilerPlugin("com.typesafe.genjavadoc" % "genjavadoc-plugin_2.11.4" % "0.8"),
   scalacOptions in Compile <+= target map (t => "-P:genjavadoc:out=" + (t / "java"))
-)
+))
 
 initialCommands :=
 """|import scala.concurrent._