mirror of
https://github.com/oliverschmidt/contiki.git
synced 2024-09-11 21:55:41 +00:00
Merge pull request #871 from cmorty/pull/doxyerrors
Regression testing: Doxygen
This commit is contained in:
commit
6b562237ff
@ -8,6 +8,13 @@ before_script:
|
||||
## Support building a binary that is identical to the CI
|
||||
- echo -n "Contiki will be compiled with RELSTR=" ; git --git-dir .git describe --tags --always
|
||||
|
||||
## Install doxygen
|
||||
- if [ ${BUILD_CATEGORY:-0} = doxygen ] ; then
|
||||
sudo add-apt-repository ppa:libreoffice/libreoffice-4-3 -y && sudo apt-get -qq update &&
|
||||
sudo apt-get --no-install-suggests --no-install-recommends -qq install doxygen &&
|
||||
doxygen --version ;
|
||||
fi
|
||||
|
||||
## Install msp430 toolchain
|
||||
- sudo apt-get -qq install lib32z1
|
||||
- $WGET http://adamdunkels.github.io/contiki-fork/mspgcc-4.7.0-compiled.tar.bz2 &&
|
||||
@ -89,6 +96,7 @@ after_script:
|
||||
env:
|
||||
## This magically kick-off parallel jobs for each of the for the sets
|
||||
## of environment variable defined below
|
||||
- BUILD_TYPE='doxygen' BUILD_CATEGORY='doxygen'
|
||||
- BUILD_TYPE='compile-base' BUILD_CATEGORY='compile'
|
||||
- BUILD_TYPE='collect'
|
||||
- BUILD_TYPE='collect-lossy'
|
||||
|
11
doc/Makefile
11
doc/Makefile
@ -23,22 +23,23 @@ endif
|
||||
|
||||
.PHONY: clean html pdf upload
|
||||
|
||||
html: init doxygen
|
||||
html: init doxygen.log
|
||||
|
||||
pdf: doclatex = YES
|
||||
pdf: init doxygen
|
||||
pdf: init doxygen.log
|
||||
gmake -C latex refman.pdf
|
||||
|
||||
init:
|
||||
@echo "> Scanning files"
|
||||
|
||||
# This target requires and graphviz and doxygen
|
||||
doxygen: docdirs = $(foreach dir,$(basedirs),${shell find ../${dir} -type d -not -path "*/.*" -not -path "*/obj_*"})
|
||||
doxygen: docsrc = $(docdirs) $(foreach dir,$(docdirs),${shell find $(dir) -type f $(filetypes)}) $(manuals)
|
||||
doxygen:
|
||||
doxygen.log: docdirs = $(sort ,$(foreach dir,$(basedirs),${shell find ../${dir} -type d -not -path "*/.*" -not -path "*/obj_*"}))
|
||||
doxygen.log: docsrc = $(docdirs) $(foreach dir,$(docdirs),${shell find $(dir) -type f $(filetypes)}) $(manuals)
|
||||
doxygen.log:
|
||||
@doxygen Doxyfile
|
||||
@echo "Done, errorlog follows:"
|
||||
@echo ""
|
||||
@touch doxygen.log
|
||||
@cat "doxygen.log"
|
||||
|
||||
clean:
|
||||
|
54
regression-tests/00-doxygen/Makefile
Normal file
54
regression-tests/00-doxygen/Makefile
Normal file
@ -0,0 +1,54 @@
|
||||
# Copyright (c) 2014, Friedrich-Alexander University Erlangen-Nuremberg
|
||||
# All rights reserved.
|
||||
#
|
||||
# Redistribution and use in source and binary forms, with or without
|
||||
# modification, are permitted provided that the following conditions
|
||||
# are met:
|
||||
# 1. Redistributions of source code must retain the above copyright
|
||||
# notice, this list of conditions and the following disclaimer.
|
||||
# 2. Redistributions in binary form must reproduce the above copyright
|
||||
# notice, this list of conditions and the following disclaimer in the
|
||||
# documentation and/or other materials provided with the distribution.
|
||||
# 3. Neither the name of the University nor the names of its contributors
|
||||
# may be used to endorse or promote products derived from this software
|
||||
# without specific prior written permission.
|
||||
#
|
||||
# THIS SOFTWARE IS PROVIDED BY THE UNIVERSITY AND CONTRIBUTORS ``AS IS'' AND
|
||||
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
# ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
|
||||
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
# SUCH DAMAGE.
|
||||
|
||||
DOCDIR=../../doc
|
||||
|
||||
all: summary
|
||||
|
||||
doxygen:
|
||||
@make -C $(DOCDIR) doxygen.log 2> doxygen.runerr > doxygen.runlog
|
||||
|
||||
summary: doxygen
|
||||
@( doxyerr=`cat doxyerrors.cnt`; curerr=`cat $(DOCDIR)/doxygen.log | grep ": warning: " | wc -l` ; delta=`expr $$curerr - $$doxyerr`; \
|
||||
if [ $$delta -lt 0 ] ; then echo "doxygen: FAIL ಠ_ಠ\nCongratulations you fixed `expr $$delta \"*\" -1 ` of doxyen's warnings (old: $$doxyerr new: $$curerr). Please adjust regression-tests/00-doxygen/doxyerrors.cnt accordingly." > summary; fi ;\
|
||||
if [ $$delta -gt 0 ] ; then echo "doxygen: FAIL ಠ_ಠ\nYou increased the number of warnings caused by doxygen by $$delta (old: $$doxyerr new: $$curerr). Please fix these." > summary; fi ; \
|
||||
if [ $$delta -eq 0 ] ; then echo "doxygen: OK\nDoxygen found $$doxyerr errors" > summary ; fi ; \
|
||||
if [ -s doxygen.runerr ] ; then \
|
||||
echo "Runtime warnings:" >> summary; \
|
||||
cat doxygen.runerr >> summary; \
|
||||
echo >> summary; \
|
||||
fi ; \
|
||||
if [ -s $(DOCDIR)/doxygen.log ] ; then \
|
||||
echo "Warnings:" >> summary; \
|
||||
cat $(DOCDIR)/doxygen.log >> summary; \
|
||||
fi ; \
|
||||
cat summary \
|
||||
)
|
||||
|
||||
|
||||
clean:
|
||||
@make -C $(DOCDIR) clean
|
1
regression-tests/00-doxygen/doxyerrors.cnt
Normal file
1
regression-tests/00-doxygen/doxyerrors.cnt
Normal file
@ -0,0 +1 @@
|
||||
380
|
Loading…
Reference in New Issue
Block a user