Fix nasa#28, Deploy documents to github

.travis.yml

@@ -1,7 +1,6 @@
+os: linux
 dist: bionic
-sudo: required
-language:
-  - c
+language: c
 compiler:
   - gcc
 addons:
@@ -14,7 +13,8 @@ env:
   global:
    - SIMULATION=native
    - ENABLE_UNIT_TESTS=true
-  matrix:
+   - DEPLOY_DIR=HOME/deploy
+  jobs:
    - BUILDTYPE=release OMIT_DEPRECATED=true
    - BUILDTYPE=release OMIT_DEPRECATED=false
    - BUILDTYPE=debug OMIT_DEPRECATED=true
@@ -23,6 +23,25 @@ env:
 before_install:
   - sudo apt-get install cppcheck doxygen lcov graphviz
 
+deploy:
+  provider: pages
+  skip_cleanup: true
+  github_token: $DEPLOY_TOKEN  # Set in the settings page of your repository, as a secure variable
+  keep_history: false
+  on:
+    branch: master
+  env: BUILDTYPE=release OMIT_DEPRECATED=true
+  script:
+    - mkdir DEPLOY_DIR
+    - cd DEPLOY_DIR
+    - echo test
+#  basically build the two docs, copy to deploydir (rename as cFE_Users_Guide.pdf, OSAL_Users_Guide.pdf
+#   - cd build/doc/users_guide/latex
+#  - make
+#  - cd build/doc/osalguide/latex
+#  - make
+#  - cd ../../../..
+
 script:
   # Check versions
   - cppcheck --version
@@ -59,6 +78,7 @@ script:
       cat make_doc_stderr.txt
       exit -1
     fi
+  # Eventually enforce no doxygen warnings
   - make usersguide > make_usersguide_stdout.txt 2> make_usersguide_stderr.txt
   - |
     if [[ -s make_usersguide_stderr.txt ]]; then
@@ -67,6 +87,13 @@ script:
       cat make_usersguide_stderr.txt
       exit -1
     fi
+  - |
+    if [[ -s build/doc/warnings.log]]; then
+      echo "You must fix doxygen warnings for \"usersguide\" before submitting a pull request"
+      echo ""
+      cat build/doc/warnings.log
+      exit -1
+    fi
   - make osalguide > make_osalguide_stdout.txt 2> make_osalguide_stderr.txt
   - |
     if [[ -s make_osalguide_stderr.txt ]]; then
@@ -75,7 +102,13 @@ script:
       cat make_osalguide_stderr.txt
       exit -1
     fi
-  # Eventually enforce no doxygen warnings
+  - |
+    if [[ -s build/doc/warnings.log]]; then
+      echo "You must fix doxygen warnings for \"osalguide\" before submitting a pull request"
+      echo ""
+      cat build/doc/warnings.log
+      exit -1
+    fi
   # List cpu1 for core binary
   - ls build/exe/cpu1/
   # Start cFE (pipe output to file), pause, send reset command, check outputs