Added Travis testing of the docs so that errors are seen sooner

.travis.yml

@@ -0,0 +1,33 @@
+# See the NOTICE file distributed with this work for additional information
+# regarding copyright ownership.
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+
+#     http://www.apache.org/licenses/LICENSE-2.0
+
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+language: python
+
+os: linux
+
+python:
+    - "2.7"
+    - "3.6"
+
+install:
+    # Install APIs and Pipelines
+    - cd ${HOME}/build/Multiscale-Genomics/mg-docs
+
+    # Fixed version due to errors in 1.7.3
+    # TODO test when 1.7.4 is available
+    - pip install sphinx==1.7.2
+
+script:
+    ./scripts/travis/docs_harness.sh

scritps/travis/docs_harness.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+# See the NOTICE file distributed with this work for additional information
+# regarding copyright ownership.
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+
+#     http://www.apache.org/licenses/LICENSE-2.0
+
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+rc=0
+
+cd docs
+make html 2> output.err
+
+grep -v "Cannot import \"pycompss\" API packages." output.err > output.tmp.err
+grep -v 'Using mock decorators.' output.tmp.err | grep -v 'FutureWarning' | grep -v 'register_converters' > output.err
+
+if [[ -s output.err ]]
+then
+    cat output.err
+    exit 1
+fi