build doc with Doxygen

.gitlab-ci.yml

@@ -14,6 +14,7 @@ job_miniupnpd:
         - "make -j3 -f Makefile.linux && make -f Makefile.linux check"
         - "make -f Makefile.linux clean"
         - "make -j3 -f Makefile.linux_nft"
+        - "make -f Makefile.linux_nft dox"
 
 # i686-w64-mingw32-gcc
 job_miniupnpc:

.travis.yml

@@ -56,6 +56,7 @@ script:
   - 'CONFIG_OPTIONS="--ipv6 --igd2" make -f $MAKEFILE -j3'
   - 'if [ "$TRAVIS_OS_NAME" = "linux" ] && [ "$PROJECT" = "miniupnpd" ]; then make -f Makefile.linux_nft ; fi'
   - make -f $MAKEFILE check
+  - 'if [ "$TRAVIS_OS_NAME" = "linux" ] && [ "$PROJECT" = "miniupnpd" ]; then make -f $MAKEFILE dox ; fi'
   - if [ "$PROJECT" = "miniupnpc" ]; then
       INSTALLPREFIX="$HOME/_pythonmodule" make -f $MAKEFILE pythonmodule;
     fi

miniupnpd/Makefile

@@ -29,6 +29,7 @@ RM = rm -f
 MV = mv
 INSTALL = install
 STRIP = strip
+DOXYGEN ?= doxygen
 
 # OSNAME and FWNAME are used for building OS or FW dependent code.
 OSNAME != uname -s
@@ -225,6 +226,9 @@ depend:	config.h
 	testgetroute.c testportinuse.c testasyncsendto.c \
 	testssdppktgen.c
 
+dox:	miniupnpd.doxyconf
+	$(DOXYGEN) $>
+
 miniupnpd: config.h $(ALLOBJS)
 	$(CC) $(LDFLAGS) -o $@ $(ALLOBJS) $(LIBS)
 

miniupnpd/Makefile.linux

@@ -39,6 +39,7 @@ INSTALL = install
 STRIP ?= strip
 PKG_CONFIG ?= pkg-config
 CP = cp
+DOXYGEN ?= doxygen
 
 
 INSTALLPREFIX ?= $(PREFIX)/usr
@@ -187,7 +188,7 @@ EXECUTABLES = miniupnpd testupnpdescgen testgetifstats \
               testgetroute testasyncsendto testportinuse \
               testssdppktgen testminissdp
 
-.PHONY:	all clean install depend genuuid
+.PHONY:	all clean install depend genuuid dox
 
 all:	$(EXECUTABLES)
 
@@ -202,6 +203,7 @@ clean:
 	$(RM) testssdppktgen.o
 	$(RM) miniupnpdctl.o
 	$(RM) validateupnppermissions validategetifaddr validatessdppktgen
+	$(RM) -r dox/
 
 install:	miniupnpd miniupnpd.8 miniupnpd.conf genuuid \
 	netfilter/iptables_init.sh netfilter/iptables_removeall.sh \
@@ -284,6 +286,9 @@ depend:	config.h
 	testgetroute.c testasyncsendto.c testportinuse.c \
 	miniupnpdctl.c testssdppktgen.c 2>/dev/null
 
+dox:	miniupnpd.doxyconf
+	$(DOXYGEN) $<
+
 # DO NOT DELETE
 
 miniupnpd.o: config.h macros.h upnpglobalvars.h upnppermissions.h

miniupnpd/Makefile.linux_nft

@@ -171,7 +171,7 @@ depend:	config.h
 	miniupnpdctl.c 2>/dev/null
 
 dox:
-	doxygen miniupnpd.doxyconf
+	$(DOXYGEN) miniupnpd.doxyconf
 
 # DO NOT DELETE