done

echo "$as_me:$LINENO: checking for DocBookV3.1" >&5

echo $ECHO_N "checking for DocBookV3.1... $ECHO_C" >&6

echo "$as_me:$LINENO: checking for DocBookV4.2" >&5

echo $ECHO_N "checking for DocBookV4.2... $ECHO_C" >&6

if test "${pgac_cv_check_docbook+set}" = set; then

echo $ECHO_N "(cached) $ECHO_C" >&6

else

cat >conftest.sgml <<EOF

<!doctype book PUBLIC "-//OASIS//DTD DocBookV3.1//EN">

<!doctype book PUBLIC "-//OASIS//DTD DocBookV4.2//EN">

<book>

<title>test</title>

<chapter>

dnl Process this file with autoconf to produce a configure script.

dnl $Header: /cvsroot/pgsql/configure.in,v 1.304 2003/11/2414:52:57 petere Exp $

dnl $Header: /cvsroot/pgsql/configure.in,v 1.305 2003/11/2419:08:01 petere Exp $

dnl

dnl Developers, please strive to achieve this order:

dnl

#

PGAC_PROG_NSGMLS

PGAC_PROG_JADE

PGAC_CHECK_DOCBOOK(3.1)

PGAC_CHECK_DOCBOOK(4.2)

PGAC_PATH_DOCBOOK_STYLESHEETS

PGAC_PATH_COLLATEINDEX

AC_CHECK_PROGS(SGMLSPL, sgmlspl)

<!--

$Header: /cvsroot/pgsql/doc/src/sgml/cvs.sgml,v 1.25 2003/06/11 15:28:55 tgl Exp $

CVS code repository

Thomas Lockhart

$Header: /cvsroot/pgsql/doc/src/sgml/cvs.sgml,v 1.26 2003/11/24 19:08:01 petere Exp $

-->

<appendix id="cvs">

<docinfo>

<appendixinfo>

<authorgroup>

<author>

<firstname>Marc</firstname>

</author>

</authorgroup>

<date>1999-05-20</date>

</docinfo>

</appendixinfo>

<title>The <productname>CVS</productname> Repository</title>

<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ddl.sgml,v 1.23 2003/11/05 00:05:32 tgl Exp $ -->

<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ddl.sgml,v 1.24 2003/11/24 19:08:01 petere Exp $ -->

<chapter id="ddl">

<title>Data Definition</title>

<sect1 id="ddl-inherit">

<title>Inheritance</title>

<comment>This section needs to be rethought. Some of the

information should go into the following chapters.</comment>

<remark>This section needs to be rethought. Some of the

information should go into the following chapters.</remark>

<para>

Let's create two tables. The capitals table contains

<!-- $Header: /cvsroot/pgsql/doc/src/sgml/dml.sgml,v 1.6 2003/08/31 17:32:18 petere Exp $ -->

<!-- $Header: /cvsroot/pgsql/doc/src/sgml/dml.sgml,v 1.7 2003/11/24 19:08:01 petere Exp $ -->

<chapter id="dml">

<title>Data Manipulation</title>

<comment>

<remark>

This chapter is still quite incomplete.

</comment>

</remark>

<para>

The previous chapter discussed how to create tables and other

<!-- $Header: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v 1.46 2003/09/12 22:17:22 tgl Exp $ -->

<!-- $Header: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v 1.47 2003/11/24 19:08:01 petere Exp $ -->

<appendix id="docguide">

<title>Documentation</title>

<listitem>

<para>

This is the definition of DocBook itself. We currently use

version3.1; you cannot use later or earlier versions. Note

version4.2; you cannot use later or earlier versions. Note

that there is also an <acronym>XML</acronym> version of DocBook

-- do not use that.

</para>

<listitem>

<para><filename>textproc/openjade</filename></para>

</listitem>

<listitem>

<para><filename>textproc/docbook-310</filename></para>

</listitem>

<listitem>

<para><filename>textproc/iso8879</filename></para>

</listitem>

<listitem>

<para><filename>textproc/dsssl-docbook-modular</filename></para>

</listitem>

</itemizedlist>

Apparently, there is no port for the DocBook V4.2 SGML DTD

available right now. You will need to install it manually.

</para>

<para>

A number of things from <filename>/usr/ports/print</filename>

(<filename>tex</filename>, <filename>jadetex</filename>) might

also be of interest.

in <filename>/usr/local/share/sgml/catalog</filename>. Be sure to

have the following line in there:

<programlisting>

CATALOG "/usr/local/share/sgml/docbook/3.1/catalog"

CATALOG "/usr/local/share/sgml/docbook/4.2/docbook.cat"

</programlisting>

If you do not want to edit the file you can also set the

environment variable <envar>SGML_CATALOG_FILES</envar> to a

<step>

<para>

Obtain the <ulink

url="http://www.oasis-open.org/docbook/sgml/3.1/docbk31.zip">DocBook

V3.1</ulink> distribution.

url="http://www.docbook.org/sgml/4.2/docbook-4.2.zip">DocBook

