restore examples to doxygen output

these were incorrectly stripped in:
50fa585 Removing examples code generation and making them static.

Change-Id: Idb475ad5b303634311e9f616604312cb925cc6a9

diff --git a/docs.mk b/docs.mk
index 9426f76..797b466 100644 (file)
--- a/docs.mk
+++ b/docs.mk
@@ -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 e4abcf7..40756e1 100644 (file)
--- 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 += $^" > $@