mirrors
/
postgres
mirror of https://github.com/postgres/postgres
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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.
This commit is contained in:
Peter Eisentraut 2001-09-18 12:08:27 +00:00
parent 89fa551808
commit 4a4abd4232
4 changed files with 23 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/src/Makefile
View File

@ -1,16 +1,15 @@
# Postgres documentation makefile
# $Header: /cvsroot/pgsql/doc/src/Makefile,v 1.21 2001/09/17 23:00:27 petere Exp $
# $Header: /cvsroot/pgsql/doc/src/Makefile,v 1.22 2001/09/18 12:08:26 petere Exp $
subdir = doc/src
top_builddir = ../..
include $(top_builddir)/src/Makefile.global
ZIPSUFFIX= gz
TAREXCLUDE= --exclude=Makefile --exclude='*.sgml' --exclude=ref
SRC= admin developer reference programmer tutorial user postgres
BOOKS = admin developer reference programmer tutorial user postgres
TARGETS= $(SRC:%=%.tar.$(ZIPSUFFIX))
TARGETS= $(BOOKS:%=%.tar.$(ZIPSUFFIX))
.PRECIOUS:
.PHONY: install all sources clean distclean
@ -33,33 +32,12 @@ sources:
sources.tar:
$(TAR) -cf $@ sgml graphics
admin.tar developer.tar reference.tar user.tar:
$(addsuffix .tar, $(BOOKS)):
$(MAKE) -C sgml clean
$(MAKE) -C sgml $(basename $@).html
$(MAKE) -C sgml $(basename $@).html
cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.css
programmer.tar:
$(MAKE) -C sgml clean
$(MAKE) -C sgml programmer.html
$(MAKE) -C sgml programmer.html
abssrcdir=`cd $(srcdir) && pwd`; \
cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.css -C $$abssrcdir/graphics catalogs.gif connections.gif
tutorial.tar:
$(MAKE) -C sgml clean
$(MAKE) -C sgml tutorial.html
$(MAKE) -C sgml tutorial.html
abssrcdir=`cd $(srcdir) && pwd`; \
cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.css -C $$abssrcdir/graphics clientserver.gif
postgres.tar:
$(MAKE) -C sgml clean
$(MAKE) -C sgml postgres.html
$(MAKE) -C sgml postgres.html
abssrcdir=`cd $(srcdir) && pwd`; \
cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.css -C $$abssrcdir/graphics catalogs.gif clientserver.gif connections.gif
$(MAKE) -C sgml $(basename $@).html JADEFLAGS='-V html-manifest'
cd sgml && $(TAR) -c -f ../$@ -T HTML.manifest *.gif *.css
man.tar:
$(MAKE) -C sgml man
$(TAR) -cf $@ -C sgml man1 man$(sqlmansect_dummy)
$(TAR) -c -f $@ -C sgml man1 man$(sqlmansect_dummy)

15
doc/src/sgml/Makefile
View File

@ -8,7 +8,7 @@
#
#
# IDENTIFICATION
# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.38 2001/08/29 19:14:39 petere Exp $
# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.39 2001/09/18 12:08:26 petere Exp $
#
#----------------------------------------------------------------------------
@ -82,12 +82,17 @@ JADE.html = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -c $(CATALOG) -d stylesheet.dsl
postgres.html: postgres.sgml $(ALLSGML) stylesheet.dsl
@rm -f *.html
$(JADE.html) $<
ln -sf $@ index.html
ln -sf index.html $@
$(addsuffix .html, $(ALLBOOKS)): %.html: %.sgml $(ALLSGML) stylesheet.dsl
@rm -f *.html
$(JADE.html) book-decl.sgml $<
ln -sf $@ index.html
ln -sf index.html $@
tutorial.html: clientserver.gif
programmer.html: catalogs.gif connections.gif
postgres.html: clientserver.gif catalogs.gif connections.gif
COLLATEINDEX = $(PERL) $(DOCBOOKSTYLE)/bin/collateindex.pl -f -g -t 'Index'
@ -134,7 +139,7 @@ $(addsuffix .tex, $(ALLBOOKS)): %.tex: %.sgml $(ALLSGML) stylesheet.dsl
# Graphics
%.gif:
cp -p ../graphics/$@ .
cp $(srcdir)/../graphics/$@ .
##
@ -179,7 +184,7 @@ check-postgres: postgres.sgml
clean distclean maintainer-clean:
# HTML
rm -f HTML.manifest *.html
rm -f HTML.manifest *.html *.gif
# man
rm -rf *.1 *.$(DEFAULTSECTION) man1 man$(DEFAULTSECTION) manpage.refs manpage.links manpage.log
# print

6
doc/src/sgml/plsql.sgml
View File

@ -1,5 +1,5 @@
<!--
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/plsql.sgml,v 2.39 2001/09/13 15:55:23 petere Exp $
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/plsql.sgml,v 2.40 2001/09/18 12:08:26 petere Exp $
-->
<chapter id="plpgsql">
@ -1715,13 +1715,15 @@ CREATE FUNCTION c_overpaid (EMP, integer) RETURNS boolean AS '
</address>
</affiliation>
</author>
<!--
Breaks HTML manifest file
<legalnotice>
<para>
Except for portions of this document quoted from other sources,
this document is licensed under the BSD License.
</para>
</legalnotice>
-->
</sect1info>
<title>Porting from Oracle PL/SQL</title>

3
doc/src/sgml/stylesheet.dsl
View File

@ -1,4 +1,4 @@
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/stylesheet.dsl,v 1.10 2001/09/15 00:48:59 petere Exp $ -->
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/stylesheet.dsl,v 1.11 2001/09/18 12:08:27 petere Exp $ -->
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!-- must turn on one of these with -i on the jade command line -->
@ -44,6 +44,7 @@
(define %section-autolabel% #t)
(define %generate-legalnotice-link% #t)
(define %html-ext% ".html")
(define %root-filename% "index")
(define %link-mailto-url% (string-append "mailto:" pgsql-docs-list))
(define %use-id-as-filename% #t)
(define %stylesheet% "stylesheet.css")