Jerry/bird
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
bird/doc/Makefile

50 lines
1.4 KiB
Makefile
Raw Permalink Normal View History

Modified the Makefile to work in the source tree. From now, you can just `make userdocs' in doc, no need to use ugly scripts. Also, `make progdocs' builds the programmer's documentation in HTML, LaTeX version to come later.
2000-05-31 19:35:47 +08:00
# Force rebuilds
Build system reworked to one global Makefile with includes and no nesting Also removed the lib-dir merging with sysdep. Updated #include's accordingly. Fixed make doc on recent Debian together with moving generated doc into objdir. Moved Makefile.in into root dir Retired all.o and birdlib.a Linking the final binaries directly from all the .o files.
2016-04-12 17:14:54 +08:00
.PHONY: progspell docs progdocs userdocs
Doc: Include full LinuxDocTools code BIRD uses hacked LinuxDocTools for building documentation, keeping some parts locally and using remaining parts from system-installed one. This setup breaks when LinuxDocTools makes some internal changes and is hard to keep consistent. Just include full LinuxDocTools code (both hacked and unmodified parts) to avoid consistency issues. Note that we still need some binaries from LinuxDocTools, so it still needs to be installed to build documentation.
2021-04-25 07:07:14 +08:00
doc-srcdir := $(realpath $(srcdir)/doc)
toolsdir := $(realpath $(srcdir)/tools)
Modified the Makefile to work in the source tree. From now, you can just `make userdocs' in doc, no need to use ugly scripts. Also, `make progdocs' builds the programmer's documentation in HTML, LaTeX version to come later.
2000-05-31 19:35:47 +08:00
docs: progdocs userdocs
Build system reworked to one global Makefile with includes and no nesting Also removed the lib-dir merging with sysdep. Updated #include's accordingly. Fixed make doc on recent Debian together with moving generated doc into objdir. Moved Makefile.in into root dir Retired all.o and birdlib.a Linking the final binaries directly from all the .o files.
2016-04-12 17:14:54 +08:00
doc-fmt = $(1): $(o)prog.$(1) $(o)bird.$(1)
$(call doc-fmt,html)
$(call doc-fmt,dvi)
$(call doc-fmt,ps)
$(call doc-fmt,pdf)
progdocs: $(o)prog.html $(o)prog.pdf
userdocs: $(o)bird.html $(o)bird.pdf
progspell: $(o)prog.spell
$(o)prog.sgml: $(srcdir)/tools/progdoc $(objdir)/.dir-stamp
$(srcdir)/tools/progdoc $(srcdir) $@
$(o)%.sgml: $(s)%.sgml $(objdir)/.dir-stamp
cp $< $@
Few bugs removed from sgml, makefile added.
2000-04-18 00:51:28 +08:00
Build system reworked to one global Makefile with includes and no nesting Also removed the lib-dir merging with sysdep. Updated #include's accordingly. Fixed make doc on recent Debian together with moving generated doc into objdir. Moved Makefile.in into root dir Retired all.o and birdlib.a Linking the final binaries directly from all the .o files.
2016-04-12 17:14:54 +08:00
$(o)%.html: $(o)%.sgml
Doc: Include full LinuxDocTools code BIRD uses hacked LinuxDocTools for building documentation, keeping some parts locally and using remaining parts from system-installed one. This setup breaks when LinuxDocTools makes some internal changes and is hard to keep consistent. Just include full LinuxDocTools code (both hacked and unmodified parts) to avoid consistency issues. Note that we still need some binaries from LinuxDocTools, so it still needs to be installed to build documentation.
2021-04-25 07:07:14 +08:00
cd $(dir $@) && $(toolsdir)/linuxdoc -B html $(notdir $<)
Few bugs removed from sgml, makefile added.
2000-04-18 00:51:28 +08:00
Merge branch 'master' into int-new
2016-11-09 02:27:58 +08:00
$(o)%.tex: $(o)%.sgml
Doc: Include full LinuxDocTools code BIRD uses hacked LinuxDocTools for building documentation, keeping some parts locally and using remaining parts from system-installed one. This setup breaks when LinuxDocTools makes some internal changes and is hard to keep consistent. Just include full LinuxDocTools code (both hacked and unmodified parts) to avoid consistency issues. Note that we still need some binaries from LinuxDocTools, so it still needs to be installed to build documentation.
2021-04-25 07:07:14 +08:00
cd $(dir $@) && $(toolsdir)/linuxdoc -B latex --output=tex $(notdir $<)
Merge branch 'master' into int-new
2016-11-09 02:27:58 +08:00
Build system reworked to one global Makefile with includes and no nesting Also removed the lib-dir merging with sysdep. Updated #include's accordingly. Fixed make doc on recent Debian together with moving generated doc into objdir. Moved Makefile.in into root dir Retired all.o and birdlib.a Linking the final binaries directly from all the .o files.
2016-04-12 17:14:54 +08:00
$(o)%.dvi: $(o)%.tex
cd $(dir $@) && TEXINPUTS=$(TEXINPUTS):$(doc-srcdir)/tex latex $(notdir $<)
cd $(dir $@) && TEXINPUTS=$(TEXINPUTS):$(doc-srcdir)/tex latex $(notdir $<)
Few bugs removed from sgml, makefile added.
2000-04-18 00:51:28 +08:00
Build system reworked to one global Makefile with includes and no nesting Also removed the lib-dir merging with sysdep. Updated #include's accordingly. Fixed make doc on recent Debian together with moving generated doc into objdir. Moved Makefile.in into root dir Retired all.o and birdlib.a Linking the final binaries directly from all the .o files.
2016-04-12 17:14:54 +08:00
$(o)%.ps: $(o)%.dvi
Proper building and installation of documentation in the Makefiles.
2000-06-09 14:31:43 +08:00
dvips -D600 -ta4 -o $@ $<
Few bugs removed from sgml, makefile added.
2000-04-18 00:51:28 +08:00
Merge branch 'master' into int-new
2016-11-09 02:27:58 +08:00
$(o)%.pdf: $(o)%.tex
Filters: VPN Route Distinguishers, Prefix Type, Docs Update
2017-03-13 20:50:32 +08:00
TEXINPUTS=$(TEXINPUTS):$(doc-srcdir)/tex pdflatex -output-directory=$(dir $@) $<
TEXINPUTS=$(TEXINPUTS):$(doc-srcdir)/tex pdflatex -output-directory=$(dir $@) $<
Modified the Makefile to work in the source tree. From now, you can just `make userdocs' in doc, no need to use ugly scripts. Also, `make progdocs' builds the programmer's documentation in HTML, LaTeX version to come later.
2000-05-31 19:35:47 +08:00
Build system reworked to one global Makefile with includes and no nesting Also removed the lib-dir merging with sysdep. Updated #include's accordingly. Fixed make doc on recent Debian together with moving generated doc into objdir. Moved Makefile.in into root dir Retired all.o and birdlib.a Linking the final binaries directly from all the .o files.
2016-04-12 17:14:54 +08:00
$(o)%.txt: $(o)%.sgml
Doc: Include full LinuxDocTools code BIRD uses hacked LinuxDocTools for building documentation, keeping some parts locally and using remaining parts from system-installed one. This setup breaks when LinuxDocTools makes some internal changes and is hard to keep consistent. Just include full LinuxDocTools code (both hacked and unmodified parts) to avoid consistency issues. Note that we still need some binaries from LinuxDocTools, so it still needs to be installed to build documentation.
2021-04-25 07:07:14 +08:00
cd $(dir $@) && $(toolsdir)/linuxdoc -B txt $(notdir $<)
Added `progspell' target which runs ispell on the progdoc SGML file with all function, variable and structure names removed.
2000-06-07 20:27:18 +08:00
Build system reworked to one global Makefile with includes and no nesting Also removed the lib-dir merging with sysdep. Updated #include's accordingly. Fixed make doc on recent Debian together with moving generated doc into objdir. Moved Makefile.in into root dir Retired all.o and birdlib.a Linking the final binaries directly from all the .o files.
2016-04-12 17:14:54 +08:00
$(o)prog.spell: $(o)prog.sgml $(s)prog-spell.sed
sed -f $(lastword $^) <$< >$@
ispell $@
Proper building and installation of documentation in the Makefiles.
2000-06-09 14:31:43 +08:00
Build system reworked to one global Makefile with includes and no nesting Also removed the lib-dir merging with sysdep. Updated #include's accordingly. Fixed make doc on recent Debian together with moving generated doc into objdir. Moved Makefile.in into root dir Retired all.o and birdlib.a Linking the final binaries directly from all the .o files.
2016-04-12 17:14:54 +08:00
$(call clean,prog.spell $(addprefix *.,html dvi ps pdf sgml tex txt aux log toc))
Reference in a new issue Copy permalink