Connected the `doc' subtree to global makefiles.

All documentation is built in obj/doc (resp. doc/ if you do a stand-alone build).

Use `make docs' to make the whole documentation or `make userdocs' resp.
`make progdocs' for user manual resp. developer's guide.

TODO

@@ -14,6 +14,8 @@ Core
 - configure: --enable-ipv6
 - configure: IPv6 on glibc 2.0?
 
+- Makefile: install target?
+
 - forgetting device routes???
 - kernel syncer doesn't support reconfiguration
 - filter-defined internal attributes

doc/Makefile

@@ -1,34 +1,28 @@
-# Makefile for bird documentation system
+root-rel=../
+dir-name=doc
 
+include ../Rules
 
-SHELL = /bin/sh
+progdocs:
+	mkdir -p prog
+	$(srcdir)/tools/progdoc $(srcdir_abs)
 
-all: internals.html
+userdocs:
-#	bird.html
-
-clean:
-	rm *.html *.tex *.dvi *.log
 
 %.html: %.sgml
 	./sgml2html $<
 
-dnl INFO format:
-
 %.info: %.sgml
 	sgml2info $<
 
-dnl TXT format:
-
 %.txt: %.sgml
 	sgml2txt $<
 
-dnl LATEX format:
-
 %.dvi: %.sgml
 	./sgml2latex $<
 
 %.tex: %.sgml
 	./sgml2latex --output=tex $<
 
-internals.html: ../filter/filter.c ../proto/rip/rip.c
+clean:
-	kernel-doc -html ../filter/filter.c ../proto/rip/rip.c > internals.html
+	rm *.html *.tex *.dvi *.log

tools/Makefile-top.in

@@ -1,9 +1,9 @@
 # Makefile for in place build of BIRD
-# (c) 1999 Martin Mares <mj@ucw.cz>
+# (c) 1999--2000 Martin Mares <mj@ucw.cz>
 
 objdir=@objdir@
 
-all depend tags:
+all depend tags docs userdocs progdocs:
 	$(MAKE) -C $(objdir) $@
 
 clean:

tools/Makefile.in

@@ -3,9 +3,7 @@
 
 include Rules
 
-srcdir_abs := $(shell cd $(srcdir) ; pwd)
+.PHONY: all daemon client subdir depend clean distclean tags docs userdocs progdocs
-
-.PHONY: all daemon client subdir depend clean distclean tags
 
 all: .dep-stamp subdir daemon @CLIENT@
 
@@ -24,18 +22,23 @@ $(exedir)/birdc: client/all.o lib/birdlib.a
 	$(CC) $(LDFLAGS) -o $@ $^ $(LIBS) $(CLIENT_LIBS)
 
 .dir-stamp:
-	mkdir -p $(static-dirs) $(client-dirs)
+	mkdir -p $(static-dirs) $(client-dirs) $(doc-dirs)
 	touch .dir-stamp
 
 .dep-stamp:
 	$(MAKE) depend
 	touch .dep-stamp
 
+docs: userdocs progdocs
+
+userdocs progdocs: .dir-stamp
+	$(MAKE) -C doc -f $(srcdir_abs)/doc/Makefile $@
+
 tags:
 	cd $(srcdir) ; etags -lc `find $(static-dirs) $(addprefix $(objdir)/,$(dynamic-dirs)) $(client-dirs) -name *.[chY]`
 
 clean:
-	find . -name "*.[oa]" -or -name core -or -name depend | xargs rm -f
+	find . -name "*.[oa]" -o -name core -o -name depend -o -name "*.html" | xargs rm -f
 	rm -f $(exedir)/bird $(exedir)/birdc $(exedir)/bird.ctl .dep-stamp
 
 distclean: clean

tools/Rules.in

@@ -1,7 +1,8 @@
 # Makefile fragments for the BIRD Internet Routing Daemon
-# (c) 1999 Martin Mares <mj@ucw.cz>
+# (c) 1999--2000 Martin Mares <mj@ucw.cz>
 
 srcdir=@srcdir_rel_mf@
+srcdir_abs := $(shell cd $(srcdir) ; pwd)
 objdir=@objdir@
 exedir=@exedir@
 
@@ -12,8 +13,10 @@ dynamic-dirs := lib conf
 dynamic-dir-paths := $(dynamic-dirs)
 client-dirs := @CLIENT@
 client-dir-paths := $(client-dirs)
+doc-dirs := doc
+doc-dir-paths := $(doc-dirs)
 
-all-dirs:=$(static-dirs) $(dynamic-dirs) $(client-dirs)
+all-dirs:=$(static-dirs) $(dynamic-dirs) $(client-dirs) $(doc-dirs)
 clean-dirs:=$(all-dirs) proto sysdep
 
 CPPFLAGS=-I$(root-rel) -I$(srcdir) @CPPFLAGS@