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

scripts/run-cmake.sh

@@ -21,6 +21,7 @@ cmake \
   -DINSTALLTOOLS=$INSTALLTOOLS \
   -DBUILDTESTS=$BUILDTESTS \
   -DUSEPYTHON3TESTS=$USEPYTHON3TESTS \
+  -DCMAKE_EXPORT_COMPILE_COMMANDS=ON \
   -H. \
   -Bbuild
 

scripts/sonar-scan.sh

@@ -37,6 +37,7 @@ sonar_cmd_base="build-wrapper-linux-x86-64 --out-dir ${bw_output_path} make clea
         -Dsonar.projectBaseDir=${MRAA_SRC_DIR} \
         -Dsonar.sources=${MRAA_SRC_DIR} \
         -Dsonar.inclusions='api/**/*,CMakeLists.txt,examples/**/*,imraa/**/*,include/**/*,src/**/*,tests/**/*' \
+        -Dsonar.java.binaries='src' \
         -Dsonar.coverage.exclusions='**/*' \
         -Dsonar.cfamily.build-wrapper-output=${bw_output_path} \
         -Dsonar.host.url=https://sonarqube.com \