Merge devel code into the trunk.

[tinyos-2.x.git] / support / make / docs.extra

diff --git a/support/make/docs.extra b/support/make/docs.extra
new file mode 100644 (file)
index 0000000..7673822
--- /dev/null
+++ b/support/make/docs.extra
@@ -0,0 +1,35 @@
+#-*-Makefile-*- vim:syntax=make
+#$Id$
+
+# configure the base for the app dirs.  This is used to generate more
+# useful package names in the documentation.
+ifeq ($(BASEDIR)_x, _x)
+BASEDIR := $(shell pwd | sed 's@\(.*\)/apps.*$$@\1@' )
+endif
+
+# The output directory for generated documentation
+ifeq ($(DOCDIR)_x, _x)
+DOCDIR := $(BASEDIR)/doc/nesdoc
+endif
+
+COMMA=,
+DOCS := $(subst $(COMMA), ,$(subst ., ,$(DOCS)))
+
+ifeq ($(filter here,$(DOCS)),here)
+DOCDIR = doc
+endif
+
+ifeq ($(filter preserve,$(DOCS)),preserve)
+PFLAGS += -preserve
+endif
+
+BUILD_DEPS = docs_
+
+docs_: FORCE
+       @echo "    Making documentation for $(COMPONENT) on $(PLATFORM)"
+        # first generate the xml files
+       nesdoc -o $(DOCDIR) $(NESDOC_FLAGS) $(PFLAGS) $(CFLAGS) $(COMPONENT).nc
+ifneq ($(filter nohtml,$(DOCS)),nohtml)
+        # generate html from the xml files
+       nesdoc -o $(DOCDIR) -html -target=$(PLATFORM) $(DOCS)
+endif