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.

diff --git a/TODO b/TODO
index 108f13213e2f91882e61f1ee3b25f002e8a42dc9..7f478f27c4f8137f9a6f5735861352ab4c474c89 100644 (file)
--- a/TODO
+++ b/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

diff --git a/doc/Makefile b/doc/Makefile
index fe263be5f63d9a6393cc5dbaef742528518eef57..f16de99a0068c5c4fea292f282f3cb7ccd0c7e34 100644 (file)
--- a/doc/Makefile
+++ b/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
-#      bird.html
-
-clean:
-       rm *.html *.tex *.dvi *.log
+userdocs:
 
 %.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
-       kernel-doc -html ../filter/filter.c ../proto/rip/rip.c > internals.html
+clean:
+       rm *.html *.tex *.dvi *.log

diff --git a/tools/Makefile-top.in b/tools/Makefile-top.in
index 0dee0dc77d4858e43498bf53a478c79bf3725897..415bc87620ec14f41c3e432d2f75f6597b928549 100644 (file)
--- a/tools/Makefile-top.in
+++ b/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:

diff --git a/tools/Makefile.in b/tools/Makefile.in
index 1dcb9bce9aa94d85933ced9340bd792f480bda5d..5eb71835d9d187d34e52953d1344fba8c0a0df32 100644 (file)
--- a/tools/Makefile.in
+++ b/tools/Makefile.in
@@ -3,9 +3,7 @@
 
 include Rules
 
-srcdir_abs := $(shell cd $(srcdir) ; pwd)
-
-.PHONY: all daemon client subdir depend clean distclean tags
+.PHONY: all daemon client subdir depend clean distclean tags docs userdocs progdocs
 
 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

diff --git a/tools/Rules.in b/tools/Rules.in
index a10f76fd387d3d4d467ebe1347be2e889ef311f4..6e786266ec2028d7f5d0b248aa9703c9f381df4d 100644 (file)
--- a/tools/Rules.in
+++ b/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@