blob: 9b32258696ba3fe3440e14fc3f18df0ebd7cec39 [file] [log] [blame]
Mario Six78a88f72018-07-10 08:40:17 +02001# Rules to convert a .h file to inline RST documentation
2
Breno Matheus Lima656d8da2019-06-05 18:18:30 +00003SRC_DIR=$(srctree)/doc/media
4PARSER = $(srctree)/doc/sphinx/parse-headers.pl
Mario Six78a88f72018-07-10 08:40:17 +02005API = $(srctree)/include
6
7FILES = linker_lists.h.rst
8
9TARGETS := $(addprefix $(BUILDDIR)/, $(FILES))
10
11gen_rst = \
12 echo ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions; \
13 ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions
14
15quiet_gen_rst = echo ' PARSE $(patsubst $(srctree)/%,%,$<)'; \
16 ${PARSER} $< $@ $(SRC_DIR)/$(notdir $@).exceptions
17
18silent_gen_rst = ${gen_rst}
19
20$(BUILDDIR)/linker_lists.h.rst: ${API}/linker_lists.h ${PARSER} $(SRC_DIR)/linker_lists.h.rst.exceptions
21 @$($(quiet)gen_rst)
22
23# Media build rules
24
Maxim Cournoyer7fa4c272022-12-18 21:48:08 -050025.PHONY: all html texinfo epub xml latex
Mario Six78a88f72018-07-10 08:40:17 +020026
27all: $(IMGDOT) $(BUILDDIR) ${TARGETS}
28html: all
Maxim Cournoyer7fa4c272022-12-18 21:48:08 -050029texinfo: all
Mario Six78a88f72018-07-10 08:40:17 +020030epub: all
31xml: all
32latex: $(IMGPDF) all
33linkcheck:
34
35clean:
36 -rm -f $(DOTTGT) $(IMGTGT) ${TARGETS} 2>/dev/null
37
38$(BUILDDIR):
39 $(Q)mkdir -p $@