Travis CI and Documentation Generation improvements

* Use docker images from docker hub instead of building them on Travis
* Fix doxygen warnings for C/C++ Documentation
* Fix examples inclusion in documentation
* Modify Travis build matrix to include stages and additional jobs
* Update doxygen2jsdoc submodule
* Add doxyport submodule
* Generate documentation for each language in Travis
* Add sonar.java.binaries to sonar-scan.sh

Signed-off-by: Nicolas Oliver <dario.n.oliver@intel.com>

scripts/build-doc.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+set -x
+set -e
+
+# Install doxygen2jsdoc dependencies
+cd doxygen2jsdoc && npm install && cd ..
+
+# Install doxyport dependencies
+cd doxyport && make setup && cd ..
+
+# Make Documentation
+make -j8 -Cbuild
+
+# Make Java Documentation
+cd build/src/java && echo ../../../src/mraa.i > mraa.i.list && \
+../../../doxyport/doxyport mraa.i.list \
+    --cmake ../../compile_commands.json \
+    --source ../../../api,../../../api/mraa \
+    --destination $(pwd)/ \
+    --convert-protected-to-private \
+    --output mraa-java-files.txt \
+    --mapping ../../../examples/samples.mapping.txt && \
+doxygen Doxyfile && cd ../../../
+
+# Copy output to build/html/ directory
+cp -r build/src/python/python2/docs/html build/html/python && \
+cp -r build/src/java/html build/html/java && \
+cp build/jsdoc/ternjs/mraa/doc.js build/html/node/mraa_tern.js