docs.mk

   1 ##
   2 ##  Copyright (c) 2010 The WebM project authors. All Rights Reserved.
   3 ##
   4 ##  Use of this source code is governed by a BSD-style license
   5 ##  that can be found in the LICENSE file in the root of the source
   6 ##  tree. An additional intellectual property rights grant can be found
   7 ##  in the file PATENTS.  All contributing project authors may
   8 ##  be found in the AUTHORS file in the root of the source tree.
   9 ##
  10
  11
  12 INSTALL_MAPS += docs/%    docs/%
  13 INSTALL_MAPS += src/%     %
  14 INSTALL_MAPS += %         %
  15
  16 # Static documentation authored in doxygen
  17 CODEC_DOX :=    mainpage.dox \
  18                 keywords.dox \
  19                 usage.dox \
  20                 usage_cx.dox \
  21                 usage_dx.dox \
  22
  23 # Other doxy files sourced in Markdown
  24 TXT_DOX = $(call enabled,TXT_DOX)
  25
  26 EXAMPLE_PATH += $(SRC_PATH_BARE) #for CHANGELOG, README, etc
  27 EXAMPLE_PATH += $(SRC_PATH_BARE)/examples
  28
  29 doxyfile: $(if $(findstring examples, $(ALL_TARGETS)),examples.doxy)
  30 doxyfile: libs.doxy_template libs.doxy
  31         @echo "    [CREATE] $@"
  32         @cat $^ > $@
  33         @echo "STRIP_FROM_PATH += $(SRC_PATH_BARE) $(BUILD_ROOT)" >> $@
  34         @echo "INPUT += $(addprefix $(SRC_PATH_BARE)/,$(CODEC_DOX))" >> $@;
  35         @echo "INPUT += $(TXT_DOX)" >> $@;
  36         @echo "EXAMPLE_PATH += $(EXAMPLE_PATH)" >> $@
  37
  38 CLEAN-OBJS += doxyfile $(wildcard docs/html/*)
  39 docs/html/index.html: doxyfile $(CODEC_DOX) $(TXT_DOX)
  40         @echo "    [DOXYGEN] $<"
  41         @doxygen $<
  42 DOCS-yes += docs/html/index.html
  43
  44 DIST-DOCS-yes = $(wildcard docs/html/*)
  45 DIST-DOCS-$(CONFIG_CODEC_SRCS) += $(addprefix src/,$(CODEC_DOX))
  46 DIST-DOCS-$(CONFIG_CODEC_SRCS) += src/libs.doxy_template
  47 DIST-DOCS-yes                  += CHANGELOG
  48 DIST-DOCS-yes                  += README