From 23d7c6973f1315b2869efcff26270badccf26a7b Mon Sep 17 00:00:00 2001 From: Peter Eisentraut Date: Sun, 8 Oct 2000 13:24:09 +0000 Subject: [PATCH] Split out Developer's from Programmer's guide. --- doc/src/Makefile | 31 +++++++++--------- doc/src/sgml/developer.sgml | 61 ++++++++++++++++++++++++++++++++++++ doc/src/sgml/postgres.sgml | 22 +++++-------- doc/src/sgml/programmer.sgml | 44 +++++--------------------- 4 files changed, 92 insertions(+), 66 deletions(-) create mode 100644 doc/src/sgml/developer.sgml diff --git a/doc/src/Makefile b/doc/src/Makefile index df6f9d953f..f4289a5fa3 100644 --- a/doc/src/Makefile +++ b/doc/src/Makefile @@ -1,5 +1,5 @@ # Postgres documentation makefile -# $Header: /cvsroot/pgsql/doc/src/Makefile,v 1.13 2000/09/12 03:47:36 thomas Exp $ +# $Header: /cvsroot/pgsql/doc/src/Makefile,v 1.14 2000/10/08 13:24:08 petere Exp $ subdir = doc/src top_builddir = ../.. @@ -10,7 +10,7 @@ ZIP= gzip ZIPSUFFIX= gz TAREXCLUDE= --exclude=Makefile --exclude='*.sgml' --exclude=ref -SRC= admin postgres programmer tutorial user +SRC= admin postgres programmer tutorial user developer TARGETS= $(SRC:%=%.tar.$(ZIPSUFFIX)) @@ -33,37 +33,37 @@ sources: $(MAKE) sources.tar.$(ZIPSUFFIX) sources.tar: - ($(TAR) -cf $@ sgml graphics) + $(TAR) -cf $@ sgml graphics admin.tar: $(MAKE) -C sgml clean $(MAKE) -C sgml admin.html - (cd sgml; $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm -C ../graphics layout.gif) + cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm -installation.tar: +developer.tar: $(MAKE) -C sgml clean - $(MAKE) -C sgml installation.html - (cd sgml; $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm) - -postgres.tar: - $(MAKE) -C sgml clean - $(MAKE) -C sgml postgres.html - (cd sgml; $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm -C ../graphics catalogs.gif clientserver.gif connections.gif layout.gif) + $(MAKE) -C sgml developer.html + cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm programmer.tar: $(MAKE) -C sgml clean $(MAKE) -C sgml programmer.html - (cd sgml; $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm -C ../graphics catalogs.gif connections.gif) + cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm -C ../graphics catalogs.gif connections.gif tutorial.tar: $(MAKE) -C sgml clean $(MAKE) -C sgml tutorial.html - (cd sgml; $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm -C ../graphics clientserver.gif) + cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm -C ../graphics clientserver.gif user.tar: $(MAKE) -C sgml clean $(MAKE) -C sgml user.html - (cd sgml; $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm) + cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm + +postgres.tar: + $(MAKE) -C sgml clean + $(MAKE) -C sgml postgres.html + cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm -C ../graphics catalogs.gif clientserver.gif connections.gif man.tar: $(MAKE) -C sgml man @@ -75,4 +75,3 @@ man.tar: %.$(ZIPSUFFIX): % $(ZIP) -f $< - diff --git a/doc/src/sgml/developer.sgml b/doc/src/sgml/developer.sgml new file mode 100644 index 0000000000..183864a7e8 --- /dev/null +++ b/doc/src/sgml/developer.sgml @@ -0,0 +1,61 @@ + + + + + + + + + + + + + + + + + + + + + + + + +]> + + + <productname>PostgreSQL Developer's Guide</></> + + <bookinfo> + <abstract> + <simpara> + This document contains assorted information that can be of use to + <productname>PostgreSQL</> developers. + </simpara> + </abstract> + + <corpauthor>The PostgreSQL Global Development Group</> + </bookinfo> + + &sources; + &arch-dev; + &geqo; +<!-- + This listing of Postgres catalogs is currently just a copy of the old + man page. It is not up to date and has not been marked up for DocBook. + - thomas 2000-04-20 + &catalogs; +--> + &protocol; + &compiler; + &bki; + &page; + &biblio; + +<!-- appendices --> + &cvs; + &docguide; +</book> diff --git a/doc/src/sgml/postgres.sgml b/doc/src/sgml/postgres.sgml index f3fa3912d4..0787a4d80f 100644 --- a/doc/src/sgml/postgres.sgml +++ b/doc/src/sgml/postgres.sgml @@ -1,5 +1,5 @@ <!-- -$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.42 2000/09/30 16:58:20 petere Exp $ +$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.43 2000/10/08 13:24:09 petere Exp $ --> <!doctype set PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ @@ -190,7 +190,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.42 2000/09/30 16:58:20 pe <bookinfo> <abstract> <para> - Information on extending Postgres + Information on client and server programming </para> </abstract> </bookinfo> @@ -201,6 +201,8 @@ $Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.42 2000/09/30 16:58:20 pe included twice. &intro-pg; --> + <part> + <title>Server Programming &arch-pg; &extend; &xfunc; @@ -215,19 +217,10 @@ $Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.42 2000/09/30 16:58:20 pe &trigger; &spi; &xplang; - - - - Interfaces - - - - - Information on Postgres language interfaces - - - + + + Client Interfaces &func-ref; &lobj; &ecpg; @@ -238,6 +231,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.42 2000/09/30 16:58:20 pe &odbc; &jdbc; &lisp; + diff --git a/doc/src/sgml/programmer.sgml b/doc/src/sgml/programmer.sgml index fe1fd3af99..85fc376184 100644 --- a/doc/src/sgml/programmer.sgml +++ b/doc/src/sgml/programmer.sgml @@ -1,5 +1,5 @@ @@ -39,20 +39,7 @@ Postgres Programmer's Guide. - - - - - - - - - - - - - ]> @@ -125,6 +112,8 @@ Your name here... &intro-pg; + + Server Programming</> &arch-pg; &extend; &xfunc; @@ -149,6 +138,9 @@ Disable it until we put in some info. &trigger; &spi; + </part> + <part> + <title>Client Interfaces</> &lobj; &libpq; &libpqpp; @@ -158,31 +150,11 @@ Disable it until we put in some info. &odbc; &jdbc; &lisp; - -<!-- development --> - - &sources; - &arch-dev; - &geqo; -<!-- - This listing of Postgres catalogs is currently just a copy of the old - man page. It is not up to date and has not been marked up for SGML. - - thomas 2000-04-20 - &catalogs; ---> - &protocol; - &compiler; - &bki; - &page; - -<!-- appendices --> - - &cvs; - &docguide; + </part> <!-- &contacts; --> - &biblio; + &biblio; <!-- <index id="index">