diff options
author | James Zern <jzern@google.com> | 2014-02-14 19:38:20 -0800 |
---|---|---|
committer | James Zern <jzern@google.com> | 2014-02-14 19:38:20 -0800 |
commit | 354c5660441a6337cd07a5439c18cec04f8e42fd (patch) | |
tree | dc7f7a65faee3bd60b0a70a7ac2db829702c26f2 | |
parent | bb07de7ccea40c145548e8d49752bcccdd08c248 (diff) | |
download | libvpx-354c5660441a6337cd07a5439c18cec04f8e42fd.tar libvpx-354c5660441a6337cd07a5439c18cec04f8e42fd.tar.gz libvpx-354c5660441a6337cd07a5439c18cec04f8e42fd.tar.bz2 libvpx-354c5660441a6337cd07a5439c18cec04f8e42fd.zip |
restore examples to doxygen output
these were incorrectly stripped in:
50fa585 Removing examples code generation and making them static.
Change-Id: Idb475ad5b303634311e9f616604312cb925cc6a9
-rw-r--r-- | docs.mk | 2 | ||||
-rw-r--r-- | examples.mk | 33 |
2 files changed, 35 insertions, 0 deletions
@@ -30,7 +30,9 @@ TXT_DOX = $(call enabled,TXT_DOX) EXAMPLE_PATH += $(SRC_PATH_BARE) #for CHANGELOG, README, etc +EXAMPLE_PATH += $(SRC_PATH_BARE)/examples +doxyfile: $(if $(findstring examples, $(ALL_TARGETS)),examples.doxy) doxyfile: libs.doxy_template libs.doxy @echo " [CREATE] $@" @cat $^ > $@ diff --git a/examples.mk b/examples.mk index e4abcf702..40756e182 100644 --- a/examples.mk +++ b/examples.mk @@ -285,3 +285,36 @@ INSTALL-BINS-$(CONFIG_MSVS) += $(foreach p,$(VS_PLATFORMS),\ $(addprefix bin/$(p)/,$(ALL_EXAMPLES_BASENAME:.c=.exe))) $(foreach proj,$(call enabled,PROJECTS),\ $(eval $(call vcproj_template,$(proj)))) + +# +# Documentation Rules +# +%.dox: %.c + @echo " [DOXY] $@" + @echo "/*!\page example_$(@F:.dox=) $(@F:.dox=)" > $@ + @echo " \includelineno $(<F)" >> $@ + @echo "*/" >> $@ + +samples.dox: examples.mk + @echo " [DOXY] $@" + @echo "/*!\page samples Sample Code" > $@ + @echo " This SDK includes a number of sample applications."\ + "Each sample documents a feature of the SDK in both prose"\ + "and the associated C code."\ + "The following samples are included: ">>$@ + @$(foreach ex,$(sort $(notdir $(EXAMPLES:.c=))),\ + echo " - \subpage example_$(ex) $($(ex).DESCRIPTION)" >> $@;) + @echo >> $@ + @echo " In addition, the SDK contains a number of utilities."\ + "Since these utilities are built upon the concepts described"\ + "in the sample code listed above, they are not documented in"\ + "pieces like the samples are. Their source is included here"\ + "for reference. The following utilities are included:" >> $@ + @$(foreach ex,$(sort $(UTILS:.c=)),\ + echo " - \subpage example_$(ex) $($(ex).DESCRIPTION)" >> $@;) + @echo "*/" >> $@ + +CLEAN-OBJS += examples.doxy samples.dox $(ALL_EXAMPLES:.c=.dox) +DOCS-yes += examples.doxy samples.dox +examples.doxy: samples.dox $(ALL_EXAMPLES:.c=.dox) + @echo "INPUT += $^" > $@ |