Commit 7be1eb44 authored by Samuel Martin's avatar Samuel Martin Committed by Peter Korsgaard
Browse files

manual: add a make target 'manual-update-lists' 



The generated lists are automatically updated when building the manual.

[Peter: fix typos]
Signed-off-by: default avatarSamuel Martin <s.martin49@gmail.com>
[yann.morin.1998@free.fr: indentation, remove temp dir, intro to host utils]
Signed-off-by: default avatar"Yann E. MORIN" <yann.morin.1998@free.fr>
Signed-off-by: default avatarPeter Korsgaard <jacmet@sunsite.dk>
parent 88f2b436

docs/manual/appendix.txt

+2 −0
Original line number Diff line number Diff line
@@ -20,6 +20,8 @@ include::package-list.txt[] 
Host utilities

--------------



The following packages are all available in the menu +Host utilities+.



include::host-package-list.txt[]



[[deprecated-list]]

docs/manual/manual.mk

+14 −5
Original line number Diff line number Diff line 
manual-update-lists:

	$(Q)$(call MESSAGE,"Updating the manual lists...")

	$(Q)BR2_DEFCONFIG="" TOPDIR=$(TOPDIR) O=$(O)/docs/manual/.build \

		$(TOPDIR)/support/scripts/gen-manual-lists.py



################################################################################

# GENDOC -- generates the make targets needed to build a specific type of

#           asciidoc documentation.
@@ -17,11 +22,15 @@ $(1): $(1)-$(3) 
.PHONY: $(1)-$(3)

$(1)-$(3): $$(O)/docs/$(1)/$(1).$(4)



$$(O)/docs/$(1)/$(1).$(4): docs/$(1)/$(1).txt $$($(call UPPERCASE,$(1))_SOURCES)

	@$(call MESSAGE,"Generating $(5) $(1)...")

	$(Q)mkdir -p $$(@D)

$$(O)/docs/$(1)/$(1).$(4): docs/$(1)/$(1).txt \

			   $$($(call UPPERCASE,$(1))_SOURCES) \

			   manual-update-lists

	$(Q)$(call MESSAGE,"Generating $(5) $(1)...")

	$(Q)mkdir -p $$(@D)/.build

	$(Q)rsync -au docs/$(1)/*.txt $$(@D)/.build

	$(Q)a2x $(6) -f $(2) -d book -L -r $(TOPDIR)/docs/images \

	  -D $$(@D) $$<

	        -D $$(@D) $$(@D)/.build/$(1).txt

	-$(Q)rm -rf $$(@D)/.build

endef



################################################################################
@@ -41,7 +50,7 @@ $(call GENDOC_INNER,$(1),epub,epub,epub,EPUB) 
clean: $(1)-clean

$(1)-clean:

	$(Q)$(RM) -rf $(O)/docs/$(1)

.PHONY: $(1) $(1)-clean

.PHONY: $(1) $(1)-clean manual-update-lists

endef



MANUAL_SOURCES = $(wildcard docs/manual/*.txt) $(wildcard docs/images/*)