Improve parser combinator documentation

 * Links to scala-lang.org/api/... for types from the Scala library
 * Diagrams (if graphviz is around)
 * Links to the source on GitHub (only for released versions)
 * Html pages didn't even a title, they do now

Author: gourlaysama

Diff for: .travis.yml

@@ -1,5 +1,10 @@
 language: scala
 
+addons:
+  apt:
+    packages:
+      - graphviz
+
 before_install:
   - cat /etc/hosts # optionally check the content *before*
   - sudo hostname "$(hostname | cut -c1-63)"

Diff for: build.sbt

@@ -23,7 +23,20 @@ crossScalaVersions in ThisBuild := {
 lazy val `scala-parser-combinators` = crossProject.in(file(".")).
   settings(scalaModuleSettings: _*).
   settings(
-    name := "scala-parser-combinators-root"
+    name := "scala-parser-combinators-root",
+    apiMappings += (scalaInstance.value.libraryJar ->
+        url(s"https://www.scala-lang.org/api/${scalaVersion.value}/")),
+    scalacOptions in (Compile, doc) ++= Seq(
+      "-diagrams",
+      "-doc-source-url",
+      s"https://github.com/scala/scala-parser-combinators/tree/v${version.value}€{FILE_PATH}.scala",
+      "-sourcepath",
+      (baseDirectory in LocalRootProject).value.absolutePath,
+      "-doc-title",
+      "Scala Parser Combinators",
+      "-doc-version",
+      version.value
+    )
   ).
   jvmSettings(
     // Mima uses the name of the jvm project in the artifactId