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.
This commit is contained in:
parent
c7d7794bb9
commit
b177724896
5 changed files with 26 additions and 24 deletions
2
TODO
2
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
|
||||
|
|
24
doc/Makefile
24
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
|
||||
|
|
|
@ -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:
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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@
|
||||
|
|
Loading…
Reference in a new issue