documentation/makefile

   1
   2 export DEFINITIONS
   3   # ensure that the macros get passed down to the subprocesses.
   4
   5 include cpp/variables.def
   6
   7 PROJECT = Source_Documentation
   8 TYPE = application
   9 FIRST_TARGETS += build_docs
  10
  11 include cpp/rules.def
  12
  13 build_docs:
  14 #       @echo the defs are $(DEFINITIONS)
  15         @echo Regenerating documentation for feisty meow with doxygen.  This could take a while...
  16         $(HIDESH) -c '\
  17 doxygen $(wildcard *.config) &> "$$TEMPORARIES_PILE/doxygen_run_$$(date +"%Y%m%d%H%M%S").log"; \
  18 if [ $$? -ne 0 ]; then \
  19   echo failed to run doxygen on our configuration file.; \
  20   echo perhaps doxygen is not properly installed?; \
  21   echo these are the ubuntu install steps:; \
  22   echo   sudo apt install doxygen graphviz; \
  23 fi \
  24 '
  25         @echo ...done regenerating the feisty meow docs.
  26
  27 clean_docs:
  28         @echo dropping code_guide contents.
  29         $(HIDESH) -c '\
  30 for dir in ../production/code_guide; do \
  31   for patt in html map md5 png js css ttf dot ; do \
  32     rm -f $$dir/*.$$patt; \
  33   done; \
  34 done \
  35 '
  36
  37