V4.2</ulink> distribution.

</para>

</step>

<step>

<para>

Create the directory

<filename>/usr/local/share/sgml/docbook31</filename> and change

<filename>/usr/local/share/sgml/docbook-4.2</filename> and change

to it. (The exact location is irrelevant, but this one is

reasonable within the layout we are following here.)

<screen>

<prompt>$ </prompt><userinput>mkdir /usr/local/share/sgml/docbook31</userinput>

<prompt>$ </prompt><userinput>cd /usr/local/share/sgml/docbook31</userinput>

<prompt>$ </prompt><userinput>mkdir /usr/local/share/sgml/docbook-4.2</userinput>

<prompt>$ </prompt><userinput>cd /usr/local/share/sgml/docbook-4.2</userinput>

</screen>

</para>

</step>

<para>

Unpack the archive.

<screen>

<prompt>$ </prompt><userinput>unzip -a ...../docbk31.zip</userinput>

<prompt>$ </prompt><userinput>unzip -a ...../docbook-4.2.zip</userinput>

</screen>

(The archive will unpack its files into the current directory.)

</para>

you told jade during installation) and put a line like this

into it:

<programlisting>

CATALOG "docbook31/docbook.cat"

CATALOG "docbook-4.2/docbook.cat"

</programlisting>

</para>

</step>

character entities</ulink> archive, unpack it, and put the

files in the same directory you put the DocBook files in.

<screen>

<prompt>$ </prompt><userinput>cd /usr/local/share/sgml/docbook31</userinput>

<prompt>$ </prompt><userinput>cd /usr/local/share/sgml/docbook-4.2</userinput>

<prompt>$ </prompt><userinput>unzip ...../ISOEnts.zip</userinput>

</screen>

</para>

<computeroutput>

checking for onsgmls... onsgmls

checking for openjade... openjade

checking for DocBookV3.1... yes

checking for DocBookV4.2... yes

checking for DocBook stylesheets... /usr/lib/sgml/stylesheets/nwalsh-modular

checking for sgmlspl... sgmlspl

</computeroutput>

</screen>

If neither <filename>onsgmls</filename> nor

<filename>nsgmls</filename> were found then you will not see the

remaining 4 lines. <filename>nsgmls</filename> is part of the Jade

package. If <quote>DocBookV3.1</quote> was not found then you did

package. If <quote>DocBookV4.2</quote> was not found then you did

not install the DocBook DTD kit in a place where jade can find it,

or you have not set up the catalog files correctly. See the

installation hints above. The DocBook stylesheets are looked for

the first line look like this:

<programlisting>

&lt;!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBookV3.1//EN"&gt;

&lt;!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBookV4.2//EN"&gt;

</programlisting>

This means that anything and everything that reads

<!--

$Header: /cvsroot/pgsql/doc/src/sgml/ecpg.sgml,v 1.54 2003/11/12 22:47:47 petere Exp $

$Header: /cvsroot/pgsql/doc/src/sgml/ecpg.sgml,v 1.55 2003/11/24 19:08:02 petere Exp $

-->

<chapter id="ecpg">

EXEC SQL ALLOCATE DESCRIPTOR <replaceable>identifier</replaceable>;

</programlisting>

The identifier serves as the <quote>variable name</quote> of the

descriptor area. <comment>The scope of the allocated descriptor is WHAT?.</comment>

descriptor area. <remark>The scope of the allocated descriptor is WHAT?.</remark>

When you don't need the descriptor anymore, you should deallocate

it:

<programlisting>

<!--

$Header: /cvsroot/pgsql/doc/src/sgml/geqo.sgml,v 1.24 2003/09/29 18:18:35 momjian Exp $

$Header: /cvsroot/pgsql/doc/src/sgml/geqo.sgml,v 1.25 2003/11/24 19:08:02 petere Exp $

Genetic Optimizer

-->

<chapter id="geqo">

<docinfo>

<chapterinfo>

<author>

<firstname>Martin</firstname>

<surname>Utesch</surname>

</affiliation>

</author>

<date>1997-10-02</date>

</docinfo>

</chapterinfo>

<title id="geqo-title">Genetic Query Optimizer</title>

<!--

$Header: /cvsroot/pgsql/doc/src/sgml/nls.sgml,v 1.7 2003/11/01 01:56:29 petere Exp $

$Header: /cvsroot/pgsql/doc/src/sgml/nls.sgml,v 1.8 2003/11/24 19:08:02 petere Exp $

-->

<chapter id="nls">

<docinfo>

<chapterinfo>

<author>

<firstname>Peter</firstname>

<surname>Eisentraut</surname>

</author>

</docinfo>

</chapterinfo>

<title>Native Language Support</title>

<!--

$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.60 2003/11/04 09:55:38 petere Exp $

$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.61 2003/11/24 19:08:02 petere Exp $

-->

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBookV3.1//EN" [

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBookV4.2//EN" [

<!entity % version SYSTEM "version.sgml">

%version;