summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorBernhard Reutner-Fischer <rep.dot.nop@gmail.com>2006-06-16 17:19:39 +0000
committerBernhard Reutner-Fischer <rep.dot.nop@gmail.com>2006-06-16 17:19:39 +0000
commitfa61ca75916b46d808d6d341f164691ad56c9d4f (patch)
treec565cf59b7cef3cea84448e1e6a8fc040f0b071d
parent6d82f94681618d50411bb7e4e30e40a0f0046d4c (diff)
- add cross-reference generation target.
Experimental.
-rw-r--r--Makefile14
1 files changed, 13 insertions, 1 deletions
diff --git a/Makefile b/Makefile
index 55f45f945..82bcca62f 100644
--- a/Makefile
+++ b/Makefile
@@ -140,6 +140,7 @@ help:
@echo ' all - Executable and documentation'
@echo ' busybox - the swiss-army executable'
@echo ' doc - docs/BusyBox.{txt,html,1}'
+ @echo ' html - create html-based cross-reference'
@echo
@echo 'Configuration:'
@echo ' allnoconfig - disable all symbols in .config'
@@ -473,7 +474,7 @@ clean:
libbusybox.so* \
.config.old busybox busybox_unstripped
- rm -r -f _install testsuite/links
- - find . -name .\*.flags -o -name \*.o -o -name \*.om \
+ - find . -name .\*.flags -o -name \*.o -o -name \*.om -o -name \*.syn \
-o -name \*.os -o -name \*.osm -o -name \*.a | xargs rm -f
distclean: clean
@@ -503,6 +504,17 @@ release: distclean #doc
tags:
ctags -R .
+# documentation, cross-reference
+# Modern distributions already ship synopsis packages (e.g. debian)
+# If you have an old distribution go to http://synopsis.fresco.org/
+syn_tgt := $(wildcard $(patsubst %,%/*.c,$(SRC_DIRS)))
+syn := $(patsubst %.c, %.syn, $(syn_tgt))
+
+%.syn: %.c
+ synopsis -p C -l Comments.SSDFilter,Comments.Previous $(INCS) -Wp,verbose,debug,preprocess,cppflags="'$(CFLAGS) $(EXTRA_CFLAGS) $(LDFLAGS) $(PROG_CFLAGS) $(PROG_LDFLAGS) $(CFLAGS_COMBINE) $(APPLETS_DEFINE) $(BUSYBOX_DEFINE)'" -o $@ $<
+html: $(syn)
+ synopsis -f HTML -Wf,title="'BusyBox Documentation'" -o $@ $^
+
endif # ifeq ($(skip-makefile),)