postgresql/doc/src/Makefile

# Postgres documentation makefile
# $Header: /cvsroot/pgsql/doc/src/Makefile,v 1.29 2002/07/28 15:19:59 petere Exp $

subdir = doc/src
top_builddir = ../..
include $(top_builddir)/src/Makefile.global

ZIPSUFFIX= gz

BOOKS = admin developer reference programmer tutorial user  postgres

TARGETS= $(BOOKS:%=%.tar.$(ZIPSUFFIX))

.PRECIOUS:
.PHONY: install all sources clean distclean

install:
	$(MAKE) all
	(mv -f *.$(ZIPSUFFIX) ..)

clean distclean maintainer-clean:
	$(MAKE) -C sgml $@

all: $(TARGETS)

sources:
	$(MAKE) sources.tar.$(ZIPSUFFIX)

sources.tar:
	$(TAR) -cf $@ sgml graphics

# Build twice to resolve index entries
$(addsuffix .tar, $(BOOKS)):
	$(MAKE) -C sgml clean
	$(MAKE) -C sgml $(basename $@).html
	$(MAKE) -C sgml $(basename $@).html JADEFLAGS='-V html-manifest'
	cd sgml && $(TAR) -cf ../$@ `cat HTML.manifest` `echo *.gif | grep -v '\*'` *.css

man.tar:
	$(MAKE) -C sgml man
	$(TAR) -cf $@ -C sgml man1 man$(sqlmansect_dummy)
SGML source for new documentation. 1998-03-01 03:16:16 -05:00			`# Postgres documentation makefile`
Clean documentation subtree during make clean. 2002-07-28 11:19:59 -04:00			`# $Header: /cvsroot/pgsql/doc/src/Makefile,v 1.29 2002/07/28 15:19:59 petere Exp $`
SGML source for new documentation. 1998-03-01 03:16:16 -05:00
Fix relative path references so that make knowns which dependencies refer to one another. Sort out builddir vs srcdir variable namings. Remove some now obsoleted make variables. 2000-08-31 12:12:35 -04:00			`subdir = doc/src`
			`top_builddir = ../..`
Revive Reference Manual, remove reference pages from User's Guide. Make version.sgml the central place for updating version numbers in the documentation. Document titles now contain the version number of the release they belong to. filelist.sgml is the central (and only) place to declare system entities (i.e., sgml files). No longer a need to declare them in each document header. There is no longer any need to maintain duplicate chapter lists in postgres.sgml and user/admin/etc.sgml, everything is build from the same sources. Some parameter entities allow for different text to be included when the integrated or a single doc set is generated, which eliminates the problems that had caused this to fail in the past. 2000-11-24 12:44:22 -05:00			`include $(top_builddir)/src/Makefile.global`
SGML source for new documentation. 1998-03-01 03:16:16 -05:00
Define ZIP rather than GZIP. Define ZIPSUFFIX to allow substitution of something other than gzip. 2000-09-11 23:47:36 -04:00			`ZIPSUFFIX= gz`
SGML source for new documentation. 1998-03-01 03:16:16 -05:00
Generate index.html as the root file name of the documentation set, rather than making index.html a symlink to the autogenerated name. Fixes fatal problems with tar programs that don't handle symlinks very well (MacOS X). (The names user.html, admin.html, etc. are still available as make targets, but they aren't packaged anymore.) Use the manifest file that the stylesheets generate as the file list for packaging. Put graphics in the right place while building, not while packaging, so you can actually look at them after building. 2001-09-18 08:08:27 -04:00			`BOOKS = admin developer reference programmer tutorial user postgres`
SGML source for new documentation. 1998-03-01 03:16:16 -05:00
Generate index.html as the root file name of the documentation set, rather than making index.html a symlink to the autogenerated name. Fixes fatal problems with tar programs that don't handle symlinks very well (MacOS X). (The names user.html, admin.html, etc. are still available as make targets, but they aren't packaged anymore.) Use the manifest file that the stylesheets generate as the file list for packaging. Put graphics in the right place while building, not while packaging, so you can actually look at them after building. 2001-09-18 08:08:27 -04:00			`TARGETS= $(BOOKS:%=%.tar.$(ZIPSUFFIX))`
SGML source for new documentation. 1998-03-01 03:16:16 -05:00
Make this rely on a real Makefile in sgml/. Implement installation and cleaning. 1998-03-01 15:47:20 -05:00			`.PRECIOUS:`
			`.PHONY: install all sources clean distclean`
