Added rosdoc_lite check

Author: fmauch

.github/actions/rosdoc_lite_action/Dockerfile

@@ -0,0 +1,8 @@
+FROM ros:noetic
+COPY entrypoint.sh /entrypoint.sh
+
+RUN apt-get update && apt-get install -y \
+    ros-noetic-rosdoc-lite \
+    graphviz
+
+ENTRYPOINT ["/entrypoint.sh"]

.github/actions/rosdoc_lite_action/action.yml

@@ -0,0 +1,6 @@
+# action.yml
+name: 'check rosdoc_lite'
+description: 'runs rosdoc_lite and check for warnings and errors'
+runs:
+  using: 'docker'
+  image: 'Dockerfile'

.github/actions/rosdoc_lite_action/entrypoint.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+
+source /opt/ros/noetic/setup.bash
+
+IGNORE_PATTERN_FILE=.rosdoc_ignore_patterns
+
+OUT_DIR=$(mktemp -d)
+
+# We are only interested in stderr, hence we forward stdout to /dev/null
+# As we want to parse the output using sed, we need to pipe stderr to stdout afterwards to we can process it
+err_output=$(rosdoc_lite . -o ${OUT_DIR} 2>&1 > /dev/null | grep -v -E -f $IGNORE_PATTERN_FILE)
+
+if [[ -z "$err_output" ]]; then
+  echo "Check successful. rosdoc_lite didn't report any errors or warnings."
+else
+  echo $err_output
+  echo "rosdoc_lite found errors or warnings."
+  exit 1
+fi
+exit 0

.github/workflows/ci.yml

@@ -56,3 +56,9 @@ jobs:
             --exclude=tcp_socket.cpp \
             --exclude=real_time.md
 
+  rosdoc_lite_check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v1
+      - uses: ./.github/actions/rosdoc_lite_action
+

.rosdoc_ignore_patterns

@@ -0,0 +1,11 @@
+To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
+warning: Tag 'TCL_SUBST' at line [0-9]+ of file '[a-zA-Z0-9_/]+' has become obsolete.
+warning: Tag 'COLS_IN_ALPHA_INDEX' at line 986 of file '[a-zA-Z0-9_/]+' has become obsolete.
+warning: Tag 'PERL_PATH' at line [0-9]+ of file '[a-zA-Z0-9_/]+' has become obsolete.
+warning: Tag 'MSCGEN_PATH' at line [0-9]+ of file '[a-zA-Z0-9_/]+' has become obsolete.
+warning: argument 'a4wide' for option PAPER_TYPE is not a valid enum value
+Using the default: a4!
+warning: tag INCLUDE_PATH: include path '\$INCLUDE_PATH' does not exist
+warning: source '\$INCLUDE_PATH' is not a readable file or directory... skipping.
+warning: source \$INCLUDE_PATH is not a readable file or directory... skipping.
+^$