From 9230f9710f6eb9af819081f4a74d4af368ac14f4 Mon Sep 17 00:00:00 2001 From: Csongor Somogyi Date: Tue, 15 Apr 2014 11:40:51 +0200 Subject: [PATCH] Fixes #13983 Two changes have been made: - In AkkaBuild, forced using UTF-8 to verify HTML files containing diagrams - In the documentation chapter Building Akka, added a section clarifying the Graphviz dependency of generating Scaladoc Content Hierarchies These fixes eliminates the issues I faced while building Akka on Windows with NetBeans. The first issue is a Windows specific issue where the default charset cannot be UTF-8. The second is Windows related in the sense that Graphviz, the optional dependency of Scaladoc, had to be manually resolved. --- akka-docs/rst/dev/building-akka.rst | 10 ++++++++++ project/AkkaBuild.scala | 2 +- 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/akka-docs/rst/dev/building-akka.rst b/akka-docs/rst/dev/building-akka.rst index 2d011a8ff9..100476fc0f 100644 --- a/akka-docs/rst/dev/building-akka.rst +++ b/akka-docs/rst/dev/building-akka.rst @@ -150,3 +150,13 @@ You can look at the Ivy dependency resolution information that is created on the resolution information for the akka-remote module compile dependencies. If you open this file in a web browser you will get an easy to navigate view of dependencies. + +Scaladoc Dependencies +===================== + +The Scaladoc may generate Content (Type) Hierarchy diagrams. For this, you may +be required to download and install Graphviz (http://www.graphviz.org/). +The installed toolset has to be added to the PATH. + +Without Graphviz, the project will be completely built but with error messages +regarding the absence of the diagram tool cumulated at the end. diff --git a/project/AkkaBuild.scala b/project/AkkaBuild.scala index de66c30a4c..54cf11c122 100644 --- a/project/AkkaBuild.scala +++ b/project/AkkaBuild.scala @@ -896,7 +896,7 @@ object AkkaBuild extends Build { val name = f.getName if (name.endsWith(".html") && !name.startsWith("index-") && !(name.compare("index.html") == 0) && !(name.compare("package.html") == 0)) { - val source = scala.io.Source.fromFile(f) + val source = scala.io.Source.fromFile(f)("utf-8") val hd = source.getLines().exists(_.contains("
")) source.close() hd