SGML source for new documentation. 1998-03-01 03:16:16 -05:00
Automatic dependency tracking The .DEFAULT rule in backend/Makefile is harmful -- removed. Replace `::' rules by `:'. 2000-07-16 10:50:44 -04:00			`install:`
SGML source for new documentation. 1998-03-01 03:16:16 -05:00			`$(MAKE) all`
Define ZIP rather than GZIP. Define ZIPSUFFIX to allow substitution of something other than gzip. 2000-09-11 23:47:36 -04:00			`(mv -f *.$(ZIPSUFFIX) ..)`
Make this rely on a real Makefile in sgml/. Implement installation and cleaning. 1998-03-01 15:47:20 -05:00
Clean documentation subtree during make clean. 2002-07-28 11:19:59 -04:00			`clean distclean maintainer-clean:`
			`$(MAKE) -C sgml $@`
SGML source for new documentation. 1998-03-01 03:16:16 -05:00
Automatic dependency tracking The .DEFAULT rule in backend/Makefile is harmful -- removed. Replace `::' rules by `:'. 2000-07-16 10:50:44 -04:00			`all: $(TARGETS)`
SGML source for new documentation. 1998-03-01 03:16:16 -05:00
Automatic dependency tracking The .DEFAULT rule in backend/Makefile is harmful -- removed. Replace `::' rules by `:'. 2000-07-16 10:50:44 -04:00			`sources:`
Define ZIP rather than GZIP. Define ZIPSUFFIX to allow substitution of something other than gzip. 2000-09-11 23:47:36 -04:00			`$(MAKE) sources.tar.$(ZIPSUFFIX)`
SGML source for new documentation. 1998-03-01 03:16:16 -05:00
Allow building a source tarball. Try to generalize the gzip/tar usage for more portability. 1998-05-09 18:32:03 -04:00			`sources.tar:`
Split out Developer's from Programmer's guide. 2000-10-08 09:24:09 -04:00			`$(TAR) -cf $@ sgml graphics`
Allow building a source tarball. Try to generalize the gzip/tar usage for more portability. 1998-05-09 18:32:03 -04:00
Fix comment 2001-11-25 17:17:27 -05:00			`# Build twice to resolve index entries`
Generate index.html as the root file name of the documentation set, rather than making index.html a symlink to the autogenerated name. Fixes fatal problems with tar programs that don't handle symlinks very well (MacOS X). (The names user.html, admin.html, etc. are still available as make targets, but they aren't packaged anymore.) Use the manifest file that the stylesheets generate as the file list for packaging. Put graphics in the right place while building, not while packaging, so you can actually look at them after building. 2001-09-18 08:08:27 -04:00			`$(addsuffix .tar, $(BOOKS)):`
SGML source for new documentation. 1998-03-01 03:16:16 -05:00			`$(MAKE) -C sgml clean`
Revive Reference Manual, remove reference pages from User's Guide. Make version.sgml the central place for updating version numbers in the documentation. Document titles now contain the version number of the release they belong to. filelist.sgml is the central (and only) place to declare system entities (i.e., sgml files). No longer a need to declare them in each document header. There is no longer any need to maintain duplicate chapter lists in postgres.sgml and user/admin/etc.sgml, everything is build from the same sources. Some parameter entities allow for different text to be included when the integrated or a single doc set is generated, which eliminates the problems that had caused this to fail in the past. 2000-11-24 12:44:22 -05:00			`$(MAKE) -C sgml $(basename $@).html`
Generate index.html as the root file name of the documentation set, rather than making index.html a symlink to the autogenerated name. Fixes fatal problems with tar programs that don't handle symlinks very well (MacOS X). (The names user.html, admin.html, etc. are still available as make targets, but they aren't packaged anymore.) Use the manifest file that the stylesheets generate as the file list for packaging. Put graphics in the right place while building, not while packaging, so you can actually look at them after building. 2001-09-18 08:08:27 -04:00			`$(MAKE) -C sgml $(basename $@).html JADEFLAGS='-V html-manifest'`
Change tar -T file to tar `cat file` for BSD tar. 2001-09-30 15:18:29 -04:00			cd sgml && $(TAR) -cf ../$@ `cat HTML.manifest` `echo .gif \| grep -v '\'` *.css
SGML source for new documentation. 1998-03-01 03:16:16 -05:00
Include rules for building a man tar file. 1999-07-06 13:13:50 -04:00			`man.tar:`
Use sgml/Makefile to generate man sections, so just "make man" there. 1999-08-08 11:10:21 -04:00			`$(MAKE) -C sgml man`
Change tar -c -f to -cf for BSD tar. 2001-09-30 15:09:57 -04:00			`$(TAR) -cf $@ -C sgml man1 man$(sqlmansect_dummy)`