docs/manual/manual.mk

   1 ################################################################################
   2 #
   3 # The Buildroot manual
   4 #
   5 ################################################################################
   6
   7 MANUAL_SOURCES = $(sort $(wildcard docs/manual/*.txt) $(wildcard docs/images/*))
   8 MANUAL_RESOURCES = $(TOPDIR)/docs/images
   9
  10 # Our manual needs to generate lists
  11 # Packages included in BR2_EXTERNAL are not part of buildroot, so they
  12 # should not be included in the manual.
  13 define MANUAL_GEN_LISTS
  14         $(Q)$(call MESSAGE,"Updating the manual lists...")
  15         $(Q)BR2_DEFCONFIG="" TOPDIR=$(TOPDIR) O=$(@D) \
  16                 BR2_EXTERNAL=$(TOPDIR)/support/dummy-external \
  17                 python -B $(TOPDIR)/support/scripts/gen-manual-lists.py
  18 endef
  19 MANUAL_POST_RSYNC_HOOKS += MANUAL_GEN_LISTS
  20
  21 # Our list-generating script requires argparse
  22 define MANUAL_CHECK_LISTS_DEPS
  23         $(Q)if ! python -c "import argparse" >/dev/null 2>&1 ; then \
  24                 echo "You need python with argparse on your host to generate" \
  25                         "the list of packages in the manual"; \
  26                 exit 1; \
  27         fi
  28 endef
  29 MANUAL_CHECK_DEPENDENCIES_HOOKS += MANUAL_CHECK_LISTS_DEPS
  30
  31 $(eval $(call asciidoc-document))