pgpool2.git / summary / log / commit / refs

commit    47d9af9c69bd7eaaefdb9d8d38d99e037c04b305
Author:   Tatsuo Ishii <ishii@postgresql.org>
Date:     Tue Mar 15 07:36:10 2016 +0000

    Mega patch to add SGML docs.
    
    This is just a starting point of the whole work.
    The work to import PostgreSQL SGML doc system was done by Usama.
    Modification them to create pgpool docs prototype was done Tatsuo.


Makefile.am | 7 +- Makefile.in | 27 +- aclocal.m4 | 1 + configure | 433 +++- configure.ac | 17 +- doc/Makefile.am | 1 + doc/Makefile.in | 273 ++- doc/src/Makefile.am | 7 + doc/src/Makefile.in | 636 ++++++ doc/src/pgpool-en.sgml | 17 + doc/src/sgml/HTML.index | 76 + doc/src/sgml/Makefile.am | 189 ++ doc/src/sgml/Makefile.in | 619 ++++++ doc/src/sgml/README.links | 46 + doc/src/sgml/biblio.sgml | 541 +++++ doc/src/sgml/bookindex.sgml | 121 ++ doc/src/sgml/errcodes-table.sgml | 1371 ++++++++++++ doc/src/sgml/features-supported.sgml | 2174 ++++++++++++++++++++ doc/src/sgml/features-unsupported.sgml | 1862 +++++++++++++++++ doc/src/sgml/filelist.sgml | 210 ++ doc/src/sgml/fixrtf | 46 + doc/src/sgml/generate-errcodes-table.pl | 59 + doc/src/sgml/history.sgml | 13 + doc/src/sgml/html/LEGALNOTICE.html | 129 ++ doc/src/sgml/html/admin.html | 231 +++ doc/src/sgml/html/biblio.html | 738 +++++++ doc/src/sgml/html/bookindex.html | 380 ++++ doc/src/sgml/html/bug-reporting.html | 169 ++ doc/src/sgml/html/history.html | 172 ++ doc/src/sgml/html/index.html | 203 ++ doc/src/sgml/html/install-getsource.html | 169 ++ doc/src/sgml/html/install-post.html | 457 ++++ doc/src/sgml/html/install-procedure.html | 1236 +++++++++++ doc/src/sgml/html/install-requirements.html | 169 ++ doc/src/sgml/html/install-short.html | 187 ++ doc/src/sgml/html/installation-platform-notes.html | 177 ++ doc/src/sgml/html/installation.html | 226 ++ doc/src/sgml/html/intro-whatis.html | 175 ++ doc/src/sgml/html/notation.html | 225 ++ doc/src/sgml/html/pcp-commands.html | 189 ++ doc/src/sgml/html/pcp-node-count.html | 294 +++ doc/src/sgml/html/preface.html | 271 +++ doc/src/sgml/html/reference.html | 198 ++ doc/src/sgml/html/resources.html | 228 ++ doc/src/sgml/html/stylesheet.css | 98 + doc/src/sgml/html/supported-platforms.html | 244 +++ doc/src/sgml/html/tutorial-install.html | 166 ++ doc/src/sgml/html/tutorial-start.html | 162 ++ doc/src/sgml/html/tutorial.html | 191 ++ doc/src/sgml/info.sgml | 68 + doc/src/sgml/installation.sgml | 1033 ++++++++++ doc/src/sgml/intro.sgml | 95 + doc/src/sgml/jadetex.cfg | 89 + doc/src/sgml/legal.sgml | 48 + doc/src/sgml/mk_feature_tables.pl | 70 + doc/src/sgml/notation.sgml | 31 + doc/src/sgml/pgpool.sgml | 269 +++ doc/src/sgml/problems.sgml | 9 + doc/src/sgml/ref/allfiles.sgml | 211 ++ doc/src/sgml/ref/pcp_node_count.sgml | 107 + doc/src/sgml/reference.sgml | 275 +++ doc/src/sgml/start.sgml | 13 + doc/src/sgml/stylesheet-common.xsl | 85 + doc/src/sgml/stylesheet-fo.xsl | 34 + doc/src/sgml/stylesheet-hh.xsl | 41 + doc/src/sgml/stylesheet-man.xsl | 211 ++ doc/src/sgml/stylesheet.css | 98 + doc/src/sgml/stylesheet.dsl | 841 ++++++++ doc/src/sgml/stylesheet.xsl | 61 + doc/src/sgml/version.sgml | 1 + doc/src/stylesheet-common.xsl | 85 + doc/src/stylesheet.css | 96 + doc/src/stylesheet.dsl | 28 + doc/src/stylesheet.xsl | 61 + src/Makefile.in | 22 +- src/include/Makefile.in | 22 +- src/libs/Makefile.in | 22 +- src/libs/pcp/Makefile.in | 22 +- src/parser/Makefile.in | 22 +- src/tools/Makefile.in | 22 +- src/tools/pcp/Makefile.in | 22 +- src/tools/pgmd5/Makefile.in | 22 +- src/watchdog/Makefile.in | 22 +- 83 files changed, 19890 insertions(+), 98 deletions(-) diff --git a/Makefile.am b/Makefile.am index 377cbe0cf..4589f0285 100644 --- a/Makefile.am +++ b/Makefile.am @@ -4,5 +4,10 @@ AUTOMAKE_OPTIONS = subdir-objects # suggested by libtoolize ACLOCAL_AMFLAGS = -I m4 -SUBDIRS = src doc +if can_build_docs +DOC_DIR = doc +endif + +SUBDIRS = src $(DOC_DIR) +DIST_SUBDIRS = src doc diff --git a/Makefile.in b/Makefile.in index 0db95050f..351d4c6ed 100644 --- a/Makefile.in +++ b/Makefile.in @@ -85,11 +85,11 @@ DIST_COMMON = INSTALL NEWS README AUTHORS ChangeLog \ compile config.guess config.sub depcomp install-sh missing \ ylwrap ltmain.sh ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \ - $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ - $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ - $(top_srcdir)/c-compiler.m4 $(top_srcdir)/c-library.m4 \ - $(top_srcdir)/general.m4 \ +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ $(top_srcdir)/ac_func_accept_argtypes.m4 \ $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ @@ -155,7 +155,6 @@ am__define_uniq_tagged_files = \ ETAGS = etags CTAGS = ctags CSCOPE = cscope -DIST_SUBDIRS = $(SUBDIRS) DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) distdir = $(PACKAGE)-$(VERSION) top_distdir = $(distdir) @@ -206,15 +205,18 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +CATALOG = @CATALOG@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ CPP = @CPP@ CPPFLAGS = @CPPFLAGS@ CYGPATH_W = @CYGPATH_W@ DEFS = @DEFS@ DEPDIR = @DEPDIR@ DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ DSYMUTIL = @DSYMUTIL@ DUMPBIN = @DUMPBIN@ ECHO_C = @ECHO_C@ @@ -229,6 +231,7 @@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_SCRIPT = @INSTALL_SCRIPT@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ LD = @LD@ LDFLAGS = @LDFLAGS@ LEX = @LEX@ @@ -240,6 +243,7 @@ LIBTOOL = @LIBTOOL@ LIPO = @LIPO@ LN_S = @LN_S@ LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ MAINT = @MAINT@ MAKEINFO = @MAKEINFO@ MANIFEST_TOOL = @MANIFEST_TOOL@ @@ -250,8 +254,10 @@ MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ MKDIR_P = @MKDIR_P@ NM = @NM@ NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ OBJDUMP = @OBJDUMP@ OBJEXT = @OBJEXT@ +OSX = @OSX@ OTOOL = @OTOOL@ OTOOL64 = @OTOOL64@ PACKAGE = @PACKAGE@ @@ -262,6 +268,7 @@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ PGCONFIG = @PGCONFIG@ PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ @@ -270,7 +277,10 @@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ STRIP = @STRIP@ +STYLE = @STYLE@ VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ YACC = @YACC@ YFLAGS = @YFLAGS@ abs_builddir = @abs_builddir@ @@ -297,6 +307,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ @@ -331,7 +342,9 @@ AUTOMAKE_OPTIONS = subdir-objects # suggested by libtoolize ACLOCAL_AMFLAGS = -I m4 -SUBDIRS = src doc +@can_build_docs_TRUE@DOC_DIR = doc +SUBDIRS = src $(DOC_DIR) +DIST_SUBDIRS = src doc all: all-recursive .SUFFIXES: diff --git a/aclocal.m4 b/aclocal.m4 index 4edfd9515..beaef7248 100644 --- a/aclocal.m4 +++ b/aclocal.m4 @@ -1230,6 +1230,7 @@ AC_SUBST([am__tar]) AC_SUBST([am__untar]) ]) # _AM_PROG_TAR +m4_include([m4/docbook.m4]) m4_include([m4/libtool.m4]) m4_include([m4/ltoptions.m4]) m4_include([m4/ltsugar.m4]) diff --git a/configure b/configure index e41029e30..693a6b150 100755 --- a/configure +++ b/configure @@ -646,6 +646,22 @@ PGCONFIG use_repl_snprintf_FALSE use_repl_snprintf_TRUE LIBOBJS +STYLE_ENV_SET_FALSE +STYLE_ENV_SET_TRUE +STYLE +XSLTPROC_HTML_FLAGS +LYNX +PERL +OSX +XSLTPROC +COLLATEINDEX +CATALOG +DOCBOOKSTYLE +have_docbook +can_build_docs_FALSE +can_build_docs_TRUE +JADE +NSGMLS YFLAGS YACC LEXLIB @@ -802,7 +818,8 @@ LIBS CPPFLAGS CPP YACC -YFLAGS' +YFLAGS +DOCBOOKSTYLE' # Initialize some variables set by options. @@ -1474,6 +1491,8 @@ Some influential environment variables: YFLAGS The list of arguments that will be passed by default to $YACC. This script will default YFLAGS to the empty string to avoid a default value of `-d' given by some make applications. + DOCBOOKSTYLE + location of DocBook stylesheets Use these variables to override the choices made by `configure' or to help it to find libraries and programs with nonstandard names/locations. @@ -12033,6 +12052,405 @@ test -n "$YACC" || YACC="yacc" +# Check for docbook +for ac_prog in onsgmls nsgmls +do + # Extract the first word of "$ac_prog", so it can be a program name with args. +set dummy $ac_prog; ac_word=$2 +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 +$as_echo_n "checking for $ac_word... " >&6; } +if ${ac_cv_prog_NSGMLS+:} false; then : + $as_echo_n "(cached) " >&6 +else + if test -n "$NSGMLS"; then + ac_cv_prog_NSGMLS="$NSGMLS" # Let the user override the test. +else +as_save_IFS=$IFS; IFS=$PATH_SEPARATOR +for as_dir in $PATH +do + IFS=$as_save_IFS + test -z "$as_dir" && as_dir=. + for ac_exec_ext in '' $ac_executable_extensions; do + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then + ac_cv_prog_NSGMLS="$ac_prog" + $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 + break 2 + fi +done + done +IFS=$as_save_IFS + +fi +fi +NSGMLS=$ac_cv_prog_NSGMLS +if test -n "$NSGMLS"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $NSGMLS" >&5 +$as_echo "$NSGMLS" >&6; } +else + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } +fi + + + test -n "$NSGMLS" && break +done + +for ac_prog in openjade jade +do + # Extract the first word of "$ac_prog", so it can be a program name with args. +set dummy $ac_prog; ac_word=$2 +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 +$as_echo_n "checking for $ac_word... " >&6; } +if ${ac_cv_prog_JADE+:} false; then : + $as_echo_n "(cached) " >&6 +else + if test -n "$JADE"; then + ac_cv_prog_JADE="$JADE" # Let the user override the test. +else +as_save_IFS=$IFS; IFS=$PATH_SEPARATOR +for as_dir in $PATH +do + IFS=$as_save_IFS + test -z "$as_dir" && as_dir=. + for ac_exec_ext in '' $ac_executable_extensions; do + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then + ac_cv_prog_JADE="$ac_prog" + $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 + break 2 + fi +done + done +IFS=$as_save_IFS + +fi +fi +JADE=$ac_cv_prog_JADE +if test -n "$JADE"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $JADE" >&5 +$as_echo "$JADE" >&6; } +else + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } +fi + + + test -n "$JADE" && break +done + + +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for DocBook V4.2" >&5 +$as_echo_n "checking for DocBook V4.2... " >&6; } +if ${pgac_cv_check_docbook+:} false; then : + $as_echo_n "(cached) " >&6 +else + cat >conftest.sgml <<EOF +<!doctype book PUBLIC "-//OASIS//DTD DocBook V4.2//EN"> +<book> + <title>test</title> + <chapter> + <title>random</title> + <sect1> + <title>testsect</title> + <para>text</para> + </sect1> + </chapter> +</book> +EOF + +pgac_cv_check_docbook=no + +if test -n "$NSGMLS"; then + $NSGMLS -s conftest.sgml 1>&5 2>&1 + if test $? -eq 0; then + pgac_cv_check_docbook=yes + fi +fi +rm -f conftest.sgml +fi +{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $pgac_cv_check_docbook" >&5 +$as_echo "$pgac_cv_check_docbook" >&6; } + +have_docbook=$pgac_cv_check_docbook + if test "$pgac_cv_check_docbook" = "yes"; then + can_build_docs_TRUE= + can_build_docs_FALSE='#' +else + can_build_docs_TRUE='#' + can_build_docs_FALSE= +fi + + + +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for DocBook stylesheets" >&5 +$as_echo_n "checking for DocBook stylesheets... " >&6; } +if ${pgac_cv_path_stylesheets+:} false; then : + $as_echo_n "(cached) " >&6 +else + if test -n "$DOCBOOKSTYLE"; then + pgac_cv_path_stylesheets=$DOCBOOKSTYLE +else + for pgac_prefix in /usr /usr/local /opt /sw; do + for pgac_infix in share lib; do + for pgac_postfix in \ + sgml/stylesheets/nwalsh-modular \ + sgml/stylesheets/docbook \ + sgml/stylesheets/dsssl/docbook \ + sgml/docbook-dsssl \ + sgml/docbook/dsssl/modular \ + sgml/docbook/stylesheet/dsssl/modular \ + sgml/docbook/dsssl-stylesheets \ + sgml/dsssl/docbook-dsssl-nwalsh + do + pgac_candidate=$pgac_prefix/$pgac_infix/$pgac_postfix + if test -r "$pgac_candidate/html/docbook.dsl" \ + && test -r "$pgac_candidate/print/docbook.dsl" + then + pgac_cv_path_stylesheets=$pgac_candidate + break 3 + fi + done + done + done +fi +fi + +DOCBOOKSTYLE=$pgac_cv_path_stylesheets + +if test -n "$DOCBOOKSTYLE"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $DOCBOOKSTYLE" >&5 +$as_echo "$DOCBOOKSTYLE" >&6; } + CATALOG=-c $(DOCBOOKSTYLE)/catalog +else + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } + CATALOG= +fi + + +if test -n "$DOCBOOKSTYLE" -a -r "$DOCBOOKSTYLE/bin/collateindex.pl"; then + COLLATEINDEX="$DOCBOOKSTYLE/bin/collateindex.pl" + +else + # Extract the first word of "collateindex.pl", so it can be a program name with args. +set dummy collateindex.pl; ac_word=$2 +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 +$as_echo_n "checking for $ac_word... " >&6; } +if ${ac_cv_path_COLLATEINDEX+:} false; then : + $as_echo_n "(cached) " >&6 +else + case $COLLATEINDEX in + [\\/]* | ?:[\\/]*) + ac_cv_path_COLLATEINDEX="$COLLATEINDEX" # Let the user override the test with a path. + ;; + *) + as_save_IFS=$IFS; IFS=$PATH_SEPARATOR +for as_dir in $PATH +do + IFS=$as_save_IFS + test -z "$as_dir" && as_dir=. + for ac_exec_ext in '' $ac_executable_extensions; do + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then + ac_cv_path_COLLATEINDEX="$as_dir/$ac_word$ac_exec_ext" + $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 + break 2 + fi +done + done +IFS=$as_save_IFS + + ;; +esac +fi +COLLATEINDEX=$ac_cv_path_COLLATEINDEX +if test -n "$COLLATEINDEX"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $COLLATEINDEX" >&5 +$as_echo "$COLLATEINDEX" >&6; } +else + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } +fi + + +fi +for ac_prog in xsltproc +do + # Extract the first word of "$ac_prog", so it can be a program name with args. +set dummy $ac_prog; ac_word=$2 +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 +$as_echo_n "checking for $ac_word... " >&6; } +if ${ac_cv_prog_XSLTPROC+:} false; then : + $as_echo_n "(cached) " >&6 +else + if test -n "$XSLTPROC"; then + ac_cv_prog_XSLTPROC="$XSLTPROC" # Let the user override the test. +else +as_save_IFS=$IFS; IFS=$PATH_SEPARATOR +for as_dir in $PATH +do + IFS=$as_save_IFS + test -z "$as_dir" && as_dir=. + for ac_exec_ext in '' $ac_executable_extensions; do + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then + ac_cv_prog_XSLTPROC="$ac_prog" + $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 + break 2 + fi +done + done +IFS=$as_save_IFS + +fi +fi +XSLTPROC=$ac_cv_prog_XSLTPROC +if test -n "$XSLTPROC"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $XSLTPROC" >&5 +$as_echo "$XSLTPROC" >&6; } +else + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } +fi + + + test -n "$XSLTPROC" && break +done + +for ac_prog in osx sgml2xml sx +do + # Extract the first word of "$ac_prog", so it can be a program name with args. +set dummy $ac_prog; ac_word=$2 +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 +$as_echo_n "checking for $ac_word... " >&6; } +if ${ac_cv_prog_OSX+:} false; then : + $as_echo_n "(cached) " >&6 +else + if test -n "$OSX"; then + ac_cv_prog_OSX="$OSX" # Let the user override the test. +else +as_save_IFS=$IFS; IFS=$PATH_SEPARATOR +for as_dir in $PATH +do + IFS=$as_save_IFS + test -z "$as_dir" && as_dir=. + for ac_exec_ext in '' $ac_executable_extensions; do + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then + ac_cv_prog_OSX="$ac_prog" + $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 + break 2 + fi +done + done +IFS=$as_save_IFS + +fi +fi +OSX=$ac_cv_prog_OSX +if test -n "$OSX"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $OSX" >&5 +$as_echo "$OSX" >&6; } +else + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } +fi + + + test -n "$OSX" && break +done + +for ac_prog in perl +do + # Extract the first word of "$ac_prog", so it can be a program name with args. +set dummy $ac_prog; ac_word=$2 +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 +$as_echo_n "checking for $ac_word... " >&6; } +if ${ac_cv_prog_PERL+:} false; then : + $as_echo_n "(cached) " >&6 +else + if test -n "$PERL"; then + ac_cv_prog_PERL="$PERL" # Let the user override the test. +else +as_save_IFS=$IFS; IFS=$PATH_SEPARATOR +for as_dir in $PATH +do + IFS=$as_save_IFS + test -z "$as_dir" && as_dir=. + for ac_exec_ext in '' $ac_executable_extensions; do + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then + ac_cv_prog_PERL="$ac_prog" + $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 + break 2 + fi +done + done +IFS=$as_save_IFS + +fi +fi +PERL=$ac_cv_prog_PERL +if test -n "$PERL"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $PERL" >&5 +$as_echo "$PERL" >&6; } +else + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } +fi + + + test -n "$PERL" && break +done + +for ac_prog in lynx +do + # Extract the first word of "$ac_prog", so it can be a program name with args. +set dummy $ac_prog; ac_word=$2 +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5 +$as_echo_n "checking for $ac_word... " >&6; } +if ${ac_cv_prog_LYNX+:} false; then : + $as_echo_n "(cached) " >&6 +else + if test -n "$LYNX"; then + ac_cv_prog_LYNX="$LYNX" # Let the user override the test. +else +as_save_IFS=$IFS; IFS=$PATH_SEPARATOR +for as_dir in $PATH +do + IFS=$as_save_IFS + test -z "$as_dir" && as_dir=. + for ac_exec_ext in '' $ac_executable_extensions; do + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then + ac_cv_prog_LYNX="$ac_prog" + $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 + break 2 + fi +done + done +IFS=$as_save_IFS + +fi +fi +LYNX=$ac_cv_prog_LYNX +if test -n "$LYNX"; then + { $as_echo "$as_me:${as_lineno-$LINENO}: result: $LYNX" >&5 +$as_echo "$LYNX" >&6; } +else + { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5 +$as_echo "no" >&6; } +fi + + + test -n "$LYNX" && break +done + + + + + if test ! -z "$STYLE"; then + STYLE_ENV_SET_TRUE= + STYLE_ENV_SET_FALSE='#' +else + STYLE_ENV_SET_TRUE='#' + STYLE_ENV_SET_FALSE= +fi + OLD_CFLAGS=$CFLAGS CFLAGS="$CFLAGS -Wall" @@ -13459,7 +13877,6 @@ else use_repl_snprintf_FALSE= fi - # Need a #define for the size of Datum (unsigned long) # The cast to long int works around a bug in the HP C Compiler # version HP92453-01 B.11.11.23709.GP, which incorrectly rejects @@ -14625,7 +15042,7 @@ ac_config_headers="$ac_config_headers src/include/config.h" ac_config_files="$ac_config_files src/sql/pgpool_adm/Makefile" -ac_config_files="$ac_config_files Makefile doc/Makefile src/Makefile src/include/Makefile src/parser/Makefile src/libs/Makefile src/libs/pcp/Makefile src/tools/Makefile src/tools/pgmd5/Makefile src/tools/pcp/Makefile src/watchdog/Makefile" +ac_config_files="$ac_config_files Makefile doc/Makefile doc/src/Makefile doc/src/sgml/Makefile src/Makefile src/include/Makefile src/parser/Makefile src/libs/Makefile src/libs/pcp/Makefile src/tools/Makefile src/tools/pgmd5/Makefile src/tools/pcp/Makefile src/watchdog/Makefile" cat >confcache <<\_ACEOF # This file is a shell script that caches the results of configure @@ -14763,6 +15180,14 @@ if test -z "${MAINTAINER_MODE_TRUE}" && test -z "${MAINTAINER_MODE_FALSE}"; then as_fn_error $? "conditional \"MAINTAINER_MODE\" was never defined. Usually this means the macro was only invoked conditionally." "$LINENO" 5 fi +if test -z "${can_build_docs_TRUE}" && test -z "${can_build_docs_FALSE}"; then + as_fn_error $? "conditional \"can_build_docs\" was never defined. +Usually this means the macro was only invoked conditionally." "$LINENO" 5 +fi +if test -z "${STYLE_ENV_SET_TRUE}" && test -z "${STYLE_ENV_SET_FALSE}"; then + as_fn_error $? "conditional \"STYLE_ENV_SET\" was never defined. +Usually this means the macro was only invoked conditionally." "$LINENO" 5 +fi if test -z "${use_repl_snprintf_TRUE}" && test -z "${use_repl_snprintf_FALSE}"; then as_fn_error $? "conditional \"use_repl_snprintf\" was never defined. Usually this means the macro was only invoked conditionally." "$LINENO" 5 @@ -15646,6 +16071,8 @@ do "src/sql/pgpool_adm/Makefile") CONFIG_FILES="$CONFIG_FILES src/sql/pgpool_adm/Makefile" ;; "Makefile") CONFIG_FILES="$CONFIG_FILES Makefile" ;; "doc/Makefile") CONFIG_FILES="$CONFIG_FILES doc/Makefile" ;; + "doc/src/Makefile") CONFIG_FILES="$CONFIG_FILES doc/src/Makefile" ;; + "doc/src/sgml/Makefile") CONFIG_FILES="$CONFIG_FILES doc/src/sgml/Makefile" ;; "src/Makefile") CONFIG_FILES="$CONFIG_FILES src/Makefile" ;; "src/include/Makefile") CONFIG_FILES="$CONFIG_FILES src/include/Makefile" ;; "src/parser/Makefile") CONFIG_FILES="$CONFIG_FILES src/parser/Makefile" ;; diff --git a/configure.ac b/configure.ac index 8133cd4a1..dbc06619d 100644 --- a/configure.ac +++ b/configure.ac @@ -18,6 +18,20 @@ AM_PROG_CC_C_O dnl suggested by libtoolize --force AC_CONFIG_MACRO_DIR([m4]) +# Check for docbook +PGAC_PROG_NSGMLS +PGAC_PROG_JADE +PGAC_CHECK_DOCBOOK(4.2) +PGAC_PATH_DOCBOOK_STYLESHEETS +PGAC_PATH_COLLATEINDEX +AC_CHECK_PROGS(XSLTPROC, xsltproc) +AC_CHECK_PROGS(OSX, [osx sgml2xml sx]) +AC_CHECK_PROGS(PERL, perl) +AC_CHECK_PROGS(LYNX, lynx) + +AC_SUBST([XSLTPROC_HTML_FLAGS]) +AC_SUBST([STYLE]) +AM_CONDITIONAL([STYLE_ENV_SET], [test ! -z "$STYLE"]) dnl Check compiler option dnl check -Wall option @@ -169,7 +183,6 @@ if test $pgac_need_repl_snprintf = yes; then AC_LIBOBJ(snprintf) fi AM_CONDITIONAL(use_repl_snprintf, test $pgac_need_repl_snprintf = yes) - # Need a #define for the size of Datum (unsigned long) AC_CHECK_SIZEOF([unsigned long]) @@ -413,4 +426,4 @@ AC_MSG_RESULT([enable cassert = $enable_cassert]) AM_CONFIG_HEADER(src/include/config.h) AC_CONFIG_FILES([src/sql/pgpool_adm/Makefile]) -AC_OUTPUT([Makefile doc/Makefile src/Makefile src/include/Makefile src/parser/Makefile src/libs/Makefile src/libs/pcp/Makefile src/tools/Makefile src/tools/pgmd5/Makefile src/tools/pcp/Makefile src/watchdog/Makefile]) +AC_OUTPUT([Makefile doc/Makefile doc/src/Makefile doc/src/sgml/Makefile src/Makefile src/include/Makefile src/parser/Makefile src/libs/Makefile src/libs/pcp/Makefile src/tools/Makefile src/tools/pgmd5/Makefile src/tools/pcp/Makefile src/watchdog/Makefile]) diff --git a/doc/Makefile.am b/doc/Makefile.am index eae8c6c6b..0956c4d58 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -39,3 +39,4 @@ EXTRA_DIST = pgpool.8.in \ CLEANFILES = pgpool.8 +SUBDIRS = src diff --git a/doc/Makefile.in b/doc/Makefile.in index 0bb4646a7..cc9830dd9 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -81,11 +81,11 @@ subdir = doc DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ $(top_srcdir)/mkinstalldirs ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \ - $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ - $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ - $(top_srcdir)/c-compiler.m4 $(top_srcdir)/c-library.m4 \ - $(top_srcdir)/general.m4 \ +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ $(top_srcdir)/ac_func_accept_argtypes.m4 \ $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ @@ -108,6 +108,14 @@ am__v_at_0 = @ am__v_at_1 = SOURCES = DIST_SOURCES = +RECURSIVE_TARGETS = all-recursive check-recursive cscopelist-recursive \ + ctags-recursive dvi-recursive html-recursive info-recursive \ + install-data-recursive install-dvi-recursive \ + install-exec-recursive install-html-recursive \ + install-info-recursive install-pdf-recursive \ + install-ps-recursive install-recursive installcheck-recursive \ + installdirs-recursive pdf-recursive ps-recursive \ + tags-recursive uninstall-recursive am__can_run_installinfo = \ case $$AM_UPDATE_INFO_DIR in \ n|no|NO) false;; \ @@ -144,8 +152,60 @@ man8dir = $(mandir)/man8 am__installdirs = "$(DESTDIR)$(man8dir)" NROFF = nroff MANS = $(man_MANS) +RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ + distclean-recursive maintainer-clean-recursive +am__recursive_targets = \ + $(RECURSIVE_TARGETS) \ + $(RECURSIVE_CLEAN_TARGETS) \ + $(am__extra_recursive_targets) +AM_RECURSIVE_TARGETS = $(am__recursive_targets:-recursive=) TAGS CTAGS \ + distdir am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +# Read a list of newline-separated strings from the standard input, +# and print each of them once, without duplicates. Input order is +# *not* preserved. +am__uniquify_input = $(AWK) '\ + BEGIN { nonempty = 0; } \ + { items[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in items) print i; }; } \ +' +# Make sure the list of sources is unique. This is necessary because, +# e.g., the same source file might be shared among _SOURCES variables +# for different programs/libraries. +am__define_uniq_tagged_files = \ + list='$(am__tagged_files)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | $(am__uniquify_input)` +ETAGS = etags +CTAGS = ctags +DIST_SUBDIRS = $(SUBDIRS) DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +am__relativize = \ + dir0=`pwd`; \ + sed_first='s,^\([^/]*\)/.*$$,\1,'; \ + sed_rest='s,^[^/]*/*,,'; \ + sed_last='s,^.*/\([^/]*\)$$,\1,'; \ + sed_butlast='s,/*[^/]*$$,,'; \ + while test -n "$$dir1"; do \ + first=`echo "$$dir1" | sed -e "$$sed_first"`; \ + if test "$$first" != "."; then \ + if test "$$first" = ".."; then \ + dir2=`echo "$$dir0" | sed -e "$$sed_last"`/"$$dir2"; \ + dir0=`echo "$$dir0" | sed -e "$$sed_butlast"`; \ + else \ + first2=`echo "$$dir2" | sed -e "$$sed_first"`; \ + if test "$$first2" = "$$first"; then \ + dir2=`echo "$$dir2" | sed -e "$$sed_rest"`; \ + else \ + dir2="../$$dir2"; \ + fi; \ + dir0="$$dir0"/"$$first"; \ + fi; \ + fi; \ + dir1=`echo "$$dir1" | sed -e "$$sed_rest"`; \ + done; \ + reldir="$$dir2" ACLOCAL = @ACLOCAL@ AMTAR = @AMTAR@ AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ @@ -154,9 +214,11 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +CATALOG = @CATALOG@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ CPP = @CPP@ CPPFLAGS = @CPPFLAGS@ CYGPATH_W = @CYGPATH_W@ @@ -165,6 +227,7 @@ DEFS = @DEFS@ \ DEPDIR = @DEPDIR@ DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ DSYMUTIL = @DSYMUTIL@ DUMPBIN = @DUMPBIN@ ECHO_C = @ECHO_C@ @@ -179,6 +242,7 @@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_SCRIPT = @INSTALL_SCRIPT@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ LD = @LD@ LDFLAGS = @LDFLAGS@ LEX = @LEX@ @@ -190,6 +254,7 @@ LIBTOOL = @LIBTOOL@ LIPO = @LIPO@ LN_S = @LN_S@ LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ MAINT = @MAINT@ MAKEINFO = @MAKEINFO@ MANIFEST_TOOL = @MANIFEST_TOOL@ @@ -200,8 +265,10 @@ MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ MKDIR_P = @MKDIR_P@ NM = @NM@ NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ OBJDUMP = @OBJDUMP@ OBJEXT = @OBJEXT@ +OSX = @OSX@ OTOOL = @OTOOL@ OTOOL64 = @OTOOL64@ PACKAGE = @PACKAGE@ @@ -212,6 +279,7 @@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ PGCONFIG = @PGCONFIG@ PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ @@ -220,7 +288,10 @@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ STRIP = @STRIP@ +STYLE = @STYLE@ VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ YACC = @YACC@ YFLAGS = @YFLAGS@ abs_builddir = @abs_builddir@ @@ -247,6 +318,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ @@ -309,7 +381,8 @@ EXTRA_DIST = pgpool.8.in \ recovery.conf.sample CLEANFILES = pgpool.8 -all: all-am +SUBDIRS = src +all: all-recursive .SUFFIXES: $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) @@ -391,12 +464,105 @@ uninstall-man8: } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ dir='$(DESTDIR)$(man8dir)'; $(am__uninstall_files_from_dir) -tags TAGS: - -ctags CTAGS: -cscope cscopelist: +# This directory's subdirectories are mostly independent; you can cd +# into them and run 'make' without going through this Makefile. +# To change the values of 'make' variables: instead of editing Makefiles, +# (1) if the variable is set in 'config.status', edit 'config.status' +# (which will cause the Makefiles to be regenerated when you run 'make'); +# (2) otherwise, pass the desired values on the 'make' command line. +$(am__recursive_targets): + @fail=; \ + if $(am__make_keepgoing); then \ + failcom='fail=yes'; \ + else \ + failcom='exit 1'; \ + fi; \ + dot_seen=no; \ + target=`echo $@ | sed s/-recursive//`; \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + for subdir in $$list; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + dot_seen=yes; \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done; \ + if test "$$dot_seen" = "no"; then \ + $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ + fi; test -z "$$fail" + +ID: $(am__tagged_files) + $(am__define_uniq_tagged_files); mkid -fID $$unique +tags: tags-recursive +TAGS: tags + +tags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files) + set x; \ + here=`pwd`; \ + if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ + include_option=--etags-include; \ + empty_fix=.; \ + else \ + include_option=--include; \ + empty_fix=; \ + fi; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test ! -f $$subdir/TAGS || \ + set "$$@" "$$include_option=$$here/$$subdir/TAGS"; \ + fi; \ + done; \ + $(am__define_uniq_tagged_files); \ + shift; \ + if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \ + test -n "$$unique" || unique=$$empty_fix; \ + if test $$# -gt 0; then \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + "$$@" $$unique; \ + else \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + $$unique; \ + fi; \ + fi +ctags: ctags-recursive + +CTAGS: ctags +ctags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files) + $(am__define_uniq_tagged_files); \ + test -z "$(CTAGS_ARGS)$$unique" \ + || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ + $$unique + +GTAGS: + here=`$(am__cd) $(top_builddir) && pwd` \ + && $(am__cd) $(top_srcdir) \ + && gtags -i $(GTAGS_ARGS) "$$here" +cscopelist: cscopelist-recursive + +cscopelist-am: $(am__tagged_files) + list='$(am__tagged_files)'; \ + case "$(srcdir)" in \ + [\\/]* | ?:[\\/]*) sdir="$(srcdir)" ;; \ + *) sdir=$(subdir)/$(srcdir) ;; \ + esac; \ + for i in $$list; do \ + if test -f "$$i"; then \ + echo "$(subdir)/$$i"; \ + else \ + echo "$$sdir/$$i"; \ + fi; \ + done >> $(top_builddir)/cscope.files +distclean-tags: + -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags distdir: $(DISTFILES) @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ @@ -428,22 +594,48 @@ distdir: $(DISTFILES) || exit 1; \ fi; \ done + @list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + $(am__make_dryrun) \ + || test -d "$(distdir)/$$subdir" \ + || $(MKDIR_P) "$(distdir)/$$subdir" \ + || exit 1; \ + dir1=$$subdir; dir2="$(distdir)/$$subdir"; \ + $(am__relativize); \ + new_distdir=$$reldir; \ + dir1=$$subdir; dir2="$(top_distdir)"; \ + $(am__relativize); \ + new_top_distdir=$$reldir; \ + echo " (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) top_distdir="$$new_top_distdir" distdir="$$new_distdir" \\"; \ + echo " am__remove_distdir=: am__skip_length_check=: am__skip_mode_fix=: distdir)"; \ + ($(am__cd) $$subdir && \ + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$$new_top_distdir" \ + distdir="$$new_distdir" \ + am__remove_distdir=: \ + am__skip_length_check=: \ + am__skip_mode_fix=: \ + distdir) \ + || exit 1; \ + fi; \ + done check-am: all-am -check: check-am +check: check-recursive all-am: Makefile $(MANS) -installdirs: +installdirs: installdirs-recursive +installdirs-am: for dir in "$(DESTDIR)$(man8dir)"; do \ test -z "$$dir" || $(MKDIR_P) "$$dir"; \ done -install: install-am -install-exec: install-exec-am -install-data: install-data-am -uninstall: uninstall-am +install: install-recursive +install-exec: install-exec-recursive +install-data: install-data-recursive +uninstall: uninstall-recursive install-am: all-am @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am -installcheck: installcheck-am +installcheck: installcheck-recursive install-strip: if test -z '$(STRIP)'; then \ $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ @@ -466,67 +658,67 @@ distclean-generic: maintainer-clean-generic: @echo "This command is intended for maintainers to use" @echo "it deletes files that may require special tools to rebuild." -clean: clean-am +clean: clean-recursive clean-am: clean-generic clean-libtool mostlyclean-am -distclean: distclean-am +distclean: distclean-recursive -rm -f Makefile -distclean-am: clean-am distclean-generic +distclean-am: clean-am distclean-generic distclean-tags -dvi: dvi-am +dvi: dvi-recursive dvi-am: -html: html-am +html: html-recursive html-am: -info: info-am +info: info-recursive info-am: install-data-am: install-man -install-dvi: install-dvi-am +install-dvi: install-dvi-recursive install-dvi-am: install-exec-am: -install-html: install-html-am +install-html: install-html-recursive install-html-am: -install-info: install-info-am +install-info: install-info-recursive install-info-am: install-man: install-man8 -install-pdf: install-pdf-am +install-pdf: install-pdf-recursive install-pdf-am: -install-ps: install-ps-am +install-ps: install-ps-recursive install-ps-am: installcheck-am: -maintainer-clean: maintainer-clean-am +maintainer-clean: maintainer-clean-recursive -rm -f Makefile maintainer-clean-am: distclean-am maintainer-clean-generic -mostlyclean: mostlyclean-am +mostlyclean: mostlyclean-recursive mostlyclean-am: mostlyclean-generic mostlyclean-libtool -pdf: pdf-am +pdf: pdf-recursive pdf-am: -ps: ps-am +ps: ps-recursive ps-am: @@ -534,20 +726,21 @@ uninstall-am: uninstall-man uninstall-man: uninstall-man8 -.MAKE: install-am install-strip +.MAKE: $(am__recursive_targets) install-am install-strip -.PHONY: all all-am check check-am clean clean-generic clean-libtool \ - cscopelist-am ctags-am distclean distclean-generic \ - distclean-libtool distdir dvi dvi-am html html-am info info-am \ +.PHONY: $(am__recursive_targets) CTAGS GTAGS TAGS all all-am check \ + check-am clean clean-generic clean-libtool cscopelist-am ctags \ + ctags-am distclean distclean-generic distclean-libtool \ + distclean-tags distdir dvi dvi-am html html-am info info-am \ install install-am install-data install-data-am install-dvi \ install-dvi-am install-exec install-exec-am install-html \ install-html-am install-info install-info-am install-man \ install-man8 install-pdf install-pdf-am install-ps \ install-ps-am install-strip installcheck installcheck-am \ - installdirs maintainer-clean maintainer-clean-generic \ - mostlyclean mostlyclean-generic mostlyclean-libtool pdf pdf-am \ - ps ps-am tags-am uninstall uninstall-am uninstall-man \ - uninstall-man8 + installdirs installdirs-am maintainer-clean \ + maintainer-clean-generic mostlyclean mostlyclean-generic \ + mostlyclean-libtool pdf pdf-am ps ps-am tags tags-am uninstall \ + uninstall-am uninstall-man uninstall-man8 pgpool.8: pgpool.8.in diff --git a/doc/src/Makefile.am b/doc/src/Makefile.am new file mode 100644 index 000000000..eb6b5c737 --- /dev/null +++ b/doc/src/Makefile.am @@ -0,0 +1,7 @@ +# suggested by libtoolize +ACLOCAL_AMFLAGS = -I m4 +DEFS = @DEFS@ \ + -DDEFAULT_CONFIGDIR=\"$(sysconfdir)\" + +SUBDIRS = sgml + diff --git a/doc/src/Makefile.in b/doc/src/Makefile.in new file mode 100644 index 000000000..a7467007b --- /dev/null +++ b/doc/src/Makefile.in @@ -0,0 +1,636 @@ +# Makefile.in generated by automake 1.14.1 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994-2013 Free Software Foundation, Inc. + +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +VPATH = @srcdir@ +am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__make_running_with_option = \ + case $${target_option-} in \ + ?) ;; \ + *) echo "am__make_running_with_option: internal error: invalid" \ + "target option '$${target_option-}' specified" >&2; \ + exit 1;; \ + esac; \ + has_opt=no; \ + sane_makeflags=$$MAKEFLAGS; \ + if $(am__is_gnu_make); then \ + sane_makeflags=$$MFLAGS; \ + else \ + case $$MAKEFLAGS in \ + *\\[\ \ ]*) \ + bs=\\; \ + sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \ + | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \ + esac; \ + fi; \ + skip_next=no; \ + strip_trailopt () \ + { \ + flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \ + }; \ + for flg in $$sane_makeflags; do \ + test $$skip_next = yes && { skip_next=no; continue; }; \ + case $$flg in \ + *=*|--*) continue;; \ + -*I) strip_trailopt 'I'; skip_next=yes;; \ + -*I?*) strip_trailopt 'I';; \ + -*O) strip_trailopt 'O'; skip_next=yes;; \ + -*O?*) strip_trailopt 'O';; \ + -*l) strip_trailopt 'l'; skip_next=yes;; \ + -*l?*) strip_trailopt 'l';; \ + -[dEDm]) skip_next=yes;; \ + -[JT]) skip_next=yes;; \ + esac; \ + case $$flg in \ + *$$target_option*) has_opt=yes; break;; \ + esac; \ + done; \ + test $$has_opt = yes +am__make_dryrun = (target_option=n; $(am__make_running_with_option)) +am__make_keepgoing = (target_option=k; $(am__make_running_with_option)) +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +subdir = doc/src +DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ + $(top_srcdir)/mkinstalldirs +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ + $(top_srcdir)/ac_func_accept_argtypes.m4 \ + $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/src/include/config.h +CONFIG_CLEAN_FILES = +CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = +SOURCES = +DIST_SOURCES = +RECURSIVE_TARGETS = all-recursive check-recursive cscopelist-recursive \ + ctags-recursive dvi-recursive html-recursive info-recursive \ + install-data-recursive install-dvi-recursive \ + install-exec-recursive install-html-recursive \ + install-info-recursive install-pdf-recursive \ + install-ps-recursive install-recursive installcheck-recursive \ + installdirs-recursive pdf-recursive ps-recursive \ + tags-recursive uninstall-recursive +am__can_run_installinfo = \ + case $$AM_UPDATE_INFO_DIR in \ + n|no|NO) false;; \ + *) (install-info --version) >/dev/null 2>&1;; \ + esac +RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ + distclean-recursive maintainer-clean-recursive +am__recursive_targets = \ + $(RECURSIVE_TARGETS) \ + $(RECURSIVE_CLEAN_TARGETS) \ + $(am__extra_recursive_targets) +AM_RECURSIVE_TARGETS = $(am__recursive_targets:-recursive=) TAGS CTAGS \ + distdir +am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +# Read a list of newline-separated strings from the standard input, +# and print each of them once, without duplicates. Input order is +# *not* preserved. +am__uniquify_input = $(AWK) '\ + BEGIN { nonempty = 0; } \ + { items[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in items) print i; }; } \ +' +# Make sure the list of sources is unique. This is necessary because, +# e.g., the same source file might be shared among _SOURCES variables +# for different programs/libraries. +am__define_uniq_tagged_files = \ + list='$(am__tagged_files)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | $(am__uniquify_input)` +ETAGS = etags +CTAGS = ctags +DIST_SUBDIRS = $(SUBDIRS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +am__relativize = \ + dir0=`pwd`; \ + sed_first='s,^\([^/]*\)/.*$$,\1,'; \ + sed_rest='s,^[^/]*/*,,'; \ + sed_last='s,^.*/\([^/]*\)$$,\1,'; \ + sed_butlast='s,/*[^/]*$$,,'; \ + while test -n "$$dir1"; do \ + first=`echo "$$dir1" | sed -e "$$sed_first"`; \ + if test "$$first" != "."; then \ + if test "$$first" = ".."; then \ + dir2=`echo "$$dir0" | sed -e "$$sed_last"`/"$$dir2"; \ + dir0=`echo "$$dir0" | sed -e "$$sed_butlast"`; \ + else \ + first2=`echo "$$dir2" | sed -e "$$sed_first"`; \ + if test "$$first2" = "$$first"; then \ + dir2=`echo "$$dir2" | sed -e "$$sed_rest"`; \ + else \ + dir2="../$$dir2"; \ + fi; \ + dir0="$$dir0"/"$$first"; \ + fi; \ + fi; \ + dir1=`echo "$$dir1" | sed -e "$$sed_rest"`; \ + done; \ + reldir="$$dir2" +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ +AR = @AR@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CATALOG = @CATALOG@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DEFS = @DEFS@ \ + -DDEFAULT_CONFIGDIR=\"$(sysconfdir)\" + +DEPDIR = @DEPDIR@ +DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ +DSYMUTIL = @DSYMUTIL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +FGREP = @FGREP@ +GREP = @GREP@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LEX = @LEX@ +LEXLIB = @LEXLIB@ +LEX_OUTPUT_ROOT = @LEX_OUTPUT_ROOT@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIBTOOL = @LIBTOOL@ +LIPO = @LIPO@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +MANIFEST_TOOL = @MANIFEST_TOOL@ +MEMCACHED_DIR = @MEMCACHED_DIR@ +MEMCACHED_INCLUDE_OPT = @MEMCACHED_INCLUDE_OPT@ +MEMCACHED_LINK_OPT = @MEMCACHED_LINK_OPT@ +MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ +MKDIR_P = @MKDIR_P@ +NM = @NM@ +NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +OSX = @OSX@ +OTOOL = @OTOOL@ +OTOOL64 = @OTOOL64@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ +PGCONFIG = @PGCONFIG@ +PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ +PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ +RANLIB = @RANLIB@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +STYLE = @STYLE@ +VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ +YACC = @YACC@ +YFLAGS = @YFLAGS@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ + +# suggested by libtoolize +ACLOCAL_AMFLAGS = -I m4 +SUBDIRS = sgml +all: all-recursive + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/src/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --gnu doc/src/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(am__aclocal_m4_deps): + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs + +# This directory's subdirectories are mostly independent; you can cd +# into them and run 'make' without going through this Makefile. +# To change the values of 'make' variables: instead of editing Makefiles, +# (1) if the variable is set in 'config.status', edit 'config.status' +# (which will cause the Makefiles to be regenerated when you run 'make'); +# (2) otherwise, pass the desired values on the 'make' command line. +$(am__recursive_targets): + @fail=; \ + if $(am__make_keepgoing); then \ + failcom='fail=yes'; \ + else \ + failcom='exit 1'; \ + fi; \ + dot_seen=no; \ + target=`echo $@ | sed s/-recursive//`; \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + for subdir in $$list; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + dot_seen=yes; \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done; \ + if test "$$dot_seen" = "no"; then \ + $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ + fi; test -z "$$fail" + +ID: $(am__tagged_files) + $(am__define_uniq_tagged_files); mkid -fID $$unique +tags: tags-recursive +TAGS: tags + +tags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files) + set x; \ + here=`pwd`; \ + if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ + include_option=--etags-include; \ + empty_fix=.; \ + else \ + include_option=--include; \ + empty_fix=; \ + fi; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test ! -f $$subdir/TAGS || \ + set "$$@" "$$include_option=$$here/$$subdir/TAGS"; \ + fi; \ + done; \ + $(am__define_uniq_tagged_files); \ + shift; \ + if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \ + test -n "$$unique" || unique=$$empty_fix; \ + if test $$# -gt 0; then \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + "$$@" $$unique; \ + else \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + $$unique; \ + fi; \ + fi +ctags: ctags-recursive + +CTAGS: ctags +ctags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files) + $(am__define_uniq_tagged_files); \ + test -z "$(CTAGS_ARGS)$$unique" \ + || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ + $$unique + +GTAGS: + here=`$(am__cd) $(top_builddir) && pwd` \ + && $(am__cd) $(top_srcdir) \ + && gtags -i $(GTAGS_ARGS) "$$here" +cscopelist: cscopelist-recursive + +cscopelist-am: $(am__tagged_files) + list='$(am__tagged_files)'; \ + case "$(srcdir)" in \ + [\\/]* | ?:[\\/]*) sdir="$(srcdir)" ;; \ + *) sdir=$(subdir)/$(srcdir) ;; \ + esac; \ + for i in $$list; do \ + if test -f "$$i"; then \ + echo "$(subdir)/$$i"; \ + else \ + echo "$$sdir/$$i"; \ + fi; \ + done >> $(top_builddir)/cscope.files + +distclean-tags: + -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ + else \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ + || exit 1; \ + fi; \ + done + @list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + $(am__make_dryrun) \ + || test -d "$(distdir)/$$subdir" \ + || $(MKDIR_P) "$(distdir)/$$subdir" \ + || exit 1; \ + dir1=$$subdir; dir2="$(distdir)/$$subdir"; \ + $(am__relativize); \ + new_distdir=$$reldir; \ + dir1=$$subdir; dir2="$(top_distdir)"; \ + $(am__relativize); \ + new_top_distdir=$$reldir; \ + echo " (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) top_distdir="$$new_top_distdir" distdir="$$new_distdir" \\"; \ + echo " am__remove_distdir=: am__skip_length_check=: am__skip_mode_fix=: distdir)"; \ + ($(am__cd) $$subdir && \ + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$$new_top_distdir" \ + distdir="$$new_distdir" \ + am__remove_distdir=: \ + am__skip_length_check=: \ + am__skip_mode_fix=: \ + distdir) \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-recursive +all-am: Makefile +installdirs: installdirs-recursive +installdirs-am: +install: install-recursive +install-exec: install-exec-recursive +install-data: install-data-recursive +uninstall: uninstall-recursive + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-recursive +install-strip: + if test -z '$(STRIP)'; then \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + install; \ + else \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \ + fi +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-recursive + +clean-am: clean-generic clean-libtool mostlyclean-am + +distclean: distclean-recursive + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-tags + +dvi: dvi-recursive + +dvi-am: + +html: html-recursive + +html-am: + +info: info-recursive + +info-am: + +install-data-am: + +install-dvi: install-dvi-recursive + +install-dvi-am: + +install-exec-am: + +install-html: install-html-recursive + +install-html-am: + +install-info: install-info-recursive + +install-info-am: + +install-man: + +install-pdf: install-pdf-recursive + +install-pdf-am: + +install-ps: install-ps-recursive + +install-ps-am: + +installcheck-am: + +maintainer-clean: maintainer-clean-recursive + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-recursive + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-recursive + +pdf-am: + +ps: ps-recursive + +ps-am: + +uninstall-am: + +.MAKE: $(am__recursive_targets) install-am install-strip + +.PHONY: $(am__recursive_targets) CTAGS GTAGS TAGS all all-am check \ + check-am clean clean-generic clean-libtool cscopelist-am ctags \ + ctags-am distclean distclean-generic distclean-libtool \ + distclean-tags distdir dvi dvi-am html html-am info info-am \ + install install-am install-data install-data-am install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + installdirs-am maintainer-clean maintainer-clean-generic \ + mostlyclean mostlyclean-generic mostlyclean-libtool pdf pdf-am \ + ps ps-am tags tags-am uninstall uninstall-am + + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff --git a/doc/src/pgpool-en.sgml b/doc/src/pgpool-en.sgml new file mode 100644 index 000000000..c5ff3994b --- /dev/null +++ b/doc/src/pgpool-en.sgml @@ -0,0 +1,17 @@ +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.2//EN"[ + <!ENTITY % version SYSTEM "version.sgml"> + %version; +]> + +<book id="pgpool-II-en"><title>pgpool-II english documentation</title> + <bookinfo> + <productname>pgpool-doc-en</productname> + <productnumber>&version;</productnumber> + <abstract> + <para> + Hello pgpool-II! + </para> + </abstract> +</bookinfo> +</book> + diff --git a/doc/src/sgml/HTML.index b/doc/src/sgml/HTML.index new file mode 100644 index 000000000..48aa25399 --- /dev/null +++ b/doc/src/sgml/HTML.index @@ -0,0 +1,76 @@ +INDEXTERM history.html +INDEXPOINT history.html#AEN50 +TITLE A Brief History of pgpool-II +significance NORMAL +ZONE history.html +TITLE A Brief History of pgpool-II +PRIMARY history +SECONDARY of pgpool-II +/INDEXTERM +INDEXTERM installation.html +INDEXPOINT installation.html#AEN114 +TITLE pgpool-IIInstallation from Source Code +significance NORMAL +ZONE installation.html +TITLE pgpool-IIInstallation from Source Code +PRIMARY installation +/INDEXTERM +INDEXTERM install-procedure.html +INDEXPOINT install-procedure.html#AEN132 +TITLE Installation Procedure +significance NORMAL +ZONE install-procedure.html +TITLE Installation Procedure +PRIMARY configure +/INDEXTERM +INDEXTERM install-procedure.html +INDEXPOINT install-procedure.html#AEN139 +TITLE Installation Procedure +significance NORMAL +PRIMARY VPATH +/INDEXTERM +INDEXTERM install-procedure.html +INDEXPOINT install-procedure.html#AEN283 +TITLE Installation Procedure +significance NORMAL +PRIMARY OpenSSL +SEEALSO SSL +/INDEXTERM +INDEXTERM install-procedure.html +INDEXPOINT install-procedure.html#AEN404 +TITLE Installation Procedure +significance NORMAL +PRIMARY regression test +/INDEXTERM +INDEXTERM install-post.html#AEN453 +INDEXPOINT install-post.html#AEN455 +TITLE Shared Libraries +significance NORMAL +PRIMARY shared library +/INDEXTERM +INDEXTERM install-post.html#AEN453 +INDEXPOINT install-post.html#AEN495 +TITLE Shared Libraries +significance NORMAL +PRIMARY ldconfig +/INDEXTERM +INDEXTERM install-post.html#AEN504 +INDEXPOINT install-post.html#AEN506 +TITLE Environment Variables +significance NORMAL +PRIMARY PATH +/INDEXTERM +INDEXTERM install-post.html#AEN504 +INDEXPOINT install-post.html#AEN525 +TITLE Environment Variables +significance NORMAL +PRIMARY MANPATH +/INDEXTERM +INDEXTERM pcp-node-count.html +INDEXPOINT pcp-node-count.html#AEN566 +TITLE pcp_node_count +significance NORMAL +ZONE pcp-node-count.html +TITLE pcp_node_count +PRIMARY pcp_node_count +/INDEXTERM diff --git a/doc/src/sgml/Makefile.am b/doc/src/sgml/Makefile.am new file mode 100644 index 000000000..be7958fbb --- /dev/null +++ b/doc/src/sgml/Makefile.am @@ -0,0 +1,189 @@ +# suggested by libtoolize +ACLOCAL_AMFLAGS = -I m4 +DEFS = @DEFS@ \ + -DDEFAULT_CONFIGDIR=\"$(sysconfdir)\" + +all: html + +GENERATED_SGML = bookindex.sgml version.sgml \ + features-supported.sgml features-unsupported.sgml errcodes-table.sgml + +ALLSGML := $(wildcard $(srcdir)/*.sgml $(srcdir)/ref/*.sgml) $(GENERATED_SGML) + +# Sometimes we don't want this one. +ALMOSTALLSGML := $(filter-out %bookindex.sgml,$(ALLSGML)) + +SPFLAGS = -wall -wno-unused-param -wno-empty -wfully-tagged + +OUTDIR = html + +#if DOCBOOKSTYLE +#CATALOG = -c $(DOCBOOKSTYLE)/catalog +#endif + +#override XSLTPROCFLAGS += --stringparam pgpool.version '$(VERSION)' +override XSLTPROCFLAGS += --stringparam pg.version '$(VERSION)' + +#jade -G -t sgml -i html -d stylesheet.dsl#html -o abas pgpool-en.sgm +JADE.html.call = $(JADE) $(JADEFLAGS) $(SPFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t sgml -i output-html +if STYLE_ENV_SET +JADE.html.call += -V website-stylesheet +XSLTPROC_HTML_FLAGS += --param website.stylesheet 1 +endif + +JADE.tex.call = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t tex -V tex-backend -i output-print -i include-index +JADE.rtf.call = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t rtf -V rtf-backend -i output-print -i include-index + +JADE_html = $(JADE) $(SPFLAGS) -d stylesheet.dsl\#html -t sgml -i html -V website-stylesheet + + +EXTRA_DIST = $(ALLSGML) + +## +## Man pages +## + +man distprep-man: man-stamp + +man-stamp: stylesheet-man.xsl postgres.xml + $(XMLLINT) --noout --valid postgres.xml + $(XSLTPROC) $(XSLTPROCFLAGS) $(XSLTPROC_MAN_FLAGS) $^ + +# The draft target creates HTML output in draft mode, without index (for faster build). +draft: pgpool.sgml $(ALMOSTALLSGML) stylesheet.dsl + $(MKDIR_P) html + $(JADE.html.call) -V draft-mode $< + cp $(srcdir)/stylesheet.css html/ + +html: html-stamp + +html-stamp: pgpool.sgml $(ALLSGML) stylesheet.dsl + $(MKDIR_P) html + $(JADE.html.call) -i include-index $< + cp $(srcdir)/stylesheet.css html/ + + +# single-page HTML +pgpool.html: pgpool.sgml $(ALLSGML) stylesheet.dsl + $(JADE.html.call) -V nochunks -V rootchunk -V '(define %root-filename% #f)' -V '(define use-output-dir #f)' -i include-index $< + +# single-page text +pgpool.txt: pgpool.html + $(LYNX) -force_html -dump -nolist $< > $@ + +HTML.index: pgpool.sgml $(ALMOSTALLSGML) stylesheet.dsl + $(MKDIR_P) html + $(JADE.html.call) -V html-index $< + +bookindex.sgml: HTML.index + LC_ALL=C $(PERL) $(COLLATEINDEX) -f -g -i 'bookindex' -o $@ $< + +# single-page text +#pgpool-en.txt: pgpool-en.html +# $(LYNX) -force_html -dump -nolist $< > $@ + +# single-page HTML +#pgpool-en.html: pgpool-en.sgml $(ALLSGML) stylesheet.dsl +# $(JADE.html.call) -V nochunks -V rootchunk -i include-index $< >$@ + +%.rtf: %.sgml $(ALLSGML) + $(JADE.rtf.call) $< + +%-A4.tex-ps: %.sgml $(ALLSGML) + $(JADE.tex.call) -V texdvi-output -V '%paper-type%'=A4 -o $@ $< + +%-US.tex-ps: %.sgml $(ALLSGML) + $(JADE.tex.call) -V texdvi-output -V '%paper-type%'=USletter -o $@ $< + +%-A4.tex-pdf: %.sgml $(ALLSGML) + $(JADE.tex.call) -V texpdf-output -V '%paper-type%'=A4 -o $@ $< + +%-US.tex-pdf: %.sgml $(ALLSGML) + $(JADE.tex.call) -V texpdf-output -V '%paper-type%'=USletter -o $@ $< + + +%.pdf: %.tex-pdf + @rm -f $*.aux $*.log $*.out +# multiple runs are necessary to create proper intra-document links + pdfjadetex $< + pdfjadetex $< + pdfjadetex $< + +#pgpool-en.pdf: pgpool-en-A4.tex-pdf pgpool-en-US.tex-pdf + +# This generates an XML version of the flow-object tree. It's useful +# # for debugging DSSSL code, and possibly to interface to some other +# # tools that can make use of this. +%.fot: %.sgml $(ALLSGML) + $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t fot -i output-print -i include-index -o $@ $< + +%.ps: %.dvi + dvips -o $@ $< + +## +## XSLT processing +## + +pgpool-en.xml: $(ALLSGML) + $(OSX) -D. -x lower -i include-xslt-index $< >pgpool-en.xmltmp + $(PERL) -p -e 's/\[(aacute|acirc|aelig|agrave|amp|aring|atilde|auml|bull|copy|eacute|egrave|gt|iacute|lt|mdash|nbsp|ntilde|oacute|ocirc|oslash|ouml|pi|quot|scaron|uuml) *\]/\&\1;/gi;' \ + -e '$$_ .= qq{<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">\n} if $$. == 1;' \ + <pgpool-en.xmltmp > $@ + rm pgpool-en.xmltmp + + +pgpool.xml: $(srcdir)/pgpool.sgml $(ALMOSTALLSGML) + $(OSX) -D. -x lower -i include-xslt-index $< >pgpool.xmltmp + $(PERL) -p -e 's/\[(aacute|acirc|aelig|agrave|amp|aring|atilde|auml|bull|copy|eacute|egrave|gt|iacute|lt|mdash|nbsp|ntilde|oacute|ocirc|oslash|ouml|pi|quot|scaron|uuml) *\]/\&\1;/gi;' \ + -e '$$_ .= qq{<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">\n} if $$. == 1;' \ + <pgpool.xmltmp > $@ + rm pgpool.xmltmp + +.PHONY: xslthtml-stamp + +xslthtml: xslthtml-stamp + +xslthtml: xslthtml-stamp + +xslthtml-stamp: stylesheet.xsl pgpool.xml + $(XMLLINT) --noout --valid pgpool.xml + $(XSLTPROC) $(XSLTPROCFLAGS) $(XSLTPROC_HTML_FLAGS) $^ + cp $(srcdir)/stylesheet.css html/ + +htmlhelp: stylesheet-hh.xsl pgpool.xml + $(XMLLINT) --noout --valid pgpool.xml + $(XSLTPROC) $(XSLTPROCFLAGS) $^ + +%-A4.fo.tmp: stylesheet-fo.xsl %.xml + $(XMLLINT) --noout --valid $*.xml + $(XSLTPROC) $(XSLTPROCFLAGS) --stringparam paper.type A4 -o $@ $^ + +%-US.fo.tmp: stylesheet-fo.xsl %.xml + $(XMLLINT) --noout --valid $*.xml + $(XSLTPROC) $(XSLTPROCFLAGS) --stringparam paper.type USletter -o $@ $^ + +FOP = fop + +#xslthtml-stamp: stylesheet.xsl pgpool-en.xml +# $(XSLTPROC) $(XSLTPROCFLAGS) $(XSLTPROC_HTML_FLAGS) $^ +# cp $(srcdir)/stylesheet.css html/ + +# reformat FO output so that locations of errors are easier to find +%.fo: %.fo.tmp + $(XMLLINT) --format --output $@ $^ + +epub: pgpool.epub + pgpool.epub: pgpool.xml + $(XMLLINT) --noout --valid $< + $(DBTOEPUB) $< + +version.sgml: $(top_srcdir)/configure + { \ + echo "<!ENTITY version \"$(PACKAGE_VERSION)\">"; \ + } > $@ + +# tabs are harmless, but it is best to avoid them in SGML files +check-tabs: + @( ! grep ' ' $(wildcard $(srcdir)/*.sgml $(srcdir)/ref/*.sgml $(srcdir)/*.dsl $(srcdir)/*.xsl) ) || (echo "Tabs appear in SGML/XML files" 1>&2; exit 1) + +CLEANFILES = *.html *.tex-pdf pgpool-en.rtf pgpool-en.txt html/* diff --git a/doc/src/sgml/Makefile.in b/doc/src/sgml/Makefile.in new file mode 100644 index 000000000..22a8a4a1c --- /dev/null +++ b/doc/src/sgml/Makefile.in @@ -0,0 +1,619 @@ +# Makefile.in generated by automake 1.14.1 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994-2013 Free Software Foundation, Inc. + +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +VPATH = @srcdir@ +am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)' +am__make_running_with_option = \ + case $${target_option-} in \ + ?) ;; \ + *) echo "am__make_running_with_option: internal error: invalid" \ + "target option '$${target_option-}' specified" >&2; \ + exit 1;; \ + esac; \ + has_opt=no; \ + sane_makeflags=$$MAKEFLAGS; \ + if $(am__is_gnu_make); then \ + sane_makeflags=$$MFLAGS; \ + else \ + case $$MAKEFLAGS in \ + *\\[\ \ ]*) \ + bs=\\; \ + sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \ + | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \ + esac; \ + fi; \ + skip_next=no; \ + strip_trailopt () \ + { \ + flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \ + }; \ + for flg in $$sane_makeflags; do \ + test $$skip_next = yes && { skip_next=no; continue; }; \ + case $$flg in \ + *=*|--*) continue;; \ + -*I) strip_trailopt 'I'; skip_next=yes;; \ + -*I?*) strip_trailopt 'I';; \ + -*O) strip_trailopt 'O'; skip_next=yes;; \ + -*O?*) strip_trailopt 'O';; \ + -*l) strip_trailopt 'l'; skip_next=yes;; \ + -*l?*) strip_trailopt 'l';; \ + -[dEDm]) skip_next=yes;; \ + -[JT]) skip_next=yes;; \ + esac; \ + case $$flg in \ + *$$target_option*) has_opt=yes; break;; \ + esac; \ + done; \ + test $$has_opt = yes +am__make_dryrun = (target_option=n; $(am__make_running_with_option)) +am__make_keepgoing = (target_option=k; $(am__make_running_with_option)) +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +@STYLE_ENV_SET_TRUE@am__append_1 = -V website-stylesheet +@STYLE_ENV_SET_TRUE@am__append_2 = --param website.stylesheet 1 +subdir = doc/src/sgml +DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ + $(top_srcdir)/mkinstalldirs +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ + $(top_srcdir)/ac_func_accept_argtypes.m4 \ + $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/src/include/config.h +CONFIG_CLEAN_FILES = +CONFIG_CLEAN_VPATH_FILES = +AM_V_P = $(am__v_P_@AM_V@) +am__v_P_ = $(am__v_P_@AM_DEFAULT_V@) +am__v_P_0 = false +am__v_P_1 = : +AM_V_GEN = $(am__v_GEN_@AM_V@) +am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@) +am__v_GEN_0 = @echo " GEN " $@; +am__v_GEN_1 = +AM_V_at = $(am__v_at_@AM_V@) +am__v_at_ = $(am__v_at_@AM_DEFAULT_V@) +am__v_at_0 = @ +am__v_at_1 = +SOURCES = +DIST_SOURCES = +am__can_run_installinfo = \ + case $$AM_UPDATE_INFO_DIR in \ + n|no|NO) false;; \ + *) (install-info --version) >/dev/null 2>&1;; \ + esac +am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ +AR = @AR@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CATALOG = @CATALOG@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DEFS = @DEFS@ \ + -DDEFAULT_CONFIGDIR=\"$(sysconfdir)\" + +DEPDIR = @DEPDIR@ +DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ +DSYMUTIL = @DSYMUTIL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +FGREP = @FGREP@ +GREP = @GREP@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LEX = @LEX@ +LEXLIB = @LEXLIB@ +LEX_OUTPUT_ROOT = @LEX_OUTPUT_ROOT@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIBTOOL = @LIBTOOL@ +LIPO = @LIPO@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +MANIFEST_TOOL = @MANIFEST_TOOL@ +MEMCACHED_DIR = @MEMCACHED_DIR@ +MEMCACHED_INCLUDE_OPT = @MEMCACHED_INCLUDE_OPT@ +MEMCACHED_LINK_OPT = @MEMCACHED_LINK_OPT@ +MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ +MKDIR_P = @MKDIR_P@ +NM = @NM@ +NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +OSX = @OSX@ +OTOOL = @OTOOL@ +OTOOL64 = @OTOOL64@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ +PGCONFIG = @PGCONFIG@ +PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ +PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ +RANLIB = @RANLIB@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +STYLE = @STYLE@ +VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ $(am__append_2) +YACC = @YACC@ +YFLAGS = @YFLAGS@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ + +# suggested by libtoolize +ACLOCAL_AMFLAGS = -I m4 +GENERATED_SGML = bookindex.sgml version.sgml \ + features-supported.sgml features-unsupported.sgml errcodes-table.sgml + +ALLSGML := $(wildcard $(srcdir)/*.sgml $(srcdir)/ref/*.sgml) $(GENERATED_SGML) + +# Sometimes we don't want this one. +ALMOSTALLSGML := $(filter-out %bookindex.sgml,$(ALLSGML)) +SPFLAGS = -wall -wno-unused-param -wno-empty -wfully-tagged +OUTDIR = html + +#jade -G -t sgml -i html -d stylesheet.dsl#html -o abas pgpool-en.sgm +JADE.html.call = $(JADE) $(JADEFLAGS) $(SPFLAGS) $(SGMLINCLUDE) \ + $(CATALOG) -d stylesheet.dsl -t sgml -i output-html \ + $(am__append_1) +JADE.tex.call = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t tex -V tex-backend -i output-print -i include-index +JADE.rtf.call = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t rtf -V rtf-backend -i output-print -i include-index +JADE_html = $(JADE) $(SPFLAGS) -d stylesheet.dsl\#html -t sgml -i html -V website-stylesheet +EXTRA_DIST = $(ALLSGML) +FOP = fop +CLEANFILES = *.html *.tex-pdf pgpool-en.rtf pgpool-en.txt html/* +all: all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/src/sgml/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --gnu doc/src/sgml/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(am__aclocal_m4_deps): + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs +tags TAGS: + +ctags CTAGS: + +cscope cscopelist: + + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ + else \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile +installdirs: +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + if test -z '$(STRIP)'; then \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + install; \ + else \ + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \ + fi +mostlyclean-generic: + +clean-generic: + -test -z "$(CLEANFILES)" || rm -f $(CLEANFILES) + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-am + +clean-am: clean-generic clean-libtool mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic + +dvi: dvi-am + +dvi-am: + +html-am: + +info: info-am + +info-am: + +install-data-am: + +install-dvi: install-dvi-am + +install-dvi-am: + +install-exec-am: + +install-html: install-html-am + +install-html-am: + +install-info: install-info-am + +install-info-am: + +install-man: + +install-pdf: install-pdf-am + +install-pdf-am: + +install-ps: install-ps-am + +install-ps-am: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: + +.MAKE: install-am install-strip + +.PHONY: all all-am check check-am clean clean-generic clean-libtool \ + cscopelist-am ctags-am distclean distclean-generic \ + distclean-libtool distdir dvi dvi-am html html-am info info-am \ + install install-am install-data install-data-am install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + maintainer-clean maintainer-clean-generic mostlyclean \ + mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ + tags-am uninstall uninstall-am + + +all: html + +#if DOCBOOKSTYLE +#CATALOG = -c $(DOCBOOKSTYLE)/catalog +#endif + +#override XSLTPROCFLAGS += --stringparam pgpool.version '$(VERSION)' +override XSLTPROCFLAGS += --stringparam pg.version '$(VERSION)' + +man distprep-man: man-stamp + +man-stamp: stylesheet-man.xsl postgres.xml + $(XMLLINT) --noout --valid postgres.xml + $(XSLTPROC) $(XSLTPROCFLAGS) $(XSLTPROC_MAN_FLAGS) $^ + +# The draft target creates HTML output in draft mode, without index (for faster build). +draft: pgpool.sgml $(ALMOSTALLSGML) stylesheet.dsl + $(MKDIR_P) html + $(JADE.html.call) -V draft-mode $< + cp $(srcdir)/stylesheet.css html/ + +html: html-stamp + +html-stamp: pgpool.sgml $(ALLSGML) stylesheet.dsl + $(MKDIR_P) html + $(JADE.html.call) -i include-index $< + cp $(srcdir)/stylesheet.css html/ + +# single-page HTML +pgpool.html: pgpool.sgml $(ALLSGML) stylesheet.dsl + $(JADE.html.call) -V nochunks -V rootchunk -V '(define %root-filename% #f)' -V '(define use-output-dir #f)' -i include-index $< + +# single-page text +pgpool.txt: pgpool.html + $(LYNX) -force_html -dump -nolist $< > $@ + +HTML.index: pgpool.sgml $(ALMOSTALLSGML) stylesheet.dsl + $(MKDIR_P) html + $(JADE.html.call) -V html-index $< + +bookindex.sgml: HTML.index + LC_ALL=C $(PERL) $(COLLATEINDEX) -f -g -i 'bookindex' -o $@ $< + +# single-page text +#pgpool-en.txt: pgpool-en.html +# $(LYNX) -force_html -dump -nolist $< > $@ + +# single-page HTML +#pgpool-en.html: pgpool-en.sgml $(ALLSGML) stylesheet.dsl +# $(JADE.html.call) -V nochunks -V rootchunk -i include-index $< >$@ + +%.rtf: %.sgml $(ALLSGML) + $(JADE.rtf.call) $< + +%-A4.tex-ps: %.sgml $(ALLSGML) + $(JADE.tex.call) -V texdvi-output -V '%paper-type%'=A4 -o $@ $< + +%-US.tex-ps: %.sgml $(ALLSGML) + $(JADE.tex.call) -V texdvi-output -V '%paper-type%'=USletter -o $@ $< + +%-A4.tex-pdf: %.sgml $(ALLSGML) + $(JADE.tex.call) -V texpdf-output -V '%paper-type%'=A4 -o $@ $< + +%-US.tex-pdf: %.sgml $(ALLSGML) + $(JADE.tex.call) -V texpdf-output -V '%paper-type%'=USletter -o $@ $< + +%.pdf: %.tex-pdf + @rm -f $*.aux $*.log $*.out +# multiple runs are necessary to create proper intra-document links + pdfjadetex $< + pdfjadetex $< + pdfjadetex $< + +#pgpool-en.pdf: pgpool-en-A4.tex-pdf pgpool-en-US.tex-pdf + +# This generates an XML version of the flow-object tree. It's useful +# # for debugging DSSSL code, and possibly to interface to some other +# # tools that can make use of this. +%.fot: %.sgml $(ALLSGML) + $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t fot -i output-print -i include-index -o $@ $< + +%.ps: %.dvi + dvips -o $@ $< + +pgpool-en.xml: $(ALLSGML) + $(OSX) -D. -x lower -i include-xslt-index $< >pgpool-en.xmltmp + $(PERL) -p -e 's/\[(aacute|acirc|aelig|agrave|amp|aring|atilde|auml|bull|copy|eacute|egrave|gt|iacute|lt|mdash|nbsp|ntilde|oacute|ocirc|oslash|ouml|pi|quot|scaron|uuml) *\]/\&\1;/gi;' \ + -e '$$_ .= qq{<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">\n} if $$. == 1;' \ + <pgpool-en.xmltmp > $@ + rm pgpool-en.xmltmp + +pgpool.xml: $(srcdir)/pgpool.sgml $(ALMOSTALLSGML) + $(OSX) -D. -x lower -i include-xslt-index $< >pgpool.xmltmp + $(PERL) -p -e 's/\[(aacute|acirc|aelig|agrave|amp|aring|atilde|auml|bull|copy|eacute|egrave|gt|iacute|lt|mdash|nbsp|ntilde|oacute|ocirc|oslash|ouml|pi|quot|scaron|uuml) *\]/\&\1;/gi;' \ + -e '$$_ .= qq{<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">\n} if $$. == 1;' \ + <pgpool.xmltmp > $@ + rm pgpool.xmltmp + +.PHONY: xslthtml-stamp + +xslthtml: xslthtml-stamp + +xslthtml: xslthtml-stamp + +xslthtml-stamp: stylesheet.xsl pgpool.xml + $(XMLLINT) --noout --valid pgpool.xml + $(XSLTPROC) $(XSLTPROCFLAGS) $(XSLTPROC_HTML_FLAGS) $^ + cp $(srcdir)/stylesheet.css html/ + +htmlhelp: stylesheet-hh.xsl pgpool.xml + $(XMLLINT) --noout --valid pgpool.xml + $(XSLTPROC) $(XSLTPROCFLAGS) $^ + +%-A4.fo.tmp: stylesheet-fo.xsl %.xml + $(XMLLINT) --noout --valid $*.xml + $(XSLTPROC) $(XSLTPROCFLAGS) --stringparam paper.type A4 -o $@ $^ + +%-US.fo.tmp: stylesheet-fo.xsl %.xml + $(XMLLINT) --noout --valid $*.xml + $(XSLTPROC) $(XSLTPROCFLAGS) --stringparam paper.type USletter -o $@ $^ + +#xslthtml-stamp: stylesheet.xsl pgpool-en.xml +# $(XSLTPROC) $(XSLTPROCFLAGS) $(XSLTPROC_HTML_FLAGS) $^ +# cp $(srcdir)/stylesheet.css html/ + +# reformat FO output so that locations of errors are easier to find +%.fo: %.fo.tmp + $(XMLLINT) --format --output $@ $^ + +epub: pgpool.epub + pgpool.epub: pgpool.xml + $(XMLLINT) --noout --valid $< + $(DBTOEPUB) $< + +version.sgml: $(top_srcdir)/configure + { \ + echo "<!ENTITY version \"$(PACKAGE_VERSION)\">"; \ + } > $@ + +# tabs are harmless, but it is best to avoid them in SGML files +check-tabs: + @( ! grep ' ' $(wildcard $(srcdir)/*.sgml $(srcdir)/ref/*.sgml $(srcdir)/*.dsl $(srcdir)/*.xsl) ) || (echo "Tabs appear in SGML/XML files" 1>&2; exit 1) + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff --git a/doc/src/sgml/README.links b/doc/src/sgml/README.links new file mode 100644 index 000000000..f64b85731 --- /dev/null +++ b/doc/src/sgml/README.links @@ -0,0 +1,46 @@ +<!-- doc/src/sgml/README.links --> + +Linking within SGML documents can be confusing, so here is a summary: + + +Intra-document Linking +---------------------- + +<xref> + use to get chapter/section number from the title of the target + link, or xreflabel if defined at the target, or refentrytitle if target + is a refentry; has no close tag + http://www.oasis-open.org/docbook/documentation/reference/html/xref.html + +<link> + use to supply text for the link, requires </link> + http://www.oasis-open.org/docbook/documentation/reference/html/link.html + +linkend= + controls the target of the link/xref, required + +endterm= + for <xref>, allows the text of the link/xref to be taken from a + different link target title + + +External Linking +---------------- + +<ulink> + like <link>, but uses a URL (not a document target); requires + </ulink>; if no text is specified, the URL appears as the link + text + http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html + +url= + used by <ulink> to specify the URL, required + + +Guidelines +---------- + +o If you want to supply text, use <link>, else <xref> +o Do not use text with <ulink> so the URL appears in printed output +o Specific nouns like GUC variables, SQL commands, and contrib modules + usually have xreflabels diff --git a/doc/src/sgml/biblio.sgml b/doc/src/sgml/biblio.sgml new file mode 100644 index 000000000..e2cd69d27 --- /dev/null +++ b/doc/src/sgml/biblio.sgml @@ -0,0 +1,541 @@ +<!-- doc/src/sgml/biblio.sgml --> + + <bibliography id="biblio"> + <title>Bibliography</title> + + <para> + Selected references and readings for <acronym>SQL</acronym> + and <productname>PostgreSQL</productname>. + </para> + + <para> + Some white papers and technical reports from the original + <productname>POSTGRES</productname> development team + are available at the University of California, Berkeley, Computer Science + Department <ulink url="http://db.cs.berkeley.edu/papers/"> + web site</ulink>. + </para> + + <bibliodiv> + <title><acronym>SQL</acronym> Reference Books</title> + <para>Reference texts for <acronym>SQL</acronym> features.</para> + + <biblioentry id="BOWMAN01"> + <title>The Practical <acronym>SQL</acronym> Handbook</title> + <titleabbrev>Bowman et al, 2001</titleabbrev> + <subtitle>Using SQL Variants</subtitle> + <edition>Fourth Edition</edition> + <authorgroup> + <author> + <firstname>Judith</firstname> + <surname>Bowman</surname> + </author> + <author> + <firstname>Sandra</firstname> + <surname>Emerson</surname> + </author> + <author> + <firstname>Marcy</firstname> + <surname>Darnovsky</surname> + </author> + </authorgroup> + <isbn>0-201-70309-2</isbn> + <pubdate>2001</pubdate> + <publisher> + <publishername>Addison-Wesley Professional</publishername> + </publisher> + <copyright> + <year>2001</year> + </copyright> + </biblioentry> + + <biblioentry id="DATE97"> + <title>A Guide to the <acronym>SQL</acronym> Standard</title> + <titleabbrev>Date and Darwen, 1997</titleabbrev> + <subtitle>A user's guide to the standard database language <acronym>SQL</acronym></subtitle> + <edition>Fourth Edition</edition> + <authorgroup> + <author> + <firstname>C. J.</firstname> + <surname>Date</surname> + </author> + <author> + <firstname>Hugh</firstname> + <surname>Darwen</surname> + </author> + </authorgroup> + <isbn>0-201-96426-0</isbn> + <pubdate>1997</pubdate> + <publisher> + <publishername>Addison-Wesley</publishername> + </publisher> + <copyright> + <year>1997</year> + <holder>Addison-Wesley Longman, Inc.</holder> + </copyright> + </biblioentry> + + <biblioentry id="DATE04"> + <title>An Introduction to Database Systems</title> + <titleabbrev>Date, 2004</titleabbrev> + <edition>Eighth Edition</edition> + <authorgroup> + <author> + <firstname>C. J.</firstname> + <surname>Date</surname> + </author> + </authorgroup> + <isbn>0-321-19784-4</isbn> + <pubdate>2003</pubdate> + <publisher> + <publishername>Addison-Wesley</publishername> + </publisher> + <copyright> + <year>2004</year> + <holder>Pearson Education, Inc.</holder> + </copyright> + </biblioentry> + + <biblioentry id="ELMA04"> + <title>Fundamentals of Database Systems</title> + <edition>Fourth Edition</edition> + <authorgroup> + <author> + <firstname>Ramez</firstname> + <surname>Elmasri</surname> + </author> + <author> + <firstname>Shamkant</firstname> + <surname>Navathe</surname> + </author> + </authorgroup> + <isbn>0-321-12226-7</isbn> + <pubdate>2003</pubdate> + <publisher> + <publishername>Addison-Wesley</publishername> + </publisher> + <copyright> + <year>2004</year> + </copyright> + </biblioentry> + + <biblioentry id="MELT93"> + <title>Understanding the New <acronym>SQL</acronym></title> + <titleabbrev>Melton and Simon, 1993</titleabbrev> + <subtitle>A complete guide</subtitle> + <authorgroup> + <author> + <firstname>Jim</firstname> + <surname>Melton</surname> + </author> + <author> + <firstname>Alan R.</firstname> + <surname>Simon</surname> + </author> + </authorgroup> + <isbn>1-55860-245-3</isbn> + <pubdate>1993</pubdate> + <publisher> + <publishername>Morgan Kaufmann</publishername> + </publisher> + <copyright> + <year>1993</year> + <holder>Morgan Kaufmann Publishers, Inc.</holder> + </copyright> + </biblioentry> + + <biblioentry id="ULL88"> + <title>Principles of Database and Knowledge</title> + <subtitle>Base Systems</subtitle> + <titleabbrev>Ullman, 1988</titleabbrev> + <authorgroup> + <author> + <firstname>Jeffrey D.</firstname> + <surname>Ullman</surname> + </author> + </authorgroup> + <volumenum>Volume 1</volumenum> + <publisher> + <publishername>Computer Science Press</publishername> + </publisher> + <pubdate>1988</pubdate> + </biblioentry> + + </bibliodiv> + + <bibliodiv> + <title>PostgreSQL-specific Documentation</title> + <para>This section is for related documentation.</para> + + <biblioentry id="SIM98"> + <title>Enhancement of the ANSI SQL Implementation of PostgreSQL</title> + <titleabbrev>Simkovics, 1998</titleabbrev> + <authorgroup> + <author> + <firstname>Stefan</firstname> + <surname>Simkovics</surname> +<!-- +Paul-Peters-Gasse 36 +2384 Breitenfurt +AUSTRIA +ssimkovi@ag.or.at +--> + </author> + </authorgroup> +<!-- + <othercredit> + <contrib> + with support by + </contrib> + <honorific>O. Univ. Prof. Dr.</honorific> + <firstname>Georg</firstname> + <surname>Gottlob</surname> + <honorific>Univ. Ass. Mag.</honorific> + <firstname>Katrin</firstname> + <surname>Seyr</surname> + </othercredit> +--> + <abstract> + <para> + Discusses SQL history and syntax, and describes the addition of + <literal>INTERSECT</> and <literal>EXCEPT</> constructs into + <productname>PostgreSQL</productname>. Prepared as a Master's + Thesis with the support of O. Univ. Prof. Dr. Georg Gottlob and + Univ. Ass. Mag. Katrin Seyr at Vienna University of Technology. + </para> + </abstract> + + <pubdate>November 29, 1998</pubdate> + <publisher> + <publishername>Department of Information Systems, Vienna University of Technology</publishername> + <address>Vienna, Austria</address> + </publisher> + </biblioentry> + + <biblioentry id="YU95"> + <title>The <productname>Postgres95</productname> User Manual</title> + <titleabbrev>Yu and Chen, 1995</titleabbrev> + <authorgroup> + <author> + <firstname>A.</firstname> + <surname>Yu</surname> + </author> + <author> + <firstname>J.</firstname> + <surname>Chen</surname> + </author> + </authorgroup> + <authorgroup> + <collab> + <collabname>The POSTGRES Group</collabname> + </collab> + </authorgroup> + + <pubdate>Sept. 5, 1995</pubdate> + <publisher> + <publishername>University of California</publishername> + <address>Berkeley, California</address> + </publisher> + </biblioentry> + + <biblioentry id="FONG"> + <title> + <ulink url="http://db.cs.berkeley.edu/papers/UCB-MS-zfong.pdf"> + The design and implementation of the <productname>POSTGRES</productname> query optimizer + </ulink></title> + <author> + <firstname>Zelaine</firstname> + <surname>Fong</surname> + </author> + <publisher> + <publishername>University of California, Berkeley, Computer Science Department</publishername> + </publisher> + </biblioentry> + + </bibliodiv> + + <bibliodiv> + <title>Proceedings and Articles</title> + <para>This section is for articles and newsletters.</para> + + <biblioentry id="OLSON93"> + <title>Partial indexing in POSTGRES: research project</title> + <titleabbrev>Olson, 1993</titleabbrev> + <authorgroup> + <author> + <firstname>Nels</firstname> + <surname>Olson</surname> + </author> + </authorgroup> + <pubdate>1993</pubdate> + <pubsnumber>UCB Engin T7.49.1993 O676</pubsnumber> + <publisher> + <publishername>University of California</publishername> + <address>Berkeley, California</address> + </publisher> + </biblioentry> + + <biblioentry id="ONG90"> + <biblioset relation="article"> + <title>A Unified Framework for Version Modeling Using Production Rules in a Database System</title> + <titleabbrev>Ong and Goh, 1990</titleabbrev> + <authorgroup> + <author> + <firstname>L.</firstname> + <surname>Ong</surname> + </author> + <author> + <firstname>J.</firstname> + <surname>Goh</surname> + </author> + </authorgroup> + </biblioset> + <biblioset relation="journal"> + <title>ERL Technical Memorandum M90/33</title> + <pubdate>April, 1990</pubdate> + <publisher> + <publishername>University of California</publishername> + <address>Berkely, California</address> + </publisher> + </biblioset> + </biblioentry> + + <biblioentry id="ROWE87"> + <biblioset relation="article"> + <title><ulink url="http://db.cs.berkeley.edu/papers/ERL-M87-13.pdf"> + The <productname>POSTGRES</productname> data model + </ulink></title> + <titleabbrev>Rowe and Stonebraker, 1987</titleabbrev> + <authorgroup> + <author> + <firstname>L.</firstname> + <surname>Rowe</surname> + </author> + <author> + <firstname>M.</firstname> + <surname>Stonebraker</surname> + </author> + </authorgroup> + </biblioset> + <confgroup> + <conftitle>VLDB Conference</conftitle> + <confdates>Sept. 1987</confdates> + <address>Brighton, England</address> + </confgroup> + </biblioentry> + + <biblioentry id="SESHADRI95"> + <biblioset relation="article"> + <title>Generalized Partial Indexes + <ulink url="http://citeseer.ist.psu.edu/seshadri95generalized.html">(cached version) +<!-- + Original URL: http://citeseer.ist.psu.edu/seshadri95generalized.html +--> + </ulink> + </title> + <titleabbrev>Seshardri, 1995</titleabbrev> + <authorgroup> + <author> + <firstname>P.</firstname> + <surname>Seshadri</surname> + </author> + <author> + <firstname>A.</firstname> + <surname>Swami</surname> + </author> + </authorgroup> + </biblioset> + <confgroup> + <conftitle>Eleventh International Conference on Data Engineering</conftitle> + <confdates>6-10 March 1995</confdates> + <address>Taipeh, Taiwan</address> + </confgroup> + <pubdate>1995</pubdate> + <pubsnumber>Cat. No.95CH35724</pubsnumber> + <publisher> + <publishername>IEEE Computer Society Press</publishername> + <address>Los Alamitos, California</address> + </publisher> + <pagenums>420-7</pagenums> + </biblioentry> + + <biblioentry id="STON86"> + <biblioset relation="article"> + <title><ulink url="http://db.cs.berkeley.edu/papers/ERL-M85-95.pdf"> + The design of <productname>POSTGRES</productname> + </ulink></title> + <titleabbrev>Stonebraker and Rowe, 1986</titleabbrev> + <authorgroup> + <author> + <firstname>M.</firstname> + <surname>Stonebraker</surname> + </author> + <author> + <firstname>L.</firstname> + <surname>Rowe</surname> + </author> + </authorgroup> + </biblioset> + <confgroup> + <conftitle>ACM-SIGMOD Conference on Management of Data</conftitle> + <confdates>May 1986</confdates> + <address>Washington, DC</address> + </confgroup> + </biblioentry> + + <biblioentry id="STON87a"> + <biblioset relation="article"> + <title>The design of the <productname>POSTGRES</productname> rules system</title> + <titleabbrev>Stonebraker, Hanson, Hong, 1987</titleabbrev> + <authorgroup> + <author> + <firstname>M.</firstname> + <surname>Stonebraker</surname> + </author> + <author> + <firstname>E.</firstname> + <surname>Hanson</surname> + </author> + <author> + <firstname>C. H.</firstname> + <surname>Hong</surname> + </author> + </authorgroup> + </biblioset> + <confgroup> + <conftitle>IEEE Conference on Data Engineering</conftitle> + <confdates>Feb. 1987</confdates> + <address>Los Angeles, California</address> + </confgroup> + </biblioentry> + + <biblioentry id="STON87b"> + <biblioset relation="article"> + <title><ulink url="http://db.cs.berkeley.edu/papers/ERL-M87-06.pdf"> + The design of the <productname>POSTGRES</productname> storage system + </ulink></title> + <titleabbrev>Stonebraker, 1987</titleabbrev> + <authorgroup> + <author> + <firstname>M.</firstname> + <surname>Stonebraker</surname> + </author> + </authorgroup> + </biblioset> + <confgroup> + <conftitle>VLDB Conference</conftitle> + <confdates>Sept. 1987</confdates> + <address>Brighton, England</address> + </confgroup> + </biblioentry> + + <biblioentry id="STON89"> + <biblioset relation="article"> + <title><ulink url="http://db.cs.berkeley.edu/papers/ERL-M89-82.pdf"> + A commentary on the <productname>POSTGRES</productname> rules system + </ulink></title> + <titleabbrev>Stonebraker et al, 1989</titleabbrev> + <authorgroup> + <author> + <firstname>M.</firstname> + <surname>Stonebraker</surname> + </author> + <author> + <firstname>M.</firstname> + <surname>Hearst</surname> + </author> + <author> + <firstname>S.</firstname> + <surname>Potamianos</surname> + </author> + </authorgroup> + </biblioset> + <biblioset relation="journal"> + <title>SIGMOD Record 18(3)</title> + <date>Sept. 1989</date> + </biblioset> + </biblioentry> + + <biblioentry id="STON89b"> + <biblioset relation="article"> + <title><ulink url="http://db.cs.berkeley.edu/papers/ERL-M89-17.pdf"> + The case for partial indexes + </ulink></title> + <titleabbrev>Stonebraker, M, 1989b</titleabbrev> + <authorgroup> + <author> + <firstname>M.</firstname> + <surname>Stonebraker</surname> + </author> + </authorgroup> + </biblioset> + <biblioset relation="journal"> + <title>SIGMOD Record 18(4)</title> + <pagenums>4-11</pagenums> + <date>Dec. 1989</date> + </biblioset> + </biblioentry> + + <biblioentry id="STON90a"> + <biblioset relation="article"> + <title><ulink url="http://db.cs.berkeley.edu/papers/ERL-M90-34.pdf"> + The implementation of <productname>POSTGRES</productname> + </ulink></title> + <titleabbrev>Stonebraker, Rowe, Hirohama, 1990</titleabbrev> + <authorgroup> + <author> + <firstname>M.</firstname> + <surname>Stonebraker</surname> + </author> + <author> + <firstname>L. A.</firstname> + <surname>Rowe</surname> + </author> + <author> + <firstname>M.</firstname> + <surname>Hirohama</surname> + </author> + </authorgroup> + </biblioset> + <biblioset relation="journal"> + <title>Transactions on Knowledge and Data Engineering 2(1)</title> + <publisher> + <publishername>IEEE</publishername> + </publisher> + <date>March 1990</date> + </biblioset> + </biblioentry> + + <biblioentry id="STON90b"> + <biblioset relation="article"> + <title><ulink url="http://db.cs.berkeley.edu/papers/ERL-M90-36.pdf"> + On Rules, Procedures, Caching and Views in Database Systems + </ulink></title> + <titleabbrev>Stonebraker et al, ACM, 1990</titleabbrev> + <authorgroup> + <author> + <firstname>M.</firstname> + <surname>Stonebraker</surname> + </author> + <author> + <firstname>A.</firstname> + <surname>Jhingran</surname> + </author> + <author> + <firstname>J.</firstname> + <surname>Goh</surname> + </author> + <author> + <firstname>S.</firstname> + <surname>Potamianos</surname> + </author> + </authorgroup> + </biblioset> + <confgroup> + <conftitle>ACM-SIGMOD Conference on Management of Data</conftitle> + <confdates>June 1990</confdates> + </confgroup> + </biblioentry> + + </bibliodiv> + </bibliography> diff --git a/doc/src/sgml/bookindex.sgml b/doc/src/sgml/bookindex.sgml new file mode 100644 index 000000000..b355c741c --- /dev/null +++ b/doc/src/sgml/bookindex.sgml @@ -0,0 +1,121 @@ +<index id='bookindex'> + +<!-- This file was produced by collateindex.pl. --> +<!-- Remove this comment if you edit this file by hand! --> +<!-- ULINK is abused here. + + The URL attribute holds the URL that points from the index entry + back to the appropriate place in the output produced by the HTML + stylesheet. (It's much easier to calculate this URL in the first + pass.) + + The Role attribute holds the ID (either real or manufactured) of + the corresponding INDEXTERM. This is used by the print backends + to produce page numbers. + + The entries below are sorted and collated into the correct order. + Duplicates may be removed in the HTML backend, but in the print + backends, it is impossible to suppress duplicate pages or coalesce + sequences of pages into a range. +--> + +<indexdiv><title>C</title> + +<indexentry> + <primaryie>configure, + <ulink url="install-procedure.html" role="install-procedure">Installation Procedure</ulink> + </primaryie> +</indexentry> + +</indexdiv> +<indexdiv><title>H</title> + +<indexentry> + <primaryie>history + </primaryie> + <secondaryie>of pgpool-II, + <ulink url="history.html" role="history">A Brief History of pgpool-II</ulink> + </secondaryie> +</indexentry> + +</indexdiv> +<indexdiv><title>I</title> + +<indexentry> + <primaryie>installation, + <ulink url="installation.html" role="installation">pgpool-IIInstallation from Source Code</ulink> + </primaryie> +</indexentry> + +</indexdiv> +<indexdiv><title>L</title> + +<indexentry> + <primaryie>ldconfig, + <ulink url="install-post.html#AEN453" role="AEN495">Shared Libraries</ulink> + </primaryie> +</indexentry> + +</indexdiv> +<indexdiv><title>M</title> + +<indexentry> + <primaryie>MANPATH, + <ulink url="install-post.html#AEN504" role="AEN525">Environment Variables</ulink> + </primaryie> +</indexentry> + +</indexdiv> +<indexdiv><title>O</title> + +<indexentry> + <primaryie>OpenSSL, + <ulink url="install-procedure.html" role="AEN283">Installation Procedure</ulink> + </primaryie> + <seealsoie>SSL</seealsoie> +</indexentry> + +</indexdiv> +<indexdiv><title>P</title> + +<indexentry> + <primaryie>PATH, + <ulink url="install-post.html#AEN504" role="AEN506">Environment Variables</ulink> + </primaryie> +</indexentry> + +<indexentry> + <primaryie>pcp_node_count, + <ulink url="pcp-node-count.html" role="pcp-node-count">pcp_node_count</ulink> + </primaryie> +</indexentry> + +</indexdiv> +<indexdiv><title>R</title> + +<indexentry> + <primaryie>regression test, + <ulink url="install-procedure.html" role="AEN404">Installation Procedure</ulink> + </primaryie> +</indexentry> + +</indexdiv> +<indexdiv><title>S</title> + +<indexentry> + <primaryie>shared library, + <ulink url="install-post.html#AEN453" role="AEN455">Shared Libraries</ulink> + </primaryie> +</indexentry> + +</indexdiv> +<indexdiv><title>V</title> + +<indexentry> + <primaryie>VPATH, + <ulink url="install-procedure.html" role="AEN139">Installation Procedure</ulink> + </primaryie> +</indexentry> + +</indexdiv> +</index> diff --git a/doc/src/sgml/errcodes-table.sgml b/doc/src/sgml/errcodes-table.sgml new file mode 100644 index 000000000..1c518cf64 --- /dev/null +++ b/doc/src/sgml/errcodes-table.sgml @@ -0,0 +1,1371 @@ +<!-- autogenerated from src/backend/utils/errcodes.txt, do not edit --> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 00 &mdash; Successful Completion</></entry> +</row> + +<row> +<entry><literal>00000</literal></entry> +<entry><symbol>successful_completion</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 01 &mdash; Warning</></entry> +</row> + +<row> +<entry><literal>01000</literal></entry> +<entry><symbol>warning</symbol></entry> +</row> + +<row> +<entry><literal>0100C</literal></entry> +<entry><symbol>dynamic_result_sets_returned</symbol></entry> +</row> + +<row> +<entry><literal>01008</literal></entry> +<entry><symbol>implicit_zero_bit_padding</symbol></entry> +</row> + +<row> +<entry><literal>01003</literal></entry> +<entry><symbol>null_value_eliminated_in_set_function</symbol></entry> +</row> + +<row> +<entry><literal>01007</literal></entry> +<entry><symbol>privilege_not_granted</symbol></entry> +</row> + +<row> +<entry><literal>01006</literal></entry> +<entry><symbol>privilege_not_revoked</symbol></entry> +</row> + +<row> +<entry><literal>01004</literal></entry> +<entry><symbol>string_data_right_truncation</symbol></entry> +</row> + +<row> +<entry><literal>01P01</literal></entry> +<entry><symbol>deprecated_feature</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 02 &mdash; No Data (this is also a warning class per the SQL standard)</></entry> +</row> + +<row> +<entry><literal>02000</literal></entry> +<entry><symbol>no_data</symbol></entry> +</row> + +<row> +<entry><literal>02001</literal></entry> +<entry><symbol>no_additional_dynamic_result_sets_returned</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 03 &mdash; SQL Statement Not Yet Complete</></entry> +</row> + +<row> +<entry><literal>03000</literal></entry> +<entry><symbol>sql_statement_not_yet_complete</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 08 &mdash; Connection Exception</></entry> +</row> + +<row> +<entry><literal>08000</literal></entry> +<entry><symbol>connection_exception</symbol></entry> +</row> + +<row> +<entry><literal>08003</literal></entry> +<entry><symbol>connection_does_not_exist</symbol></entry> +</row> + +<row> +<entry><literal>08006</literal></entry> +<entry><symbol>connection_failure</symbol></entry> +</row> + +<row> +<entry><literal>08001</literal></entry> +<entry><symbol>sqlclient_unable_to_establish_sqlconnection</symbol></entry> +</row> + +<row> +<entry><literal>08004</literal></entry> +<entry><symbol>sqlserver_rejected_establishment_of_sqlconnection</symbol></entry> +</row> + +<row> +<entry><literal>08007</literal></entry> +<entry><symbol>transaction_resolution_unknown</symbol></entry> +</row> + +<row> +<entry><literal>08P01</literal></entry> +<entry><symbol>protocol_violation</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 09 &mdash; Triggered Action Exception</></entry> +</row> + +<row> +<entry><literal>09000</literal></entry> +<entry><symbol>triggered_action_exception</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 0A &mdash; Feature Not Supported</></entry> +</row> + +<row> +<entry><literal>0A000</literal></entry> +<entry><symbol>feature_not_supported</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 0B &mdash; Invalid Transaction Initiation</></entry> +</row> + +<row> +<entry><literal>0B000</literal></entry> +<entry><symbol>invalid_transaction_initiation</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 0F &mdash; Locator Exception</></entry> +</row> + +<row> +<entry><literal>0F000</literal></entry> +<entry><symbol>locator_exception</symbol></entry> +</row> + +<row> +<entry><literal>0F001</literal></entry> +<entry><symbol>invalid_locator_specification</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 0L &mdash; Invalid Grantor</></entry> +</row> + +<row> +<entry><literal>0L000</literal></entry> +<entry><symbol>invalid_grantor</symbol></entry> +</row> + +<row> +<entry><literal>0LP01</literal></entry> +<entry><symbol>invalid_grant_operation</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 0P &mdash; Invalid Role Specification</></entry> +</row> + +<row> +<entry><literal>0P000</literal></entry> +<entry><symbol>invalid_role_specification</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 0Z &mdash; Diagnostics Exception</></entry> +</row> + +<row> +<entry><literal>0Z000</literal></entry> +<entry><symbol>diagnostics_exception</symbol></entry> +</row> + +<row> +<entry><literal>0Z002</literal></entry> +<entry><symbol>stacked_diagnostics_accessed_without_active_handler</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 20 &mdash; Case Not Found</></entry> +</row> + +<row> +<entry><literal>20000</literal></entry> +<entry><symbol>case_not_found</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 21 &mdash; Cardinality Violation</></entry> +</row> + +<row> +<entry><literal>21000</literal></entry> +<entry><symbol>cardinality_violation</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 22 &mdash; Data Exception</></entry> +</row> + +<row> +<entry><literal>22000</literal></entry> +<entry><symbol>data_exception</symbol></entry> +</row> + +<row> +<entry><literal>2202E</literal></entry> +<entry><symbol>array_subscript_error</symbol></entry> +</row> + +<row> +<entry><literal>22021</literal></entry> +<entry><symbol>character_not_in_repertoire</symbol></entry> +</row> + +<row> +<entry><literal>22008</literal></entry> +<entry><symbol>datetime_field_overflow</symbol></entry> +</row> + +<row> +<entry><literal>22012</literal></entry> +<entry><symbol>division_by_zero</symbol></entry> +</row> + +<row> +<entry><literal>22005</literal></entry> +<entry><symbol>error_in_assignment</symbol></entry> +</row> + +<row> +<entry><literal>2200B</literal></entry> +<entry><symbol>escape_character_conflict</symbol></entry> +</row> + +<row> +<entry><literal>22022</literal></entry> +<entry><symbol>indicator_overflow</symbol></entry> +</row> + +<row> +<entry><literal>22015</literal></entry> +<entry><symbol>interval_field_overflow</symbol></entry> +</row> + +<row> +<entry><literal>2201E</literal></entry> +<entry><symbol>invalid_argument_for_logarithm</symbol></entry> +</row> + +<row> +<entry><literal>22014</literal></entry> +<entry><symbol>invalid_argument_for_ntile_function</symbol></entry> +</row> + +<row> +<entry><literal>22016</literal></entry> +<entry><symbol>invalid_argument_for_nth_value_function</symbol></entry> +</row> + +<row> +<entry><literal>2201F</literal></entry> +<entry><symbol>invalid_argument_for_power_function</symbol></entry> +</row> + +<row> +<entry><literal>2201G</literal></entry> +<entry><symbol>invalid_argument_for_width_bucket_function</symbol></entry> +</row> + +<row> +<entry><literal>22018</literal></entry> +<entry><symbol>invalid_character_value_for_cast</symbol></entry> +</row> + +<row> +<entry><literal>22007</literal></entry> +<entry><symbol>invalid_datetime_format</symbol></entry> +</row> + +<row> +<entry><literal>22019</literal></entry> +<entry><symbol>invalid_escape_character</symbol></entry> +</row> + +<row> +<entry><literal>2200D</literal></entry> +<entry><symbol>invalid_escape_octet</symbol></entry> +</row> + +<row> +<entry><literal>22025</literal></entry> +<entry><symbol>invalid_escape_sequence</symbol></entry> +</row> + +<row> +<entry><literal>22P06</literal></entry> +<entry><symbol>nonstandard_use_of_escape_character</symbol></entry> +</row> + +<row> +<entry><literal>22010</literal></entry> +<entry><symbol>invalid_indicator_parameter_value</symbol></entry> +</row> + +<row> +<entry><literal>22023</literal></entry> +<entry><symbol>invalid_parameter_value</symbol></entry> +</row> + +<row> +<entry><literal>2201B</literal></entry> +<entry><symbol>invalid_regular_expression</symbol></entry> +</row> + +<row> +<entry><literal>2201W</literal></entry> +<entry><symbol>invalid_row_count_in_limit_clause</symbol></entry> +</row> + +<row> +<entry><literal>2201X</literal></entry> +<entry><symbol>invalid_row_count_in_result_offset_clause</symbol></entry> +</row> + +<row> +<entry><literal>22009</literal></entry> +<entry><symbol>invalid_time_zone_displacement_value</symbol></entry> +</row> + +<row> +<entry><literal>2200C</literal></entry> +<entry><symbol>invalid_use_of_escape_character</symbol></entry> +</row> + +<row> +<entry><literal>2200G</literal></entry> +<entry><symbol>most_specific_type_mismatch</symbol></entry> +</row> + +<row> +<entry><literal>22004</literal></entry> +<entry><symbol>null_value_not_allowed</symbol></entry> +</row> + +<row> +<entry><literal>22002</literal></entry> +<entry><symbol>null_value_no_indicator_parameter</symbol></entry> +</row> + +<row> +<entry><literal>22003</literal></entry> +<entry><symbol>numeric_value_out_of_range</symbol></entry> +</row> + +<row> +<entry><literal>22026</literal></entry> +<entry><symbol>string_data_length_mismatch</symbol></entry> +</row> + +<row> +<entry><literal>22001</literal></entry> +<entry><symbol>string_data_right_truncation</symbol></entry> +</row> + +<row> +<entry><literal>22011</literal></entry> +<entry><symbol>substring_error</symbol></entry> +</row> + +<row> +<entry><literal>22027</literal></entry> +<entry><symbol>trim_error</symbol></entry> +</row> + +<row> +<entry><literal>22024</literal></entry> +<entry><symbol>unterminated_c_string</symbol></entry> +</row> + +<row> +<entry><literal>2200F</literal></entry> +<entry><symbol>zero_length_character_string</symbol></entry> +</row> + +<row> +<entry><literal>22P01</literal></entry> +<entry><symbol>floating_point_exception</symbol></entry> +</row> + +<row> +<entry><literal>22P02</literal></entry> +<entry><symbol>invalid_text_representation</symbol></entry> +</row> + +<row> +<entry><literal>22P03</literal></entry> +<entry><symbol>invalid_binary_representation</symbol></entry> +</row> + +<row> +<entry><literal>22P04</literal></entry> +<entry><symbol>bad_copy_file_format</symbol></entry> +</row> + +<row> +<entry><literal>22P05</literal></entry> +<entry><symbol>untranslatable_character</symbol></entry> +</row> + +<row> +<entry><literal>2200L</literal></entry> +<entry><symbol>not_an_xml_document</symbol></entry> +</row> + +<row> +<entry><literal>2200M</literal></entry> +<entry><symbol>invalid_xml_document</symbol></entry> +</row> + +<row> +<entry><literal>2200N</literal></entry> +<entry><symbol>invalid_xml_content</symbol></entry> +</row> + +<row> +<entry><literal>2200S</literal></entry> +<entry><symbol>invalid_xml_comment</symbol></entry> +</row> + +<row> +<entry><literal>2200T</literal></entry> +<entry><symbol>invalid_xml_processing_instruction</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 23 &mdash; Integrity Constraint Violation</></entry> +</row> + +<row> +<entry><literal>23000</literal></entry> +<entry><symbol>integrity_constraint_violation</symbol></entry> +</row> + +<row> +<entry><literal>23001</literal></entry> +<entry><symbol>restrict_violation</symbol></entry> +</row> + +<row> +<entry><literal>23502</literal></entry> +<entry><symbol>not_null_violation</symbol></entry> +</row> + +<row> +<entry><literal>23503</literal></entry> +<entry><symbol>foreign_key_violation</symbol></entry> +</row> + +<row> +<entry><literal>23505</literal></entry> +<entry><symbol>unique_violation</symbol></entry> +</row> + +<row> +<entry><literal>23514</literal></entry> +<entry><symbol>check_violation</symbol></entry> +</row> + +<row> +<entry><literal>23P01</literal></entry> +<entry><symbol>exclusion_violation</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 24 &mdash; Invalid Cursor State</></entry> +</row> + +<row> +<entry><literal>24000</literal></entry> +<entry><symbol>invalid_cursor_state</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 25 &mdash; Invalid Transaction State</></entry> +</row> + +<row> +<entry><literal>25000</literal></entry> +<entry><symbol>invalid_transaction_state</symbol></entry> +</row> + +<row> +<entry><literal>25001</literal></entry> +<entry><symbol>active_sql_transaction</symbol></entry> +</row> + +<row> +<entry><literal>25002</literal></entry> +<entry><symbol>branch_transaction_already_active</symbol></entry> +</row> + +<row> +<entry><literal>25008</literal></entry> +<entry><symbol>held_cursor_requires_same_isolation_level</symbol></entry> +</row> + +<row> +<entry><literal>25003</literal></entry> +<entry><symbol>inappropriate_access_mode_for_branch_transaction</symbol></entry> +</row> + +<row> +<entry><literal>25004</literal></entry> +<entry><symbol>inappropriate_isolation_level_for_branch_transaction</symbol></entry> +</row> + +<row> +<entry><literal>25005</literal></entry> +<entry><symbol>no_active_sql_transaction_for_branch_transaction</symbol></entry> +</row> + +<row> +<entry><literal>25006</literal></entry> +<entry><symbol>read_only_sql_transaction</symbol></entry> +</row> + +<row> +<entry><literal>25007</literal></entry> +<entry><symbol>schema_and_data_statement_mixing_not_supported</symbol></entry> +</row> + +<row> +<entry><literal>25P01</literal></entry> +<entry><symbol>no_active_sql_transaction</symbol></entry> +</row> + +<row> +<entry><literal>25P02</literal></entry> +<entry><symbol>in_failed_sql_transaction</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 26 &mdash; Invalid SQL Statement Name</></entry> +</row> + +<row> +<entry><literal>26000</literal></entry> +<entry><symbol>invalid_sql_statement_name</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 27 &mdash; Triggered Data Change Violation</></entry> +</row> + +<row> +<entry><literal>27000</literal></entry> +<entry><symbol>triggered_data_change_violation</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 28 &mdash; Invalid Authorization Specification</></entry> +</row> + +<row> +<entry><literal>28000</literal></entry> +<entry><symbol>invalid_authorization_specification</symbol></entry> +</row> + +<row> +<entry><literal>28P01</literal></entry> +<entry><symbol>invalid_password</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 2B &mdash; Dependent Privilege Descriptors Still Exist</></entry> +</row> + +<row> +<entry><literal>2B000</literal></entry> +<entry><symbol>dependent_privilege_descriptors_still_exist</symbol></entry> +</row> + +<row> +<entry><literal>2BP01</literal></entry> +<entry><symbol>dependent_objects_still_exist</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 2D &mdash; Invalid Transaction Termination</></entry> +</row> + +<row> +<entry><literal>2D000</literal></entry> +<entry><symbol>invalid_transaction_termination</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 2F &mdash; SQL Routine Exception</></entry> +</row> + +<row> +<entry><literal>2F000</literal></entry> +<entry><symbol>sql_routine_exception</symbol></entry> +</row> + +<row> +<entry><literal>2F005</literal></entry> +<entry><symbol>function_executed_no_return_statement</symbol></entry> +</row> + +<row> +<entry><literal>2F002</literal></entry> +<entry><symbol>modifying_sql_data_not_permitted</symbol></entry> +</row> + +<row> +<entry><literal>2F003</literal></entry> +<entry><symbol>prohibited_sql_statement_attempted</symbol></entry> +</row> + +<row> +<entry><literal>2F004</literal></entry> +<entry><symbol>reading_sql_data_not_permitted</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 34 &mdash; Invalid Cursor Name</></entry> +</row> + +<row> +<entry><literal>34000</literal></entry> +<entry><symbol>invalid_cursor_name</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 38 &mdash; External Routine Exception</></entry> +</row> + +<row> +<entry><literal>38000</literal></entry> +<entry><symbol>external_routine_exception</symbol></entry> +</row> + +<row> +<entry><literal>38001</literal></entry> +<entry><symbol>containing_sql_not_permitted</symbol></entry> +</row> + +<row> +<entry><literal>38002</literal></entry> +<entry><symbol>modifying_sql_data_not_permitted</symbol></entry> +</row> + +<row> +<entry><literal>38003</literal></entry> +<entry><symbol>prohibited_sql_statement_attempted</symbol></entry> +</row> + +<row> +<entry><literal>38004</literal></entry> +<entry><symbol>reading_sql_data_not_permitted</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 39 &mdash; External Routine Invocation Exception</></entry> +</row> + +<row> +<entry><literal>39000</literal></entry> +<entry><symbol>external_routine_invocation_exception</symbol></entry> +</row> + +<row> +<entry><literal>39001</literal></entry> +<entry><symbol>invalid_sqlstate_returned</symbol></entry> +</row> + +<row> +<entry><literal>39004</literal></entry> +<entry><symbol>null_value_not_allowed</symbol></entry> +</row> + +<row> +<entry><literal>39P01</literal></entry> +<entry><symbol>trigger_protocol_violated</symbol></entry> +</row> + +<row> +<entry><literal>39P02</literal></entry> +<entry><symbol>srf_protocol_violated</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 3B &mdash; Savepoint Exception</></entry> +</row> + +<row> +<entry><literal>3B000</literal></entry> +<entry><symbol>savepoint_exception</symbol></entry> +</row> + +<row> +<entry><literal>3B001</literal></entry> +<entry><symbol>invalid_savepoint_specification</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 3D &mdash; Invalid Catalog Name</></entry> +</row> + +<row> +<entry><literal>3D000</literal></entry> +<entry><symbol>invalid_catalog_name</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 3F &mdash; Invalid Schema Name</></entry> +</row> + +<row> +<entry><literal>3F000</literal></entry> +<entry><symbol>invalid_schema_name</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 40 &mdash; Transaction Rollback</></entry> +</row> + +<row> +<entry><literal>40000</literal></entry> +<entry><symbol>transaction_rollback</symbol></entry> +</row> + +<row> +<entry><literal>40002</literal></entry> +<entry><symbol>transaction_integrity_constraint_violation</symbol></entry> +</row> + +<row> +<entry><literal>40001</literal></entry> +<entry><symbol>serialization_failure</symbol></entry> +</row> + +<row> +<entry><literal>40003</literal></entry> +<entry><symbol>statement_completion_unknown</symbol></entry> +</row> + +<row> +<entry><literal>40P01</literal></entry> +<entry><symbol>deadlock_detected</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 42 &mdash; Syntax Error or Access Rule Violation</></entry> +</row> + +<row> +<entry><literal>42000</literal></entry> +<entry><symbol>syntax_error_or_access_rule_violation</symbol></entry> +</row> + +<row> +<entry><literal>42601</literal></entry> +<entry><symbol>syntax_error</symbol></entry> +</row> + +<row> +<entry><literal>42501</literal></entry> +<entry><symbol>insufficient_privilege</symbol></entry> +</row> + +<row> +<entry><literal>42846</literal></entry> +<entry><symbol>cannot_coerce</symbol></entry> +</row> + +<row> +<entry><literal>42803</literal></entry> +<entry><symbol>grouping_error</symbol></entry> +</row> + +<row> +<entry><literal>42P20</literal></entry> +<entry><symbol>windowing_error</symbol></entry> +</row> + +<row> +<entry><literal>42P19</literal></entry> +<entry><symbol>invalid_recursion</symbol></entry> +</row> + +<row> +<entry><literal>42830</literal></entry> +<entry><symbol>invalid_foreign_key</symbol></entry> +</row> + +<row> +<entry><literal>42602</literal></entry> +<entry><symbol>invalid_name</symbol></entry> +</row> + +<row> +<entry><literal>42622</literal></entry> +<entry><symbol>name_too_long</symbol></entry> +</row> + +<row> +<entry><literal>42939</literal></entry> +<entry><symbol>reserved_name</symbol></entry> +</row> + +<row> +<entry><literal>42804</literal></entry> +<entry><symbol>datatype_mismatch</symbol></entry> +</row> + +<row> +<entry><literal>42P18</literal></entry> +<entry><symbol>indeterminate_datatype</symbol></entry> +</row> + +<row> +<entry><literal>42P21</literal></entry> +<entry><symbol>collation_mismatch</symbol></entry> +</row> + +<row> +<entry><literal>42P22</literal></entry> +<entry><symbol>indeterminate_collation</symbol></entry> +</row> + +<row> +<entry><literal>42809</literal></entry> +<entry><symbol>wrong_object_type</symbol></entry> +</row> + +<row> +<entry><literal>42703</literal></entry> +<entry><symbol>undefined_column</symbol></entry> +</row> + +<row> +<entry><literal>42883</literal></entry> +<entry><symbol>undefined_function</symbol></entry> +</row> + +<row> +<entry><literal>42P01</literal></entry> +<entry><symbol>undefined_table</symbol></entry> +</row> + +<row> +<entry><literal>42P02</literal></entry> +<entry><symbol>undefined_parameter</symbol></entry> +</row> + +<row> +<entry><literal>42704</literal></entry> +<entry><symbol>undefined_object</symbol></entry> +</row> + +<row> +<entry><literal>42701</literal></entry> +<entry><symbol>duplicate_column</symbol></entry> +</row> + +<row> +<entry><literal>42P03</literal></entry> +<entry><symbol>duplicate_cursor</symbol></entry> +</row> + +<row> +<entry><literal>42P04</literal></entry> +<entry><symbol>duplicate_database</symbol></entry> +</row> + +<row> +<entry><literal>42723</literal></entry> +<entry><symbol>duplicate_function</symbol></entry> +</row> + +<row> +<entry><literal>42P05</literal></entry> +<entry><symbol>duplicate_prepared_statement</symbol></entry> +</row> + +<row> +<entry><literal>42P06</literal></entry> +<entry><symbol>duplicate_schema</symbol></entry> +</row> + +<row> +<entry><literal>42P07</literal></entry> +<entry><symbol>duplicate_table</symbol></entry> +</row> + +<row> +<entry><literal>42712</literal></entry> +<entry><symbol>duplicate_alias</symbol></entry> +</row> + +<row> +<entry><literal>42710</literal></entry> +<entry><symbol>duplicate_object</symbol></entry> +</row> + +<row> +<entry><literal>42702</literal></entry> +<entry><symbol>ambiguous_column</symbol></entry> +</row> + +<row> +<entry><literal>42725</literal></entry> +<entry><symbol>ambiguous_function</symbol></entry> +</row> + +<row> +<entry><literal>42P08</literal></entry> +<entry><symbol>ambiguous_parameter</symbol></entry> +</row> + +<row> +<entry><literal>42P09</literal></entry> +<entry><symbol>ambiguous_alias</symbol></entry> +</row> + +<row> +<entry><literal>42P10</literal></entry> +<entry><symbol>invalid_column_reference</symbol></entry> +</row> + +<row> +<entry><literal>42611</literal></entry> +<entry><symbol>invalid_column_definition</symbol></entry> +</row> + +<row> +<entry><literal>42P11</literal></entry> +<entry><symbol>invalid_cursor_definition</symbol></entry> +</row> + +<row> +<entry><literal>42P12</literal></entry> +<entry><symbol>invalid_database_definition</symbol></entry> +</row> + +<row> +<entry><literal>42P13</literal></entry> +<entry><symbol>invalid_function_definition</symbol></entry> +</row> + +<row> +<entry><literal>42P14</literal></entry> +<entry><symbol>invalid_prepared_statement_definition</symbol></entry> +</row> + +<row> +<entry><literal>42P15</literal></entry> +<entry><symbol>invalid_schema_definition</symbol></entry> +</row> + +<row> +<entry><literal>42P16</literal></entry> +<entry><symbol>invalid_table_definition</symbol></entry> +</row> + +<row> +<entry><literal>42P17</literal></entry> +<entry><symbol>invalid_object_definition</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 44 &mdash; WITH CHECK OPTION Violation</></entry> +</row> + +<row> +<entry><literal>44000</literal></entry> +<entry><symbol>with_check_option_violation</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 53 &mdash; Insufficient Resources</></entry> +</row> + +<row> +<entry><literal>53000</literal></entry> +<entry><symbol>insufficient_resources</symbol></entry> +</row> + +<row> +<entry><literal>53100</literal></entry> +<entry><symbol>disk_full</symbol></entry> +</row> + +<row> +<entry><literal>53200</literal></entry> +<entry><symbol>out_of_memory</symbol></entry> +</row> + +<row> +<entry><literal>53300</literal></entry> +<entry><symbol>too_many_connections</symbol></entry> +</row> + +<row> +<entry><literal>53400</literal></entry> +<entry><symbol>configuration_limit_exceeded</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 54 &mdash; Program Limit Exceeded</></entry> +</row> + +<row> +<entry><literal>54000</literal></entry> +<entry><symbol>program_limit_exceeded</symbol></entry> +</row> + +<row> +<entry><literal>54001</literal></entry> +<entry><symbol>statement_too_complex</symbol></entry> +</row> + +<row> +<entry><literal>54011</literal></entry> +<entry><symbol>too_many_columns</symbol></entry> +</row> + +<row> +<entry><literal>54023</literal></entry> +<entry><symbol>too_many_arguments</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 55 &mdash; Object Not In Prerequisite State</></entry> +</row> + +<row> +<entry><literal>55000</literal></entry> +<entry><symbol>object_not_in_prerequisite_state</symbol></entry> +</row> + +<row> +<entry><literal>55006</literal></entry> +<entry><symbol>object_in_use</symbol></entry> +</row> + +<row> +<entry><literal>55P02</literal></entry> +<entry><symbol>cant_change_runtime_param</symbol></entry> +</row> + +<row> +<entry><literal>55P03</literal></entry> +<entry><symbol>lock_not_available</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 57 &mdash; Operator Intervention</></entry> +</row> + +<row> +<entry><literal>57000</literal></entry> +<entry><symbol>operator_intervention</symbol></entry> +</row> + +<row> +<entry><literal>57014</literal></entry> +<entry><symbol>query_canceled</symbol></entry> +</row> + +<row> +<entry><literal>57P01</literal></entry> +<entry><symbol>admin_shutdown</symbol></entry> +</row> + +<row> +<entry><literal>57P02</literal></entry> +<entry><symbol>crash_shutdown</symbol></entry> +</row> + +<row> +<entry><literal>57P03</literal></entry> +<entry><symbol>cannot_connect_now</symbol></entry> +</row> + +<row> +<entry><literal>57P04</literal></entry> +<entry><symbol>database_dropped</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class 58 &mdash; System Error (errors external to <productname>PostgreSQL</> itself)</></entry> +</row> + +<row> +<entry><literal>58000</literal></entry> +<entry><symbol>system_error</symbol></entry> +</row> + +<row> +<entry><literal>58030</literal></entry> +<entry><symbol>io_error</symbol></entry> +</row> + +<row> +<entry><literal>58P01</literal></entry> +<entry><symbol>undefined_file</symbol></entry> +</row> + +<row> +<entry><literal>58P02</literal></entry> +<entry><symbol>duplicate_file</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class F0 &mdash; Configuration File Error</></entry> +</row> + +<row> +<entry><literal>F0000</literal></entry> +<entry><symbol>config_file_error</symbol></entry> +</row> + +<row> +<entry><literal>F0001</literal></entry> +<entry><symbol>lock_file_exists</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class HV &mdash; Foreign Data Wrapper Error (SQL/MED)</></entry> +</row> + +<row> +<entry><literal>HV000</literal></entry> +<entry><symbol>fdw_error</symbol></entry> +</row> + +<row> +<entry><literal>HV005</literal></entry> +<entry><symbol>fdw_column_name_not_found</symbol></entry> +</row> + +<row> +<entry><literal>HV002</literal></entry> +<entry><symbol>fdw_dynamic_parameter_value_needed</symbol></entry> +</row> + +<row> +<entry><literal>HV010</literal></entry> +<entry><symbol>fdw_function_sequence_error</symbol></entry> +</row> + +<row> +<entry><literal>HV021</literal></entry> +<entry><symbol>fdw_inconsistent_descriptor_information</symbol></entry> +</row> + +<row> +<entry><literal>HV024</literal></entry> +<entry><symbol>fdw_invalid_attribute_value</symbol></entry> +</row> + +<row> +<entry><literal>HV007</literal></entry> +<entry><symbol>fdw_invalid_column_name</symbol></entry> +</row> + +<row> +<entry><literal>HV008</literal></entry> +<entry><symbol>fdw_invalid_column_number</symbol></entry> +</row> + +<row> +<entry><literal>HV004</literal></entry> +<entry><symbol>fdw_invalid_data_type</symbol></entry> +</row> + +<row> +<entry><literal>HV006</literal></entry> +<entry><symbol>fdw_invalid_data_type_descriptors</symbol></entry> +</row> + +<row> +<entry><literal>HV091</literal></entry> +<entry><symbol>fdw_invalid_descriptor_field_identifier</symbol></entry> +</row> + +<row> +<entry><literal>HV00B</literal></entry> +<entry><symbol>fdw_invalid_handle</symbol></entry> +</row> + +<row> +<entry><literal>HV00C</literal></entry> +<entry><symbol>fdw_invalid_option_index</symbol></entry> +</row> + +<row> +<entry><literal>HV00D</literal></entry> +<entry><symbol>fdw_invalid_option_name</symbol></entry> +</row> + +<row> +<entry><literal>HV090</literal></entry> +<entry><symbol>fdw_invalid_string_length_or_buffer_length</symbol></entry> +</row> + +<row> +<entry><literal>HV00A</literal></entry> +<entry><symbol>fdw_invalid_string_format</symbol></entry> +</row> + +<row> +<entry><literal>HV009</literal></entry> +<entry><symbol>fdw_invalid_use_of_null_pointer</symbol></entry> +</row> + +<row> +<entry><literal>HV014</literal></entry> +<entry><symbol>fdw_too_many_handles</symbol></entry> +</row> + +<row> +<entry><literal>HV001</literal></entry> +<entry><symbol>fdw_out_of_memory</symbol></entry> +</row> + +<row> +<entry><literal>HV00P</literal></entry> +<entry><symbol>fdw_no_schemas</symbol></entry> +</row> + +<row> +<entry><literal>HV00J</literal></entry> +<entry><symbol>fdw_option_name_not_found</symbol></entry> +</row> + +<row> +<entry><literal>HV00K</literal></entry> +<entry><symbol>fdw_reply_handle</symbol></entry> +</row> + +<row> +<entry><literal>HV00Q</literal></entry> +<entry><symbol>fdw_schema_not_found</symbol></entry> +</row> + +<row> +<entry><literal>HV00R</literal></entry> +<entry><symbol>fdw_table_not_found</symbol></entry> +</row> + +<row> +<entry><literal>HV00L</literal></entry> +<entry><symbol>fdw_unable_to_create_execution</symbol></entry> +</row> + +<row> +<entry><literal>HV00M</literal></entry> +<entry><symbol>fdw_unable_to_create_reply</symbol></entry> +</row> + +<row> +<entry><literal>HV00N</literal></entry> +<entry><symbol>fdw_unable_to_establish_connection</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class P0 &mdash; PL/pgSQL Error</></entry> +</row> + +<row> +<entry><literal>P0000</literal></entry> +<entry><symbol>plpgsql_error</symbol></entry> +</row> + +<row> +<entry><literal>P0001</literal></entry> +<entry><symbol>raise_exception</symbol></entry> +</row> + +<row> +<entry><literal>P0002</literal></entry> +<entry><symbol>no_data_found</symbol></entry> +</row> + +<row> +<entry><literal>P0003</literal></entry> +<entry><symbol>too_many_rows</symbol></entry> +</row> + + +<row> +<entry spanname="span12"><emphasis role="bold">Class XX &mdash; Internal Error</></entry> +</row> + +<row> +<entry><literal>XX000</literal></entry> +<entry><symbol>internal_error</symbol></entry> +</row> + +<row> +<entry><literal>XX001</literal></entry> +<entry><symbol>data_corrupted</symbol></entry> +</row> + +<row> +<entry><literal>XX002</literal></entry> +<entry><symbol>index_corrupted</symbol></entry> +</row> diff --git a/doc/src/sgml/features-supported.sgml b/doc/src/sgml/features-supported.sgml new file mode 100644 index 000000000..c879328a9 --- /dev/null +++ b/doc/src/sgml/features-supported.sgml @@ -0,0 +1,2174 @@ +<tbody> + <row> + <entry>B012</entry> + <entry></entry> + <entry>Embedded C</entry> + <entry></entry> + </row> + <row> + <entry>B021</entry> + <entry></entry> + <entry>Direct SQL</entry> + <entry></entry> + </row> + <row> + <entry>E011</entry> + <entry>Core</entry> + <entry>Numeric data types</entry> + <entry></entry> + </row> + <row> + <entry>E011-01</entry> + <entry>Core</entry> + <entry>INTEGER and SMALLINT data types</entry> + <entry></entry> + </row> + <row> + <entry>E011-02</entry> + <entry>Core</entry> + <entry>REAL, DOUBLE PRECISION, and FLOAT data types</entry> + <entry></entry> + </row> + <row> + <entry>E011-03</entry> + <entry>Core</entry> + <entry>DECIMAL and NUMERIC data types</entry> + <entry></entry> + </row> + <row> + <entry>E011-04</entry> + <entry>Core</entry> + <entry>Arithmetic operators</entry> + <entry></entry> + </row> + <row> + <entry>E011-05</entry> + <entry>Core</entry> + <entry>Numeric comparison</entry> + <entry></entry> + </row> + <row> + <entry>E011-06</entry> + <entry>Core</entry> + <entry>Implicit casting among the numeric data types</entry> + <entry></entry> + </row> + <row> + <entry>E021</entry> + <entry>Core</entry> + <entry>Character data types</entry> + <entry></entry> + </row> + <row> + <entry>E021-01</entry> + <entry>Core</entry> + <entry>CHARACTER data type</entry> + <entry></entry> + </row> + <row> + <entry>E021-02</entry> + <entry>Core</entry> + <entry>CHARACTER VARYING data type</entry> + <entry></entry> + </row> + <row> + <entry>E021-03</entry> + <entry>Core</entry> + <entry>Character literals</entry> + <entry></entry> + </row> + <row> + <entry>E021-04</entry> + <entry>Core</entry> + <entry>CHARACTER_LENGTH function</entry> + <entry>trims trailing spaces from CHARACTER values before counting</entry> + </row> + <row> + <entry>E021-05</entry> + <entry>Core</entry> + <entry>OCTET_LENGTH function</entry> + <entry></entry> + </row> + <row> + <entry>E021-06</entry> + <entry>Core</entry> + <entry>SUBSTRING function</entry> + <entry></entry> + </row> + <row> + <entry>E021-07</entry> + <entry>Core</entry> + <entry>Character concatenation</entry> + <entry></entry> + </row> + <row> + <entry>E021-08</entry> + <entry>Core</entry> + <entry>UPPER and LOWER functions</entry> + <entry></entry> + </row> + <row> + <entry>E021-09</entry> + <entry>Core</entry> + <entry>TRIM function</entry> + <entry></entry> + </row> + <row> + <entry>E021-10</entry> + <entry>Core</entry> + <entry>Implicit casting among the character string types</entry> + <entry></entry> + </row> + <row> + <entry>E021-11</entry> + <entry>Core</entry> + <entry>POSITION function</entry> + <entry></entry> + </row> + <row> + <entry>E021-12</entry> + <entry>Core</entry> + <entry>Character comparison</entry> + <entry></entry> + </row> + <row> + <entry>E031</entry> + <entry>Core</entry> + <entry>Identifiers</entry> + <entry></entry> + </row> + <row> + <entry>E031-01</entry> + <entry>Core</entry> + <entry>Delimited identifiers</entry> + <entry></entry> + </row> + <row> + <entry>E031-02</entry> + <entry>Core</entry> + <entry>Lower case identifiers</entry> + <entry></entry> + </row> + <row> + <entry>E031-03</entry> + <entry>Core</entry> + <entry>Trailing underscore</entry> + <entry></entry> + </row> + <row> + <entry>E051</entry> + <entry>Core</entry> + <entry>Basic query specification</entry> + <entry></entry> + </row> + <row> + <entry>E051-01</entry> + <entry>Core</entry> + <entry>SELECT DISTINCT</entry> + <entry></entry> + </row> + <row> + <entry>E051-02</entry> + <entry>Core</entry> + <entry>GROUP BY clause</entry> + <entry></entry> + </row> + <row> + <entry>E051-04</entry> + <entry>Core</entry> + <entry>GROUP BY can contain columns not in &lt;select list&gt;</entry> + <entry></entry> + </row> + <row> + <entry>E051-05</entry> + <entry>Core</entry> + <entry>Select list items can be renamed</entry> + <entry></entry> + </row> + <row> + <entry>E051-06</entry> + <entry>Core</entry> + <entry>HAVING clause</entry> + <entry></entry> + </row> + <row> + <entry>E051-07</entry> + <entry>Core</entry> + <entry>Qualified * in select list</entry> + <entry></entry> + </row> + <row> + <entry>E051-08</entry> + <entry>Core</entry> + <entry>Correlation names in the FROM clause</entry> + <entry></entry> + </row> + <row> + <entry>E051-09</entry> + <entry>Core</entry> + <entry>Rename columns in the FROM clause</entry> + <entry></entry> + </row> + <row> + <entry>E061</entry> + <entry>Core</entry> + <entry>Basic predicates and search conditions</entry> + <entry></entry> + </row> + <row> + <entry>E061-01</entry> + <entry>Core</entry> + <entry>Comparison predicate</entry> + <entry></entry> + </row> + <row> + <entry>E061-02</entry> + <entry>Core</entry> + <entry>BETWEEN predicate</entry> + <entry></entry> + </row> + <row> + <entry>E061-03</entry> + <entry>Core</entry> + <entry>IN predicate with list of values</entry> + <entry></entry> + </row> + <row> + <entry>E061-04</entry> + <entry>Core</entry> + <entry>LIKE predicate</entry> + <entry></entry> + </row> + <row> + <entry>E061-05</entry> + <entry>Core</entry> + <entry>LIKE predicate ESCAPE clause</entry> + <entry></entry> + </row> + <row> + <entry>E061-06</entry> + <entry>Core</entry> + <entry>NULL predicate</entry> + <entry></entry> + </row> + <row> + <entry>E061-07</entry> + <entry>Core</entry> + <entry>Quantified comparison predicate</entry> + <entry></entry> + </row> + <row> + <entry>E061-08</entry> + <entry>Core</entry> + <entry>EXISTS predicate</entry> + <entry></entry> + </row> + <row> + <entry>E061-09</entry> + <entry>Core</entry> + <entry>Subqueries in comparison predicate</entry> + <entry></entry> + </row> + <row> + <entry>E061-11</entry> + <entry>Core</entry> + <entry>Subqueries in IN predicate</entry> + <entry></entry> + </row> + <row> + <entry>E061-12</entry> + <entry>Core</entry> + <entry>Subqueries in quantified comparison predicate</entry> + <entry></entry> + </row> + <row> + <entry>E061-13</entry> + <entry>Core</entry> + <entry>Correlated subqueries</entry> + <entry></entry> + </row> + <row> + <entry>E061-14</entry> + <entry>Core</entry> + <entry>Search condition</entry> + <entry></entry> + </row> + <row> + <entry>E071</entry> + <entry>Core</entry> + <entry>Basic query expressions</entry> + <entry></entry> + </row> + <row> + <entry>E071-01</entry> + <entry>Core</entry> + <entry>UNION DISTINCT table operator</entry> + <entry></entry> + </row> + <row> + <entry>E071-02</entry> + <entry>Core</entry> + <entry>UNION ALL table operator</entry> + <entry></entry> + </row> + <row> + <entry>E071-03</entry> + <entry>Core</entry> + <entry>EXCEPT DISTINCT table operator</entry> + <entry></entry> + </row> + <row> + <entry>E071-05</entry> + <entry>Core</entry> + <entry>Columns combined via table operators need not have exactly the same data type</entry> + <entry></entry> + </row> + <row> + <entry>E071-06</entry> + <entry>Core</entry> + <entry>Table operators in subqueries</entry> + <entry></entry> + </row> + <row> + <entry>E081</entry> + <entry>Core</entry> + <entry>Basic Privileges</entry> + <entry></entry> + </row> + <row> + <entry>E081-01</entry> + <entry>Core</entry> + <entry>SELECT privilege</entry> + <entry></entry> + </row> + <row> + <entry>E081-02</entry> + <entry>Core</entry> + <entry>DELETE privilege</entry> + <entry></entry> + </row> + <row> + <entry>E081-03</entry> + <entry>Core</entry> + <entry>INSERT privilege at the table level</entry> + <entry></entry> + </row> + <row> + <entry>E081-04</entry> + <entry>Core</entry> + <entry>UPDATE privilege at the table level</entry> + <entry></entry> + </row> + <row> + <entry>E081-05</entry> + <entry>Core</entry> + <entry>UPDATE privilege at the column level</entry> + <entry></entry> + </row> + <row> + <entry>E081-06</entry> + <entry>Core</entry> + <entry>REFERENCES privilege at the table level</entry> + <entry></entry> + </row> + <row> + <entry>E081-07</entry> + <entry>Core</entry> + <entry>REFERENCES privilege at the column level</entry> + <entry></entry> + </row> + <row> + <entry>E081-08</entry> + <entry>Core</entry> + <entry>WITH GRANT OPTION</entry> + <entry></entry> + </row> + <row> + <entry>E081-09</entry> + <entry>Core</entry> + <entry>USAGE privilege</entry> + <entry></entry> + </row> + <row> + <entry>E081-10</entry> + <entry>Core</entry> + <entry>EXECUTE privilege</entry> + <entry></entry> + </row> + <row> + <entry>E091</entry> + <entry>Core</entry> + <entry>Set functions</entry> + <entry></entry> + </row> + <row> + <entry>E091-01</entry> + <entry>Core</entry> + <entry>AVG</entry> + <entry></entry> + </row> + <row> + <entry>E091-02</entry> + <entry>Core</entry> + <entry>COUNT</entry> + <entry></entry> + </row> + <row> + <entry>E091-03</entry> + <entry>Core</entry> + <entry>MAX</entry> + <entry></entry> + </row> + <row> + <entry>E091-04</entry> + <entry>Core</entry> + <entry>MIN</entry> + <entry></entry> + </row> + <row> + <entry>E091-05</entry> + <entry>Core</entry> + <entry>SUM</entry> + <entry></entry> + </row> + <row> + <entry>E091-06</entry> + <entry>Core</entry> + <entry>ALL quantifier</entry> + <entry></entry> + </row> + <row> + <entry>E091-07</entry> + <entry>Core</entry> + <entry>DISTINCT quantifier</entry> + <entry></entry> + </row> + <row> + <entry>E101</entry> + <entry>Core</entry> + <entry>Basic data manipulation</entry> + <entry></entry> + </row> + <row> + <entry>E101-01</entry> + <entry>Core</entry> + <entry>INSERT statement</entry> + <entry></entry> + </row> + <row> + <entry>E101-03</entry> + <entry>Core</entry> + <entry>Searched UPDATE statement</entry> + <entry></entry> + </row> + <row> + <entry>E101-04</entry> + <entry>Core</entry> + <entry>Searched DELETE statement</entry> + <entry></entry> + </row> + <row> + <entry>E111</entry> + <entry>Core</entry> + <entry>Single row SELECT statement</entry> + <entry></entry> + </row> + <row> + <entry>E121</entry> + <entry>Core</entry> + <entry>Basic cursor support</entry> + <entry></entry> + </row> + <row> + <entry>E121-01</entry> + <entry>Core</entry> + <entry>DECLARE CURSOR</entry> + <entry></entry> + </row> + <row> + <entry>E121-02</entry> + <entry>Core</entry> + <entry>ORDER BY columns need not be in select list</entry> + <entry></entry> + </row> + <row> + <entry>E121-03</entry> + <entry>Core</entry> + <entry>Value expressions in ORDER BY clause</entry> + <entry></entry> + </row> + <row> + <entry>E121-04</entry> + <entry>Core</entry> + <entry>OPEN statement</entry> + <entry></entry> + </row> + <row> + <entry>E121-06</entry> + <entry>Core</entry> + <entry>Positioned UPDATE statement</entry> + <entry></entry> + </row> + <row> + <entry>E121-07</entry> + <entry>Core</entry> + <entry>Positioned DELETE statement</entry> + <entry></entry> + </row> + <row> + <entry>E121-08</entry> + <entry>Core</entry> + <entry>CLOSE statement</entry> + <entry></entry> + </row> + <row> + <entry>E121-10</entry> + <entry>Core</entry> + <entry>FETCH statement implicit NEXT</entry> + <entry></entry> + </row> + <row> + <entry>E121-17</entry> + <entry>Core</entry> + <entry>WITH HOLD cursors</entry> + <entry></entry> + </row> + <row> + <entry>E131</entry> + <entry>Core</entry> + <entry>Null value support (nulls in lieu of values)</entry> + <entry></entry> + </row> + <row> + <entry>E141</entry> + <entry>Core</entry> + <entry>Basic integrity constraints</entry> + <entry></entry> + </row> + <row> + <entry>E141-01</entry> + <entry>Core</entry> + <entry>NOT NULL constraints</entry> + <entry></entry> + </row> + <row> + <entry>E141-02</entry> + <entry>Core</entry> + <entry>UNIQUE constraints of NOT NULL columns</entry> + <entry></entry> + </row> + <row> + <entry>E141-03</entry> + <entry>Core</entry> + <entry>PRIMARY KEY constraints</entry> + <entry></entry> + </row> + <row> + <entry>E141-04</entry> + <entry>Core</entry> + <entry>Basic FOREIGN KEY constraint with the NO ACTION default for both referential delete action and referential update action</entry> + <entry></entry> + </row> + <row> + <entry>E141-06</entry> + <entry>Core</entry> + <entry>CHECK constraints</entry> + <entry></entry> + </row> + <row> + <entry>E141-07</entry> + <entry>Core</entry> + <entry>Column defaults</entry> + <entry></entry> + </row> + <row> + <entry>E141-08</entry> + <entry>Core</entry> + <entry>NOT NULL inferred on PRIMARY KEY</entry> + <entry></entry> + </row> + <row> + <entry>E141-10</entry> + <entry>Core</entry> + <entry>Names in a foreign key can be specified in any order</entry> + <entry></entry> + </row> + <row> + <entry>E151</entry> + <entry>Core</entry> + <entry>Transaction support</entry> + <entry></entry> + </row> + <row> + <entry>E151-01</entry> + <entry>Core</entry> + <entry>COMMIT statement</entry> + <entry></entry> + </row> + <row> + <entry>E151-02</entry> + <entry>Core</entry> + <entry>ROLLBACK statement</entry> + <entry></entry> + </row> + <row> + <entry>E152</entry> + <entry>Core</entry> + <entry>Basic SET TRANSACTION statement</entry> + <entry></entry> + </row> + <row> + <entry>E152-01</entry> + <entry>Core</entry> + <entry>SET TRANSACTION statement: ISOLATION LEVEL SERIALIZABLE clause</entry> + <entry></entry> + </row> + <row> + <entry>E152-02</entry> + <entry>Core</entry> + <entry>SET TRANSACTION statement: READ ONLY and READ WRITE clauses</entry> + <entry></entry> + </row> + <row> + <entry>E153</entry> + <entry>Core</entry> + <entry>Updatable queries with subqueries</entry> + <entry></entry> + </row> + <row> + <entry>E161</entry> + <entry>Core</entry> + <entry>SQL comments using leading double minus</entry> + <entry></entry> + </row> + <row> + <entry>E171</entry> + <entry>Core</entry> + <entry>SQLSTATE support</entry> + <entry></entry> + </row> + <row> + <entry>F021</entry> + <entry>Core</entry> + <entry>Basic information schema</entry> + <entry></entry> + </row> + <row> + <entry>F021-01</entry> + <entry>Core</entry> + <entry>COLUMNS view</entry> + <entry></entry> + </row> + <row> + <entry>F021-02</entry> + <entry>Core</entry> + <entry>TABLES view</entry> + <entry></entry> + </row> + <row> + <entry>F021-03</entry> + <entry>Core</entry> + <entry>VIEWS view</entry> + <entry></entry> + </row> + <row> + <entry>F021-04</entry> + <entry>Core</entry> + <entry>TABLE_CONSTRAINTS view</entry> + <entry></entry> + </row> + <row> + <entry>F021-05</entry> + <entry>Core</entry> + <entry>REFERENTIAL_CONSTRAINTS view</entry> + <entry></entry> + </row> + <row> + <entry>F021-06</entry> + <entry>Core</entry> + <entry>CHECK_CONSTRAINTS view</entry> + <entry></entry> + </row> + <row> + <entry>F031</entry> + <entry>Core</entry> + <entry>Basic schema manipulation</entry> + <entry></entry> + </row> + <row> + <entry>F031-01</entry> + <entry>Core</entry> + <entry>CREATE TABLE statement to create persistent base tables</entry> + <entry></entry> + </row> + <row> + <entry>F031-02</entry> + <entry>Core</entry> + <entry>CREATE VIEW statement</entry> + <entry></entry> + </row> + <row> + <entry>F031-03</entry> + <entry>Core</entry> + <entry>GRANT statement</entry> + <entry></entry> + </row> + <row> + <entry>F031-04</entry> + <entry>Core</entry> + <entry>ALTER TABLE statement: ADD COLUMN clause</entry> + <entry></entry> + </row> + <row> + <entry>F031-13</entry> + <entry>Core</entry> + <entry>DROP TABLE statement: RESTRICT clause</entry> + <entry></entry> + </row> + <row> + <entry>F031-16</entry> + <entry>Core</entry> + <entry>DROP VIEW statement: RESTRICT clause</entry> + <entry></entry> + </row> + <row> + <entry>F031-19</entry> + <entry>Core</entry> + <entry>REVOKE statement: RESTRICT clause</entry> + <entry></entry> + </row> + <row> + <entry>F032</entry> + <entry></entry> + <entry>CASCADE drop behavior</entry> + <entry></entry> + </row> + <row> + <entry>F033</entry> + <entry></entry> + <entry>ALTER TABLE statement: DROP COLUMN clause</entry> + <entry></entry> + </row> + <row> + <entry>F034</entry> + <entry></entry> + <entry>Extended REVOKE statement</entry> + <entry></entry> + </row> + <row> + <entry>F034-01</entry> + <entry></entry> + <entry>REVOKE statement performed by other than the owner of a schema object</entry> + <entry></entry> + </row> + <row> + <entry>F034-02</entry> + <entry></entry> + <entry>REVOKE statement: GRANT OPTION FOR clause</entry> + <entry></entry> + </row> + <row> + <entry>F034-03</entry> + <entry></entry> + <entry>REVOKE statement to revoke a privilege that the grantee has WITH GRANT OPTION</entry> + <entry></entry> + </row> + <row> + <entry>F041</entry> + <entry>Core</entry> + <entry>Basic joined table</entry> + <entry></entry> + </row> + <row> + <entry>F041-01</entry> + <entry>Core</entry> + <entry>Inner join (but not necessarily the INNER keyword)</entry> + <entry></entry> + </row> + <row> + <entry>F041-02</entry> + <entry>Core</entry> + <entry>INNER keyword</entry> + <entry></entry> + </row> + <row> + <entry>F041-03</entry> + <entry>Core</entry> + <entry>LEFT OUTER JOIN</entry> + <entry></entry> + </row> + <row> + <entry>F041-04</entry> + <entry>Core</entry> + <entry>RIGHT OUTER JOIN</entry> + <entry></entry> + </row> + <row> + <entry>F041-05</entry> + <entry>Core</entry> + <entry>Outer joins can be nested</entry> + <entry></entry> + </row> + <row> + <entry>F041-07</entry> + <entry>Core</entry> + <entry>The inner table in a left or right outer join can also be used in an inner join</entry> + <entry></entry> + </row> + <row> + <entry>F041-08</entry> + <entry>Core</entry> + <entry>All comparison operators are supported (rather than just =)</entry> + <entry></entry> + </row> + <row> + <entry>F051</entry> + <entry>Core</entry> + <entry>Basic date and time</entry> + <entry></entry> + </row> + <row> + <entry>F051-01</entry> + <entry>Core</entry> + <entry>DATE data type (including support of DATE literal)</entry> + <entry></entry> + </row> + <row> + <entry>F051-02</entry> + <entry>Core</entry> + <entry>TIME data type (including support of TIME literal) with fractional seconds precision of at least 0</entry> + <entry></entry> + </row> + <row> + <entry>F051-03</entry> + <entry>Core</entry> + <entry>TIMESTAMP data type (including support of TIMESTAMP literal) with fractional seconds precision of at least 0 and 6</entry> + <entry></entry> + </row> + <row> + <entry>F051-04</entry> + <entry>Core</entry> + <entry>Comparison predicate on DATE, TIME, and TIMESTAMP data types</entry> + <entry></entry> + </row> + <row> + <entry>F051-05</entry> + <entry>Core</entry> + <entry>Explicit CAST between datetime types and character string types</entry> + <entry></entry> + </row> + <row> + <entry>F051-06</entry> + <entry>Core</entry> + <entry>CURRENT_DATE</entry> + <entry></entry> + </row> + <row> + <entry>F051-07</entry> + <entry>Core</entry> + <entry>LOCALTIME</entry> + <entry></entry> + </row> + <row> + <entry>F051-08</entry> + <entry>Core</entry> + <entry>LOCALTIMESTAMP</entry> + <entry></entry> + </row> + <row> + <entry>F052</entry> + <entry>Enhanced datetime facilities</entry> + <entry>Intervals and datetime arithmetic</entry> + <entry></entry> + </row> + <row> + <entry>F053</entry> + <entry></entry> + <entry>OVERLAPS predicate</entry> + <entry></entry> + </row> + <row> + <entry>F081</entry> + <entry>Core</entry> + <entry>UNION and EXCEPT in views</entry> + <entry></entry> + </row> + <row> + <entry>F111</entry> + <entry></entry> + <entry>Isolation levels other than SERIALIZABLE</entry> + <entry></entry> + </row> + <row> + <entry>F111-01</entry> + <entry></entry> + <entry>READ UNCOMMITTED isolation level</entry> + <entry></entry> + </row> + <row> + <entry>F111-02</entry> + <entry></entry> + <entry>READ COMMITTED isolation level</entry> + <entry></entry> + </row> + <row> + <entry>F111-03</entry> + <entry></entry> + <entry>REPEATABLE READ isolation level</entry> + <entry></entry> + </row> + <row> + <entry>F131</entry> + <entry>Core</entry> + <entry>Grouped operations</entry> + <entry></entry> + </row> + <row> + <entry>F131-01</entry> + <entry>Core</entry> + <entry>WHERE, GROUP BY, and HAVING clauses supported in queries with grouped views</entry> + <entry></entry> + </row> + <row> + <entry>F131-02</entry> + <entry>Core</entry> + <entry>Multiple tables supported in queries with grouped views</entry> + <entry></entry> + </row> + <row> + <entry>F131-03</entry> + <entry>Core</entry> + <entry>Set functions supported in queries with grouped views</entry> + <entry></entry> + </row> + <row> + <entry>F131-04</entry> + <entry>Core</entry> + <entry>Subqueries with GROUP BY and HAVING clauses and grouped views</entry> + <entry></entry> + </row> + <row> + <entry>F131-05</entry> + <entry>Core</entry> + <entry>Single row SELECT with GROUP BY and HAVING clauses and grouped views</entry> + <entry></entry> + </row> + <row> + <entry>F171</entry> + <entry></entry> + <entry>Multiple schemas per user</entry> + <entry></entry> + </row> + <row> + <entry>F191</entry> + <entry>Enhanced integrity management</entry> + <entry>Referential delete actions</entry> + <entry></entry> + </row> + <row> + <entry>F200</entry> + <entry></entry> + <entry>TRUNCATE TABLE statement</entry> + <entry></entry> + </row> + <row> + <entry>F201</entry> + <entry>Core</entry> + <entry>CAST function</entry> + <entry></entry> + </row> + <row> + <entry>F221</entry> + <entry>Core</entry> + <entry>Explicit defaults</entry> + <entry></entry> + </row> + <row> + <entry>F222</entry> + <entry></entry> + <entry>INSERT statement: DEFAULT VALUES clause</entry> + <entry></entry> + </row> + <row> + <entry>F231</entry> + <entry></entry> + <entry>Privilege tables</entry> + <entry></entry> + </row> + <row> + <entry>F231-01</entry> + <entry></entry> + <entry>TABLE_PRIVILEGES view</entry> + <entry></entry> + </row> + <row> + <entry>F231-02</entry> + <entry></entry> + <entry>COLUMN_PRIVILEGES view</entry> + <entry></entry> + </row> + <row> + <entry>F231-03</entry> + <entry></entry> + <entry>USAGE_PRIVILEGES view</entry> + <entry></entry> + </row> + <row> + <entry>F251</entry> + <entry></entry> + <entry>Domain support</entry> + <entry></entry> + </row> + <row> + <entry>F261</entry> + <entry>Core</entry> + <entry>CASE expression</entry> + <entry></entry> + </row> + <row> + <entry>F261-01</entry> + <entry>Core</entry> + <entry>Simple CASE</entry> + <entry></entry> + </row> + <row> + <entry>F261-02</entry> + <entry>Core</entry> + <entry>Searched CASE</entry> + <entry></entry> + </row> + <row> + <entry>F261-03</entry> + <entry>Core</entry> + <entry>NULLIF</entry> + <entry></entry> + </row> + <row> + <entry>F261-04</entry> + <entry>Core</entry> + <entry>COALESCE</entry> + <entry></entry> + </row> + <row> + <entry>F262</entry> + <entry></entry> + <entry>Extended CASE expression</entry> + <entry></entry> + </row> + <row> + <entry>F271</entry> + <entry></entry> + <entry>Compound character literals</entry> + <entry></entry> + </row> + <row> + <entry>F281</entry> + <entry></entry> + <entry>LIKE enhancements</entry> + <entry></entry> + </row> + <row> + <entry>F302</entry> + <entry></entry> + <entry>INTERSECT table operator</entry> + <entry></entry> + </row> + <row> + <entry>F302-01</entry> + <entry></entry> + <entry>INTERSECT DISTINCT table operator</entry> + <entry></entry> + </row> + <row> + <entry>F302-02</entry> + <entry></entry> + <entry>INTERSECT ALL table operator</entry> + <entry></entry> + </row> + <row> + <entry>F304</entry> + <entry></entry> + <entry>EXCEPT ALL table operator</entry> + <entry></entry> + </row> + <row> + <entry>F311-01</entry> + <entry>Core</entry> + <entry>CREATE SCHEMA</entry> + <entry></entry> + </row> + <row> + <entry>F311-02</entry> + <entry>Core</entry> + <entry>CREATE TABLE for persistent base tables</entry> + <entry></entry> + </row> + <row> + <entry>F311-03</entry> + <entry>Core</entry> + <entry>CREATE VIEW</entry> + <entry></entry> + </row> + <row> + <entry>F311-04</entry> + <entry>Core</entry> + <entry>CREATE VIEW: WITH CHECK OPTION</entry> + <entry></entry> + </row> + <row> + <entry>F311-05</entry> + <entry>Core</entry> + <entry>GRANT statement</entry> + <entry></entry> + </row> + <row> + <entry>F321</entry> + <entry></entry> + <entry>User authorization</entry> + <entry></entry> + </row> + <row> + <entry>F361</entry> + <entry></entry> + <entry>Subprogram support</entry> + <entry></entry> + </row> + <row> + <entry>F381</entry> + <entry></entry> + <entry>Extended schema manipulation</entry> + <entry></entry> + </row> + <row> + <entry>F381-01</entry> + <entry></entry> + <entry>ALTER TABLE statement: ALTER COLUMN clause</entry> + <entry></entry> + </row> + <row> + <entry>F381-02</entry> + <entry></entry> + <entry>ALTER TABLE statement: ADD CONSTRAINT clause</entry> + <entry></entry> + </row> + <row> + <entry>F381-03</entry> + <entry></entry> + <entry>ALTER TABLE statement: DROP CONSTRAINT clause</entry> + <entry></entry> + </row> + <row> + <entry>F382</entry> + <entry></entry> + <entry>Alter column data type</entry> + <entry></entry> + </row> + <row> + <entry>F383</entry> + <entry></entry> + <entry>Set column not null clause</entry> + <entry></entry> + </row> + <row> + <entry>F391</entry> + <entry></entry> + <entry>Long identifiers</entry> + <entry></entry> + </row> + <row> + <entry>F392</entry> + <entry></entry> + <entry>Unicode escapes in identifiers</entry> + <entry></entry> + </row> + <row> + <entry>F393</entry> + <entry></entry> + <entry>Unicode escapes in literals</entry> + <entry></entry> + </row> + <row> + <entry>F401</entry> + <entry></entry> + <entry>Extended joined table</entry> + <entry></entry> + </row> + <row> + <entry>F401-01</entry> + <entry></entry> + <entry>NATURAL JOIN</entry> + <entry></entry> + </row> + <row> + <entry>F401-02</entry> + <entry></entry> + <entry>FULL OUTER JOIN</entry> + <entry></entry> + </row> + <row> + <entry>F401-04</entry> + <entry></entry> + <entry>CROSS JOIN</entry> + <entry></entry> + </row> + <row> + <entry>F402</entry> + <entry></entry> + <entry>Named column joins for LOBs, arrays, and multisets</entry> + <entry></entry> + </row> + <row> + <entry>F411</entry> + <entry>Enhanced datetime facilities</entry> + <entry>Time zone specification</entry> + <entry>differences regarding literal interpretation</entry> + </row> + <row> + <entry>F421</entry> + <entry></entry> + <entry>National character</entry> + <entry></entry> + </row> + <row> + <entry>F431</entry> + <entry></entry> + <entry>Read-only scrollable cursors</entry> + <entry></entry> + </row> + <row> + <entry>F431-01</entry> + <entry></entry> + <entry>FETCH with explicit NEXT</entry> + <entry></entry> + </row> + <row> + <entry>F431-02</entry> + <entry></entry> + <entry>FETCH FIRST</entry> + <entry></entry> + </row> + <row> + <entry>F431-03</entry> + <entry></entry> + <entry>FETCH LAST</entry> + <entry></entry> + </row> + <row> + <entry>F431-04</entry> + <entry></entry> + <entry>FETCH PRIOR</entry> + <entry></entry> + </row> + <row> + <entry>F431-05</entry> + <entry></entry> + <entry>FETCH ABSOLUTE</entry> + <entry></entry> + </row> + <row> + <entry>F431-06</entry> + <entry></entry> + <entry>FETCH RELATIVE</entry> + <entry></entry> + </row> + <row> + <entry>F441</entry> + <entry></entry> + <entry>Extended set function support</entry> + <entry></entry> + </row> + <row> + <entry>F442</entry> + <entry></entry> + <entry>Mixed column references in set functions</entry> + <entry></entry> + </row> + <row> + <entry>F471</entry> + <entry>Core</entry> + <entry>Scalar subquery values</entry> + <entry></entry> + </row> + <row> + <entry>F481</entry> + <entry>Core</entry> + <entry>Expanded NULL predicate</entry> + <entry></entry> + </row> + <row> + <entry>F491</entry> + <entry>Enhanced integrity management</entry> + <entry>Constraint management</entry> + <entry></entry> + </row> + <row> + <entry>F501</entry> + <entry>Core</entry> + <entry>Features and conformance views</entry> + <entry></entry> + </row> + <row> + <entry>F501-01</entry> + <entry>Core</entry> + <entry>SQL_FEATURES view</entry> + <entry></entry> + </row> + <row> + <entry>F501-02</entry> + <entry>Core</entry> + <entry>SQL_SIZING view</entry> + <entry></entry> + </row> + <row> + <entry>F501-03</entry> + <entry>Core</entry> + <entry>SQL_LANGUAGES view</entry> + <entry></entry> + </row> + <row> + <entry>F502</entry> + <entry></entry> + <entry>Enhanced documentation tables</entry> + <entry></entry> + </row> + <row> + <entry>F502-01</entry> + <entry></entry> + <entry>SQL_SIZING_PROFILES view</entry> + <entry></entry> + </row> + <row> + <entry>F502-02</entry> + <entry></entry> + <entry>SQL_IMPLEMENTATION_INFO view</entry> + <entry></entry> + </row> + <row> + <entry>F502-03</entry> + <entry></entry> + <entry>SQL_PACKAGES view</entry> + <entry></entry> + </row> + <row> + <entry>F531</entry> + <entry></entry> + <entry>Temporary tables</entry> + <entry></entry> + </row> + <row> + <entry>F555</entry> + <entry>Enhanced datetime facilities</entry> + <entry>Enhanced seconds precision</entry> + <entry></entry> + </row> + <row> + <entry>F561</entry> + <entry></entry> + <entry>Full value expressions</entry> + <entry></entry> + </row> + <row> + <entry>F571</entry> + <entry></entry> + <entry>Truth value tests</entry> + <entry></entry> + </row> + <row> + <entry>F591</entry> + <entry></entry> + <entry>Derived tables</entry> + <entry></entry> + </row> + <row> + <entry>F611</entry> + <entry></entry> + <entry>Indicator data types</entry> + <entry></entry> + </row> + <row> + <entry>F641</entry> + <entry></entry> + <entry>Row and table constructors</entry> + <entry></entry> + </row> + <row> + <entry>F651</entry> + <entry></entry> + <entry>Catalog name qualifiers</entry> + <entry></entry> + </row> + <row> + <entry>F661</entry> + <entry></entry> + <entry>Simple tables</entry> + <entry></entry> + </row> + <row> + <entry>F672</entry> + <entry></entry> + <entry>Retrospective check constraints</entry> + <entry></entry> + </row> + <row> + <entry>F690</entry> + <entry></entry> + <entry>Collation support</entry> + <entry>but no character set support</entry> + </row> + <row> + <entry>F692</entry> + <entry></entry> + <entry>Extended collation support</entry> + <entry></entry> + </row> + <row> + <entry>F701</entry> + <entry>Enhanced integrity management</entry> + <entry>Referential update actions</entry> + <entry></entry> + </row> + <row> + <entry>F711</entry> + <entry></entry> + <entry>ALTER domain</entry> + <entry></entry> + </row> + <row> + <entry>F731</entry> + <entry></entry> + <entry>INSERT column privileges</entry> + <entry></entry> + </row> + <row> + <entry>F751</entry> + <entry></entry> + <entry>View CHECK enhancements</entry> + <entry></entry> + </row> + <row> + <entry>F761</entry> + <entry></entry> + <entry>Session management</entry> + <entry></entry> + </row> + <row> + <entry>F762</entry> + <entry></entry> + <entry>CURRENT_CATALOG</entry> + <entry></entry> + </row> + <row> + <entry>F763</entry> + <entry></entry> + <entry>CURRENT_SCHEMA</entry> + <entry></entry> + </row> + <row> + <entry>F771</entry> + <entry></entry> + <entry>Connection management</entry> + <entry></entry> + </row> + <row> + <entry>F781</entry> + <entry></entry> + <entry>Self-referencing operations</entry> + <entry></entry> + </row> + <row> + <entry>F791</entry> + <entry></entry> + <entry>Insensitive cursors</entry> + <entry></entry> + </row> + <row> + <entry>F801</entry> + <entry></entry> + <entry>Full set function</entry> + <entry></entry> + </row> + <row> + <entry>F850</entry> + <entry></entry> + <entry>Top-level &lt;order by clause&gt; in &lt;query expression&gt;</entry> + <entry></entry> + </row> + <row> + <entry>F851</entry> + <entry></entry> + <entry>&lt;order by clause&gt; in subqueries</entry> + <entry></entry> + </row> + <row> + <entry>F852</entry> + <entry></entry> + <entry>Top-level &lt;order by clause&gt; in views</entry> + <entry></entry> + </row> + <row> + <entry>F855</entry> + <entry></entry> + <entry>Nested &lt;order by clause&gt; in &lt;query expression&gt;</entry> + <entry></entry> + </row> + <row> + <entry>F856</entry> + <entry></entry> + <entry>Nested &lt;fetch first clause&gt; in &lt;query expression&gt;</entry> + <entry></entry> + </row> + <row> + <entry>F857</entry> + <entry></entry> + <entry>Top-level &lt;fetch first clause&gt; in &lt;query expression&gt;</entry> + <entry></entry> + </row> + <row> + <entry>F858</entry> + <entry></entry> + <entry>&lt;fetch first clause&gt; in subqueries</entry> + <entry></entry> + </row> + <row> + <entry>F859</entry> + <entry></entry> + <entry>Top-level &lt;fetch first clause&gt; in views</entry> + <entry></entry> + </row> + <row> + <entry>F860</entry> + <entry></entry> + <entry>&lt;fetch first row count&gt; in &lt;fetch first clause&gt;</entry> + <entry></entry> + </row> + <row> + <entry>F861</entry> + <entry></entry> + <entry>Top-level &lt;result offset clause&gt; in &lt;query expression&gt;</entry> + <entry></entry> + </row> + <row> + <entry>F862</entry> + <entry></entry> + <entry>&lt;result offset clause&gt; in subqueries</entry> + <entry></entry> + </row> + <row> + <entry>F863</entry> + <entry></entry> + <entry>Nested &lt;result offset clause&gt; in &lt;query expression&gt;</entry> + <entry></entry> + </row> + <row> + <entry>F864</entry> + <entry></entry> + <entry>Top-level &lt;result offset clause&gt; in views</entry> + <entry></entry> + </row> + <row> + <entry>F865</entry> + <entry></entry> + <entry>&lt;offset row count&gt; in &lt;result offset clause&gt;</entry> + <entry></entry> + </row> + <row> + <entry>S071</entry> + <entry>Enhanced object support</entry> + <entry>SQL paths in function and type name resolution</entry> + <entry></entry> + </row> + <row> + <entry>S092</entry> + <entry></entry> + <entry>Arrays of user-defined types</entry> + <entry></entry> + </row> + <row> + <entry>S095</entry> + <entry></entry> + <entry>Array constructors by query</entry> + <entry></entry> + </row> + <row> + <entry>S096</entry> + <entry></entry> + <entry>Optional array bounds</entry> + <entry></entry> + </row> + <row> + <entry>S098</entry> + <entry></entry> + <entry>ARRAY_AGG</entry> + <entry></entry> + </row> + <row> + <entry>S111</entry> + <entry>Enhanced object support</entry> + <entry>ONLY in query expressions</entry> + <entry></entry> + </row> + <row> + <entry>S201</entry> + <entry></entry> + <entry>SQL-invoked routines on arrays</entry> + <entry></entry> + </row> + <row> + <entry>S201-01</entry> + <entry></entry> + <entry>Array parameters</entry> + <entry></entry> + </row> + <row> + <entry>S201-02</entry> + <entry></entry> + <entry>Array as result type of functions</entry> + <entry></entry> + </row> + <row> + <entry>S211</entry> + <entry>Enhanced object support</entry> + <entry>User-defined cast functions</entry> + <entry></entry> + </row> + <row> + <entry>T031</entry> + <entry></entry> + <entry>BOOLEAN data type</entry> + <entry></entry> + </row> + <row> + <entry>T071</entry> + <entry></entry> + <entry>BIGINT data type</entry> + <entry></entry> + </row> + <row> + <entry>T121</entry> + <entry></entry> + <entry>WITH (excluding RECURSIVE) in query expression</entry> + <entry></entry> + </row> + <row> + <entry>T122</entry> + <entry></entry> + <entry>WITH (excluding RECURSIVE) in subquery</entry> + <entry></entry> + </row> + <row> + <entry>T131</entry> + <entry></entry> + <entry>Recursive query</entry> + <entry></entry> + </row> + <row> + <entry>T132</entry> + <entry></entry> + <entry>Recursive query in subquery</entry> + <entry></entry> + </row> + <row> + <entry>T141</entry> + <entry></entry> + <entry>SIMILAR predicate</entry> + <entry></entry> + </row> + <row> + <entry>T151</entry> + <entry></entry> + <entry>DISTINCT predicate</entry> + <entry></entry> + </row> + <row> + <entry>T152</entry> + <entry></entry> + <entry>DISTINCT predicate with negation</entry> + <entry></entry> + </row> + <row> + <entry>T171</entry> + <entry></entry> + <entry>LIKE clause in table definition</entry> + <entry></entry> + </row> + <row> + <entry>T172</entry> + <entry></entry> + <entry>AS subquery clause in table definition</entry> + <entry></entry> + </row> + <row> + <entry>T173</entry> + <entry></entry> + <entry>Extended LIKE clause in table definition</entry> + <entry></entry> + </row> + <row> + <entry>T191</entry> + <entry>Enhanced integrity management</entry> + <entry>Referential action RESTRICT</entry> + <entry></entry> + </row> + <row> + <entry>T201</entry> + <entry>Enhanced integrity management</entry> + <entry>Comparable data types for referential constraints</entry> + <entry></entry> + </row> + <row> + <entry>T211-01</entry> + <entry>Active database, Enhanced integrity management</entry> + <entry>Triggers activated on UPDATE, INSERT, or DELETE of one base table</entry> + <entry></entry> + </row> + <row> + <entry>T211-02</entry> + <entry>Active database, Enhanced integrity management</entry> + <entry>BEFORE triggers</entry> + <entry></entry> + </row> + <row> + <entry>T211-03</entry> + <entry>Active database, Enhanced integrity management</entry> + <entry>AFTER triggers</entry> + <entry></entry> + </row> + <row> + <entry>T211-04</entry> + <entry>Active database, Enhanced integrity management</entry> + <entry>FOR EACH ROW triggers</entry> + <entry></entry> + </row> + <row> + <entry>T211-05</entry> + <entry>Active database, Enhanced integrity management</entry> + <entry>Ability to specify a search condition that must be true before the trigger is invoked</entry> + <entry></entry> + </row> + <row> + <entry>T211-07</entry> + <entry>Active database, Enhanced integrity management</entry> + <entry>TRIGGER privilege</entry> + <entry></entry> + </row> + <row> + <entry>T212</entry> + <entry>Enhanced integrity management</entry> + <entry>Enhanced trigger capability</entry> + <entry></entry> + </row> + <row> + <entry>T213</entry> + <entry></entry> + <entry>INSTEAD OF triggers</entry> + <entry></entry> + </row> + <row> + <entry>T231</entry> + <entry></entry> + <entry>Sensitive cursors</entry> + <entry></entry> + </row> + <row> + <entry>T241</entry> + <entry></entry> + <entry>START TRANSACTION statement</entry> + <entry></entry> + </row> + <row> + <entry>T271</entry> + <entry></entry> + <entry>Savepoints</entry> + <entry></entry> + </row> + <row> + <entry>T281</entry> + <entry></entry> + <entry>SELECT privilege with column granularity</entry> + <entry></entry> + </row> + <row> + <entry>T312</entry> + <entry></entry> + <entry>OVERLAY function</entry> + <entry></entry> + </row> + <row> + <entry>T321-01</entry> + <entry>Core</entry> + <entry>User-defined functions with no overloading</entry> + <entry></entry> + </row> + <row> + <entry>T321-03</entry> + <entry>Core</entry> + <entry>Function invocation</entry> + <entry></entry> + </row> + <row> + <entry>T321-06</entry> + <entry>Core</entry> + <entry>ROUTINES view</entry> + <entry></entry> + </row> + <row> + <entry>T321-07</entry> + <entry>Core</entry> + <entry>PARAMETERS view</entry> + <entry></entry> + </row> + <row> + <entry>T323</entry> + <entry></entry> + <entry>Explicit security for external routines</entry> + <entry></entry> + </row> + <row> + <entry>T325</entry> + <entry></entry> + <entry>Qualified SQL parameter references</entry> + <entry></entry> + </row> + <row> + <entry>T331</entry> + <entry></entry> + <entry>Basic roles</entry> + <entry></entry> + </row> + <row> + <entry>T341</entry> + <entry></entry> + <entry>Overloading of SQL-invoked functions and procedures</entry> + <entry></entry> + </row> + <row> + <entry>T351</entry> + <entry></entry> + <entry>Bracketed SQL comments (/*...*/ comments)</entry> + <entry></entry> + </row> + <row> + <entry>T441</entry> + <entry></entry> + <entry>ABS and MOD functions</entry> + <entry></entry> + </row> + <row> + <entry>T461</entry> + <entry></entry> + <entry>Symmetric BETWEEN predicate</entry> + <entry></entry> + </row> + <row> + <entry>T491</entry> + <entry></entry> + <entry>LATERAL derived table</entry> + <entry></entry> + </row> + <row> + <entry>T501</entry> + <entry></entry> + <entry>Enhanced EXISTS predicate</entry> + <entry></entry> + </row> + <row> + <entry>T551</entry> + <entry></entry> + <entry>Optional key words for default syntax</entry> + <entry></entry> + </row> + <row> + <entry>T581</entry> + <entry></entry> + <entry>Regular expression substring function</entry> + <entry></entry> + </row> + <row> + <entry>T591</entry> + <entry></entry> + <entry>UNIQUE constraints of possibly null columns</entry> + <entry></entry> + </row> + <row> + <entry>T614</entry> + <entry></entry> + <entry>NTILE function</entry> + <entry></entry> + </row> + <row> + <entry>T615</entry> + <entry></entry> + <entry>LEAD and LAG functions</entry> + <entry></entry> + </row> + <row> + <entry>T617</entry> + <entry></entry> + <entry>FIRST_VALUE and LAST_VALUE function</entry> + <entry></entry> + </row> + <row> + <entry>T621</entry> + <entry></entry> + <entry>Enhanced numeric functions</entry> + <entry></entry> + </row> + <row> + <entry>T631</entry> + <entry>Core</entry> + <entry>IN predicate with one list element</entry> + <entry></entry> + </row> + <row> + <entry>T651</entry> + <entry></entry> + <entry>SQL-schema statements in SQL routines</entry> + <entry></entry> + </row> + <row> + <entry>T655</entry> + <entry></entry> + <entry>Cyclically dependent routines</entry> + <entry></entry> + </row> + <row> + <entry>X010</entry> + <entry></entry> + <entry>XML type</entry> + <entry></entry> + </row> + <row> + <entry>X011</entry> + <entry></entry> + <entry>Arrays of XML type</entry> + <entry></entry> + </row> + <row> + <entry>X016</entry> + <entry></entry> + <entry>Persistent XML values</entry> + <entry></entry> + </row> + <row> + <entry>X020</entry> + <entry></entry> + <entry>XMLConcat</entry> + <entry></entry> + </row> + <row> + <entry>X031</entry> + <entry></entry> + <entry>XMLElement</entry> + <entry></entry> + </row> + <row> + <entry>X032</entry> + <entry></entry> + <entry>XMLForest</entry> + <entry></entry> + </row> + <row> + <entry>X034</entry> + <entry></entry> + <entry>XMLAgg</entry> + <entry></entry> + </row> + <row> + <entry>X035</entry> + <entry></entry> + <entry>XMLAgg: ORDER BY option</entry> + <entry></entry> + </row> + <row> + <entry>X036</entry> + <entry></entry> + <entry>XMLComment</entry> + <entry></entry> + </row> + <row> + <entry>X037</entry> + <entry></entry> + <entry>XMLPI</entry> + <entry></entry> + </row> + <row> + <entry>X040</entry> + <entry></entry> + <entry>Basic table mapping</entry> + <entry></entry> + </row> + <row> + <entry>X041</entry> + <entry></entry> + <entry>Basic table mapping: nulls absent</entry> + <entry></entry> + </row> + <row> + <entry>X042</entry> + <entry></entry> + <entry>Basic table mapping: null as nil</entry> + <entry></entry> + </row> + <row> + <entry>X043</entry> + <entry></entry> + <entry>Basic table mapping: table as forest</entry> + <entry></entry> + </row> + <row> + <entry>X044</entry> + <entry></entry> + <entry>Basic table mapping: table as element</entry> + <entry></entry> + </row> + <row> + <entry>X045</entry> + <entry></entry> + <entry>Basic table mapping: with target namespace</entry> + <entry></entry> + </row> + <row> + <entry>X046</entry> + <entry></entry> + <entry>Basic table mapping: data mapping</entry> + <entry></entry> + </row> + <row> + <entry>X047</entry> + <entry></entry> + <entry>Basic table mapping: metadata mapping</entry> + <entry></entry> + </row> + <row> + <entry>X048</entry> + <entry></entry> + <entry>Basic table mapping: base64 encoding of binary strings</entry> + <entry></entry> + </row> + <row> + <entry>X049</entry> + <entry></entry> + <entry>Basic table mapping: hex encoding of binary strings</entry> + <entry></entry> + </row> + <row> + <entry>X050</entry> + <entry></entry> + <entry>Advanced table mapping</entry> + <entry></entry> + </row> + <row> + <entry>X051</entry> + <entry></entry> + <entry>Advanced table mapping: nulls absent</entry> + <entry></entry> + </row> + <row> + <entry>X052</entry> + <entry></entry> + <entry>Advanced table mapping: null as nil</entry> + <entry></entry> + </row> + <row> + <entry>X053</entry> + <entry></entry> + <entry>Advanced table mapping: table as forest</entry> + <entry></entry> + </row> + <row> + <entry>X054</entry> + <entry></entry> + <entry>Advanced table mapping: table as element</entry> + <entry></entry> + </row> + <row> + <entry>X055</entry> + <entry></entry> + <entry>Advanced table mapping: target namespace</entry> + <entry></entry> + </row> + <row> + <entry>X056</entry> + <entry></entry> + <entry>Advanced table mapping: data mapping</entry> + <entry></entry> + </row> + <row> + <entry>X057</entry> + <entry></entry> + <entry>Advanced table mapping: metadata mapping</entry> + <entry></entry> + </row> + <row> + <entry>X058</entry> + <entry></entry> + <entry>Advanced table mapping: base64 encoding of binary strings</entry> + <entry></entry> + </row> + <row> + <entry>X059</entry> + <entry></entry> + <entry>Advanced table mapping: hex encoding of binary strings</entry> + <entry></entry> + </row> + <row> + <entry>X060</entry> + <entry></entry> + <entry>XMLParse: Character string input and CONTENT option</entry> + <entry></entry> + </row> + <row> + <entry>X061</entry> + <entry></entry> + <entry>XMLParse: Character string input and DOCUMENT option</entry> + <entry></entry> + </row> + <row> + <entry>X070</entry> + <entry></entry> + <entry>XMLSerialize: Character string serialization and CONTENT option</entry> + <entry></entry> + </row> + <row> + <entry>X071</entry> + <entry></entry> + <entry>XMLSerialize: Character string serialization and DOCUMENT option</entry> + <entry></entry> + </row> + <row> + <entry>X072</entry> + <entry></entry> + <entry>XMLSerialize: Character string serialization</entry> + <entry></entry> + </row> + <row> + <entry>X090</entry> + <entry></entry> + <entry>XML document predicate</entry> + <entry></entry> + </row> + <row> + <entry>X120</entry> + <entry></entry> + <entry>XML parameters in SQL routines</entry> + <entry></entry> + </row> + <row> + <entry>X121</entry> + <entry></entry> + <entry>XML parameters in external routines</entry> + <entry></entry> + </row> + <row> + <entry>X400</entry> + <entry></entry> + <entry>Name and identifier mapping</entry> + <entry></entry> + </row> + <row> + <entry>X410</entry> + <entry></entry> + <entry>Alter column data type: XML type</entry> + <entry></entry> + </row> +</tbody> diff --git a/doc/src/sgml/features-unsupported.sgml b/doc/src/sgml/features-unsupported.sgml new file mode 100644 index 000000000..4d42fbbff --- /dev/null +++ b/doc/src/sgml/features-unsupported.sgml @@ -0,0 +1,1862 @@ +<tbody> + <row> + <entry>B011</entry> + <entry></entry> + <entry>Embedded Ada</entry> + <entry></entry> + </row> + <row> + <entry>B013</entry> + <entry></entry> + <entry>Embedded COBOL</entry> + <entry></entry> + </row> + <row> + <entry>B014</entry> + <entry></entry> + <entry>Embedded Fortran</entry> + <entry></entry> + </row> + <row> + <entry>B015</entry> + <entry></entry> + <entry>Embedded MUMPS</entry> + <entry></entry> + </row> + <row> + <entry>B016</entry> + <entry></entry> + <entry>Embedded Pascal</entry> + <entry></entry> + </row> + <row> + <entry>B017</entry> + <entry></entry> + <entry>Embedded PL/I</entry> + <entry></entry> + </row> + <row> + <entry>B031</entry> + <entry></entry> + <entry>Basic dynamic SQL</entry> + <entry></entry> + </row> + <row> + <entry>B032</entry> + <entry></entry> + <entry>Extended dynamic SQL</entry> + <entry></entry> + </row> + <row> + <entry>B032-01</entry> + <entry></entry> + <entry>&lt;describe input statement&gt;</entry> + <entry></entry> + </row> + <row> + <entry>B033</entry> + <entry></entry> + <entry>Untyped SQL-invoked function arguments</entry> + <entry></entry> + </row> + <row> + <entry>B034</entry> + <entry></entry> + <entry>Dynamic specification of cursor attributes</entry> + <entry></entry> + </row> + <row> + <entry>B035</entry> + <entry></entry> + <entry>Non-extended descriptor names</entry> + <entry></entry> + </row> + <row> + <entry>B041</entry> + <entry></entry> + <entry>Extensions to embedded SQL exception declarations</entry> + <entry></entry> + </row> + <row> + <entry>B051</entry> + <entry></entry> + <entry>Enhanced execution rights</entry> + <entry></entry> + </row> + <row> + <entry>B111</entry> + <entry></entry> + <entry>Module language Ada</entry> + <entry></entry> + </row> + <row> + <entry>B112</entry> + <entry></entry> + <entry>Module language C</entry> + <entry></entry> + </row> + <row> + <entry>B113</entry> + <entry></entry> + <entry>Module language COBOL</entry> + <entry></entry> + </row> + <row> + <entry>B114</entry> + <entry></entry> + <entry>Module language Fortran</entry> + <entry></entry> + </row> + <row> + <entry>B115</entry> + <entry></entry> + <entry>Module language MUMPS</entry> + <entry></entry> + </row> + <row> + <entry>B116</entry> + <entry></entry> + <entry>Module language Pascal</entry> + <entry></entry> + </row> + <row> + <entry>B117</entry> + <entry></entry> + <entry>Module language PL/I</entry> + <entry></entry> + </row> + <row> + <entry>B121</entry> + <entry></entry> + <entry>Routine language Ada</entry> + <entry></entry> + </row> + <row> + <entry>B122</entry> + <entry></entry> + <entry>Routine language C</entry> + <entry></entry> + </row> + <row> + <entry>B123</entry> + <entry></entry> + <entry>Routine language COBOL</entry> + <entry></entry> + </row> + <row> + <entry>B124</entry> + <entry></entry> + <entry>Routine language Fortran</entry> + <entry></entry> + </row> + <row> + <entry>B125</entry> + <entry></entry> + <entry>Routine language MUMPS</entry> + <entry></entry> + </row> + <row> + <entry>B126</entry> + <entry></entry> + <entry>Routine language Pascal</entry> + <entry></entry> + </row> + <row> + <entry>B127</entry> + <entry></entry> + <entry>Routine language PL/I</entry> + <entry></entry> + </row> + <row> + <entry>B128</entry> + <entry></entry> + <entry>Routine language SQL</entry> + <entry></entry> + </row> + <row> + <entry>B211</entry> + <entry></entry> + <entry>Module language Ada: VARCHAR and NUMERIC support</entry> + <entry></entry> + </row> + <row> + <entry>B221</entry> + <entry></entry> + <entry>Routine language Ada: VARCHAR and NUMERIC support</entry> + <entry></entry> + </row> + <row> + <entry>E182</entry> + <entry>Core</entry> + <entry>Module language</entry> + <entry></entry> + </row> + <row> + <entry>F054</entry> + <entry></entry> + <entry>TIMESTAMP in DATE type precedence list</entry> + <entry></entry> + </row> + <row> + <entry>F121</entry> + <entry></entry> + <entry>Basic diagnostics management</entry> + <entry></entry> + </row> + <row> + <entry>F121-01</entry> + <entry></entry> + <entry>GET DIAGNOSTICS statement</entry> + <entry></entry> + </row> + <row> + <entry>F121-02</entry> + <entry></entry> + <entry>SET TRANSACTION statement: DIAGNOSTICS SIZE clause</entry> + <entry></entry> + </row> + <row> + <entry>F122</entry> + <entry></entry> + <entry>Enhanced diagnostics management</entry> + <entry></entry> + </row> + <row> + <entry>F123</entry> + <entry></entry> + <entry>All diagnostics</entry> + <entry></entry> + </row> + <row> + <entry>F181</entry> + <entry>Core</entry> + <entry>Multiple module support</entry> + <entry></entry> + </row> + <row> + <entry>F202</entry> + <entry></entry> + <entry>TRUNCATE TABLE: identity column restart option</entry> + <entry></entry> + </row> + <row> + <entry>F263</entry> + <entry></entry> + <entry>Comma-separated predicates in simple CASE expression</entry> + <entry></entry> + </row> + <row> + <entry>F291</entry> + <entry></entry> + <entry>UNIQUE predicate</entry> + <entry></entry> + </row> + <row> + <entry>F301</entry> + <entry></entry> + <entry>CORRESPONDING in query expressions</entry> + <entry></entry> + </row> + <row> + <entry>F311</entry> + <entry>Core</entry> + <entry>Schema definition statement</entry> + <entry></entry> + </row> + <row> + <entry>F312</entry> + <entry></entry> + <entry>MERGE statement</entry> + <entry></entry> + </row> + <row> + <entry>F313</entry> + <entry></entry> + <entry>Enhanced MERGE statement</entry> + <entry></entry> + </row> + <row> + <entry>F314</entry> + <entry></entry> + <entry>MERGE statement with DELETE branch</entry> + <entry></entry> + </row> + <row> + <entry>F341</entry> + <entry></entry> + <entry>Usage tables</entry> + <entry>no ROUTINE_*_USAGE tables</entry> + </row> + <row> + <entry>F384</entry> + <entry></entry> + <entry>Drop identity property clause</entry> + <entry></entry> + </row> + <row> + <entry>F385</entry> + <entry></entry> + <entry>Drop column generation expression clause</entry> + <entry></entry> + </row> + <row> + <entry>F386</entry> + <entry></entry> + <entry>Set identity column generation clause</entry> + <entry></entry> + </row> + <row> + <entry>F394</entry> + <entry></entry> + <entry>Optional normal form specification</entry> + <entry></entry> + </row> + <row> + <entry>F403</entry> + <entry></entry> + <entry>Partitioned joined tables</entry> + <entry></entry> + </row> + <row> + <entry>F451</entry> + <entry></entry> + <entry>Character set definition</entry> + <entry></entry> + </row> + <row> + <entry>F461</entry> + <entry></entry> + <entry>Named character sets</entry> + <entry></entry> + </row> + <row> + <entry>F492</entry> + <entry></entry> + <entry>Optional table constraint enforcement</entry> + <entry></entry> + </row> + <row> + <entry>F521</entry> + <entry>Enhanced integrity management</entry> + <entry>Assertions</entry> + <entry></entry> + </row> + <row> + <entry>F671</entry> + <entry>Enhanced integrity management</entry> + <entry>Subqueries in CHECK</entry> + <entry>intentionally omitted</entry> + </row> + <row> + <entry>F693</entry> + <entry></entry> + <entry>SQL-session and client module collations</entry> + <entry></entry> + </row> + <row> + <entry>F695</entry> + <entry></entry> + <entry>Translation support</entry> + <entry></entry> + </row> + <row> + <entry>F696</entry> + <entry></entry> + <entry>Additional translation documentation</entry> + <entry></entry> + </row> + <row> + <entry>F721</entry> + <entry></entry> + <entry>Deferrable constraints</entry> + <entry>foreign and unique keys only</entry> + </row> + <row> + <entry>F741</entry> + <entry></entry> + <entry>Referential MATCH types</entry> + <entry>no partial match yet</entry> + </row> + <row> + <entry>F812</entry> + <entry>Core</entry> + <entry>Basic flagging</entry> + <entry></entry> + </row> + <row> + <entry>F813</entry> + <entry></entry> + <entry>Extended flagging</entry> + <entry></entry> + </row> + <row> + <entry>F821</entry> + <entry></entry> + <entry>Local table references</entry> + <entry></entry> + </row> + <row> + <entry>F831</entry> + <entry></entry> + <entry>Full cursor update</entry> + <entry></entry> + </row> + <row> + <entry>F831-01</entry> + <entry></entry> + <entry>Updatable scrollable cursors</entry> + <entry></entry> + </row> + <row> + <entry>F831-02</entry> + <entry></entry> + <entry>Updatable ordered cursors</entry> + <entry></entry> + </row> + <row> + <entry>F841</entry> + <entry></entry> + <entry>LIKE_REGEX predicate</entry> + <entry></entry> + </row> + <row> + <entry>F842</entry> + <entry></entry> + <entry>OCCURENCES_REGEX function</entry> + <entry></entry> + </row> + <row> + <entry>F843</entry> + <entry></entry> + <entry>POSITION_REGEX function</entry> + <entry></entry> + </row> + <row> + <entry>F844</entry> + <entry></entry> + <entry>SUBSTRING_REGEX function</entry> + <entry></entry> + </row> + <row> + <entry>F845</entry> + <entry></entry> + <entry>TRANSLATE_REGEX function</entry> + <entry></entry> + </row> + <row> + <entry>F846</entry> + <entry></entry> + <entry>Octet support in regular expression operators</entry> + <entry></entry> + </row> + <row> + <entry>F847</entry> + <entry></entry> + <entry>Nonconstant regular expressions</entry> + <entry></entry> + </row> + <row> + <entry>F866</entry> + <entry></entry> + <entry>FETCH FIRST clause: PERCENT option</entry> + <entry></entry> + </row> + <row> + <entry>F867</entry> + <entry></entry> + <entry>FETCH FIRST clause: WITH TIES option</entry> + <entry></entry> + </row> + <row> + <entry>S011</entry> + <entry>Core</entry> + <entry>Distinct data types</entry> + <entry></entry> + </row> + <row> + <entry>S011-01</entry> + <entry>Core</entry> + <entry>USER_DEFINED_TYPES view</entry> + <entry></entry> + </row> + <row> + <entry>S023</entry> + <entry>Basic object support</entry> + <entry>Basic structured types</entry> + <entry></entry> + </row> + <row> + <entry>S024</entry> + <entry>Enhanced object support</entry> + <entry>Enhanced structured types</entry> + <entry></entry> + </row> + <row> + <entry>S025</entry> + <entry></entry> + <entry>Final structured types</entry> + <entry></entry> + </row> + <row> + <entry>S026</entry> + <entry></entry> + <entry>Self-referencing structured types</entry> + <entry></entry> + </row> + <row> + <entry>S027</entry> + <entry></entry> + <entry>Create method by specific method name</entry> + <entry></entry> + </row> + <row> + <entry>S028</entry> + <entry></entry> + <entry>Permutable UDT options list</entry> + <entry></entry> + </row> + <row> + <entry>S041</entry> + <entry>Basic object support</entry> + <entry>Basic reference types</entry> + <entry></entry> + </row> + <row> + <entry>S043</entry> + <entry>Enhanced object support</entry> + <entry>Enhanced reference types</entry> + <entry></entry> + </row> + <row> + <entry>S051</entry> + <entry>Basic object support</entry> + <entry>Create table of type</entry> + <entry>partially supported</entry> + </row> + <row> + <entry>S081</entry> + <entry>Enhanced object support</entry> + <entry>Subtables</entry> + <entry></entry> + </row> + <row> + <entry>S091</entry> + <entry></entry> + <entry>Basic array support</entry> + <entry>partially supported</entry> + </row> + <row> + <entry>S091-01</entry> + <entry></entry> + <entry>Arrays of built-in data types</entry> + <entry></entry> + </row> + <row> + <entry>S091-02</entry> + <entry></entry> + <entry>Arrays of distinct types</entry> + <entry></entry> + </row> + <row> + <entry>S091-03</entry> + <entry></entry> + <entry>Array expressions</entry> + <entry></entry> + </row> + <row> + <entry>S094</entry> + <entry></entry> + <entry>Arrays of reference types</entry> + <entry></entry> + </row> + <row> + <entry>S097</entry> + <entry></entry> + <entry>Array element assignment</entry> + <entry></entry> + </row> + <row> + <entry>S151</entry> + <entry>Basic object support</entry> + <entry>Type predicate</entry> + <entry></entry> + </row> + <row> + <entry>S161</entry> + <entry>Enhanced object support</entry> + <entry>Subtype treatment</entry> + <entry></entry> + </row> + <row> + <entry>S162</entry> + <entry></entry> + <entry>Subtype treatment for references</entry> + <entry></entry> + </row> + <row> + <entry>S202</entry> + <entry></entry> + <entry>SQL-invoked routines on multisets</entry> + <entry></entry> + </row> + <row> + <entry>S231</entry> + <entry>Enhanced object support</entry> + <entry>Structured type locators</entry> + <entry></entry> + </row> + <row> + <entry>S232</entry> + <entry></entry> + <entry>Array locators</entry> + <entry></entry> + </row> + <row> + <entry>S233</entry> + <entry></entry> + <entry>Multiset locators</entry> + <entry></entry> + </row> + <row> + <entry>S241</entry> + <entry></entry> + <entry>Transform functions</entry> + <entry></entry> + </row> + <row> + <entry>S242</entry> + <entry></entry> + <entry>Alter transform statement</entry> + <entry></entry> + </row> + <row> + <entry>S251</entry> + <entry></entry> + <entry>User-defined orderings</entry> + <entry></entry> + </row> + <row> + <entry>S261</entry> + <entry></entry> + <entry>Specific type method</entry> + <entry></entry> + </row> + <row> + <entry>S271</entry> + <entry></entry> + <entry>Basic multiset support</entry> + <entry></entry> + </row> + <row> + <entry>S272</entry> + <entry></entry> + <entry>Multisets of user-defined types</entry> + <entry></entry> + </row> + <row> + <entry>S274</entry> + <entry></entry> + <entry>Multisets of reference types</entry> + <entry></entry> + </row> + <row> + <entry>S275</entry> + <entry></entry> + <entry>Advanced multiset support</entry> + <entry></entry> + </row> + <row> + <entry>S281</entry> + <entry></entry> + <entry>Nested collection types</entry> + <entry></entry> + </row> + <row> + <entry>S291</entry> + <entry></entry> + <entry>Unique constraint on entire row</entry> + <entry></entry> + </row> + <row> + <entry>S301</entry> + <entry></entry> + <entry>Enhanced UNNEST</entry> + <entry></entry> + </row> + <row> + <entry>S401</entry> + <entry></entry> + <entry>Distinct types based on array types</entry> + <entry></entry> + </row> + <row> + <entry>S402</entry> + <entry></entry> + <entry>Distinct types based on distinct types</entry> + <entry></entry> + </row> + <row> + <entry>S403</entry> + <entry></entry> + <entry>ARRAY_MAX_CARDINALITY</entry> + <entry></entry> + </row> + <row> + <entry>S404</entry> + <entry></entry> + <entry>TRIM_ARRAY</entry> + <entry></entry> + </row> + <row> + <entry>T011</entry> + <entry></entry> + <entry>Timestamp in Information Schema</entry> + <entry></entry> + </row> + <row> + <entry>T021</entry> + <entry></entry> + <entry>BINARY and VARBINARY data types</entry> + <entry></entry> + </row> + <row> + <entry>T022</entry> + <entry></entry> + <entry>Advanced support for BINARY and VARBINARY data types</entry> + <entry></entry> + </row> + <row> + <entry>T023</entry> + <entry></entry> + <entry>Compound binary literal</entry> + <entry></entry> + </row> + <row> + <entry>T024</entry> + <entry></entry> + <entry>Spaces in binary literals</entry> + <entry></entry> + </row> + <row> + <entry>T041</entry> + <entry>Basic object support</entry> + <entry>Basic LOB data type support</entry> + <entry></entry> + </row> + <row> + <entry>T041-01</entry> + <entry>Basic object support</entry> + <entry>BLOB data type</entry> + <entry></entry> + </row> + <row> + <entry>T041-02</entry> + <entry>Basic object support</entry> + <entry>CLOB data type</entry> + <entry></entry> + </row> + <row> + <entry>T041-03</entry> + <entry>Basic object support</entry> + <entry>POSITION, LENGTH, LOWER, TRIM, UPPER, and SUBSTRING functions for LOB data types</entry> + <entry></entry> + </row> + <row> + <entry>T041-04</entry> + <entry>Basic object support</entry> + <entry>Concatenation of LOB data types</entry> + <entry></entry> + </row> + <row> + <entry>T041-05</entry> + <entry>Basic object support</entry> + <entry>LOB locator: non-holdable</entry> + <entry></entry> + </row> + <row> + <entry>T042</entry> + <entry></entry> + <entry>Extended LOB data type support</entry> + <entry></entry> + </row> + <row> + <entry>T043</entry> + <entry></entry> + <entry>Multiplier T</entry> + <entry></entry> + </row> + <row> + <entry>T044</entry> + <entry></entry> + <entry>Multiplier P</entry> + <entry></entry> + </row> + <row> + <entry>T051</entry> + <entry></entry> + <entry>Row types</entry> + <entry></entry> + </row> + <row> + <entry>T052</entry> + <entry></entry> + <entry>MAX and MIN for row types</entry> + <entry></entry> + </row> + <row> + <entry>T053</entry> + <entry></entry> + <entry>Explicit aliases for all-fields reference</entry> + <entry></entry> + </row> + <row> + <entry>T061</entry> + <entry></entry> + <entry>UCS support</entry> + <entry></entry> + </row> + <row> + <entry>T101</entry> + <entry></entry> + <entry>Enhanced nullability determination</entry> + <entry></entry> + </row> + <row> + <entry>T111</entry> + <entry></entry> + <entry>Updatable joins, unions, and columns</entry> + <entry></entry> + </row> + <row> + <entry>T174</entry> + <entry></entry> + <entry>Identity columns</entry> + <entry></entry> + </row> + <row> + <entry>T175</entry> + <entry></entry> + <entry>Generated columns</entry> + <entry></entry> + </row> + <row> + <entry>T176</entry> + <entry></entry> + <entry>Sequence generator support</entry> + <entry></entry> + </row> + <row> + <entry>T177</entry> + <entry></entry> + <entry>Sequence generator support: simple restart option</entry> + <entry></entry> + </row> + <row> + <entry>T178</entry> + <entry></entry> + <entry>Identity columns: simple restart option</entry> + <entry></entry> + </row> + <row> + <entry>T180</entry> + <entry></entry> + <entry>System-versioned tables</entry> + <entry></entry> + </row> + <row> + <entry>T181</entry> + <entry></entry> + <entry>Application-time period tables</entry> + <entry></entry> + </row> + <row> + <entry>T211</entry> + <entry>Active database, Enhanced integrity management</entry> + <entry>Basic trigger capability</entry> + <entry></entry> + </row> + <row> + <entry>T211-06</entry> + <entry>Active database, Enhanced integrity management</entry> + <entry>Support for run-time rules for the interaction of triggers and constraints</entry> + <entry></entry> + </row> + <row> + <entry>T211-08</entry> + <entry>Active database, Enhanced integrity management</entry> + <entry>Multiple triggers for the same event are executed in the order in which they were created in the catalog</entry> + <entry>intentionally omitted</entry> + </row> + <row> + <entry>T251</entry> + <entry></entry> + <entry>SET TRANSACTION statement: LOCAL option</entry> + <entry></entry> + </row> + <row> + <entry>T261</entry> + <entry></entry> + <entry>Chained transactions</entry> + <entry></entry> + </row> + <row> + <entry>T272</entry> + <entry></entry> + <entry>Enhanced savepoint management</entry> + <entry></entry> + </row> + <row> + <entry>T285</entry> + <entry></entry> + <entry>Enhanced derived column names</entry> + <entry></entry> + </row> + <row> + <entry>T301</entry> + <entry></entry> + <entry>Functional dependencies</entry> + <entry>partially supported</entry> + </row> + <row> + <entry>T321</entry> + <entry>Core</entry> + <entry>Basic SQL-invoked routines</entry> + <entry></entry> + </row> + <row> + <entry>T321-02</entry> + <entry>Core</entry> + <entry>User-defined stored procedures with no overloading</entry> + <entry></entry> + </row> + <row> + <entry>T321-04</entry> + <entry>Core</entry> + <entry>CALL statement</entry> + <entry></entry> + </row> + <row> + <entry>T321-05</entry> + <entry>Core</entry> + <entry>RETURN statement</entry> + <entry></entry> + </row> + <row> + <entry>T322</entry> + <entry>PSM</entry> + <entry>Declared data type attributes</entry> + <entry></entry> + </row> + <row> + <entry>T324</entry> + <entry></entry> + <entry>Explicit security for SQL routines</entry> + <entry></entry> + </row> + <row> + <entry>T326</entry> + <entry></entry> + <entry>Table functions</entry> + <entry></entry> + </row> + <row> + <entry>T332</entry> + <entry></entry> + <entry>Extended roles</entry> + <entry>mostly supported</entry> + </row> + <row> + <entry>T431</entry> + <entry>OLAP</entry> + <entry>Extended grouping capabilities</entry> + <entry></entry> + </row> + <row> + <entry>T432</entry> + <entry></entry> + <entry>Nested and concatenated GROUPING SETS</entry> + <entry></entry> + </row> + <row> + <entry>T433</entry> + <entry></entry> + <entry>Multiargument GROUPING function</entry> + <entry></entry> + </row> + <row> + <entry>T434</entry> + <entry></entry> + <entry>GROUP BY DISTINCT</entry> + <entry></entry> + </row> + <row> + <entry>T471</entry> + <entry></entry> + <entry>Result sets return value</entry> + <entry></entry> + </row> + <row> + <entry>T472</entry> + <entry></entry> + <entry>DESCRIBE CURSOR</entry> + <entry></entry> + </row> + <row> + <entry>T495</entry> + <entry></entry> + <entry>Combined data change and retrieval</entry> + <entry>different syntax</entry> + </row> + <row> + <entry>T502</entry> + <entry></entry> + <entry>Period predicates</entry> + <entry></entry> + </row> + <row> + <entry>T511</entry> + <entry></entry> + <entry>Transaction counts</entry> + <entry></entry> + </row> + <row> + <entry>T521</entry> + <entry></entry> + <entry>Named arguments in CALL statement</entry> + <entry></entry> + </row> + <row> + <entry>T522</entry> + <entry></entry> + <entry>Default values for IN parameters of SQL-invoked procedures</entry> + <entry></entry> + </row> + <row> + <entry>T541</entry> + <entry></entry> + <entry>Updatable table references</entry> + <entry></entry> + </row> + <row> + <entry>T561</entry> + <entry></entry> + <entry>Holdable locators</entry> + <entry></entry> + </row> + <row> + <entry>T571</entry> + <entry></entry> + <entry>Array-returning external SQL-invoked functions</entry> + <entry></entry> + </row> + <row> + <entry>T572</entry> + <entry></entry> + <entry>Multiset-returning external SQL-invoked functions</entry> + <entry></entry> + </row> + <row> + <entry>T601</entry> + <entry></entry> + <entry>Local cursor references</entry> + <entry></entry> + </row> + <row> + <entry>T611</entry> + <entry>OLAP</entry> + <entry>Elementary OLAP operations</entry> + <entry>most forms supported</entry> + </row> + <row> + <entry>T612</entry> + <entry></entry> + <entry>Advanced OLAP operations</entry> + <entry>some forms supported</entry> + </row> + <row> + <entry>T613</entry> + <entry></entry> + <entry>Sampling</entry> + <entry></entry> + </row> + <row> + <entry>T616</entry> + <entry></entry> + <entry>Null treatment option for LEAD and LAG functions</entry> + <entry></entry> + </row> + <row> + <entry>T618</entry> + <entry></entry> + <entry>NTH_VALUE function</entry> + <entry>function exists, but some options missing</entry> + </row> + <row> + <entry>T619</entry> + <entry></entry> + <entry>Nested window functions</entry> + <entry></entry> + </row> + <row> + <entry>T620</entry> + <entry></entry> + <entry>WINDOW clause: GROUPS option</entry> + <entry></entry> + </row> + <row> + <entry>T641</entry> + <entry></entry> + <entry>Multiple column assignment</entry> + <entry>only some syntax variants supported</entry> + </row> + <row> + <entry>T652</entry> + <entry></entry> + <entry>SQL-dynamic statements in SQL routines</entry> + <entry></entry> + </row> + <row> + <entry>T653</entry> + <entry></entry> + <entry>SQL-schema statements in external routines</entry> + <entry></entry> + </row> + <row> + <entry>T654</entry> + <entry></entry> + <entry>SQL-dynamic statements in external routines</entry> + <entry></entry> + </row> + <row> + <entry>M001</entry> + <entry></entry> + <entry>Datalinks</entry> + <entry></entry> + </row> + <row> + <entry>M002</entry> + <entry></entry> + <entry>Datalinks via SQL/CLI</entry> + <entry></entry> + </row> + <row> + <entry>M003</entry> + <entry></entry> + <entry>Datalinks via Embedded SQL</entry> + <entry></entry> + </row> + <row> + <entry>M004</entry> + <entry></entry> + <entry>Foreign data support</entry> + <entry>partially supported</entry> + </row> + <row> + <entry>M005</entry> + <entry></entry> + <entry>Foreign schema support</entry> + <entry></entry> + </row> + <row> + <entry>M006</entry> + <entry></entry> + <entry>GetSQLString routine</entry> + <entry></entry> + </row> + <row> + <entry>M007</entry> + <entry></entry> + <entry>TransmitRequest</entry> + <entry></entry> + </row> + <row> + <entry>M009</entry> + <entry></entry> + <entry>GetOpts and GetStatistics routines</entry> + <entry></entry> + </row> + <row> + <entry>M010</entry> + <entry></entry> + <entry>Foreign data wrapper support</entry> + <entry>different API</entry> + </row> + <row> + <entry>M011</entry> + <entry></entry> + <entry>Datalinks via Ada</entry> + <entry></entry> + </row> + <row> + <entry>M012</entry> + <entry></entry> + <entry>Datalinks via C</entry> + <entry></entry> + </row> + <row> + <entry>M013</entry> + <entry></entry> + <entry>Datalinks via COBOL</entry> + <entry></entry> + </row> + <row> + <entry>M014</entry> + <entry></entry> + <entry>Datalinks via Fortran</entry> + <entry></entry> + </row> + <row> + <entry>M015</entry> + <entry></entry> + <entry>Datalinks via M</entry> + <entry></entry> + </row> + <row> + <entry>M016</entry> + <entry></entry> + <entry>Datalinks via Pascal</entry> + <entry></entry> + </row> + <row> + <entry>M017</entry> + <entry></entry> + <entry>Datalinks via PL/I</entry> + <entry></entry> + </row> + <row> + <entry>M018</entry> + <entry></entry> + <entry>Foreign data wrapper interface routines in Ada</entry> + <entry></entry> + </row> + <row> + <entry>M019</entry> + <entry></entry> + <entry>Foreign data wrapper interface routines in C</entry> + <entry>different API</entry> + </row> + <row> + <entry>M020</entry> + <entry></entry> + <entry>Foreign data wrapper interface routines in COBOL</entry> + <entry></entry> + </row> + <row> + <entry>M021</entry> + <entry></entry> + <entry>Foreign data wrapper interface routines in Fortran</entry> + <entry></entry> + </row> + <row> + <entry>M022</entry> + <entry></entry> + <entry>Foreign data wrapper interface routines in MUMPS</entry> + <entry></entry> + </row> + <row> + <entry>M023</entry> + <entry></entry> + <entry>Foreign data wrapper interface routines in Pascal</entry> + <entry></entry> + </row> + <row> + <entry>M024</entry> + <entry></entry> + <entry>Foreign data wrapper interface routines in PL/I</entry> + <entry></entry> + </row> + <row> + <entry>M030</entry> + <entry></entry> + <entry>SQL-server foreign data support</entry> + <entry></entry> + </row> + <row> + <entry>M031</entry> + <entry></entry> + <entry>Foreign data wrapper general routines</entry> + <entry></entry> + </row> + <row> + <entry>X012</entry> + <entry></entry> + <entry>Multisets of XML type</entry> + <entry></entry> + </row> + <row> + <entry>X013</entry> + <entry></entry> + <entry>Distinct types of XML type</entry> + <entry></entry> + </row> + <row> + <entry>X014</entry> + <entry></entry> + <entry>Attributes of XML type</entry> + <entry></entry> + </row> + <row> + <entry>X015</entry> + <entry></entry> + <entry>Fields of XML type</entry> + <entry></entry> + </row> + <row> + <entry>X025</entry> + <entry></entry> + <entry>XMLCast</entry> + <entry></entry> + </row> + <row> + <entry>X030</entry> + <entry></entry> + <entry>XMLDocument</entry> + <entry></entry> + </row> + <row> + <entry>X038</entry> + <entry></entry> + <entry>XMLText</entry> + <entry></entry> + </row> + <row> + <entry>X065</entry> + <entry></entry> + <entry>XMLParse: BLOB input and CONTENT option</entry> + <entry></entry> + </row> + <row> + <entry>X066</entry> + <entry></entry> + <entry>XMLParse: BLOB input and DOCUMENT option</entry> + <entry></entry> + </row> + <row> + <entry>X068</entry> + <entry></entry> + <entry>XMLSerialize: BOM</entry> + <entry></entry> + </row> + <row> + <entry>X069</entry> + <entry></entry> + <entry>XMLSerialize: INDENT</entry> + <entry></entry> + </row> + <row> + <entry>X073</entry> + <entry></entry> + <entry>XMLSerialize: BLOB serialization and CONTENT option</entry> + <entry></entry> + </row> + <row> + <entry>X074</entry> + <entry></entry> + <entry>XMLSerialize: BLOB serialization and DOCUMENT option</entry> + <entry></entry> + </row> + <row> + <entry>X075</entry> + <entry></entry> + <entry>XMLSerialize: BLOB serialization</entry> + <entry></entry> + </row> + <row> + <entry>X076</entry> + <entry></entry> + <entry>XMLSerialize: VERSION</entry> + <entry></entry> + </row> + <row> + <entry>X077</entry> + <entry></entry> + <entry>XMLSerialize: explicit ENCODING option</entry> + <entry></entry> + </row> + <row> + <entry>X078</entry> + <entry></entry> + <entry>XMLSerialize: explicit XML declaration</entry> + <entry></entry> + </row> + <row> + <entry>X080</entry> + <entry></entry> + <entry>Namespaces in XML publishing</entry> + <entry></entry> + </row> + <row> + <entry>X081</entry> + <entry></entry> + <entry>Query-level XML namespace declarations</entry> + <entry></entry> + </row> + <row> + <entry>X082</entry> + <entry></entry> + <entry>XML namespace declarations in DML</entry> + <entry></entry> + </row> + <row> + <entry>X083</entry> + <entry></entry> + <entry>XML namespace declarations in DDL</entry> + <entry></entry> + </row> + <row> + <entry>X084</entry> + <entry></entry> + <entry>XML namespace declarations in compound statements</entry> + <entry></entry> + </row> + <row> + <entry>X085</entry> + <entry></entry> + <entry>Predefined namespace prefixes</entry> + <entry></entry> + </row> + <row> + <entry>X086</entry> + <entry></entry> + <entry>XML namespace declarations in XMLTable</entry> + <entry></entry> + </row> + <row> + <entry>X091</entry> + <entry></entry> + <entry>XML content predicate</entry> + <entry></entry> + </row> + <row> + <entry>X096</entry> + <entry></entry> + <entry>XMLExists</entry> + <entry></entry> + </row> + <row> + <entry>X100</entry> + <entry></entry> + <entry>Host language support for XML: CONTENT option</entry> + <entry></entry> + </row> + <row> + <entry>X101</entry> + <entry></entry> + <entry>Host language support for XML: DOCUMENT option</entry> + <entry></entry> + </row> + <row> + <entry>X110</entry> + <entry></entry> + <entry>Host language support for XML: VARCHAR mapping</entry> + <entry></entry> + </row> + <row> + <entry>X111</entry> + <entry></entry> + <entry>Host language support for XML: CLOB mapping</entry> + <entry></entry> + </row> + <row> + <entry>X112</entry> + <entry></entry> + <entry>Host language support for XML: BLOB mapping</entry> + <entry></entry> + </row> + <row> + <entry>X113</entry> + <entry></entry> + <entry>Host language support for XML: STRIP WHITESPACE option</entry> + <entry></entry> + </row> + <row> + <entry>X114</entry> + <entry></entry> + <entry>Host language support for XML: PRESERVE WHITESPACE option</entry> + <entry></entry> + </row> + <row> + <entry>X131</entry> + <entry></entry> + <entry>Query-level XMLBINARY clause</entry> + <entry></entry> + </row> + <row> + <entry>X132</entry> + <entry></entry> + <entry>XMLBINARY clause in DML</entry> + <entry></entry> + </row> + <row> + <entry>X133</entry> + <entry></entry> + <entry>XMLBINARY clause in DDL</entry> + <entry></entry> + </row> + <row> + <entry>X134</entry> + <entry></entry> + <entry>XMLBINARY clause in compound statements</entry> + <entry></entry> + </row> + <row> + <entry>X135</entry> + <entry></entry> + <entry>XMLBINARY clause in subqueries</entry> + <entry></entry> + </row> + <row> + <entry>X141</entry> + <entry></entry> + <entry>IS VALID predicate: data-driven case</entry> + <entry></entry> + </row> + <row> + <entry>X142</entry> + <entry></entry> + <entry>IS VALID predicate: ACCORDING TO clause</entry> + <entry></entry> + </row> + <row> + <entry>X143</entry> + <entry></entry> + <entry>IS VALID predicate: ELEMENT clause</entry> + <entry></entry> + </row> + <row> + <entry>X144</entry> + <entry></entry> + <entry>IS VALID predicate: schema location</entry> + <entry></entry> + </row> + <row> + <entry>X145</entry> + <entry></entry> + <entry>IS VALID predicate outside check constraints</entry> + <entry></entry> + </row> + <row> + <entry>X151</entry> + <entry></entry> + <entry>IS VALID predicate with DOCUMENT option</entry> + <entry></entry> + </row> + <row> + <entry>X152</entry> + <entry></entry> + <entry>IS VALID predicate with CONTENT option</entry> + <entry></entry> + </row> + <row> + <entry>X153</entry> + <entry></entry> + <entry>IS VALID predicate with SEQUENCE option</entry> + <entry></entry> + </row> + <row> + <entry>X155</entry> + <entry></entry> + <entry>IS VALID predicate: NAMESPACE without ELEMENT clause</entry> + <entry></entry> + </row> + <row> + <entry>X157</entry> + <entry></entry> + <entry>IS VALID predicate: NO NAMESPACE with ELEMENT clause</entry> + <entry></entry> + </row> + <row> + <entry>X160</entry> + <entry></entry> + <entry>Basic Information Schema for registered XML Schemas</entry> + <entry></entry> + </row> + <row> + <entry>X161</entry> + <entry></entry> + <entry>Advanced Information Schema for registered XML Schemas</entry> + <entry></entry> + </row> + <row> + <entry>X170</entry> + <entry></entry> + <entry>XML null handling options</entry> + <entry></entry> + </row> + <row> + <entry>X171</entry> + <entry></entry> + <entry>NIL ON NO CONTENT option</entry> + <entry></entry> + </row> + <row> + <entry>X181</entry> + <entry></entry> + <entry>XML(DOCUMENT(UNTYPED)) type</entry> + <entry></entry> + </row> + <row> + <entry>X182</entry> + <entry></entry> + <entry>XML(DOCUMENT(ANY)) type</entry> + <entry></entry> + </row> + <row> + <entry>X190</entry> + <entry></entry> + <entry>XML(SEQUENCE) type</entry> + <entry></entry> + </row> + <row> + <entry>X191</entry> + <entry></entry> + <entry>XML(DOCUMENT(XMLSCHEMA)) type</entry> + <entry></entry> + </row> + <row> + <entry>X192</entry> + <entry></entry> + <entry>XML(CONTENT(XMLSCHEMA)) type</entry> + <entry></entry> + </row> + <row> + <entry>X200</entry> + <entry></entry> + <entry>XMLQuery</entry> + <entry></entry> + </row> + <row> + <entry>X201</entry> + <entry></entry> + <entry>XMLQuery: RETURNING CONTENT</entry> + <entry></entry> + </row> + <row> + <entry>X202</entry> + <entry></entry> + <entry>XMLQuery: RETURNING SEQUENCE</entry> + <entry></entry> + </row> + <row> + <entry>X203</entry> + <entry></entry> + <entry>XMLQuery: passing a context item</entry> + <entry></entry> + </row> + <row> + <entry>X204</entry> + <entry></entry> + <entry>XMLQuery: initializing an XQuery variable</entry> + <entry></entry> + </row> + <row> + <entry>X205</entry> + <entry></entry> + <entry>XMLQuery: EMPTY ON EMPTY option</entry> + <entry></entry> + </row> + <row> + <entry>X206</entry> + <entry></entry> + <entry>XMLQuery: NULL ON EMPTY option</entry> + <entry></entry> + </row> + <row> + <entry>X211</entry> + <entry></entry> + <entry>XML 1.1 support</entry> + <entry></entry> + </row> + <row> + <entry>X221</entry> + <entry></entry> + <entry>XML passing mechanism BY VALUE</entry> + <entry></entry> + </row> + <row> + <entry>X222</entry> + <entry></entry> + <entry>XML passing mechanism BY REF</entry> + <entry></entry> + </row> + <row> + <entry>X231</entry> + <entry></entry> + <entry>XML(CONTENT(UNTYPED)) type</entry> + <entry></entry> + </row> + <row> + <entry>X232</entry> + <entry></entry> + <entry>XML(CONTENT(ANY)) type</entry> + <entry></entry> + </row> + <row> + <entry>X241</entry> + <entry></entry> + <entry>RETURNING CONTENT in XML publishing</entry> + <entry></entry> + </row> + <row> + <entry>X242</entry> + <entry></entry> + <entry>RETURNING SEQUENCE in XML publishing</entry> + <entry></entry> + </row> + <row> + <entry>X251</entry> + <entry></entry> + <entry>Persistent XML values of XML(DOCUMENT(UNTYPED)) type</entry> + <entry></entry> + </row> + <row> + <entry>X252</entry> + <entry></entry> + <entry>Persistent XML values of XML(DOCUMENT(ANY)) type</entry> + <entry></entry> + </row> + <row> + <entry>X253</entry> + <entry></entry> + <entry>Persistent XML values of XML(CONTENT(UNTYPED)) type</entry> + <entry></entry> + </row> + <row> + <entry>X254</entry> + <entry></entry> + <entry>Persistent XML values of XML(CONTENT(ANY)) type</entry> + <entry></entry> + </row> + <row> + <entry>X255</entry> + <entry></entry> + <entry>Persistent XML values of XML(SEQUENCE) type</entry> + <entry></entry> + </row> + <row> + <entry>X256</entry> + <entry></entry> + <entry>Persistent XML values of XML(DOCUMENT(XMLSCHEMA)) type</entry> + <entry></entry> + </row> + <row> + <entry>X257</entry> + <entry></entry> + <entry>Persistent XML values of XML(CONTENT(XMLSCHEMA)) type</entry> + <entry></entry> + </row> + <row> + <entry>X260</entry> + <entry></entry> + <entry>XML type: ELEMENT clause</entry> + <entry></entry> + </row> + <row> + <entry>X261</entry> + <entry></entry> + <entry>XML type: NAMESPACE without ELEMENT clause</entry> + <entry></entry> + </row> + <row> + <entry>X263</entry> + <entry></entry> + <entry>XML type: NO NAMESPACE with ELEMENT clause</entry> + <entry></entry> + </row> + <row> + <entry>X264</entry> + <entry></entry> + <entry>XML type: schema location</entry> + <entry></entry> + </row> + <row> + <entry>X271</entry> + <entry></entry> + <entry>XMLValidate: data-driven case</entry> + <entry></entry> + </row> + <row> + <entry>X272</entry> + <entry></entry> + <entry>XMLValidate: ACCORDING TO clause</entry> + <entry></entry> + </row> + <row> + <entry>X273</entry> + <entry></entry> + <entry>XMLValidate: ELEMENT clause</entry> + <entry></entry> + </row> + <row> + <entry>X274</entry> + <entry></entry> + <entry>XMLValidate: schema location</entry> + <entry></entry> + </row> + <row> + <entry>X281</entry> + <entry></entry> + <entry>XMLValidate: with DOCUMENT option</entry> + <entry></entry> + </row> + <row> + <entry>X282</entry> + <entry></entry> + <entry>XMLValidate with CONTENT option</entry> + <entry></entry> + </row> + <row> + <entry>X283</entry> + <entry></entry> + <entry>XMLValidate with SEQUENCE option</entry> + <entry></entry> + </row> + <row> + <entry>X284</entry> + <entry></entry> + <entry>XMLValidate NAMESPACE without ELEMENT clause</entry> + <entry></entry> + </row> + <row> + <entry>X286</entry> + <entry></entry> + <entry>XMLValidate: NO NAMESPACE with ELEMENT clause</entry> + <entry></entry> + </row> + <row> + <entry>X300</entry> + <entry></entry> + <entry>XMLTable</entry> + <entry></entry> + </row> + <row> + <entry>X301</entry> + <entry></entry> + <entry>XMLTable: derived column list option</entry> + <entry></entry> + </row> + <row> + <entry>X302</entry> + <entry></entry> + <entry>XMLTable: ordinality column option</entry> + <entry></entry> + </row> + <row> + <entry>X303</entry> + <entry></entry> + <entry>XMLTable: column default option</entry> + <entry></entry> + </row> + <row> + <entry>X304</entry> + <entry></entry> + <entry>XMLTable: passing a context item</entry> + <entry></entry> + </row> + <row> + <entry>X305</entry> + <entry></entry> + <entry>XMLTable: initializing an XQuery variable</entry> + <entry></entry> + </row> +</tbody> diff --git a/doc/src/sgml/filelist.sgml b/doc/src/sgml/filelist.sgml new file mode 100644 index 000000000..a12fee73d --- /dev/null +++ b/doc/src/sgml/filelist.sgml @@ -0,0 +1,210 @@ +<!-- doc/src/sgml/filelist.sgml --> + +<!ENTITY history SYSTEM "history.sgml"> +<!ENTITY info SYSTEM "info.sgml"> +<!ENTITY intro SYSTEM "intro.sgml"> +<!ENTITY legal SYSTEM "legal.sgml"> +<!ENTITY notation SYSTEM "notation.sgml"> +<!ENTITY problems SYSTEM "problems.sgml"> + +<!-- tutorial --> +<!ENTITY advanced SYSTEM "advanced.sgml"> +<!ENTITY query SYSTEM "query.sgml"> +<!ENTITY start SYSTEM "start.sgml"> + +<!-- currently unused, but contains some interesting information --> +<!ENTITY sql SYSTEM "sql.sgml"> + +<!-- user's guide --> +<!ENTITY array SYSTEM "array.sgml"> +<!ENTITY datatype SYSTEM "datatype.sgml"> +<!ENTITY ddl SYSTEM "ddl.sgml"> +<!ENTITY dml SYSTEM "dml.sgml"> +<!ENTITY func SYSTEM "func.sgml"> +<!ENTITY indices SYSTEM "indices.sgml"> +<!ENTITY json SYSTEM "json.sgml"> +<!ENTITY mvcc SYSTEM "mvcc.sgml"> +<!ENTITY perform SYSTEM "perform.sgml"> +<!ENTITY queries SYSTEM "queries.sgml"> +<!ENTITY rangetypes SYSTEM "rangetypes.sgml"> +<!ENTITY rowtypes SYSTEM "rowtypes.sgml"> +<!ENTITY syntax SYSTEM "syntax.sgml"> +<!ENTITY textsearch SYSTEM "textsearch.sgml"> +<!ENTITY typeconv SYSTEM "typeconv.sgml"> + +<!-- administrator's guide --> +<!ENTITY backup SYSTEM "backup.sgml"> +<!ENTITY charset SYSTEM "charset.sgml"> +<!ENTITY client-auth SYSTEM "client-auth.sgml"> +<!ENTITY diskusage SYSTEM "diskusage.sgml"> +<!ENTITY high-availability SYSTEM "high-availability.sgml"> +<!ENTITY installation SYSTEM "installation.sgml"> +<!ENTITY installw SYSTEM "install-windows.sgml"> +<!ENTITY maintenance SYSTEM "maintenance.sgml"> +<!ENTITY manage-ag SYSTEM "manage-ag.sgml"> +<!ENTITY monitoring SYSTEM "monitoring.sgml"> +<!ENTITY regress SYSTEM "regress.sgml"> +<!ENTITY recovery-config SYSTEM "recovery-config.sgml"> +<!ENTITY runtime SYSTEM "runtime.sgml"> +<!ENTITY config SYSTEM "config.sgml"> +<!ENTITY user-manag SYSTEM "user-manag.sgml"> +<!ENTITY wal SYSTEM "wal.sgml"> + +<!-- programmer's guide --> +<!ENTITY bgworker SYSTEM "bgworker.sgml"> +<!ENTITY dfunc SYSTEM "dfunc.sgml"> +<!ENTITY ecpg SYSTEM "ecpg.sgml"> +<!ENTITY extend SYSTEM "extend.sgml"> +<!ENTITY external-projects SYSTEM "external-projects.sgml"> +<!ENTITY func-ref SYSTEM "func-ref.sgml"> +<!ENTITY infoschema SYSTEM "information_schema.sgml"> +<!ENTITY libpq SYSTEM "libpq.sgml"> +<!ENTITY lobj SYSTEM "lobj.sgml"> +<!ENTITY rules SYSTEM "rules.sgml"> +<!ENTITY spi SYSTEM "spi.sgml"> +<!ENTITY trigger SYSTEM "trigger.sgml"> +<!ENTITY event-trigger SYSTEM "event-trigger.sgml"> +<!ENTITY xaggr SYSTEM "xaggr.sgml"> +<!ENTITY xfunc SYSTEM "xfunc.sgml"> +<!ENTITY xindex SYSTEM "xindex.sgml"> +<!ENTITY xplang SYSTEM "xplang.sgml"> +<!ENTITY xoper SYSTEM "xoper.sgml"> +<!ENTITY xtypes SYSTEM "xtypes.sgml"> +<!ENTITY plperl SYSTEM "plperl.sgml"> +<!ENTITY plpython SYSTEM "plpython.sgml"> +<!ENTITY plsql SYSTEM "plpgsql.sgml"> +<!ENTITY pltcl SYSTEM "pltcl.sgml"> + +<!-- reference pages --> +<!ENTITY % allfiles SYSTEM "ref/allfiles.sgml"> +%allfiles; + +<!-- developer's guide --> +<!ENTITY arch-dev SYSTEM "arch-dev.sgml"> +<!ENTITY bki SYSTEM "bki.sgml"> +<!ENTITY catalogs SYSTEM "catalogs.sgml"> +<!ENTITY geqo SYSTEM "geqo.sgml"> +<!ENTITY gist SYSTEM "gist.sgml"> +<!ENTITY spgist SYSTEM "spgist.sgml"> +<!ENTITY gin SYSTEM "gin.sgml"> +<!ENTITY brin SYSTEM "brin.sgml"> +<!ENTITY planstats SYSTEM "planstats.sgml"> +<!ENTITY indexam SYSTEM "indexam.sgml"> +<!ENTITY nls SYSTEM "nls.sgml"> +<!ENTITY plhandler SYSTEM "plhandler.sgml"> +<!ENTITY fdwhandler SYSTEM "fdwhandler.sgml"> +<!ENTITY custom-scan SYSTEM "custom-scan.sgml"> +<!ENTITY logicaldecoding SYSTEM "logicaldecoding.sgml"> +<!ENTITY replication-origins SYSTEM "replication-origins.sgml"> +<!ENTITY protocol SYSTEM "protocol.sgml"> +<!ENTITY sources SYSTEM "sources.sgml"> +<!ENTITY storage SYSTEM "storage.sgml"> +<!ENTITY tablesample-method SYSTEM "tablesample-method.sgml"> + +<!-- contrib information --> +<!ENTITY contrib SYSTEM "contrib.sgml"> +<!ENTITY adminpack SYSTEM "adminpack.sgml"> +<!ENTITY auth-delay SYSTEM "auth-delay.sgml"> +<!ENTITY auto-explain SYSTEM "auto-explain.sgml"> +<!ENTITY btree-gin SYSTEM "btree-gin.sgml"> +<!ENTITY btree-gist SYSTEM "btree-gist.sgml"> +<!ENTITY chkpass SYSTEM "chkpass.sgml"> +<!ENTITY citext SYSTEM "citext.sgml"> +<!ENTITY cube SYSTEM "cube.sgml"> +<!ENTITY dblink SYSTEM "dblink.sgml"> +<!ENTITY dict-int SYSTEM "dict-int.sgml"> +<!ENTITY dict-xsyn SYSTEM "dict-xsyn.sgml"> +<!ENTITY dummy-seclabel SYSTEM "dummy-seclabel.sgml"> +<!ENTITY earthdistance SYSTEM "earthdistance.sgml"> +<!ENTITY file-fdw SYSTEM "file-fdw.sgml"> +<!ENTITY fuzzystrmatch SYSTEM "fuzzystrmatch.sgml"> +<!ENTITY hstore SYSTEM "hstore.sgml"> +<!ENTITY intagg SYSTEM "intagg.sgml"> +<!ENTITY intarray SYSTEM "intarray.sgml"> +<!ENTITY isn SYSTEM "isn.sgml"> +<!ENTITY lo SYSTEM "lo.sgml"> +<!ENTITY ltree SYSTEM "ltree.sgml"> +<!ENTITY oid2name SYSTEM "oid2name.sgml"> +<!ENTITY pageinspect SYSTEM "pageinspect.sgml"> +<!ENTITY passwordcheck SYSTEM "passwordcheck.sgml"> +<!ENTITY pgbuffercache SYSTEM "pgbuffercache.sgml"> +<!ENTITY pgcrypto SYSTEM "pgcrypto.sgml"> +<!ENTITY pgfreespacemap SYSTEM "pgfreespacemap.sgml"> +<!ENTITY pgprewarm SYSTEM "pgprewarm.sgml"> +<!ENTITY pgrowlocks SYSTEM "pgrowlocks.sgml"> +<!ENTITY pgstandby SYSTEM "pgstandby.sgml"> +<!ENTITY pgstatstatements SYSTEM "pgstatstatements.sgml"> +<!ENTITY pgstattuple SYSTEM "pgstattuple.sgml"> +<!ENTITY pgtrgm SYSTEM "pgtrgm.sgml"> +<!ENTITY postgres-fdw SYSTEM "postgres-fdw.sgml"> +<!ENTITY seg SYSTEM "seg.sgml"> +<!ENTITY contrib-spi SYSTEM "contrib-spi.sgml"> +<!ENTITY sepgsql SYSTEM "sepgsql.sgml"> +<!ENTITY sslinfo SYSTEM "sslinfo.sgml"> +<!ENTITY tablefunc SYSTEM "tablefunc.sgml"> +<!ENTITY tcn SYSTEM "tcn.sgml"> +<!ENTITY test-decoding SYSTEM "test-decoding.sgml"> +<!ENTITY test-parser SYSTEM "test-parser.sgml"> +<!ENTITY test-shm-mq SYSTEM "test-shm-mq.sgml"> +<!ENTITY tsearch2 SYSTEM "tsearch2.sgml"> +<!ENTITY tsm-system-rows SYSTEM "tsm-system-rows.sgml"> +<!ENTITY tsm-system-time SYSTEM "tsm-system-time.sgml"> +<!ENTITY unaccent SYSTEM "unaccent.sgml"> +<!ENTITY uuid-ossp SYSTEM "uuid-ossp.sgml"> +<!ENTITY vacuumlo SYSTEM "vacuumlo.sgml"> +<!ENTITY xml2 SYSTEM "xml2.sgml"> + +<!-- appendixes --> +<!ENTITY contacts SYSTEM "contacts.sgml"> +<!ENTITY datetime SYSTEM "datetime.sgml"> +<!ENTITY docguide SYSTEM "docguide.sgml"> +<!ENTITY errcodes SYSTEM "errcodes.sgml"> +<!ENTITY features SYSTEM "features.sgml"> +<!ENTITY keywords SYSTEM "keywords.sgml"> +<!ENTITY sourcerepo SYSTEM "sourcerepo.sgml"> + +<!ENTITY release SYSTEM "release.sgml"> +<!ENTITY release-9.5 SYSTEM "release-9.5.sgml"> +<!ENTITY release-9.4 SYSTEM "release-9.4.sgml"> +<!ENTITY release-9.3 SYSTEM "release-9.3.sgml"> +<!ENTITY release-9.2 SYSTEM "release-9.2.sgml"> +<!ENTITY release-9.1 SYSTEM "release-9.1.sgml"> +<!ENTITY release-9.0 SYSTEM "release-9.0.sgml"> +<!ENTITY release-8.4 SYSTEM "release-8.4.sgml"> +<!ENTITY release-8.3 SYSTEM "release-8.3.sgml"> +<!ENTITY release-8.2 SYSTEM "release-8.2.sgml"> +<!ENTITY release-8.1 SYSTEM "release-8.1.sgml"> +<!ENTITY release-8.0 SYSTEM "release-8.0.sgml"> +<!ENTITY release-7.4 SYSTEM "release-7.4.sgml"> +<!ENTITY release-old SYSTEM "release-old.sgml"> + +<!ENTITY acronyms SYSTEM "acronyms.sgml"> + +<!ENTITY features-supported SYSTEM "features-supported.sgml"> +<!ENTITY features-unsupported SYSTEM "features-unsupported.sgml"> + +<!ENTITY errcodes-table SYSTEM "errcodes-table.sgml"> + +<!-- back matter --> +<!ENTITY biblio SYSTEM "biblio.sgml"> +<!ENTITY bookindex SYSTEM "bookindex.sgml"> + +<!-- + Some parts of the documentation are also source for some plain-text + files used during installation. To selectively ignore or include + some parts (e.g., external xref's) when generating these files we use + these parameter entities. See also standalone-install.sgml. + --> +<!ENTITY % standalone-ignore "INCLUDE"> +<!ENTITY % standalone-include "IGNORE"> + +<!-- + By default, no index is included. Use -i include-index on the command line + to include it. + --> +<!ENTITY % include-index "IGNORE"> + +<!-- + Create empty index element for processing by XSLT stylesheet. + --> +<!ENTITY % include-xslt-index "IGNORE"> diff --git a/doc/src/sgml/fixrtf b/doc/src/sgml/fixrtf new file mode 100644 index 000000000..31cb5f85c --- /dev/null +++ b/doc/src/sgml/fixrtf @@ -0,0 +1,46 @@ +#!/bin/sh +# fixrtf + +# doc/src/sgml/fixrtf + +# Repair (slightly) damaged RTF generated by jade +# Applixware wants the s0 stylesheet defined, whereas +# M$Word does not care about it. +# (c) 2001, Thomas Lockhart, PostgreSQL Inc. + +flist="" +RPAT="" +for i in $@ ; do + case "$i" in + -r|--refentry) + RPAT='-e s/\\\keepn/\\\keep/g' + ;; + -?|--help) + echo "$0 [--refentry] <rtf file> ..." + exit 0 + ;; + -*) + echo "Command $i not recognized" + $0 --help + exit 1 + ;; + *) + flist="$flist $i" + esac +done + +if [ "$flist" = "" ] ; then + flist=*.rtf +fi + +for f in $flist ; do + echo -n "Repairing '$f' ..." + if [ -r $f ] ; then + (sed -e 's/{\\stylesheet{\\s1/{\\stylesheet{\\s0 Normal 0;}{\\s1/g' $RPAT $f > $f.new \ + && mv -f $f.new $f \ + && echo " done") || echo " failed" + else + echo " file not found" + fi +done +exit diff --git a/doc/src/sgml/generate-errcodes-table.pl b/doc/src/sgml/generate-errcodes-table.pl new file mode 100644 index 000000000..2195e0f45 --- /dev/null +++ b/doc/src/sgml/generate-errcodes-table.pl @@ -0,0 +1,59 @@ +#!/usr/bin/perl +# +# Generate the errcodes-table.sgml file from errcodes.txt +# Copyright (c) 2000-2016, PostgreSQL Global Development Group + +use warnings; +use strict; + +print + "<!-- autogenerated from src/backend/utils/errcodes.txt, do not edit -->\n"; + +open my $errcodes, $ARGV[0] or die; + +while (<$errcodes>) +{ + chomp; + + # Skip comments + next if /^#/; + next if /^\s*$/; + + # Emit section headers + if (/^Section:/) + { + + # Remove the Section: string + s/^Section: //; + + # Escape dashes for SGML + s/-/&mdash;/; + + # Wrap PostgreSQL in <productname/> + s/PostgreSQL/<productname>PostgreSQL<\/>/g; + + print "\n\n"; + print "<row>\n"; + print "<entry spanname=\"span12\">"; + print "<emphasis role=\"bold\">$_</></entry>\n"; + print "</row>\n"; + + next; + } + + die unless /^([^\s]{5})\s+([EWS])\s+([^\s]+)(?:\s+)?([^\s]+)?/; + + (my $sqlstate, my $type, my $errcode_macro, my $condition_name) = + ($1, $2, $3, $4); + + # Skip lines without PL/pgSQL condition names + next unless defined($condition_name); + + print "\n"; + print "<row>\n"; + print "<entry><literal>$sqlstate</literal></entry>\n"; + print "<entry><symbol>$condition_name</symbol></entry>\n"; + print "</row>\n"; +} + +close $errcodes; diff --git a/doc/src/sgml/history.sgml b/doc/src/sgml/history.sgml new file mode 100644 index 000000000..32a2da67c --- /dev/null +++ b/doc/src/sgml/history.sgml @@ -0,0 +1,13 @@ +<!-- doc/src/sgml/history.sgml --> + +<sect1 id="history"> + <title>A Brief History of <productname>pgpool-II</productname></title> + + <indexterm zone="history"> + <primary>history</primary> + <secondary>of pgpool-II</secondary> + </indexterm> + <para> + pgpool-II history... + </para> +</sect1> diff --git a/doc/src/sgml/html/LEGALNOTICE.html b/doc/src/sgml/html/LEGALNOTICE.html new file mode 100644 index 000000000..057401319 --- /dev/null +++ b/doc/src/sgml/html/LEGALNOTICE.html @@ -0,0 +1,129 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="NEXT" +TITLE="Preface" +HREF="preface.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="LEGALNOTICE" +><A +NAME="LEGALNOTICE" +></A +><P +><B +>Legal Notice</B +></P +><P +> <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> is Copyright &copy; 1996-2016 + by the PostgreSQL Global Development Group. + </P +><P +> <SPAN +CLASS="PRODUCTNAME" +>Postgres95</SPAN +> is Copyright &copy; 1994-5 + by the Regents of the University of California. + </P +><P +> Permission to use, copy, modify, and distribute this software and + its documentation for any purpose, without fee, and without a + written agreement is hereby granted, provided that the above + copyright notice and this paragraph and the following two paragraphs + appear in all copies. + </P +><P +> IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY + PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL + DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS + SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA + HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + </P +><P +> THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, + INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE + PROVIDED HEREUNDER IS ON AN <SPAN +CLASS="QUOTE" +>"AS-IS"</SPAN +> BASIS, AND THE UNIVERSITY OF + CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, + UPDATES, ENHANCEMENTS, OR MODIFICATIONS. + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>&nbsp;</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>&nbsp;</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/admin.html b/doc/src/sgml/html/admin.html new file mode 100644 index 000000000..227186548 --- /dev/null +++ b/doc/src/sgml/html/admin.html @@ -0,0 +1,231 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Server Administration</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Installation" +HREF="tutorial-install.html"><LINK +REL="NEXT" +TITLE="pgpool-IIInstallation from Source Code" +HREF="installation.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="PART" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Installation" +HREF="tutorial-install.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="pgpool-IIInstallation from Source Code" +HREF="installation.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="PART" +><A +NAME="ADMIN" +></A +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +>II. Server Administration</H1 +><DIV +CLASS="PARTINTRO" +><A +NAME="AEN108" +></A +><P +> This part covers topics that are of interest to a + <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> ... + </P +></DIV +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +>2. <A +HREF="installation.html" +><SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</A +></DT +><DD +><DL +><DT +>2.1. <A +HREF="install-short.html" +>Short Version</A +></DT +><DT +>2.2. <A +HREF="install-requirements.html" +>Requirements</A +></DT +><DT +>2.3. <A +HREF="install-getsource.html" +>Getting The Source</A +></DT +><DT +>2.4. <A +HREF="install-procedure.html" +>Installation Procedure</A +></DT +><DT +>2.5. <A +HREF="install-post.html" +>Post-Installation Setup</A +></DT +><DT +>2.6. <A +HREF="supported-platforms.html" +>Supported Platforms</A +></DT +><DT +>2.7. <A +HREF="installation-platform-notes.html" +>Platform-specific Notes</A +></DT +></DL +></DD +></DL +></DIV +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="tutorial-install.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Installation</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +>&nbsp;</TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/biblio.html b/doc/src/sgml/html/biblio.html new file mode 100644 index 000000000..4ea25a065 --- /dev/null +++ b/doc/src/sgml/html/biblio.html @@ -0,0 +1,738 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Bibliography</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="pcp_node_count" +HREF="pcp-node-count.html"><LINK +REL="NEXT" +TITLE="Index" +HREF="bookindex.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="BIBLIOGRAPHY" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="pcp_node_count" +HREF="pcp-node-count.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Index" +HREF="bookindex.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><A +NAME="BIBLIO" +></A +><H1 +><A +NAME="BIBLIO" +></A +>Bibliography</H1 +><P +> Selected references and readings for <ACRONYM +CLASS="ACRONYM" +>SQL</ACRONYM +> + and <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +>. + </P +><P +> Some white papers and technical reports from the original + <SPAN +CLASS="PRODUCTNAME" +>POSTGRES</SPAN +> development team + are available at the University of California, Berkeley, Computer Science + Department <A +HREF="http://db.cs.berkeley.edu/papers/" +TARGET="_top" +> web site</A +>. + </P +><H2 +CLASS="BIBLIODIV" +><A +NAME="AEN624" +><ACRONYM +CLASS="ACRONYM" +>SQL</ACRONYM +> Reference Books</A +></H2 +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="BOWMAN01" +></A +><P +><SPAN +CLASS="AUTHOR" +>Judith Bowman, </SPAN +><SPAN +CLASS="AUTHOR" +>Sandra Emerson, </SPAN +><SPAN +CLASS="AUTHOR" +>and Marcy Darnovsky</SPAN +>, <I +>The Practical <ACRONYM +CLASS="ACRONYM" +>SQL</ACRONYM +> Handbook</I +><I +>: </I +><I +>Using SQL Variants</I +>, Fourth Edition, Addison-Wesley Professional, ISBN 0-201-70309-2, 2001.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="DATE97" +></A +><P +><SPAN +CLASS="AUTHOR" +>C. J. Date </SPAN +><SPAN +CLASS="AUTHOR" +>and Hugh Darwen</SPAN +>, <I +>A Guide to the <ACRONYM +CLASS="ACRONYM" +>SQL</ACRONYM +> Standard</I +><I +>: </I +><I +>A user's guide to the standard database language <ACRONYM +CLASS="ACRONYM" +>SQL</ACRONYM +></I +>, Fourth Edition, Addison-Wesley, ISBN 0-201-96426-0, 1997.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="DATE04" +></A +><P +><SPAN +CLASS="AUTHOR" +>C. J. Date</SPAN +>, <I +>An Introduction to Database Systems</I +>, Eighth Edition, Addison-Wesley, ISBN 0-321-19784-4, 2003.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="ELMA04" +></A +><P +><SPAN +CLASS="AUTHOR" +>Ramez Elmasri </SPAN +><SPAN +CLASS="AUTHOR" +>and Shamkant Navathe</SPAN +>, <I +>Fundamentals of Database Systems</I +>, Fourth Edition, Addison-Wesley, ISBN 0-321-12226-7, 2003.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="MELT93" +></A +><P +><SPAN +CLASS="AUTHOR" +>Jim Melton </SPAN +><SPAN +CLASS="AUTHOR" +>and Alan R. Simon</SPAN +>, <I +>Understanding the New <ACRONYM +CLASS="ACRONYM" +>SQL</ACRONYM +></I +><I +>: </I +><I +>A complete guide</I +>, Morgan Kaufmann, ISBN 1-55860-245-3, 1993.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="ULL88" +></A +><P +><SPAN +CLASS="AUTHOR" +>Jeffrey D. Ullman</SPAN +>, <I +>Principles of Database and Knowledge</I +><I +>: </I +><I +>Base Systems</I +>, Volume 1, Computer Science Press, 1988.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><H2 +CLASS="BIBLIODIV" +><A +NAME="AEN734" +>PostgreSQL-specific Documentation</A +></H2 +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="SIM98" +></A +><P +><SPAN +CLASS="AUTHOR" +>Stefan Simkovics</SPAN +>, <I +>Enhancement of the ANSI SQL Implementation of PostgreSQL</I +>, Department of Information Systems, Vienna University of Technology, November 29, 1998.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +><DIV +CLASS="ABSTRACT" +><P +> Discusses SQL history and syntax, and describes the addition of + <TT +CLASS="LITERAL" +>INTERSECT</TT +> and <TT +CLASS="LITERAL" +>EXCEPT</TT +> constructs into + <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +>. Prepared as a Master's + Thesis with the support of O. Univ. Prof. Dr. Georg Gottlob and + Univ. Ass. Mag. Katrin Seyr at Vienna University of Technology. + </P +></DIV +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="YU95" +></A +><P +><SPAN +CLASS="AUTHOR" +>A. Yu </SPAN +><SPAN +CLASS="AUTHOR" +>and J. Chen</SPAN +>, The POSTGRES Group, <I +>The <SPAN +CLASS="PRODUCTNAME" +>Postgres95</SPAN +> User Manual</I +>, University of California, Sept. 5, 1995.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="FONG" +></A +><P +><SPAN +CLASS="AUTHOR" +>Zelaine Fong</SPAN +>, <I +> <A +HREF="http://db.cs.berkeley.edu/papers/UCB-MS-zfong.pdf" +TARGET="_top" +> The design and implementation of the <SPAN +CLASS="PRODUCTNAME" +>POSTGRES</SPAN +> query optimizer + </A +></I +>, University of California, Berkeley, Computer Science Department.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><H2 +CLASS="BIBLIODIV" +><A +NAME="AEN780" +>Proceedings and Articles</A +></H2 +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="OLSON93" +></A +><P +><SPAN +CLASS="AUTHOR" +>Nels Olson</SPAN +>, <I +>Partial indexing in POSTGRES: research project</I +>, University of California, UCB Engin T7.49.1993 O676, 1993.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="ONG90" +></A +><P +><SPAN +CLASS="AUTHOR" +>L. Ong </SPAN +><SPAN +CLASS="AUTHOR" +>and J. Goh</SPAN +>, "A Unified Framework for Version Modeling Using Production Rules in a Database System", <I +>ERL Technical Memorandum M90/33</I +>, University of California, April, 1990.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="ROWE87" +></A +><P +><SPAN +CLASS="AUTHOR" +>L. Rowe </SPAN +><SPAN +CLASS="AUTHOR" +>and M. Stonebraker</SPAN +>, "<A +HREF="http://db.cs.berkeley.edu/papers/ERL-M87-13.pdf" +TARGET="_top" +> The <SPAN +CLASS="PRODUCTNAME" +>POSTGRES</SPAN +> data model + </A +>", Proc. <SPAN +CLASS="CONFTITLE" +>VLDB Conference</SPAN +>, <SPAN +CLASS="CONFDATES" +>Sept. 1987</SPAN +>.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="SESHADRI95" +></A +><P +><SPAN +CLASS="AUTHOR" +>P. Seshadri </SPAN +><SPAN +CLASS="AUTHOR" +>and A. Swami</SPAN +>, "Generalized Partial Indexes + <A +HREF="http://citeseer.ist.psu.edu/seshadri95generalized.html" +TARGET="_top" +>(cached version) + </A +> + ", Proc. <SPAN +CLASS="CONFTITLE" +>Eleventh International Conference on Data Engineering</SPAN +>, <SPAN +CLASS="CONFDATES" +>6-10 March 1995</SPAN +>, IEEE Computer Society Press, Cat. No.95CH35724, 1995, 420-7.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="STON86" +></A +><P +><SPAN +CLASS="AUTHOR" +>M. Stonebraker </SPAN +><SPAN +CLASS="AUTHOR" +>and L. Rowe</SPAN +>, "<A +HREF="http://db.cs.berkeley.edu/papers/ERL-M85-95.pdf" +TARGET="_top" +> The design of <SPAN +CLASS="PRODUCTNAME" +>POSTGRES</SPAN +> + </A +>", Proc. <SPAN +CLASS="CONFTITLE" +>ACM-SIGMOD Conference on Management of Data</SPAN +>, <SPAN +CLASS="CONFDATES" +>May 1986</SPAN +>.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="STON87A" +></A +><P +><SPAN +CLASS="AUTHOR" +>M. Stonebraker, </SPAN +><SPAN +CLASS="AUTHOR" +>E. Hanson, </SPAN +><SPAN +CLASS="AUTHOR" +>and C. H. Hong</SPAN +>, "The design of the <SPAN +CLASS="PRODUCTNAME" +>POSTGRES</SPAN +> rules system", Proc. <SPAN +CLASS="CONFTITLE" +>IEEE Conference on Data Engineering</SPAN +>, <SPAN +CLASS="CONFDATES" +>Feb. 1987</SPAN +>.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="STON87B" +></A +><P +><SPAN +CLASS="AUTHOR" +>M. Stonebraker</SPAN +>, "<A +HREF="http://db.cs.berkeley.edu/papers/ERL-M87-06.pdf" +TARGET="_top" +> The design of the <SPAN +CLASS="PRODUCTNAME" +>POSTGRES</SPAN +> storage system + </A +>", Proc. <SPAN +CLASS="CONFTITLE" +>VLDB Conference</SPAN +>, <SPAN +CLASS="CONFDATES" +>Sept. 1987</SPAN +>.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="STON89" +></A +><P +><SPAN +CLASS="AUTHOR" +>M. Stonebraker, </SPAN +><SPAN +CLASS="AUTHOR" +>M. Hearst, </SPAN +><SPAN +CLASS="AUTHOR" +>and S. Potamianos</SPAN +>, "<A +HREF="http://db.cs.berkeley.edu/papers/ERL-M89-82.pdf" +TARGET="_top" +> A commentary on the <SPAN +CLASS="PRODUCTNAME" +>POSTGRES</SPAN +> rules system + </A +>", <I +>SIGMOD Record 18(3)</I +>, Sept. 1989.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="STON89B" +></A +><P +><SPAN +CLASS="AUTHOR" +>M. Stonebraker</SPAN +>, "<A +HREF="http://db.cs.berkeley.edu/papers/ERL-M89-17.pdf" +TARGET="_top" +> The case for partial indexes + </A +>", <I +>SIGMOD Record 18(4)</I +>, Dec. 1989, 4-11.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="STON90A" +></A +><P +><SPAN +CLASS="AUTHOR" +>M. Stonebraker, </SPAN +><SPAN +CLASS="AUTHOR" +>L. A. Rowe, </SPAN +><SPAN +CLASS="AUTHOR" +>and M. Hirohama</SPAN +>, "<A +HREF="http://db.cs.berkeley.edu/papers/ERL-M90-34.pdf" +TARGET="_top" +> The implementation of <SPAN +CLASS="PRODUCTNAME" +>POSTGRES</SPAN +> + </A +>", <I +>Transactions on Knowledge and Data Engineering 2(1)</I +>, IEEE, March 1990.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="BIBLIOENTRY" +><A +NAME="STON90B" +></A +><P +><SPAN +CLASS="AUTHOR" +>M. Stonebraker, </SPAN +><SPAN +CLASS="AUTHOR" +>A. Jhingran, </SPAN +><SPAN +CLASS="AUTHOR" +>J. Goh, </SPAN +><SPAN +CLASS="AUTHOR" +>and S. Potamianos</SPAN +>, "<A +HREF="http://db.cs.berkeley.edu/papers/ERL-M90-36.pdf" +TARGET="_top" +> On Rules, Procedures, Caching and Views in Database Systems + </A +>", Proc. <SPAN +CLASS="CONFTITLE" +>ACM-SIGMOD Conference on Management of Data</SPAN +>, <SPAN +CLASS="CONFDATES" +>June 1990</SPAN +>.</P +><DIV +CLASS="BIBLIOENTRYBLOCK" +STYLE="margin-left: 0.5in" +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="pcp-node-count.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="bookindex.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>pcp_node_count</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +>&nbsp;</TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Index</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/bookindex.html b/doc/src/sgml/html/bookindex.html new file mode 100644 index 000000000..16707ef75 --- /dev/null +++ b/doc/src/sgml/html/bookindex.html @@ -0,0 +1,380 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Index</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Bibliography" +HREF="biblio.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="INDEX" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Bibliography" +HREF="biblio.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +>&nbsp;</TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="INDEX" +><H1 +><A +NAME="BOOKINDEX" +></A +>Index</H1 +><P +CLASS="INDEXDIV-QUICKLINKS" +><A +HREF="bookindex.html#AEN976" +>C</A +> | <A +HREF="bookindex.html#AEN981" +>H</A +> | <A +HREF="bookindex.html#AEN987" +>I</A +> | <A +HREF="bookindex.html#AEN992" +>L</A +> | <A +HREF="bookindex.html#AEN997" +>M</A +> | <A +HREF="bookindex.html#AEN1002" +>O</A +> | <A +HREF="bookindex.html#AEN1008" +>P</A +> | <A +HREF="bookindex.html#AEN1016" +>R</A +> | <A +HREF="bookindex.html#AEN1021" +>S</A +> | <A +HREF="bookindex.html#AEN1026" +>V</A +></P +><DIV +CLASS="INDEXDIV" +><H2 +CLASS="INDEXDIV" +><A +NAME="AEN976" +>C</A +></H2 +><DL +><DT +>configure, + <A +HREF="install-procedure.html" +>Installation Procedure</A +> + </DT +></DL +></DIV +><DIV +CLASS="INDEXDIV" +><H2 +CLASS="INDEXDIV" +><A +NAME="AEN981" +>H</A +></H2 +><DL +><DT +>history + </DT +><DD +><DL +><DT +>of pgpool-II, + <A +HREF="history.html" +>A Brief History of pgpool-II</A +> + </DT +><DD +><DL +></DL +></DD +></DL +></DD +></DL +></DIV +><DIV +CLASS="INDEXDIV" +><H2 +CLASS="INDEXDIV" +><A +NAME="AEN987" +>I</A +></H2 +><DL +><DT +>installation, + <A +HREF="installation.html" +>pgpool-IIInstallation from Source Code</A +> + </DT +></DL +></DIV +><DIV +CLASS="INDEXDIV" +><H2 +CLASS="INDEXDIV" +><A +NAME="AEN992" +>L</A +></H2 +><DL +><DT +>ldconfig, + <A +HREF="install-post.html#AEN453" +>Shared Libraries</A +> + </DT +></DL +></DIV +><DIV +CLASS="INDEXDIV" +><H2 +CLASS="INDEXDIV" +><A +NAME="AEN997" +>M</A +></H2 +><DL +><DT +>MANPATH, + <A +HREF="install-post.html#AEN504" +>Environment Variables</A +> + </DT +></DL +></DIV +><DIV +CLASS="INDEXDIV" +><H2 +CLASS="INDEXDIV" +><A +NAME="AEN1002" +>O</A +></H2 +><DL +><DT +>OpenSSL, + <A +HREF="install-procedure.html" +>Installation Procedure</A +> + </DT +><DD +><DL +><DT +>see also SSL</DT +></DL +></DD +></DL +></DIV +><DIV +CLASS="INDEXDIV" +><H2 +CLASS="INDEXDIV" +><A +NAME="AEN1008" +>P</A +></H2 +><DL +><DT +>PATH, + <A +HREF="install-post.html#AEN504" +>Environment Variables</A +> + </DT +><DT +>pcp_node_count, + <A +HREF="pcp-node-count.html" +>pcp_node_count</A +> + </DT +></DL +></DIV +><DIV +CLASS="INDEXDIV" +><H2 +CLASS="INDEXDIV" +><A +NAME="AEN1016" +>R</A +></H2 +><DL +><DT +>regression test, + <A +HREF="install-procedure.html" +>Installation Procedure</A +> + </DT +></DL +></DIV +><DIV +CLASS="INDEXDIV" +><H2 +CLASS="INDEXDIV" +><A +NAME="AEN1021" +>S</A +></H2 +><DL +><DT +>shared library, + <A +HREF="install-post.html#AEN453" +>Shared Libraries</A +> + </DT +></DL +></DIV +><DIV +CLASS="INDEXDIV" +><H2 +CLASS="INDEXDIV" +><A +NAME="AEN1026" +>V</A +></H2 +><DL +><DT +>VPATH, + <A +HREF="install-procedure.html" +>Installation Procedure</A +> + </DT +></DL +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="biblio.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>&nbsp;</TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Bibliography</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +>&nbsp;</TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>&nbsp;</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/bug-reporting.html b/doc/src/sgml/html/bug-reporting.html new file mode 100644 index 000000000..52c513911 --- /dev/null +++ b/doc/src/sgml/html/bug-reporting.html @@ -0,0 +1,169 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Bug Reporting Guidelines</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="Preface" +HREF="preface.html"><LINK +REL="PREVIOUS" +TITLE="Further Information" +HREF="resources.html"><LINK +REL="NEXT" +TITLE="Tutorial" +HREF="tutorial.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Further Information" +HREF="resources.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Preface</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Tutorial" +HREF="tutorial.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="BUG-REPORTING" +>Bug Reporting Guidelines</A +></H1 +><P +> When you find a bug in <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> ... + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="resources.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="tutorial.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Further Information</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Tutorial</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/history.html b/doc/src/sgml/html/history.html new file mode 100644 index 000000000..a3a644dbb --- /dev/null +++ b/doc/src/sgml/html/history.html @@ -0,0 +1,172 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>A Brief History of pgpool-II</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="Preface" +HREF="preface.html"><LINK +REL="PREVIOUS" +TITLE=" What is pgpool-II?" +HREF="intro-whatis.html"><LINK +REL="NEXT" +TITLE="Conventions" +HREF="notation.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE=" What is pgpool-II?" +HREF="intro-whatis.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Preface</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Conventions" +HREF="notation.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="HISTORY" +>A Brief History of <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +></A +></H1 +><P +> pgpool-II history... + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="intro-whatis.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="notation.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>What is <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>?</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Conventions</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/index.html b/doc/src/sgml/html/index.html new file mode 100644 index 000000000..27fd27ecd --- /dev/null +++ b/doc/src/sgml/html/index.html @@ -0,0 +1,203 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>pgpool-II 3.5.0 Documentation</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="NEXT" +TITLE="Preface" +HREF="preface.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="BOOK" +><DIV +CLASS="BOOK" +><A +NAME="POSTGRES" +></A +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +><A +NAME="POSTGRES" +>pgpool-II 3.5.0 Documentation</A +></H1 +><H3 +CLASS="CORPAUTHOR" +>The Pgpool Global Development Group</H3 +><P +CLASS="COPYRIGHT" +><A +HREF="LEGALNOTICE.html" +>Copyright</A +> &copy; 1996-2016 The PostgreSQL Global Development Group</P +><HR></DIV +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +><A +HREF="preface.html" +>Preface</A +></DT +><DD +><DL +><DT +><A +HREF="intro-whatis.html" +>What is <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>?</A +></DT +><DT +><A +HREF="history.html" +>A Brief History of <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +></A +></DT +><DT +><A +HREF="notation.html" +>Conventions</A +></DT +><DT +><A +HREF="resources.html" +>Further Information</A +></DT +><DT +><A +HREF="bug-reporting.html" +>Bug Reporting Guidelines</A +></DT +></DL +></DD +><DT +>I. <A +HREF="tutorial.html" +>Tutorial</A +></DT +><DD +><DL +><DT +>1. <A +HREF="tutorial-start.html" +>Getting Started</A +></DT +></DL +></DD +><DT +>II. <A +HREF="admin.html" +>Server Administration</A +></DT +><DD +><DL +><DT +>2. <A +HREF="installation.html" +><SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</A +></DT +></DL +></DD +><DT +>III. <A +HREF="reference.html" +>Reference</A +></DT +><DD +><DL +><DT +>I. <A +HREF="pcp-commands.html" +>PCP commands</A +></DT +></DL +></DD +><DT +><A +HREF="biblio.html" +>Bibliography</A +></DT +><DT +><A +HREF="bookindex.html" +>Index</A +></DT +></DL +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>&nbsp;</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +>&nbsp;</TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>&nbsp;</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +>&nbsp;</TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Preface</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/install-getsource.html b/doc/src/sgml/html/install-getsource.html new file mode 100644 index 000000000..8faac93fc --- /dev/null +++ b/doc/src/sgml/html/install-getsource.html @@ -0,0 +1,169 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Getting The Source</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="pgpool-IIInstallation from Source Code" +HREF="installation.html"><LINK +REL="PREVIOUS" +TITLE="Requirements" +HREF="install-requirements.html"><LINK +REL="NEXT" +TITLE="Installation Procedure" +HREF="install-procedure.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Requirements" +HREF="install-requirements.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Chapter 2. <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Installation Procedure" +HREF="install-procedure.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="INSTALL-GETSOURCE" +>2.3. Getting The Source</A +></H1 +><P +> Blah... + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="install-requirements.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="install-procedure.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Requirements</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Installation Procedure</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/install-post.html b/doc/src/sgml/html/install-post.html new file mode 100644 index 000000000..963984508 --- /dev/null +++ b/doc/src/sgml/html/install-post.html @@ -0,0 +1,457 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Post-Installation Setup</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="pgpool-IIInstallation from Source Code" +HREF="installation.html"><LINK +REL="PREVIOUS" +TITLE="Installation Procedure" +HREF="install-procedure.html"><LINK +REL="NEXT" +TITLE="Supported Platforms" +HREF="supported-platforms.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Installation Procedure" +HREF="install-procedure.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Chapter 2. <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Supported Platforms" +HREF="supported-platforms.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="INSTALL-POST" +>2.5. Post-Installation Setup</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN453" +>2.5.1. Shared Libraries</A +></H2 +><P +> On some systems with shared libraries + you need to tell the system how to find the newly installed + shared libraries. The systems on which this is + <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>not</I +></SPAN +> necessary include + <SPAN +CLASS="SYSTEMITEM" +>FreeBSD</SPAN +>, + <SPAN +CLASS="SYSTEMITEM" +>HP-UX</SPAN +>, + <SPAN +CLASS="SYSTEMITEM" +>Linux</SPAN +>, + <SPAN +CLASS="SYSTEMITEM" +>NetBSD</SPAN +>, <SPAN +CLASS="SYSTEMITEM" +>OpenBSD</SPAN +>, and + <SPAN +CLASS="SYSTEMITEM" +>Solaris</SPAN +>. + </P +><P +> The method to set the shared library search path varies between + platforms, but the most widely-used method is to set the + environment variable <TT +CLASS="ENVAR" +>LD_LIBRARY_PATH</TT +> like so: In Bourne + shells (<TT +CLASS="COMMAND" +>sh</TT +>, <TT +CLASS="COMMAND" +>ksh</TT +>, <TT +CLASS="COMMAND" +>bash</TT +>, <TT +CLASS="COMMAND" +>zsh</TT +>): +</P><PRE +CLASS="PROGRAMLISTING" +>LD_LIBRARY_PATH=/usr/local/pgsql/lib +export LD_LIBRARY_PATH</PRE +><P> + or in <TT +CLASS="COMMAND" +>csh</TT +> or <TT +CLASS="COMMAND" +>tcsh</TT +>: +</P><PRE +CLASS="PROGRAMLISTING" +>setenv LD_LIBRARY_PATH /usr/local/pgsql/lib</PRE +><P> + Replace <TT +CLASS="LITERAL" +>/usr/local/pgsql/lib</TT +> with whatever you set + <TT +CLASS="OPTION" +><TT +CLASS="LITERAL" +>--libdir</TT +></TT +> to in <A +HREF="install-procedure.html#CONFIGURE" +>step 1</A +>. + You should put these commands into a shell start-up file such as + <TT +CLASS="FILENAME" +>/etc/profile</TT +> or <TT +CLASS="FILENAME" +>~/.bash_profile</TT +>. Some + good information about the caveats associated with this method can + be found at <A +HREF="http://xahlee.org/UnixResource_dir/_/ldpath.html" +TARGET="_top" +>http://xahlee.org/UnixResource_dir/_/ldpath.html</A +>. + </P +><P +> On some systems it might be preferable to set the environment + variable <TT +CLASS="ENVAR" +>LD_RUN_PATH</TT +> <SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>before</I +></SPAN +> + building. + </P +><P +> On <SPAN +CLASS="SYSTEMITEM" +>Cygwin</SPAN +>, put the library + directory in the <TT +CLASS="ENVAR" +>PATH</TT +> or move the + <TT +CLASS="FILENAME" +>.dll</TT +> files into the <TT +CLASS="FILENAME" +>bin</TT +> + directory. + </P +><P +> If in doubt, refer to the manual pages of your system (perhaps + <TT +CLASS="COMMAND" +>ld.so</TT +> or <TT +CLASS="COMMAND" +>rld</TT +>). If you later + get a message like: +</P><PRE +CLASS="SCREEN" +>psql: error in loading shared libraries +libpq.so.2.1: cannot open shared object file: No such file or directory</PRE +><P> + then this step was necessary. Simply take care of it then. + </P +><P +> + If you are on <SPAN +CLASS="SYSTEMITEM" +>Linux</SPAN +> and you have root + access, you can run: +</P><PRE +CLASS="PROGRAMLISTING" +>/sbin/ldconfig /usr/local/pgsql/lib</PRE +><P> + (or equivalent directory) after installation to enable the + run-time linker to find the shared libraries faster. Refer to the + manual page of <TT +CLASS="COMMAND" +>ldconfig</TT +> for more information. On + <SPAN +CLASS="SYSTEMITEM" +>FreeBSD</SPAN +>, <SPAN +CLASS="SYSTEMITEM" +>NetBSD</SPAN +>, and <SPAN +CLASS="SYSTEMITEM" +>OpenBSD</SPAN +> the command is: +</P><PRE +CLASS="PROGRAMLISTING" +>/sbin/ldconfig -m /usr/local/pgsql/lib</PRE +><P> + instead. Other systems are not known to have an equivalent + command. + </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN504" +>2.5.2. Environment Variables</A +></H2 +><P +> If you installed into <TT +CLASS="FILENAME" +>/usr/local/pgsql</TT +> or some other + location that is not searched for programs by default, you should + add <TT +CLASS="FILENAME" +>/usr/local/pgsql/bin</TT +> (or whatever you set + <TT +CLASS="OPTION" +><TT +CLASS="LITERAL" +>--bindir</TT +></TT +> to in <A +HREF="install-procedure.html#CONFIGURE" +>step 1</A +>) + into your <TT +CLASS="ENVAR" +>PATH</TT +>. Strictly speaking, this is not + necessary, but it will make the use of <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> + much more convenient. + </P +><P +> To do this, add the following to your shell start-up file, such as + <TT +CLASS="FILENAME" +>~/.bash_profile</TT +> (or <TT +CLASS="FILENAME" +>/etc/profile</TT +>, if you + want it to affect all users): +</P><PRE +CLASS="PROGRAMLISTING" +>PATH=/usr/local/pgsql/bin:$PATH +export PATH</PRE +><P> + If you are using <TT +CLASS="COMMAND" +>csh</TT +> or <TT +CLASS="COMMAND" +>tcsh</TT +>, then use this command: +</P><PRE +CLASS="PROGRAMLISTING" +>set path = ( /usr/local/pgsql/bin $path )</PRE +><P> + </P +><P +> + To enable your system to find the <SPAN +CLASS="APPLICATION" +>man</SPAN +> + documentation, you need to add lines like the following to a + shell start-up file unless you installed into a location that is + searched by default: +</P><PRE +CLASS="PROGRAMLISTING" +>MANPATH=/usr/local/pgsql/man:$MANPATH +export MANPATH</PRE +><P> + </P +><P +> The environment variables <TT +CLASS="ENVAR" +>PGHOST</TT +> and <TT +CLASS="ENVAR" +>PGPORT</TT +> + specify to client applications the host and port of the database + server, overriding the compiled-in defaults. If you are going to + run client applications remotely then it is convenient if every + user that plans to use the database sets <TT +CLASS="ENVAR" +>PGHOST</TT +>. This + is not required, however; the settings can be communicated via command + line options to most client programs. + </P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="install-procedure.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="supported-platforms.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Installation Procedure</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Supported Platforms</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/install-procedure.html b/doc/src/sgml/html/install-procedure.html new file mode 100644 index 000000000..1463c0f27 --- /dev/null +++ b/doc/src/sgml/html/install-procedure.html @@ -0,0 +1,1236 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Installation Procedure</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="pgpool-IIInstallation from Source Code" +HREF="installation.html"><LINK +REL="PREVIOUS" +TITLE="Getting The Source" +HREF="install-getsource.html"><LINK +REL="NEXT" +TITLE="Post-Installation Setup" +HREF="install-post.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Getting The Source" +HREF="install-getsource.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Chapter 2. <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Post-Installation Setup" +HREF="install-post.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="INSTALL-PROCEDURE" +>2.4. Installation Procedure</A +></H1 +><DIV +CLASS="PROCEDURE" +><OL +TYPE="1" +><LI +CLASS="STEP" +><A +NAME="CONFIGURE" +></A +><P +><B +>Configuration</B +></P +><P +> The first step of the installation procedure is to configure the + source tree for your system and choose the options you would like. + This is done by running the <TT +CLASS="FILENAME" +>configure</TT +> script. For a + default installation simply enter: +</P><PRE +CLASS="SCREEN" +><KBD +CLASS="USERINPUT" +>./configure</KBD +></PRE +><P> + This script will run a number of tests to determine values for various + system dependent variables and detect any quirks of your + operating system, and finally will create several files in the + build tree to record what it found. You can also run + <TT +CLASS="FILENAME" +>configure</TT +> in a directory outside the source + tree, if you want to keep the build directory separate. This + procedure is also called a + <I +CLASS="FIRSTTERM" +>VPATH</I +> + build. Here's how: +</P><PRE +CLASS="SCREEN" +><KBD +CLASS="USERINPUT" +>mkdir build_dir</KBD +> +<KBD +CLASS="USERINPUT" +>cd build_dir</KBD +> +<KBD +CLASS="USERINPUT" +>/path/to/source/tree/configure [options go here]</KBD +> +<KBD +CLASS="USERINPUT" +>make</KBD +></PRE +><P> + </P +><P +> The default configuration will build the server and utilities, as + well as all client applications and interfaces that require only a + C compiler. All files will be installed under + <TT +CLASS="FILENAME" +>/usr/local/pgsql</TT +> by default. + </P +><P +> You can customize the build and installation process by supplying one + or more of the following command line options to + <TT +CLASS="FILENAME" +>configure</TT +>: + + <P +></P +></P><DIV +CLASS="VARIABLELIST" +><DL +><DT +><TT +CLASS="OPTION" +>--prefix=<TT +CLASS="REPLACEABLE" +><I +>PREFIX</I +></TT +></TT +></DT +><DD +><P +> Install all files under the directory <TT +CLASS="REPLACEABLE" +><I +>PREFIX</I +></TT +> + instead of <TT +CLASS="FILENAME" +>/usr/local/pgsql</TT +>. The actual + files will be installed into various subdirectories; no files + will ever be installed directly into the + <TT +CLASS="REPLACEABLE" +><I +>PREFIX</I +></TT +> directory. + </P +><P +> If you have special needs, you can also customize the + individual subdirectories with the following options. However, + if you leave these with their defaults, the installation will be + relocatable, meaning you can move the directory after + installation. (The <TT +CLASS="LITERAL" +>man</TT +> and <TT +CLASS="LITERAL" +>doc</TT +> + locations are not affected by this.) + </P +><P +> For relocatable installs, you might want to use + <TT +CLASS="FILENAME" +>configure</TT +>'s <TT +CLASS="LITERAL" +>--disable-rpath</TT +> + option. Also, you will need to tell the operating system how + to find the shared libraries. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--exec-prefix=<TT +CLASS="REPLACEABLE" +><I +>EXEC-PREFIX</I +></TT +></TT +></DT +><DD +><P +> You can install architecture-dependent files under a + different prefix, <TT +CLASS="REPLACEABLE" +><I +>EXEC-PREFIX</I +></TT +>, than what + <TT +CLASS="REPLACEABLE" +><I +>PREFIX</I +></TT +> was set to. This can be useful to + share architecture-independent files between hosts. If you + omit this, then <TT +CLASS="REPLACEABLE" +><I +>EXEC-PREFIX</I +></TT +> is set equal to + <TT +CLASS="REPLACEABLE" +><I +>PREFIX</I +></TT +> and both architecture-dependent and + independent files will be installed under the same tree, + which is probably what you want. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--bindir=<TT +CLASS="REPLACEABLE" +><I +>DIRECTORY</I +></TT +></TT +></DT +><DD +><P +> Specifies the directory for executable programs. The default + is <TT +CLASS="FILENAME" +><TT +CLASS="REPLACEABLE" +><I +>EXEC-PREFIX</I +></TT +>/bin</TT +>, which + normally means <TT +CLASS="FILENAME" +>/usr/local/pgsql/bin</TT +>. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--sysconfdir=<TT +CLASS="REPLACEABLE" +><I +>DIRECTORY</I +></TT +></TT +></DT +><DD +><P +> Sets the directory for various configuration files, + <TT +CLASS="FILENAME" +><TT +CLASS="REPLACEABLE" +><I +>PREFIX</I +></TT +>/etc</TT +> by default. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--libdir=<TT +CLASS="REPLACEABLE" +><I +>DIRECTORY</I +></TT +></TT +></DT +><DD +><P +> Sets the location to install libraries and dynamically loadable + modules. The default is + <TT +CLASS="FILENAME" +><TT +CLASS="REPLACEABLE" +><I +>EXEC-PREFIX</I +></TT +>/lib</TT +>. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--includedir=<TT +CLASS="REPLACEABLE" +><I +>DIRECTORY</I +></TT +></TT +></DT +><DD +><P +> Sets the directory for installing C and C++ header files. The + default is <TT +CLASS="FILENAME" +><TT +CLASS="REPLACEABLE" +><I +>PREFIX</I +></TT +>/include</TT +>. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--datarootdir=<TT +CLASS="REPLACEABLE" +><I +>DIRECTORY</I +></TT +></TT +></DT +><DD +><P +> Sets the root directory for various types of read-only data + files. This only sets the default for some of the following + options. The default is + <TT +CLASS="FILENAME" +><TT +CLASS="REPLACEABLE" +><I +>PREFIX</I +></TT +>/share</TT +>. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--datadir=<TT +CLASS="REPLACEABLE" +><I +>DIRECTORY</I +></TT +></TT +></DT +><DD +><P +> Sets the directory for read-only data files used by the + installed programs. The default is + <TT +CLASS="FILENAME" +><TT +CLASS="REPLACEABLE" +><I +>DATAROOTDIR</I +></TT +></TT +>. Note that this has + nothing to do with where your database files will be placed. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--mandir=<TT +CLASS="REPLACEABLE" +><I +>DIRECTORY</I +></TT +></TT +></DT +><DD +><P +> The man pages that come with <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> will be installed under + this directory, in their respective + <TT +CLASS="FILENAME" +>man<TT +CLASS="REPLACEABLE" +><I +>x</I +></TT +></TT +> subdirectories. + The default is <TT +CLASS="FILENAME" +><TT +CLASS="REPLACEABLE" +><I +>DATAROOTDIR</I +></TT +>/man</TT +>. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--docdir=<TT +CLASS="REPLACEABLE" +><I +>DIRECTORY</I +></TT +></TT +></DT +><DD +><P +> Sets the root directory for installing documentation files, + except <SPAN +CLASS="QUOTE" +>"man"</SPAN +> pages. This only sets the default for + the following options. The default value for this option is + <TT +CLASS="FILENAME" +><TT +CLASS="REPLACEABLE" +><I +>DATAROOTDIR</I +></TT +>/doc/postgresql</TT +>. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--htmldir=<TT +CLASS="REPLACEABLE" +><I +>DIRECTORY</I +></TT +></TT +></DT +><DD +><P +> The HTML-formatted documentation for + <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> will be installed under + this directory. The default is + <TT +CLASS="FILENAME" +><TT +CLASS="REPLACEABLE" +><I +>DATAROOTDIR</I +></TT +></TT +>. + </P +></DD +></DL +></DIV +><P> + + </P><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> Notes... + </P +></BLOCKQUOTE +></DIV +><P> + </P +><P +> <P +></P +></P><DIV +CLASS="VARIABLELIST" +><DL +><DT +><TT +CLASS="OPTION" +>--with-includes=<TT +CLASS="REPLACEABLE" +><I +>DIRECTORIES</I +></TT +></TT +></DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>DIRECTORIES</I +></TT +> is a colon-separated list of + directories that will be added to the list the compiler + searches for header files. If you have optional packages + (such as GNU <SPAN +CLASS="APPLICATION" +>Readline</SPAN +>) installed in a non-standard + location, + you have to use this option and probably also the corresponding + <TT +CLASS="OPTION" +>--with-libraries</TT +> option. + </P +><P +> Example: <TT +CLASS="LITERAL" +>--with-includes=/opt/gnu/include:/usr/sup/include</TT +>. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--with-libraries=<TT +CLASS="REPLACEABLE" +><I +>DIRECTORIES</I +></TT +></TT +></DT +><DD +><P +> <TT +CLASS="REPLACEABLE" +><I +>DIRECTORIES</I +></TT +> is a colon-separated list of + directories to search for libraries. You will probably have + to use this option (and the corresponding + <TT +CLASS="OPTION" +>--with-includes</TT +> option) if you have packages + installed in non-standard locations. + </P +><P +> Example: <TT +CLASS="LITERAL" +>--with-libraries=/opt/gnu/lib:/usr/sup/lib</TT +>. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--with-openssl</TT +> + </DT +><DD +><P +> Build with support for <ACRONYM +CLASS="ACRONYM" +>SSL</ACRONYM +> (encrypted) + connections. This requires the <SPAN +CLASS="PRODUCTNAME" +>OpenSSL</SPAN +> + package to be installed. <TT +CLASS="FILENAME" +>configure</TT +> will check + for the required header files and libraries to make sure that + your <SPAN +CLASS="PRODUCTNAME" +>OpenSSL</SPAN +> installation is sufficient + before proceeding. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--enable-debug</TT +></DT +><DD +><P +> Compiles all programs and libraries with debugging symbols. + This means that you can run the programs in a debugger + to analyze problems. This enlarges the size of the installed + executables considerably, and on non-GCC compilers it usually + also disables compiler optimization, causing slowdowns. However, + having the symbols available is extremely helpful for dealing + with any problems that might arise. Currently, this option is + recommended for production installations only if you use GCC. + But you should always have it on if you are doing development work + or running a beta version. + </P +></DD +><DT +><TT +CLASS="OPTION" +>--enable-profiling</TT +></DT +><DD +><P +> If using GCC, all programs and libraries are compiled so they + can be profiled. On backend exit, a subdirectory will be created + that contains the <TT +CLASS="FILENAME" +>gmon.out</TT +> file for use in profiling. + This option is for use only with GCC and when doing development work. + </P +></DD +></DL +></DIV +><P> + </P +><P +> If you prefer a C compiler different from the one + <TT +CLASS="FILENAME" +>configure</TT +> picks, you can set the + environment variable <TT +CLASS="ENVAR" +>CC</TT +> to the program of your choice. + By default, <TT +CLASS="FILENAME" +>configure</TT +> will pick + <TT +CLASS="FILENAME" +>gcc</TT +> if available, else the platform's + default (usually <TT +CLASS="FILENAME" +>cc</TT +>). Similarly, you can override the + default compiler flags if needed with the <TT +CLASS="ENVAR" +>CFLAGS</TT +> variable. + </P +><P +> You can specify environment variables on the + <TT +CLASS="FILENAME" +>configure</TT +> command line, for example: +</P><PRE +CLASS="SCREEN" +><KBD +CLASS="USERINPUT" +>./configure CC=/opt/bin/gcc CFLAGS='-O2 -pipe'</KBD +></PRE +><P> + </P +><P +> Here is a list of the significant variables that can be set in + this manner: + + <P +></P +></P><DIV +CLASS="VARIABLELIST" +><DL +><DT +><TT +CLASS="ENVAR" +>BISON</TT +></DT +><DD +><P +> Bison program + </P +></DD +><DT +><TT +CLASS="ENVAR" +>CC</TT +></DT +><DD +><P +> C compiler + </P +></DD +><DT +><TT +CLASS="ENVAR" +>CFLAGS</TT +></DT +><DD +><P +> options to pass to the C compiler + </P +></DD +><DT +><TT +CLASS="ENVAR" +>CPP</TT +></DT +><DD +><P +> C preprocessor + </P +></DD +><DT +><TT +CLASS="ENVAR" +>CPPFLAGS</TT +></DT +><DD +><P +> options to pass to the C preprocessor + </P +></DD +><DT +><TT +CLASS="ENVAR" +>DTRACE</TT +></DT +><DD +><P +> location of the <TT +CLASS="COMMAND" +>dtrace</TT +> program + </P +></DD +><DT +><TT +CLASS="ENVAR" +>DTRACEFLAGS</TT +></DT +><DD +><P +> options to pass to the <TT +CLASS="COMMAND" +>dtrace</TT +> program + </P +></DD +><DT +><TT +CLASS="ENVAR" +>FLEX</TT +></DT +><DD +><P +> Flex program + </P +></DD +><DT +><TT +CLASS="ENVAR" +>LDFLAGS</TT +></DT +><DD +><P +> options to use when linking either executables or shared libraries + </P +></DD +><DT +><TT +CLASS="ENVAR" +>LDFLAGS_EX</TT +></DT +><DD +><P +> additional options for linking executables only + </P +></DD +><DT +><TT +CLASS="ENVAR" +>LDFLAGS_SL</TT +></DT +><DD +><P +> additional options for linking shared libraries only + </P +></DD +><DT +><TT +CLASS="ENVAR" +>XML2_CONFIG</TT +></DT +><DD +><P +> <TT +CLASS="COMMAND" +>xml2-config</TT +> program used to locate the + libxml installation. + </P +></DD +></DL +></DIV +><P> + </P +><DIV +CLASS="NOTE" +><BLOCKQUOTE +CLASS="NOTE" +><P +><B +>Note: </B +> When developing code inside the server, it is recommended to + use the configure options <TT +CLASS="OPTION" +>--enable-cassert</TT +> (which + turns on many run-time error checks) and <TT +CLASS="OPTION" +>--enable-debug</TT +> + (which improves the usefulness of debugging tools). + </P +><P +> If using GCC, it is best to build with an optimization level of + at least <TT +CLASS="OPTION" +>-O1</TT +>, because using no optimization + (<TT +CLASS="OPTION" +>-O0</TT +>) disables some important compiler warnings (such + as the use of uninitialized variables). However, non-zero + optimization levels can complicate debugging because stepping + through compiled code will usually not match up one-to-one with + source code lines. If you get confused while trying to debug + optimized code, recompile the specific files of interest with + <TT +CLASS="OPTION" +>-O0</TT +>. An easy way to do this is by passing an option + to <SPAN +CLASS="APPLICATION" +>make</SPAN +>: <TT +CLASS="COMMAND" +>make PROFILE=-O0 file.o</TT +>. + </P +></BLOCKQUOTE +></DIV +></LI +><LI +CLASS="STEP" +><A +NAME="BUILD" +></A +><P +><B +>Build</B +></P +><P +> To start the build, type: +</P><PRE +CLASS="SCREEN" +><KBD +CLASS="USERINPUT" +>make</KBD +></PRE +><P> + (Remember to use <ACRONYM +CLASS="ACRONYM" +>GNU</ACRONYM +> <SPAN +CLASS="APPLICATION" +>make</SPAN +>.) The build + will take a few minutes depending on your + hardware. The last line displayed should be: +</P><PRE +CLASS="SCREEN" +>All of PostgreSQL is successfully made. Ready to install.</PRE +><P> + </P +><P +> If you want to build everything that can be built, including the + documentation (HTML and man pages), and the additional modules + (<TT +CLASS="FILENAME" +>contrib</TT +>), type instead: +</P><PRE +CLASS="SCREEN" +><KBD +CLASS="USERINPUT" +>make world</KBD +></PRE +><P> + The last line displayed should be: +</P><PRE +CLASS="SCREEN" +>PostgreSQL, contrib and HTML documentation successfully made. Ready to install.</PRE +><P> + </P +></LI +><LI +CLASS="STEP" +><P +><B +>Regression Tests</B +></P +><P +> Description about the regression test... + </P +></LI +><LI +CLASS="STEP" +><A +NAME="INSTALL" +></A +><P +><B +>Installing the Files</B +></P +><P +> To install <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> enter: +</P><PRE +CLASS="SCREEN" +><KBD +CLASS="USERINPUT" +>make install</KBD +></PRE +><P> + This will install files into the directories that were specified + in <A +HREF="install-procedure.html#CONFIGURE" +>step 1</A +>. Make sure that you have appropriate + permissions to write into that area. Normally you need to do this + step as root. Alternatively, you can create the target + directories in advance and arrange for appropriate permissions to + be granted. + </P +><P +> To install the documentation (HTML and man pages), enter: +</P><PRE +CLASS="SCREEN" +><KBD +CLASS="USERINPUT" +>make install-docs</KBD +></PRE +><P> + </P +><P +> If you built the world above, type instead: +</P><PRE +CLASS="SCREEN" +><KBD +CLASS="USERINPUT" +>make install-world</KBD +></PRE +><P> + This also installs the documentation. + </P +><P +> You can use <TT +CLASS="LITERAL" +>make install-strip</TT +> instead of + <TT +CLASS="LITERAL" +>make install</TT +> to strip the executable files and + libraries as they are installed. This will save some space. If + you built with debugging support, stripping will effectively + remove the debugging support, so it should only be done if + debugging is no longer needed. <TT +CLASS="LITERAL" +>install-strip</TT +> + tries to do a reasonable job saving space, but it does not have + perfect knowledge of how to strip every unneeded byte from an + executable file, so if you want to save all the disk space you + possibly can, you will have to do manual work. + </P +><P +> The standard installation provides all the header files needed for client + application development as well as for server-side program + development, such as custom functions or data types written in C. + (Prior to <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> 8.0, a separate <TT +CLASS="LITERAL" +>make + install-all-headers</TT +> command was needed for the latter, but this + step has been folded into the standard install.) + </P +><DIV +CLASS="FORMALPARA" +><P +><B +>Client-only installation: </B +> If you want to install only the client applications and + interface libraries, then you can use these commands: +</P><PRE +CLASS="SCREEN" +><KBD +CLASS="USERINPUT" +>make -C src/bin install</KBD +> +<KBD +CLASS="USERINPUT" +>make -C src/include install</KBD +> +<KBD +CLASS="USERINPUT" +>make -C src/interfaces install</KBD +> +<KBD +CLASS="USERINPUT" +>make -C doc install</KBD +></PRE +><P> + <TT +CLASS="FILENAME" +>src/bin</TT +> has a few binaries for server-only use, + but they are small. + </P +></DIV +></LI +></OL +></DIV +><DIV +CLASS="FORMALPARA" +><P +><B +>Uninstallation: </B +> To undo the installation use the command <TT +CLASS="COMMAND" +>make + uninstall</TT +>. However, this will not remove any created directories. + </P +></DIV +><DIV +CLASS="FORMALPARA" +><P +><B +>Cleaning: </B +> After the installation you can free disk space by removing the built + files from the source tree with the command <TT +CLASS="COMMAND" +>make + clean</TT +>. This will preserve the files made by the <TT +CLASS="COMMAND" +>configure</TT +> + program, so that you can rebuild everything with <TT +CLASS="COMMAND" +>make</TT +> + later on. To reset the source tree to the state in which it was + distributed, use <TT +CLASS="COMMAND" +>make distclean</TT +>. If you are going to + build for several platforms within the same source tree you must do + this and re-configure for each platform. (Alternatively, use + a separate build tree for each platform, so that the source tree + remains unmodified.) + </P +></DIV +><P +> If you perform a build and then discover that your <TT +CLASS="COMMAND" +>configure</TT +> + options were wrong, or if you change anything that <TT +CLASS="COMMAND" +>configure</TT +> + investigates (for example, software upgrades), then it's a good + idea to do <TT +CLASS="COMMAND" +>make distclean</TT +> before reconfiguring and + rebuilding. Without this, your changes in configuration choices + might not propagate everywhere they need to. + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="install-getsource.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="install-post.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Getting The Source</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Post-Installation Setup</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/install-requirements.html b/doc/src/sgml/html/install-requirements.html new file mode 100644 index 000000000..ef6af518a --- /dev/null +++ b/doc/src/sgml/html/install-requirements.html @@ -0,0 +1,169 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Requirements</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="pgpool-IIInstallation from Source Code" +HREF="installation.html"><LINK +REL="PREVIOUS" +TITLE="Short Version" +HREF="install-short.html"><LINK +REL="NEXT" +TITLE="Getting The Source" +HREF="install-getsource.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Short Version" +HREF="install-short.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Chapter 2. <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Getting The Source" +HREF="install-getsource.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="INSTALL-REQUIREMENTS" +>2.2. Requirements</A +></H1 +><P +> Blah... + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="install-short.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="install-getsource.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Short Version</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Getting The Source</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/install-short.html b/doc/src/sgml/html/install-short.html new file mode 100644 index 000000000..d43bd4013 --- /dev/null +++ b/doc/src/sgml/html/install-short.html @@ -0,0 +1,187 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Short Version</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="pgpool-IIInstallation from Source Code" +HREF="installation.html"><LINK +REL="PREVIOUS" +TITLE="pgpool-IIInstallation from Source Code" +HREF="installation.html"><LINK +REL="NEXT" +TITLE="Requirements" +HREF="install-requirements.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="pgpool-IIInstallation from Source Code" +HREF="installation.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Chapter 2. <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Requirements" +HREF="install-requirements.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="INSTALL-SHORT" +>2.1. Short Version</A +></H1 +><P +></P><PRE +CLASS="SYNOPSIS" +>./configure +make +su +make install +adduser postgres +mkdir /usr/local/pgsql/data +chown postgres /usr/local/pgsql/data +su - postgres +/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data +/usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data &gt;logfile 2&gt;&amp;1 &amp; +/usr/local/pgsql/bin/createdb test +/usr/local/pgsql/bin/psql test</PRE +><P> + The long version is the rest of this chapter. + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="install-requirements.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Requirements</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/installation-platform-notes.html b/doc/src/sgml/html/installation-platform-notes.html new file mode 100644 index 000000000..06c421410 --- /dev/null +++ b/doc/src/sgml/html/installation-platform-notes.html @@ -0,0 +1,177 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Platform-specific Notes</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="pgpool-IIInstallation from Source Code" +HREF="installation.html"><LINK +REL="PREVIOUS" +TITLE="Supported Platforms" +HREF="supported-platforms.html"><LINK +REL="NEXT" +TITLE="Reference" +HREF="reference.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Supported Platforms" +HREF="supported-platforms.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Chapter 2. <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Reference" +HREF="reference.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="INSTALLATION-PLATFORM-NOTES" +>2.7. Platform-specific Notes</A +></H1 +><P +> This section documents additional platform-specific issues + regarding the installation and setup of <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>. + </P +><P +> Platforms that are not covered here have no known platform-specific + installation issues. + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="supported-platforms.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="reference.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Supported Platforms</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Reference</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/installation.html b/doc/src/sgml/html/installation.html new file mode 100644 index 000000000..1f82d1b3e --- /dev/null +++ b/doc/src/sgml/html/installation.html @@ -0,0 +1,226 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>pgpool-IIInstallation from Source Code</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="Server Administration" +HREF="admin.html"><LINK +REL="PREVIOUS" +TITLE="Server Administration" +HREF="admin.html"><LINK +REL="NEXT" +TITLE="Short Version" +HREF="install-short.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="CHAPTER" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Server Administration" +HREF="admin.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="admin.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Short Version" +HREF="install-short.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="CHAPTER" +><H1 +><A +NAME="INSTALLATION" +></A +>Chapter 2. <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</H1 +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +>2.1. <A +HREF="install-short.html" +>Short Version</A +></DT +><DT +>2.2. <A +HREF="install-requirements.html" +>Requirements</A +></DT +><DT +>2.3. <A +HREF="install-getsource.html" +>Getting The Source</A +></DT +><DT +>2.4. <A +HREF="install-procedure.html" +>Installation Procedure</A +></DT +><DT +>2.5. <A +HREF="install-post.html" +>Post-Installation Setup</A +></DT +><DD +><DL +><DT +>2.5.1. <A +HREF="install-post.html#AEN453" +>Shared Libraries</A +></DT +><DT +>2.5.2. <A +HREF="install-post.html#AEN504" +>Environment Variables</A +></DT +></DL +></DD +><DT +>2.6. <A +HREF="supported-platforms.html" +>Supported Platforms</A +></DT +><DT +>2.7. <A +HREF="installation-platform-notes.html" +>Platform-specific Notes</A +></DT +></DL +></DIV +><P +> Blah blah... + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="admin.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="install-short.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Server Administration</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="admin.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Short Version</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/intro-whatis.html b/doc/src/sgml/html/intro-whatis.html new file mode 100644 index 000000000..e06a45b68 --- /dev/null +++ b/doc/src/sgml/html/intro-whatis.html @@ -0,0 +1,175 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +> What is pgpool-II?</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="Preface" +HREF="preface.html"><LINK +REL="PREVIOUS" +TITLE="Preface" +HREF="preface.html"><LINK +REL="NEXT" +TITLE="A Brief History of pgpool-II" +HREF="history.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Preface" +HREF="preface.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Preface</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="A Brief History of pgpool-II" +HREF="history.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="INTRO-WHATIS" +>What is <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>?</A +></H1 +><P +> <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> is .... + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="history.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Preface</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>A Brief History of <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +></TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/notation.html b/doc/src/sgml/html/notation.html new file mode 100644 index 000000000..3b60a3fe8 --- /dev/null +++ b/doc/src/sgml/html/notation.html @@ -0,0 +1,225 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Conventions</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="Preface" +HREF="preface.html"><LINK +REL="PREVIOUS" +TITLE="A Brief History of pgpool-II" +HREF="history.html"><LINK +REL="NEXT" +TITLE="Further Information" +HREF="resources.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="A Brief History of pgpool-II" +HREF="history.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Preface</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Further Information" +HREF="resources.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="NOTATION" +>Conventions</A +></H1 +><P +> The following conventions are used in the synopsis of a command: + brackets (<TT +CLASS="LITERAL" +>[</TT +> and <TT +CLASS="LITERAL" +>]</TT +>) indicate + optional parts. (In the synopsis of a Tcl command, question marks + (<TT +CLASS="LITERAL" +>?</TT +>) are used instead, as is usual in Tcl.) Braces + (<TT +CLASS="LITERAL" +>{</TT +> and <TT +CLASS="LITERAL" +>}</TT +>) and vertical lines + (<TT +CLASS="LITERAL" +>|</TT +>) indicate that you must choose one + alternative. Dots (<TT +CLASS="LITERAL" +>...</TT +>) mean that the preceding element + can be repeated. + </P +><P +> Where it enhances the clarity, SQL commands are preceded by the + prompt <TT +CLASS="LITERAL" +>=&gt;</TT +>, and shell commands are preceded by the + prompt <TT +CLASS="LITERAL" +>$</TT +>. Normally, prompts are not shown, though. + </P +><P +> An <I +CLASS="FIRSTTERM" +>administrator</I +> is generally a person who is + in charge of installing and running the server. A <I +CLASS="FIRSTTERM" +>user</I +> + could be anyone who is using, or wants to use, any part of the + <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> system. These terms should not + be interpreted too narrowly; this book does not have fixed + presumptions about system administration procedures. + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="history.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="resources.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>A Brief History of <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Further Information</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/pcp-commands.html b/doc/src/sgml/html/pcp-commands.html new file mode 100644 index 000000000..2d04a2808 --- /dev/null +++ b/doc/src/sgml/html/pcp-commands.html @@ -0,0 +1,189 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>PCP commands</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="Reference" +HREF="reference.html"><LINK +REL="PREVIOUS" +TITLE="Reference" +HREF="reference.html"><LINK +REL="NEXT" +TITLE="pcp_node_count" +HREF="pcp-node-count.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="REFERENCE" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Reference" +HREF="reference.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="reference.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="pcp_node_count" +HREF="pcp-node-count.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="REFERENCE" +><A +NAME="PCP-COMMANDS" +></A +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +>I. PCP commands</H1 +><DIV +CLASS="PARTINTRO" +><A +NAME="AEN563" +></A +><P +> This part contains reference information for pcp commands... + </P +></DIV +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +><A +HREF="pcp-node-count.html" +>pcp_node_count</A +>&nbsp;--&nbsp; displays the total number of database nodes</DT +></DL +></DIV +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="reference.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="pcp-node-count.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Reference</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="reference.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>pcp_node_count</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/pcp-node-count.html b/doc/src/sgml/html/pcp-node-count.html new file mode 100644 index 000000000..5de2da04a --- /dev/null +++ b/doc/src/sgml/html/pcp-node-count.html @@ -0,0 +1,294 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>pcp_node_count</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="PCP commands" +HREF="pcp-commands.html"><LINK +REL="PREVIOUS" +TITLE="PCP commands" +HREF="pcp-commands.html"><LINK +REL="NEXT" +TITLE="Bibliography" +HREF="biblio.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="REFENTRY" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="PCP commands" +HREF="pcp-commands.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="pcp-commands.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Bibliography" +HREF="biblio.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><H1 +><A +NAME="PCP-NODE-COUNT" +></A +>pcp_node_count</H1 +><DIV +CLASS="REFNAMEDIV" +><A +NAME="AEN572" +></A +><H2 +>Name</H2 +>pcp_node_count&nbsp;--&nbsp; displays the total number of database nodes</DIV +><DIV +CLASS="REFSYNOPSISDIV" +><A +NAME="AEN575" +></A +><H2 +>Synopsis</H2 +><P +><TT +CLASS="COMMAND" +>pcp_node_count</TT +> [<TT +CLASS="REPLACEABLE" +><I +>option</I +></TT +>...] [<TT +CLASS="OPTION" +>--pgdata</TT +> | <TT +CLASS="OPTION" +>-D</TT +>]<TT +CLASS="REPLACEABLE" +><I +> directory</I +></TT +> </P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="R1-PCP-NODE-COUNT-1" +></A +><H2 +> Description + </H2 +><P +> <TT +CLASS="COMMAND" +>pcp_node_count</TT +> + displays the total number of database nodes defined in <TT +CLASS="FILENAME" +>pgpool.conf</TT +>. It does + not distinguish between nodes status, ie attached/detached. ALL nodes are counted. + </P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN592" +></A +><H2 +>Options</H2 +><P +> <P +></P +></P><DIV +CLASS="VARIABLELIST" +><DL +><DT +><TT +CLASS="OPTION" +>-h <TT +CLASS="REPLACEABLE" +><I +>hostname</I +></TT +></TT +><BR><TT +CLASS="OPTION" +>--host=<TT +CLASS="REPLACEABLE" +><I +>hostname</I +></TT +></TT +></DT +><DD +><P +> The host name of the machine on which the server is running. If the + value begins with a slash, it is used as the directory for the Unix-domain socket. + </P +></DD +></DL +></DIV +><P> + </P +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN605" +></A +><H2 +>Environment</H2 +><P +></P +><DIV +CLASS="VARIABLELIST" +><DL +><DT +><TT +CLASS="ENVAR" +>PCPPASSFILE</TT +></DT +><DD +><P +> Specifies the path to pcp password file. + </P +></DD +></DL +></DIV +></DIV +><DIV +CLASS="REFSECT1" +><A +NAME="AEN613" +></A +><H2 +>Notes</H2 +><P +> Notes... + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="pcp-commands.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="biblio.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>PCP commands</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="pcp-commands.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Bibliography</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/preface.html b/doc/src/sgml/html/preface.html new file mode 100644 index 000000000..722eeb263 --- /dev/null +++ b/doc/src/sgml/html/preface.html @@ -0,0 +1,271 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Preface</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="NEXT" +TITLE=" What is pgpool-II?" +HREF="intro-whatis.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="PREFACE" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE=" What is pgpool-II?" +HREF="intro-whatis.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="PREFACE" +><H1 +><A +NAME="PREFACE" +></A +>Preface</H1 +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +><A +HREF="intro-whatis.html" +>What is <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>?</A +></DT +><DT +><A +HREF="history.html" +>A Brief History of <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +></A +></DT +><DT +><A +HREF="notation.html" +>Conventions</A +></DT +><DT +><A +HREF="resources.html" +>Further Information</A +></DT +><DT +><A +HREF="bug-reporting.html" +>Bug Reporting Guidelines</A +></DT +></DL +></DIV +><P +> This book is the official documentation of + <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>. It has been written by the + <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> developers and other + volunteers in parallel to the development of the + <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> software. It describes all + the functionality that the current version of + <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> officially supports. + </P +><P +> To make the large amount of information about + <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> manageable, this book has been + organized in several parts. Each part is targeted at a different + class of users, or at users in different stages of their + <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> experience: + + <P +></P +></P><UL +><LI +><P +> <A +HREF="tutorial.html" +>Part I</A +> is an informal introduction for new users. + </P +></LI +><LI +><P +> <A +HREF="admin.html" +>Part II</A +> describes the installation and + administration of the server. Everyone who runs a + <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> server, be it for private + use or for others, should read this part. + </P +></LI +><LI +><P +> <A +HREF="reference.html" +>Part III</A +> contains reference information about + SQL commands, client and server programs. This part supports + the other parts with structured information sorted by command or + program. + </P +></LI +></UL +><P> + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="intro-whatis.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>pgpool-II 3.5.0 Documentation</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +>&nbsp;</TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>What is <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>?</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/reference.html b/doc/src/sgml/html/reference.html new file mode 100644 index 000000000..b80b13e32 --- /dev/null +++ b/doc/src/sgml/html/reference.html @@ -0,0 +1,198 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Reference</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Platform-specific Notes" +HREF="installation-platform-notes.html"><LINK +REL="NEXT" +TITLE="PCP commands" +HREF="pcp-commands.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="PART" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Platform-specific Notes" +HREF="installation-platform-notes.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="PCP commands" +HREF="pcp-commands.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="PART" +><A +NAME="REFERENCE" +></A +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +>III. Reference</H1 +><DIV +CLASS="PARTINTRO" +><A +NAME="AEN557" +></A +><P +> About pgool-II reference... + </P +><P +> The reference entries are also available as traditional + <SPAN +CLASS="QUOTE" +>"man"</SPAN +> pages. + </P +></DIV +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +>I. <A +HREF="pcp-commands.html" +>PCP commands</A +></DT +><DD +><DL +><DT +><A +HREF="pcp-node-count.html" +>pcp_node_count</A +>&nbsp;--&nbsp; displays the total number of database nodes</DT +></DL +></DD +></DL +></DIV +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="installation-platform-notes.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="pcp-commands.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Platform-specific Notes</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +>&nbsp;</TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>PCP commands</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/resources.html b/doc/src/sgml/html/resources.html new file mode 100644 index 000000000..f8a930d6b --- /dev/null +++ b/doc/src/sgml/html/resources.html @@ -0,0 +1,228 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Further Information</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="Preface" +HREF="preface.html"><LINK +REL="PREVIOUS" +TITLE="Conventions" +HREF="notation.html"><LINK +REL="NEXT" +TITLE="Bug Reporting Guidelines" +HREF="bug-reporting.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Conventions" +HREF="notation.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Preface</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Bug Reporting Guidelines" +HREF="bug-reporting.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="RESOURCES" +>Further Information</A +></H1 +><P +> Besides the documentation, that is, this book, there are other + resources about <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>: + + <P +></P +></P><DIV +CLASS="VARIABLELIST" +><DL +><DT +>Web Site</DT +><DD +><P +> The <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> + <A +HREF="http://pgpool.net" +TARGET="_top" +>web site</A +>... + </P +></DD +><DT +>Mailing Lists</DT +><DD +><P +> The mailing lists are a good place to have your questions + answered, to share experiences with other users, and to contact + the developers. Consult the <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> web site + for details. + </P +></DD +><DT +>Yourself!</DT +><DD +><P +> <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +> is an open-source project. + As such, it depends on the user community for ongoing support. + As you begin to use <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +>, you + will rely on others for help, either through the documentation + or through the mailing lists. Consider contributing your + knowledge back. Read the mailing lists and answer questions. If + you learn something which is not in the documentation, write it + up and contribute it. If you add features to the code, + contribute them. + </P +></DD +></DL +></DIV +><P> + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="notation.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="bug-reporting.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Conventions</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="preface.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Bug Reporting Guidelines</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/stylesheet.css b/doc/src/sgml/html/stylesheet.css new file mode 100644 index 000000000..60dcc7620 --- /dev/null +++ b/doc/src/sgml/html/stylesheet.css @@ -0,0 +1,98 @@ +/* doc/src/sgml/stylesheet.css */ + +/* color scheme similar to www.postgresql.org */ + +BODY { + color: #000000; + background: #FFFFFF; + font-family: verdana, sans-serif; +} + +A:link { color:#0066A2; } +A:visited { color:#004E66; } +A:active { color:#0066A2; } +A:hover { color:#000000; } + +H1 { + font-size: 1.4em; + font-weight: bold; + margin-top: 0em; + margin-bottom: 0em; + color: #EC5800; +} + +H2 { + font-size: 1.2em; + margin: 1.2em 0em 1.2em 0em; + font-weight: bold; + color: #666; +} + +H3 { + font-size: 1.1em; + margin: 1.2em 0em 1.2em 0em; + font-weight: bold; + color: #666; +} + +H4 { + font-size: 0.95em; + margin: 1.2em 0em 1.2em 0em; + font-weight: normal; + color: #666; +} + +H5 { + font-size: 0.9em; + margin: 1.2em 0em 1.2em 0em; + font-weight: normal; +} + +H6 { + font-size: 0.85em; + margin: 1.2em 0em 1.2em 0em; + font-weight: normal; +} + +/* center some titles */ + +.BOOK .TITLE, .BOOK .CORPAUTHOR, .BOOK .COPYRIGHT { + text-align: center; +} + +/* decoration for formal examples */ + +DIV.EXAMPLE { + padding-left: 15px; + border-style: solid; + border-width: 0px; + border-left-width: 2px; + border-color: black; + margin: 0.5ex; +} + +/* less dense spacing of TOC */ + +.BOOK .TOC DL DT { + padding-top: 1.5ex; + padding-bottom: 1.5ex; +} + +.BOOK .TOC DL DL DT { + padding-top: 0ex; + padding-bottom: 0ex; +} + +/* miscellaneous */ + +PRE.LITERALLAYOUT, .SCREEN, .SYNOPSIS, .PROGRAMLISTING { + margin-left: 4ex; +} + +.COMMENT { color: red; } + +VAR { font-family: monospace; font-style: italic; } +/* Konqueror's standard style for ACRONYM is italic. */ +ACRONYM { font-style: inherit; } + +.OPTION { white-space: nowrap; } diff --git a/doc/src/sgml/html/supported-platforms.html b/doc/src/sgml/html/supported-platforms.html new file mode 100644 index 000000000..4accdc25e --- /dev/null +++ b/doc/src/sgml/html/supported-platforms.html @@ -0,0 +1,244 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Supported Platforms</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="pgpool-IIInstallation from Source Code" +HREF="installation.html"><LINK +REL="PREVIOUS" +TITLE="Post-Installation Setup" +HREF="install-post.html"><LINK +REL="NEXT" +TITLE="Platform-specific Notes" +HREF="installation-platform-notes.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Post-Installation Setup" +HREF="install-post.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Chapter 2. <SPAN +CLASS="PRODUCTNAME" +>pgpool-II</SPAN +>Installation from Source Code</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Platform-specific Notes" +HREF="installation-platform-notes.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="SUPPORTED-PLATFORMS" +>2.6. Supported Platforms</A +></H1 +><P +> A platform (that is, a CPU architecture and operating system combination) + is considered supported by the <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> development + community if the code contains provisions to work on that platform and + it has recently been verified to build and pass its regression tests + on that platform. Currently, most testing of platform compatibility + is done automatically by test machines in the + <A +HREF="http://buildfarm.postgresql.org/" +TARGET="_top" +>PostgreSQL Build Farm</A +>. + If you are interested in using <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> on a platform + that is not represented in the build farm, but on which the code works + or can be made to work, you are strongly encouraged to set up a build + farm member machine so that continued compatibility can be assured. + </P +><P +> In general, <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> can be expected to work on + these CPU architectures: x86, x86_64, IA64, PowerPC, + PowerPC 64, S/390, S/390x, Sparc, Sparc 64, ARM, MIPS, MIPSEL, M68K, + and PA-RISC. Code support exists for M32R and VAX, but these + architectures are not known to have been tested recently. It is often + possible to build on an unsupported CPU type by configuring with + <TT +CLASS="OPTION" +>--disable-spinlocks</TT +>, but performance will be poor. + </P +><P +> <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> can be expected to work on these operating + systems: Linux (all recent distributions), Windows (Win2000 SP4 and later), + FreeBSD, OpenBSD, NetBSD, OS X, AIX, HP/UX, Solaris, + and UnixWare. Other Unix-like systems may also work but are not currently + being tested. In most cases, all CPU architectures supported by + a given operating system will work. Look in + the <A +HREF="installation-platform-notes.html" +>Section 2.7</A +> below to see if + there is information + specific to your operating system, particularly if using an older system. + </P +><P +> If you have installation problems on a platform that is known + to be supported according to recent build farm results, please report + it to <CODE +CLASS="EMAIL" +>&#60;<A +HREF="mailto:pgsql-bugs@postgresql.org" +>pgsql-bugs@postgresql.org</A +>&#62;</CODE +>. If you are interested + in porting <SPAN +CLASS="PRODUCTNAME" +>PostgreSQL</SPAN +> to a new platform, + <CODE +CLASS="EMAIL" +>&#60;<A +HREF="mailto:pgsql-hackers@postgresql.org" +>pgsql-hackers@postgresql.org</A +>&#62;</CODE +> is the appropriate place + to discuss that. + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="install-post.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="installation-platform-notes.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Post-Installation Setup</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="installation.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Platform-specific Notes</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/tutorial-install.html b/doc/src/sgml/html/tutorial-install.html new file mode 100644 index 000000000..c532c828c --- /dev/null +++ b/doc/src/sgml/html/tutorial-install.html @@ -0,0 +1,166 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Installation</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="Getting Started" +HREF="tutorial-start.html"><LINK +REL="PREVIOUS" +TITLE="Getting Started" +HREF="tutorial-start.html"><LINK +REL="NEXT" +TITLE="Server Administration" +HREF="admin.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="SECT1" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Getting Started" +HREF="tutorial-start.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="tutorial-start.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +>Chapter 1. Getting Started</TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Server Administration" +HREF="admin.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="TUTORIAL-INSTALL" +>1.1. Installation</A +></H1 +><P +> How to install... + </P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="tutorial-start.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="admin.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Getting Started</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="tutorial-start.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Server Administration</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/tutorial-start.html b/doc/src/sgml/html/tutorial-start.html new file mode 100644 index 000000000..c6c2fa67a --- /dev/null +++ b/doc/src/sgml/html/tutorial-start.html @@ -0,0 +1,162 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Getting Started</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="Tutorial" +HREF="tutorial.html"><LINK +REL="PREVIOUS" +TITLE="Tutorial" +HREF="tutorial.html"><LINK +REL="NEXT" +TITLE="Installation" +HREF="tutorial-install.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="CHAPTER" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Tutorial" +HREF="tutorial.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="tutorial.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Installation" +HREF="tutorial-install.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="CHAPTER" +><H1 +><A +NAME="TUTORIAL-START" +></A +>Chapter 1. Getting Started</H1 +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="tutorial.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="tutorial-install.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Tutorial</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="tutorial.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Installation</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/html/tutorial.html b/doc/src/sgml/html/tutorial.html new file mode 100644 index 000000000..d3d740915 --- /dev/null +++ b/doc/src/sgml/html/tutorial.html @@ -0,0 +1,191 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML +><HEAD +><TITLE +>Tutorial</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +REV="MADE" +HREF="mailto:pgsql-docs@postgresql.org"><LINK +REL="HOME" +TITLE="pgpool-II 3.5.0 Documentation" +HREF="index.html"><LINK +REL="PREVIOUS" +TITLE="Bug Reporting Guidelines" +HREF="bug-reporting.html"><LINK +REL="NEXT" +TITLE="Getting Started" +HREF="tutorial-start.html"><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="stylesheet.css"><META +HTTP-EQUIV="Content-Type" +CONTENT="text/html; charset=ISO-8859-1"><META +NAME="creation" +CONTENT="2016-03-15T07:35:30"></HEAD +><BODY +CLASS="PART" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="4" +ALIGN="center" +VALIGN="bottom" +><A +HREF="index.html" +>pgpool-II 3.5.0 Documentation</A +></TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +TITLE="Bug Reporting Guidelines" +HREF="bug-reporting.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="60%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="20%" +ALIGN="right" +VALIGN="top" +><A +TITLE="Getting Started" +HREF="tutorial-start.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="PART" +><A +NAME="TUTORIAL" +></A +><DIV +CLASS="TITLEPAGE" +><H1 +CLASS="TITLE" +>I. Tutorial</H1 +><DIV +CLASS="PARTINTRO" +><A +NAME="AEN99" +></A +><P +> Explanation about pgpool-II tutorial here... + </P +></DIV +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +>1. <A +HREF="tutorial-start.html" +>Getting Started</A +></DT +><DD +><DL +><DT +>1.1. <A +HREF="tutorial-install.html" +>Installation</A +></DT +></DL +></DD +></DL +></DIV +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="bug-reporting.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="tutorial-start.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Bug Reporting Guidelines</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +>&nbsp;</TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Getting Started</TD +></TR +></TABLE +></DIV +></BODY +></HTML +> \ No newline at end of file diff --git a/doc/src/sgml/info.sgml b/doc/src/sgml/info.sgml new file mode 100644 index 000000000..eeeedb9f9 --- /dev/null +++ b/doc/src/sgml/info.sgml @@ -0,0 +1,68 @@ +<!-- doc/src/sgml/info.sgml --> + +<sect1 id="resources"> + <title>Further Information</title> + + <para> + Besides the documentation, that is, this book, there are other + resources about <productname>pgpool-II</productname>: + + <variablelist> + +<!-- + <varlistentry> + <term>Wiki</term> + <listitem> + <para> + The <productname>PostgreSQL</productname> <ulink + url="http://wiki.postgresql.org">wiki</ulink> contains the project's <ulink + url="http://wiki.postgresql.org/wiki/Frequently_Asked_Questions">FAQ</> + (Frequently Asked Questions) list, <ulink + url="http://wiki.postgresql.org/wiki/Todo">TODO</> list, and + detailed information about many more topics. + </para> + </listitem> + </varlistentry> +--> + + <varlistentry> + <term>Web Site</term> + <listitem> + <para> + The <productname>pgpool-II</productname> + <ulink url="http://pgpool.net">web site</ulink>... + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Mailing Lists</term> + <listitem> + <para> + The mailing lists are a good place to have your questions + answered, to share experiences with other users, and to contact + the developers. Consult the <productname>pgpool-II</> web site + for details. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Yourself!</term> + <listitem> + <para> + <productname>pgpool-II</productname> is an open-source project. + As such, it depends on the user community for ongoing support. + As you begin to use <productname>PostgreSQL</productname>, you + will rely on others for help, either through the documentation + or through the mailing lists. Consider contributing your + knowledge back. Read the mailing lists and answer questions. If + you learn something which is not in the documentation, write it + up and contribute it. If you add features to the code, + contribute them. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> +</sect1> diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml new file mode 100644 index 000000000..0618c2f75 --- /dev/null +++ b/doc/src/sgml/installation.sgml @@ -0,0 +1,1033 @@ +<!-- doc/src/sgml/installation.sgml --> +<!-- + +Use </link> not just </> so INSTALL.html can be created without links +to the main documentation. Don't use <xref>; or if you must, wrap it +in a standalone-ignore clause. + +--> + +<chapter id="installation"> + <title><productname>pgpool-II</productname>Installation from Source Code</title> + + <indexterm zone="installation"> + <primary>installation</primary> + </indexterm> + + <para> + Blah blah... + </para> + + <sect1 id="install-short"> + <title>Short Version</title> + + <para> +<synopsis> +./configure +make +su +make install +adduser postgres +mkdir /usr/local/pgsql/data +chown postgres /usr/local/pgsql/data +su - postgres +/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data +/usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data &gt;logfile 2&gt;&amp;1 &amp; +/usr/local/pgsql/bin/createdb test +/usr/local/pgsql/bin/psql test +</synopsis> + The long version is the rest of this chapter. + </para> + </sect1> + + + <sect1 id="install-requirements"> + <title>Requirements</title> + + <para> + Blah... + </para> + </sect1> + + <sect1 id="install-getsource"> + <title>Getting The Source</title> + + <para> + Blah... + </para> + </sect1> + + <sect1 id="install-procedure"> + <title>Installation Procedure</title> + + <procedure> + + <step id="configure"> + <title>Configuration</title> + + <indexterm zone="configure"> + <primary>configure</primary> + </indexterm> + + <para> + The first step of the installation procedure is to configure the + source tree for your system and choose the options you would like. + This is done by running the <filename>configure</> script. For a + default installation simply enter: +<screen> +<userinput>./configure</userinput> +</screen> + This script will run a number of tests to determine values for various + system dependent variables and detect any quirks of your + operating system, and finally will create several files in the + build tree to record what it found. You can also run + <filename>configure</filename> in a directory outside the source + tree, if you want to keep the build directory separate. This + procedure is also called a + <indexterm><primary>VPATH</primary></indexterm><firstterm>VPATH</firstterm> + build. Here's how: +<screen> +<userinput>mkdir build_dir</userinput> +<userinput>cd build_dir</userinput> +<userinput>/path/to/source/tree/configure [options go here]</userinput> +<userinput>make</userinput> +</screen> + </para> + + <para> + The default configuration will build the server and utilities, as + well as all client applications and interfaces that require only a + C compiler. All files will be installed under + <filename>/usr/local/pgsql</> by default. + </para> + + <para> + You can customize the build and installation process by supplying one + or more of the following command line options to + <filename>configure</filename>: + + <variablelist> + <varlistentry> + <term><option>--prefix=<replaceable>PREFIX</></option></term> + <listitem> + <para> + Install all files under the directory <replaceable>PREFIX</> + instead of <filename>/usr/local/pgsql</filename>. The actual + files will be installed into various subdirectories; no files + will ever be installed directly into the + <replaceable>PREFIX</> directory. + </para> + + <para> + If you have special needs, you can also customize the + individual subdirectories with the following options. However, + if you leave these with their defaults, the installation will be + relocatable, meaning you can move the directory after + installation. (The <literal>man</> and <literal>doc</> + locations are not affected by this.) + </para> + + <para> + For relocatable installs, you might want to use + <filename>configure</filename>'s <literal>--disable-rpath</> + option. Also, you will need to tell the operating system how + to find the shared libraries. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--exec-prefix=<replaceable>EXEC-PREFIX</></option></term> + <listitem> + <para> + You can install architecture-dependent files under a + different prefix, <replaceable>EXEC-PREFIX</>, than what + <replaceable>PREFIX</> was set to. This can be useful to + share architecture-independent files between hosts. If you + omit this, then <replaceable>EXEC-PREFIX</> is set equal to + <replaceable>PREFIX</> and both architecture-dependent and + independent files will be installed under the same tree, + which is probably what you want. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--bindir=<replaceable>DIRECTORY</></option></term> + <listitem> + <para> + Specifies the directory for executable programs. The default + is <filename><replaceable>EXEC-PREFIX</>/bin</>, which + normally means <filename>/usr/local/pgsql/bin</>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--sysconfdir=<replaceable>DIRECTORY</></option></term> + <listitem> + <para> + Sets the directory for various configuration files, + <filename><replaceable>PREFIX</>/etc</> by default. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--libdir=<replaceable>DIRECTORY</></option></term> + <listitem> + <para> + Sets the location to install libraries and dynamically loadable + modules. The default is + <filename><replaceable>EXEC-PREFIX</>/lib</>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--includedir=<replaceable>DIRECTORY</></option></term> + <listitem> + <para> + Sets the directory for installing C and C++ header files. The + default is <filename><replaceable>PREFIX</>/include</>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--datarootdir=<replaceable>DIRECTORY</></option></term> + <listitem> + <para> + Sets the root directory for various types of read-only data + files. This only sets the default for some of the following + options. The default is + <filename><replaceable>PREFIX</>/share</>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--datadir=<replaceable>DIRECTORY</></option></term> + <listitem> + <para> + Sets the directory for read-only data files used by the + installed programs. The default is + <filename><replaceable>DATAROOTDIR</></>. Note that this has + nothing to do with where your database files will be placed. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--mandir=<replaceable>DIRECTORY</></option></term> + <listitem> + <para> + The man pages that come with <productname>PostgreSQL</> will be installed under + this directory, in their respective + <filename>man<replaceable>x</></> subdirectories. + The default is <filename><replaceable>DATAROOTDIR</>/man</>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--docdir=<replaceable>DIRECTORY</></option></term> + <listitem> + <para> + Sets the root directory for installing documentation files, + except <quote>man</> pages. This only sets the default for + the following options. The default value for this option is + <filename><replaceable>DATAROOTDIR</>/doc/postgresql</>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--htmldir=<replaceable>DIRECTORY</></option></term> + <listitem> + <para> + The HTML-formatted documentation for + <productname>PostgreSQL</productname> will be installed under + this directory. The default is + <filename><replaceable>DATAROOTDIR</></>. + </para> + </listitem> + </varlistentry> + </variablelist> + + <note> + <para> + Notes... + </para> + </note> + </para> + + <para> + <variablelist> + + <varlistentry> + <term><option>--with-includes=<replaceable>DIRECTORIES</></option></term> + <listitem> + <para> + <replaceable>DIRECTORIES</> is a colon-separated list of + directories that will be added to the list the compiler + searches for header files. If you have optional packages + (such as GNU <application>Readline</>) installed in a non-standard + location, + you have to use this option and probably also the corresponding + <option>--with-libraries</> option. + </para> + <para> + Example: <literal>--with-includes=/opt/gnu/include:/usr/sup/include</>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--with-libraries=<replaceable>DIRECTORIES</></option></term> + <listitem> + <para> + <replaceable>DIRECTORIES</> is a colon-separated list of + directories to search for libraries. You will probably have + to use this option (and the corresponding + <option>--with-includes</> option) if you have packages + installed in non-standard locations. + </para> + <para> + Example: <literal>--with-libraries=/opt/gnu/lib:/usr/sup/lib</>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--with-openssl</option> + <indexterm> + <primary>OpenSSL</primary> + <seealso>SSL</seealso> + </indexterm> + </term> + <listitem> + <para> + Build with support for <acronym>SSL</> (encrypted) + connections. This requires the <productname>OpenSSL</> + package to be installed. <filename>configure</> will check + for the required header files and libraries to make sure that + your <productname>OpenSSL</> installation is sufficient + before proceeding. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--enable-debug</option></term> + <listitem> + <para> + Compiles all programs and libraries with debugging symbols. + This means that you can run the programs in a debugger + to analyze problems. This enlarges the size of the installed + executables considerably, and on non-GCC compilers it usually + also disables compiler optimization, causing slowdowns. However, + having the symbols available is extremely helpful for dealing + with any problems that might arise. Currently, this option is + recommended for production installations only if you use GCC. + But you should always have it on if you are doing development work + or running a beta version. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--enable-profiling</option></term> + <listitem> + <para> + If using GCC, all programs and libraries are compiled so they + can be profiled. On backend exit, a subdirectory will be created + that contains the <filename>gmon.out</> file for use in profiling. + This option is for use only with GCC and when doing development work. + </para> + </listitem> + </varlistentry> + + </variablelist> + </para> + + <para> + If you prefer a C compiler different from the one + <filename>configure</filename> picks, you can set the + environment variable <envar>CC</> to the program of your choice. + By default, <filename>configure</filename> will pick + <filename>gcc</filename> if available, else the platform's + default (usually <filename>cc</>). Similarly, you can override the + default compiler flags if needed with the <envar>CFLAGS</envar> variable. + </para> + + <para> + You can specify environment variables on the + <filename>configure</filename> command line, for example: +<screen> +<userinput>./configure CC=/opt/bin/gcc CFLAGS='-O2 -pipe'</> +</screen> + </para> + + <para> + Here is a list of the significant variables that can be set in + this manner: + + <variablelist> + <varlistentry> + <term><envar>BISON</envar></term> + <listitem> + <para> + Bison program + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><envar>CC</envar></term> + <listitem> + <para> + C compiler + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><envar>CFLAGS</envar></term> + <listitem> + <para> + options to pass to the C compiler + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><envar>CPP</envar></term> + <listitem> + <para> + C preprocessor + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><envar>CPPFLAGS</envar></term> + <listitem> + <para> + options to pass to the C preprocessor + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><envar>DTRACE</envar></term> + <listitem> + <para> + location of the <command>dtrace</command> program + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><envar>DTRACEFLAGS</envar></term> + <listitem> + <para> + options to pass to the <command>dtrace</command> program + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><envar>FLEX</envar></term> + <listitem> + <para> + Flex program + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><envar>LDFLAGS</envar></term> + <listitem> + <para> + options to use when linking either executables or shared libraries + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><envar>LDFLAGS_EX</envar></term> + <listitem> + <para> + additional options for linking executables only + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><envar>LDFLAGS_SL</envar></term> + <listitem> + <para> + additional options for linking shared libraries only + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><envar>XML2_CONFIG</envar></term> + <listitem> + <para> + <command>xml2-config</command> program used to locate the + libxml installation. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + + <note> + <para> + When developing code inside the server, it is recommended to + use the configure options <option>--enable-cassert</> (which + turns on many run-time error checks) and <option>--enable-debug</> + (which improves the usefulness of debugging tools). + </para> + + <para> + If using GCC, it is best to build with an optimization level of + at least <option>-O1</>, because using no optimization + (<option>-O0</>) disables some important compiler warnings (such + as the use of uninitialized variables). However, non-zero + optimization levels can complicate debugging because stepping + through compiled code will usually not match up one-to-one with + source code lines. If you get confused while trying to debug + optimized code, recompile the specific files of interest with + <option>-O0</>. An easy way to do this is by passing an option + to <application>make</>: <command>make PROFILE=-O0 file.o</>. + </para> + </note> + </step> + + <step id="build"> + <title>Build</title> + + <para> + To start the build, type: +<screen> +<userinput>make</userinput> +</screen> + (Remember to use <acronym>GNU</> <application>make</>.) The build + will take a few minutes depending on your + hardware. The last line displayed should be: +<screen> +All of PostgreSQL is successfully made. Ready to install. +</screen> + </para> + + <para> + If you want to build everything that can be built, including the + documentation (HTML and man pages), and the additional modules + (<filename>contrib</filename>), type instead: +<screen> +<userinput>make world</userinput> +</screen> + The last line displayed should be: +<screen> +PostgreSQL, contrib and HTML documentation successfully made. Ready to install. +</screen> + </para> + </step> + + <step> + <title>Regression Tests</title> + + <indexterm> + <primary>regression test</primary> + </indexterm> + + <para> + Description about the regression test... + </para> + </step> + + <step id="install"> + <title>Installing the Files</title> + + <para> + To install <productname>pgpool-II</> enter: +<screen> +<userinput>make install</userinput> +</screen> + This will install files into the directories that were specified + in <xref linkend="configure">. Make sure that you have appropriate + permissions to write into that area. Normally you need to do this + step as root. Alternatively, you can create the target + directories in advance and arrange for appropriate permissions to + be granted. + </para> + + <para> + To install the documentation (HTML and man pages), enter: +<screen> +<userinput>make install-docs</userinput> +</screen> + </para> + + <para> + If you built the world above, type instead: +<screen> +<userinput>make install-world</userinput> +</screen> + This also installs the documentation. + </para> + + <para> + You can use <literal>make install-strip</literal> instead of + <literal>make install</literal> to strip the executable files and + libraries as they are installed. This will save some space. If + you built with debugging support, stripping will effectively + remove the debugging support, so it should only be done if + debugging is no longer needed. <literal>install-strip</literal> + tries to do a reasonable job saving space, but it does not have + perfect knowledge of how to strip every unneeded byte from an + executable file, so if you want to save all the disk space you + possibly can, you will have to do manual work. + </para> + + <para> + The standard installation provides all the header files needed for client + application development as well as for server-side program + development, such as custom functions or data types written in C. + (Prior to <productname>PostgreSQL</> 8.0, a separate <literal>make + install-all-headers</> command was needed for the latter, but this + step has been folded into the standard install.) + </para> + + <formalpara> + <title>Client-only installation:</title> + <para> + If you want to install only the client applications and + interface libraries, then you can use these commands: +<screen> +<userinput>make -C src/bin install</> +<userinput>make -C src/include install</> +<userinput>make -C src/interfaces install</> +<userinput>make -C doc install</> +</screen> + <filename>src/bin</> has a few binaries for server-only use, + but they are small. + </para> + </formalpara> + </step> + </procedure> + + <formalpara> + <title>Uninstallation:</title> + <para> + To undo the installation use the command <command>make + uninstall</>. However, this will not remove any created directories. + </para> + </formalpara> + + <formalpara> + <title>Cleaning:</title> + + <para> + After the installation you can free disk space by removing the built + files from the source tree with the command <command>make + clean</>. This will preserve the files made by the <command>configure</command> + program, so that you can rebuild everything with <command>make</> + later on. To reset the source tree to the state in which it was + distributed, use <command>make distclean</>. If you are going to + build for several platforms within the same source tree you must do + this and re-configure for each platform. (Alternatively, use + a separate build tree for each platform, so that the source tree + remains unmodified.) + </para> + </formalpara> + + <para> + If you perform a build and then discover that your <command>configure</> + options were wrong, or if you change anything that <command>configure</> + investigates (for example, software upgrades), then it's a good + idea to do <command>make distclean</> before reconfiguring and + rebuilding. Without this, your changes in configuration choices + might not propagate everywhere they need to. + </para> + </sect1> + + <sect1 id="install-post"> + <title>Post-Installation Setup</title> + + <sect2> + <title>Shared Libraries</title> + + <indexterm> + <primary>shared library</primary> + </indexterm> + + <para> + On some systems with shared libraries + you need to tell the system how to find the newly installed + shared libraries. The systems on which this is + <emphasis>not</emphasis> necessary include + <systemitem class="osname">FreeBSD</>, + <systemitem class="osname">HP-UX</>, + <systemitem class="osname">Linux</>, + <systemitem class="osname">NetBSD</>, <systemitem + class="osname">OpenBSD</>, and + <systemitem class="osname">Solaris</>. + </para> + + <para> + The method to set the shared library search path varies between + platforms, but the most widely-used method is to set the + environment variable <envar>LD_LIBRARY_PATH</> like so: In Bourne + shells (<command>sh</>, <command>ksh</>, <command>bash</>, <command>zsh</>): +<programlisting> +LD_LIBRARY_PATH=/usr/local/pgsql/lib +export LD_LIBRARY_PATH +</programlisting> + or in <command>csh</> or <command>tcsh</>: +<programlisting> +setenv LD_LIBRARY_PATH /usr/local/pgsql/lib +</programlisting> + Replace <literal>/usr/local/pgsql/lib</> with whatever you set + <option><literal>--libdir</></> to in <xref linkend="configure">. + You should put these commands into a shell start-up file such as + <filename>/etc/profile</> or <filename>~/.bash_profile</>. Some + good information about the caveats associated with this method can + be found at <ulink + url="http://xahlee.org/UnixResource_dir/_/ldpath.html"></ulink>. + </para> + + <para> + On some systems it might be preferable to set the environment + variable <envar>LD_RUN_PATH</envar> <emphasis>before</emphasis> + building. + </para> + + <para> + On <systemitem class="osname">Cygwin</systemitem>, put the library + directory in the <envar>PATH</envar> or move the + <filename>.dll</filename> files into the <filename>bin</filename> + directory. + </para> + + <para> + If in doubt, refer to the manual pages of your system (perhaps + <command>ld.so</command> or <command>rld</command>). If you later + get a message like: +<screen> +psql: error in loading shared libraries +libpq.so.2.1: cannot open shared object file: No such file or directory +</screen> + then this step was necessary. Simply take care of it then. + </para> + + <para> + <indexterm> + <primary>ldconfig</primary> + </indexterm> + If you are on <systemitem class="osname">Linux</> and you have root + access, you can run: +<programlisting> +/sbin/ldconfig /usr/local/pgsql/lib +</programlisting> + (or equivalent directory) after installation to enable the + run-time linker to find the shared libraries faster. Refer to the + manual page of <command>ldconfig</> for more information. On + <systemitem class="osname">FreeBSD</>, <systemitem + class="osname">NetBSD</>, and <systemitem + class="osname">OpenBSD</> the command is: +<programlisting> +/sbin/ldconfig -m /usr/local/pgsql/lib +</programlisting> + instead. Other systems are not known to have an equivalent + command. + </para> + </sect2> + + <sect2> + <title>Environment Variables</title> + + <indexterm> + <primary><envar>PATH</envar></primary> + </indexterm> + + <para> + If you installed into <filename>/usr/local/pgsql</> or some other + location that is not searched for programs by default, you should + add <filename>/usr/local/pgsql/bin</> (or whatever you set + <option><literal>--bindir</></> to in <xref linkend="configure">) + into your <envar>PATH</>. Strictly speaking, this is not + necessary, but it will make the use of <productname>PostgreSQL</> + much more convenient. + </para> + + <para> + To do this, add the following to your shell start-up file, such as + <filename>~/.bash_profile</> (or <filename>/etc/profile</>, if you + want it to affect all users): +<programlisting> +PATH=/usr/local/pgsql/bin:$PATH +export PATH +</programlisting> + If you are using <command>csh</> or <command>tcsh</>, then use this command: +<programlisting> +set path = ( /usr/local/pgsql/bin $path ) +</programlisting> + </para> + + <para> + <indexterm> + <primary><envar>MANPATH</envar></primary> + </indexterm> + To enable your system to find the <application>man</> + documentation, you need to add lines like the following to a + shell start-up file unless you installed into a location that is + searched by default: +<programlisting> +MANPATH=/usr/local/pgsql/man:$MANPATH +export MANPATH +</programlisting> + </para> + + <para> + The environment variables <envar>PGHOST</> and <envar>PGPORT</> + specify to client applications the host and port of the database + server, overriding the compiled-in defaults. If you are going to + run client applications remotely then it is convenient if every + user that plans to use the database sets <envar>PGHOST</>. This + is not required, however; the settings can be communicated via command + line options to most client programs. + </para> + </sect2> + </sect1> + + +<![%standalone-include;[ + <sect1 id="install-getting-started"> + <title>Getting Started</title> + + <para> + The following is a quick summary of how to get <productname>PostgreSQL</> up and + running once installed. The main documentation contains more information. + </para> + + <procedure> + <step> + <para> + Create a user account for the <productname>PostgreSQL</> + server. This is the user the server will run as. For production + use you should create a separate, unprivileged account + (<quote>postgres</> is commonly used). If you do not have root + access or just want to play around, your own user account is + enough, but running the server as root is a security risk and + will not work. +<screen> +<userinput>adduser postgres</> +</screen> + </para> + </step> + + <step> + <para> + Create a database installation with the <command>initdb</> + command. To run <command>initdb</> you must be logged in to your + <productname>PostgreSQL</> server account. It will not work as + root. +<screen> +root# <userinput>mkdir /usr/local/pgsql/data</> +root# <userinput>chown postgres /usr/local/pgsql/data</> +root# <userinput>su - postgres</> +postgres$ <userinput>/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data</> +</screen> + </para> + + <para> + The <option>-D</> option specifies the location where the data + will be stored. You can use any path you want, it does not have + to be under the installation directory. Just make sure that the + server account can write to the directory (or create it, if it + doesn't already exist) before starting <command>initdb</>, as + illustrated here. + </para> + </step> + + <step> + <para> + At this point, if you did not use the <command>initdb</> <literal>-A</> + option, you might want to modify <filename>pg_hba.conf</> to control + local access to the server before you start it. The default is to + trust all local users. + </para> + </step> + + <step> + <para> + The previous <command>initdb</> step should have told you how to + start up the database server. Do so now. The command should look + something like: +<programlisting> +/usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data +</programlisting> + This will start the server in the foreground. To put the server + in the background use something like: +<programlisting> +nohup /usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data \ + &lt;/dev/null &gt;&gt;server.log 2&gt;&amp;1 &lt;/dev/null &amp; +</programlisting> + </para> + + <para> + To stop a server running in the background you can type: +<programlisting> +kill `cat /usr/local/pgsql/data/postmaster.pid` +</programlisting> + </para> + </step> + + <step> + <para> + Create a database: +<screen> +<userinput>createdb testdb</> +</screen> + Then enter: +<screen> +<userinput>psql testdb</> +</screen> + to connect to that database. At the prompt you can enter SQL + commands and start experimenting. + </para> + </step> + </procedure> + </sect1> + + <sect1 id="install-whatnow"> + <title>What Now?</title> + + <para> + <itemizedlist> + <listitem> + <para> + The <productname>PostgreSQL</> distribution contains a + comprehensive documentation set, which you should read sometime. + After installation, the documentation can be accessed by + pointing your browser to + <filename>/usr/local/pgsql/doc/html/index.html</>, unless you + changed the installation directories. + </para> + + <para> + The first few chapters of the main documentation are the Tutorial, + which should be your first reading if you are completely new to + <acronym>SQL</> databases. If you are familiar with database + concepts then you want to proceed with part on server + administration, which contains information about how to set up + the database server, database users, and authentication. + </para> + </listitem> + + <listitem> + <para> + Usually, you will want to modify your computer so that it will + automatically start the database server whenever it boots. Some + suggestions for this are in the documentation. + </para> + </listitem> + + <listitem> + <para> + Run the regression tests against the installed server (using + <command>make installcheck</command>). If you didn't run the + tests before installation, you should definitely do it now. This + is also explained in the documentation. + </para> + </listitem> + + <listitem> + <para> + By default, <productname>PostgreSQL</> is configured to run on + minimal hardware. This allows it to start up with almost any + hardware configuration. The default configuration is, however, + not designed for optimum performance. To achieve optimum + performance, several server parameters must be adjusted, the two + most common being <varname>shared_buffers</varname> and + <varname>work_mem</varname>. + Other parameters mentioned in the documentation also affect + performance. + </para> + </listitem> + </itemizedlist> + </para> + </sect1> +]]> + + + <sect1 id="supported-platforms"> + <title>Supported Platforms</title> + + <para> + A platform (that is, a CPU architecture and operating system combination) + is considered supported by the <productname>PostgreSQL</> development + community if the code contains provisions to work on that platform and + it has recently been verified to build and pass its regression tests + on that platform. Currently, most testing of platform compatibility + is done automatically by test machines in the + <ulink url="http://buildfarm.postgresql.org/">PostgreSQL Build Farm</ulink>. + If you are interested in using <productname>PostgreSQL</> on a platform + that is not represented in the build farm, but on which the code works + or can be made to work, you are strongly encouraged to set up a build + farm member machine so that continued compatibility can be assured. + </para> + + <para> + In general, <productname>PostgreSQL</> can be expected to work on + these CPU architectures: x86, x86_64, IA64, PowerPC, + PowerPC 64, S/390, S/390x, Sparc, Sparc 64, ARM, MIPS, MIPSEL, M68K, + and PA-RISC. Code support exists for M32R and VAX, but these + architectures are not known to have been tested recently. It is often + possible to build on an unsupported CPU type by configuring with + <option>--disable-spinlocks</option>, but performance will be poor. + </para> + + <para> + <productname>PostgreSQL</> can be expected to work on these operating + systems: Linux (all recent distributions), Windows (Win2000 SP4 and later), + FreeBSD, OpenBSD, NetBSD, OS X, AIX, HP/UX, Solaris, + and UnixWare. Other Unix-like systems may also work but are not currently + being tested. In most cases, all CPU architectures supported by + a given operating system will work. Look in + the <xref linkend="installation-platform-notes"> below to see if + there is information + specific to your operating system, particularly if using an older system. + </para> + + <para> + If you have installation problems on a platform that is known + to be supported according to recent build farm results, please report + it to <email>pgsql-bugs@postgresql.org</email>. If you are interested + in porting <productname>PostgreSQL</> to a new platform, + <email>pgsql-hackers@postgresql.org</email> is the appropriate place + to discuss that. + </para> + </sect1> + + <sect1 id="installation-platform-notes"> + <title>Platform-specific Notes</title> + + <para> + This section documents additional platform-specific issues + regarding the installation and setup of <productname>pgpool-II</>. + </para> + + <para> + Platforms that are not covered here have no known platform-specific + installation issues. + </para> + + </sect1> + +</chapter> diff --git a/doc/src/sgml/intro.sgml b/doc/src/sgml/intro.sgml new file mode 100644 index 000000000..22c018a72 --- /dev/null +++ b/doc/src/sgml/intro.sgml @@ -0,0 +1,95 @@ +<!-- doc/src/sgml/intro.sgml --> + +<preface id="preface"> + <title>Preface</title> + + <para> + This book is the official documentation of + <productname>pgpool-II</productname>. It has been written by the + <productname>pgpool-II</productname> developers and other + volunteers in parallel to the development of the + <productname>pgpool-II</productname> software. It describes all + the functionality that the current version of + <productname>pgpool-II</productname> officially supports. + </para> + + <para> + To make the large amount of information about + <productname>pgpool-II</productname> manageable, this book has been + organized in several parts. Each part is targeted at a different + class of users, or at users in different stages of their + <productname>pgpool-II</productname> experience: + + <itemizedlist> + <listitem> + <para> + <xref linkend="tutorial"> is an informal introduction for new users. + </para> + </listitem> + +<!-- + <listitem> + <para> + <xref linkend="sql"> documents the <acronym>SQL</acronym> query + language environment, including data types and functions, as well + as user-level performance tuning. Every + <productname>PostgreSQL</> user should read this. + </para> + </listitem> +--> + + <listitem> + <para> + <xref linkend="admin"> describes the installation and + administration of the server. Everyone who runs a + <productname>PostgreSQL</productname> server, be it for private + use or for others, should read this part. + </para> + </listitem> + +<!-- + <listitem> + <para> + <xref linkend="client-interfaces"> describes the programming + interfaces for <productname>pgpool-II</productname> PCP client + programs. + </para> + </listitem> +--> + + <listitem> + <para> + <xref linkend="reference"> contains reference information about + SQL commands, client and server programs. This part supports + the other parts with structured information sorted by command or + program. + </para> + </listitem> + +<!-- + <listitem> + <para> + <xref linkend="internals"> contains assorted information that might be of + use to <productname>PostgreSQL</> developers. + </para> + </listitem> +--> + + </itemizedlist> + </para> + + <sect1 id="intro-whatis"> + <title> What is <productname>pgpool-II</productname>?</title> + + <para> + <productname>pgpool-II</productname> is .... + </para> + + </sect1> + + &history; + &notation; + &info; + &problems; + +</preface> diff --git a/doc/src/sgml/jadetex.cfg b/doc/src/sgml/jadetex.cfg new file mode 100644 index 000000000..875598f15 --- /dev/null +++ b/doc/src/sgml/jadetex.cfg @@ -0,0 +1,89 @@ +% doc/src/sgml/jadetex.cfg +% +% This file redefines \FlowObjectSetup and some related macros to greatly +% reduce the number of control sequence names created, and also to avoid +% creation of many useless hyperlink anchors (bookmarks) in PDF files. +% +% The original coding of \FlowObjectSetup defined a control sequence x@LABEL +% for pretty nearly every flow object in the file, whether that object was +% cross-referenced or not. Worse yet, it created a hyperlink anchor for +% every such object, which not only bloated the output PDF with useless +% anchors but consumed an additional control sequence name per anchor. +% This results in overrunning TeX's limited-size string pool. +% +% To fix, extend \PageLabel's already-existing mechanism whereby a p@LABEL +% control sequence is filled in only for labels that are referenced by at +% least one \Pageref call. We now also fill in p@LABEL for labels that are +% referenced by a \Link. Then, we can drop x@LABEL entirely, and use p@LABEL +% to control emission of both a hyperlink anchor and a page-number label. +% Now, both of those things are emitted for all and only the flow objects +% that have either a hyperlink reference or a page-number reference. +% We consume about one control sequence name per flow object plus one per +% referenced object, which is a lot better than three per flow object. +% +% (With a more invasive patch, we could track the need for an anchor and a +% page-number label separately, but that would probably require two control +% sequences for every flow object. Besides, many objects that have one kind +% of reference will have the other one too; that's certainly true for objects +% referenced in either the TOC or the index, for example.) +% +% +% In addition to checking p@LABEL not x@LABEL, this version of \FlowObjectSetup +% is fixed to clear \Label and \Element whether or not it emits an anchor +% and page label. Failure to do that seems to explain some pre-existing bugs +% in which certain SGML constructs weren't correctly cross-referenced. +% +\def\FlowObjectSetup#1{% +\ifDoFOBSet + \ifLabelElements + \ifx\Label\@empty\let\Label\Element\fi + \fi + \ifx\Label\@empty\else + \expandafter\ifx\csname p@\Label\endcsname\relax + \else + \bgroup + \ifNestedLink + \else + \hyper@anchorstart{\Label}\hyper@anchorend + \PageLabel{\Label}% + \fi + \egroup + \fi + \let\Label\@empty + \let\Element\@empty + \fi +\fi +} +% +% Adjust \PageLabel so that the p@NAME control sequence acquires a correct +% value immediately; this seems to be needed to avoid scenarios wherein +% additional TeX runs are needed to reach a stable state of the .aux file. +% +\def\PageLabel#1{% + \@bsphack + \expandafter\ifx\csname p@#1\endcsname\relax + \else + \protected@write\@auxout{}% + {\string\pagelabel{#1}{\thepage}}% + % Ensure the p@NAME control sequence acquires correct value immediately + \expandafter\xdef\csname p@#1\endcsname{\thepage}% + \fi + \@esphack} +% +% In \Link, add code to emit an aux-file entry if the p@NAME sequence isn't +% defined. Much as in \@Setref, this ensures we'll process the referenced +% item correctly on the next TeX run. +% +\def\Link#1{% + \begingroup + \SetupICs{#1}% + \ifx\Label\@empty\let\Label\Element\fi +% \typeout{Made a Link at \the\inputlineno, to \Label}% + \hyper@linkstart{\LinkType}{\Label}% + \NestedLinktrue + % If p@NAME control sequence isn't defined, emit dummy def to aux file + % so it will get defined properly on next run, much as in \@Setref + \expandafter\ifx\csname p@\Label\endcsname\relax + \immediate\write\@mainaux{\string\pagelabel{\Label}{qqq}}% + \fi +} diff --git a/doc/src/sgml/legal.sgml b/doc/src/sgml/legal.sgml new file mode 100644 index 000000000..84bc7beb5 --- /dev/null +++ b/doc/src/sgml/legal.sgml @@ -0,0 +1,48 @@ +<!-- doc/src/sgml/legal.sgml --> + +<date>2016</date> + +<copyright> + <year>1996-2016</year> + <holder>The PostgreSQL Global Development Group</holder> +</copyright> + +<legalnotice id="legalnotice"> + <title>Legal Notice</title> + + <para> + <productname>PostgreSQL</productname> is Copyright &copy; 1996-2016 + by the PostgreSQL Global Development Group. + </para> + + <para> + <productname>Postgres95</productname> is Copyright &copy; 1994-5 + by the Regents of the University of California. + </para> + + <para> + Permission to use, copy, modify, and distribute this software and + its documentation for any purpose, without fee, and without a + written agreement is hereby granted, provided that the above + copyright notice and this paragraph and the following two paragraphs + appear in all copies. + </para> + + <para> + IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY + PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL + DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS + SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA + HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + </para> + + <para> + THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, + INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE + PROVIDED HEREUNDER IS ON AN <quote>AS-IS</quote> BASIS, AND THE UNIVERSITY OF + CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, + UPDATES, ENHANCEMENTS, OR MODIFICATIONS. + </para> + +</legalnotice> diff --git a/doc/src/sgml/mk_feature_tables.pl b/doc/src/sgml/mk_feature_tables.pl new file mode 100644 index 000000000..45dea798c --- /dev/null +++ b/doc/src/sgml/mk_feature_tables.pl @@ -0,0 +1,70 @@ +# /usr/bin/perl -w + +# doc/src/sgml/mk_feature_tables.pl + +my $yesno = $ARGV[0]; + +open PACK, $ARGV[1] or die; + +my %feature_packages; + +while (<PACK>) +{ + chomp; + my ($fid, $pname) = split /\t/; + if ($feature_packages{$fid}) + { + $feature_packages{$fid} .= ", $pname"; + } + else + { + $feature_packages{$fid} = $pname; + } +} + +close PACK; + +open FEAT, $ARGV[2] or die; + +print "<tbody>\n"; + +while (<FEAT>) +{ + chomp; + my ($feature_id, $feature_name, $subfeature_id, + $subfeature_name, $is_supported, $comments) = split /\t/; + + $is_supported eq $yesno || next; + + $feature_name =~ s/</&lt;/g; + $feature_name =~ s/>/&gt;/g; + $subfeature_name =~ s/</&lt;/g; + $subfeature_name =~ s/>/&gt;/g; + + print " <row>\n"; + + if ($subfeature_id) + { + print " <entry>$feature_id-$subfeature_id</entry>\n"; + } + else + { + print " <entry>$feature_id</entry>\n"; + } + print " <entry>" . $feature_packages{$feature_id} . "</entry>\n"; + if ($subfeature_id) + { + print " <entry>$subfeature_name</entry>\n"; + } + else + { + print " <entry>$feature_name</entry>\n"; + } + print " <entry>$comments</entry>\n"; + + print " </row>\n"; +} + +print "</tbody>\n"; + +close FEAT; diff --git a/doc/src/sgml/notation.sgml b/doc/src/sgml/notation.sgml new file mode 100644 index 000000000..2f350a329 --- /dev/null +++ b/doc/src/sgml/notation.sgml @@ -0,0 +1,31 @@ +<!-- doc/src/sgml/notation.sgml --> + +<sect1 id="notation"> + <title>Conventions</title> + + <para> + The following conventions are used in the synopsis of a command: + brackets (<literal>[</literal> and <literal>]</literal>) indicate + optional parts. (In the synopsis of a Tcl command, question marks + (<literal>?</>) are used instead, as is usual in Tcl.) Braces + (<literal>{</literal> and <literal>}</literal>) and vertical lines + (<literal>|</literal>) indicate that you must choose one + alternative. Dots (<literal>...</>) mean that the preceding element + can be repeated. + </para> + + <para> + Where it enhances the clarity, SQL commands are preceded by the + prompt <literal>=&gt;</>, and shell commands are preceded by the + prompt <literal>$</>. Normally, prompts are not shown, though. + </para> + + <para> + An <firstterm>administrator</firstterm> is generally a person who is + in charge of installing and running the server. A <firstterm>user</firstterm> + could be anyone who is using, or wants to use, any part of the + <productname>PostgreSQL</productname> system. These terms should not + be interpreted too narrowly; this book does not have fixed + presumptions about system administration procedures. + </para> +</sect1> diff --git a/doc/src/sgml/pgpool.sgml b/doc/src/sgml/pgpool.sgml new file mode 100644 index 000000000..ba60703d9 --- /dev/null +++ b/doc/src/sgml/pgpool.sgml @@ -0,0 +1,269 @@ +<!-- doc/src/sgml/pgpool-en.sgml --> + +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.2//EN" [ + +<!ENTITY % version SYSTEM "version.sgml"> +%version; +<!ENTITY % filelist SYSTEM "filelist.sgml"> +%filelist; + +<!ENTITY reference SYSTEM "reference.sgml"> + +]> + +<book id="postgres"> +<!-- needs to be replaced as "pgpool" later --> + + <title>pgpool-II &version; Documentation</title> + + <bookinfo> + <corpauthor>The Pgpool Global Development Group</corpauthor> + <productname>pgpool-II</productname> + <productnumber>&version;</productnumber> + &legal; + </bookinfo> + + &intro; + + <part id="tutorial"> + <title>Tutorial</title> + + <partintro> + <para> + Explanation about pgpool-II tutorial here... + </para> + +<!-- + <para> + After you have worked through this tutorial you might want to move + on to reading <xref linkend="sql"> to gain a more formal knowledge + of the SQL language, or <xref linkend="client-interfaces"> for + information about developing applications for + <productname>PostgreSQL</productname>. Those who set up and + manage their own server should also read <xref linkend="admin">. + </para> +--> + + </partintro> + + &start; +<!-- + &query; + &advanced; +--> + + </part> + +<!-- + <part id="sql"> + <title>The SQL Language</title> + + <partintro> + <para> + This part describes the use of the <acronym>SQL</acronym> language + in <productname>PostgreSQL</productname>. We start with + describing the general syntax of <acronym>SQL</acronym>, then + explain how to create the structures to hold data, how to populate + the database, and how to query it. The middle part lists the + available data types and functions for use in + <acronym>SQL</acronym> commands. The rest treats several + aspects that are important for tuning a database for optimal + performance. + </para> + + <para> + The information in this part is arranged so that a novice user can + follow it start to end to gain a full understanding of the topics + without having to refer forward too many times. The chapters are + intended to be self-contained, so that advanced users can read the + chapters individually as they choose. The information in this + part is presented in a narrative fashion in topical units. + Readers looking for a complete description of a particular command + should see <xref linkend="reference">. + </para> + + <para> + Readers of this part should know how to connect to a + <productname>PostgreSQL</> database and issue + <acronym>SQL</acronym> commands. Readers that are unfamiliar with + these issues are encouraged to read <xref linkend="tutorial"> + first. <acronym>SQL</acronym> commands are typically entered + using the <productname>PostgreSQL</> interactive terminal + <application>psql</application>, but other programs that have + similar functionality can be used as well. + </para> + </partintro> + + + &syntax; + &ddl; + &dml; + &queries; + &datatype; + &func; + &typeconv; + &indices; + &textsearch; + &mvcc; + &perform; + + </part> + +--> + + <part id="admin"> + <title>Server Administration</title> + + <partintro> + <para> + This part covers topics that are of interest to a + <productname>pgpool-II</> ... + </para> + </partintro> + + &installation; +<!-- + &installw; + &runtime; + &config; + &client-auth; + &user-manag; + &manage-ag; + &charset; + &maintenance; + &backup; + &high-availability; + &recovery-config; + &monitoring; + &diskusage; + &wal; + &regress; +--> + + </part> + +<!--- + <part id="client-interfaces"> + <title>Client Interfaces</title> + + <partintro> + <para> + This part describes the client programming interfaces distributed + with <productname>PostgreSQL</>. Each of these chapters can be + read independently. Note that there are many other programming + interfaces for client programs that are distributed separately and + contain their own documentation (<xref linkend="external-projects"> + lists some of the more popular ones). Readers of this part should be + familiar with using <acronym>SQL</acronym> commands to manipulate + and query the database (see <xref linkend="sql">) and of course + with the programming language that the interface uses. + </para> + </partintro> + + &libpq; + &lobj; + &ecpg; + &infoschema; + + </part> + + <part id="server-programming"> + <title>Server Programming</title> + + <partintro> + <para> + This part is about extending the server functionality with + user-defined functions, data types, triggers, etc. These are + advanced topics which should probably be approached only after all + the other user documentation about <productname>PostgreSQL</> has + been understood. Later chapters in this part describe the server-side + programming languages available in the + <productname>PostgreSQL</productname> distribution as well as + general issues concerning server-side programming languages. It + is essential to read at least the earlier sections of <xref + linkend="extend"> (covering functions) before diving into the + material about server-side programming languages. + </para> + </partintro> + + &extend; + &trigger; + &event-trigger; + &rules; + + &xplang; + &plsql; + &pltcl; + &plperl; + &plpython; + + &spi; + &bgworker; + &logicaldecoding; + &replication-origins; + + </part> +--> + + &reference; + +<!-- + <part id="internals"> + <title>Internals</title> + + <partintro> + <para> + This part contains assorted information that might be of use to + <productname>PostgreSQL</> developers. + </para> + </partintro> + + &arch-dev; + &catalogs; + &protocol; + &sources; + &nls; + &plhandler; + &fdwhandler; + &tablesample-method; + &custom-scan; + &geqo; + &indexam; + &gist; + &spgist; + &gin; + &brin; + &storage; + &bki; + &planstats; + + </part> + + <part id="appendixes"> + <title>Appendixes</title> + + <partintro> + <para> + something... + </para> + </partintro> + + &errcodes; + &datetime; + &keywords; + &features; + &release; + &contrib; + &external-projects; + &sourcerepo; + &docguide; + &acronyms; + + </part> +--> + + &biblio; + <![%include-index;[&bookindex;]]> + <![%include-xslt-index;[<index id="bookindex"></index>]]> + +</book> diff --git a/doc/src/sgml/problems.sgml b/doc/src/sgml/problems.sgml new file mode 100644 index 000000000..b37810393 --- /dev/null +++ b/doc/src/sgml/problems.sgml @@ -0,0 +1,9 @@ +<!-- doc/src/sgml/problems.sgml --> + +<sect1 id="bug-reporting"> + <title>Bug Reporting Guidelines</title> + + <para> + When you find a bug in <productname>pgpool-II</productname> ... + </para> +</sect1> diff --git a/doc/src/sgml/ref/allfiles.sgml b/doc/src/sgml/ref/allfiles.sgml new file mode 100644 index 000000000..d6ea11f86 --- /dev/null +++ b/doc/src/sgml/ref/allfiles.sgml @@ -0,0 +1,211 @@ +<!-- +doc/src/sgml/ref/allfiles.sgml +PostgreSQL documentation +Complete list of usable sgml source files in this directory. +--> + +<!-- SQL commands --> +<!-- +<!ENTITY abort SYSTEM "abort.sgml"> +<!ENTITY alterAggregate SYSTEM "alter_aggregate.sgml"> +<!ENTITY alterCollation SYSTEM "alter_collation.sgml"> +<!ENTITY alterConversion SYSTEM "alter_conversion.sgml"> +<!ENTITY alterDatabase SYSTEM "alter_database.sgml"> +<!ENTITY alterDefaultPrivileges SYSTEM "alter_default_privileges.sgml"> +<!ENTITY alterDomain SYSTEM "alter_domain.sgml"> +<!ENTITY alterEventTrigger SYSTEM "alter_event_trigger.sgml"> +<!ENTITY alterExtension SYSTEM "alter_extension.sgml"> +<!ENTITY alterForeignDataWrapper SYSTEM "alter_foreign_data_wrapper.sgml"> +<!ENTITY alterForeignTable SYSTEM "alter_foreign_table.sgml"> +<!ENTITY alterFunction SYSTEM "alter_function.sgml"> +<!ENTITY alterGroup SYSTEM "alter_group.sgml"> +<!ENTITY alterIndex SYSTEM "alter_index.sgml"> +<!ENTITY alterLanguage SYSTEM "alter_language.sgml"> +<!ENTITY alterLargeObject SYSTEM "alter_large_object.sgml"> +<!ENTITY alterMaterializedView SYSTEM "alter_materialized_view.sgml"> +<!ENTITY alterOperator SYSTEM "alter_operator.sgml"> +<!ENTITY alterOperatorClass SYSTEM "alter_opclass.sgml"> +<!ENTITY alterOperatorFamily SYSTEM "alter_opfamily.sgml"> +<!ENTITY alterPolicy SYSTEM "alter_policy.sgml"> +<!ENTITY alterRole SYSTEM "alter_role.sgml"> +<!ENTITY alterRule SYSTEM "alter_rule.sgml"> +<!ENTITY alterSchema SYSTEM "alter_schema.sgml"> +<!ENTITY alterServer SYSTEM "alter_server.sgml"> +<!ENTITY alterSequence SYSTEM "alter_sequence.sgml"> +<!ENTITY alterSystem SYSTEM "alter_system.sgml"> +<!ENTITY alterTable SYSTEM "alter_table.sgml"> +<!ENTITY alterTableSpace SYSTEM "alter_tablespace.sgml"> +<!ENTITY alterTSConfig SYSTEM "alter_tsconfig.sgml"> +<!ENTITY alterTSDictionary SYSTEM "alter_tsdictionary.sgml"> +<!ENTITY alterTSParser SYSTEM "alter_tsparser.sgml"> +<!ENTITY alterTSTemplate SYSTEM "alter_tstemplate.sgml"> +<!ENTITY alterTrigger SYSTEM "alter_trigger.sgml"> +<!ENTITY alterType SYSTEM "alter_type.sgml"> +<!ENTITY alterUser SYSTEM "alter_user.sgml"> +<!ENTITY alterUserMapping SYSTEM "alter_user_mapping.sgml"> +<!ENTITY alterView SYSTEM "alter_view.sgml"> +<!ENTITY analyze SYSTEM "analyze.sgml"> +<!ENTITY begin SYSTEM "begin.sgml"> +<!ENTITY checkpoint SYSTEM "checkpoint.sgml"> +<!ENTITY close SYSTEM "close.sgml"> +<!ENTITY cluster SYSTEM "cluster.sgml"> +<!ENTITY commentOn SYSTEM "comment.sgml"> +<!ENTITY commit SYSTEM "commit.sgml"> +<!ENTITY commitPrepared SYSTEM "commit_prepared.sgml"> +<!ENTITY copyTable SYSTEM "copy.sgml"> +<!ENTITY createAggregate SYSTEM "create_aggregate.sgml"> +<!ENTITY createCast SYSTEM "create_cast.sgml"> +<!ENTITY createCollation SYSTEM "create_collation.sgml"> +<!ENTITY createConversion SYSTEM "create_conversion.sgml"> +<!ENTITY createDatabase SYSTEM "create_database.sgml"> +<!ENTITY createDomain SYSTEM "create_domain.sgml"> +<!ENTITY createEventTrigger SYSTEM "create_event_trigger.sgml"> +<!ENTITY createExtension SYSTEM "create_extension.sgml"> +<!ENTITY createForeignDataWrapper SYSTEM "create_foreign_data_wrapper.sgml"> +<!ENTITY createForeignTable SYSTEM "create_foreign_table.sgml"> +<!ENTITY createFunction SYSTEM "create_function.sgml"> +<!ENTITY createGroup SYSTEM "create_group.sgml"> +<!ENTITY createIndex SYSTEM "create_index.sgml"> +<!ENTITY createLanguage SYSTEM "create_language.sgml"> +<!ENTITY createMaterializedView SYSTEM "create_materialized_view.sgml"> +<!ENTITY createOperator SYSTEM "create_operator.sgml"> +<!ENTITY createOperatorClass SYSTEM "create_opclass.sgml"> +<!ENTITY createOperatorFamily SYSTEM "create_opfamily.sgml"> +<!ENTITY createPolicy SYSTEM "create_policy.sgml"> +<!ENTITY createRole SYSTEM "create_role.sgml"> +<!ENTITY createRule SYSTEM "create_rule.sgml"> +<!ENTITY createSchema SYSTEM "create_schema.sgml"> +<!ENTITY createSequence SYSTEM "create_sequence.sgml"> +<!ENTITY createServer SYSTEM "create_server.sgml"> +<!ENTITY createTable SYSTEM "create_table.sgml"> +<!ENTITY createTableAs SYSTEM "create_table_as.sgml"> +<!ENTITY createTableSpace SYSTEM "create_tablespace.sgml"> +<!ENTITY createTransform SYSTEM "create_transform.sgml"> +<!ENTITY createTrigger SYSTEM "create_trigger.sgml"> +<!ENTITY createTSConfig SYSTEM "create_tsconfig.sgml"> +<!ENTITY createTSDictionary SYSTEM "create_tsdictionary.sgml"> +<!ENTITY createTSParser SYSTEM "create_tsparser.sgml"> +<!ENTITY createTSTemplate SYSTEM "create_tstemplate.sgml"> +<!ENTITY createType SYSTEM "create_type.sgml"> +<!ENTITY createUser SYSTEM "create_user.sgml"> +<!ENTITY createUserMapping SYSTEM "create_user_mapping.sgml"> +<!ENTITY createView SYSTEM "create_view.sgml"> +<!ENTITY deallocate SYSTEM "deallocate.sgml"> +<!ENTITY declare SYSTEM "declare.sgml"> +<!ENTITY delete SYSTEM "delete.sgml"> +<!ENTITY discard SYSTEM "discard.sgml"> +<!ENTITY do SYSTEM "do.sgml"> +<!ENTITY dropAggregate SYSTEM "drop_aggregate.sgml"> +<!ENTITY dropCast SYSTEM "drop_cast.sgml"> +<!ENTITY dropCollation SYSTEM "drop_collation.sgml"> +<!ENTITY dropConversion SYSTEM "drop_conversion.sgml"> +<!ENTITY dropDatabase SYSTEM "drop_database.sgml"> +<!ENTITY dropDomain SYSTEM "drop_domain.sgml"> +<!ENTITY dropEventTrigger SYSTEM "drop_event_trigger.sgml"> +<!ENTITY dropExtension SYSTEM "drop_extension.sgml"> +<!ENTITY dropForeignDataWrapper SYSTEM "drop_foreign_data_wrapper.sgml"> +<!ENTITY dropForeignTable SYSTEM "drop_foreign_table.sgml"> +<!ENTITY dropFunction SYSTEM "drop_function.sgml"> +<!ENTITY dropGroup SYSTEM "drop_group.sgml"> +<!ENTITY dropIndex SYSTEM "drop_index.sgml"> +<!ENTITY dropLanguage SYSTEM "drop_language.sgml"> +<!ENTITY dropMaterializedView SYSTEM "drop_materialized_view.sgml"> +<!ENTITY dropOperator SYSTEM "drop_operator.sgml"> +<!ENTITY dropOperatorClass SYSTEM "drop_opclass.sgml"> +<!ENTITY dropOperatorFamily SYSTEM "drop_opfamily.sgml"> +<!ENTITY dropOwned SYSTEM "drop_owned.sgml"> +<!ENTITY dropPolicy SYSTEM "drop_policy.sgml"> +<!ENTITY dropRole SYSTEM "drop_role.sgml"> +<!ENTITY dropRule SYSTEM "drop_rule.sgml"> +<!ENTITY dropSchema SYSTEM "drop_schema.sgml"> +<!ENTITY dropSequence SYSTEM "drop_sequence.sgml"> +<!ENTITY dropServer SYSTEM "drop_server.sgml"> +<!ENTITY dropTable SYSTEM "drop_table.sgml"> +<!ENTITY dropTableSpace SYSTEM "drop_tablespace.sgml"> +<!ENTITY dropTransform SYSTEM "drop_transform.sgml"> +<!ENTITY dropTrigger SYSTEM "drop_trigger.sgml"> +<!ENTITY dropTSConfig SYSTEM "drop_tsconfig.sgml"> +<!ENTITY dropTSDictionary SYSTEM "drop_tsdictionary.sgml"> +<!ENTITY dropTSParser SYSTEM "drop_tsparser.sgml"> +<!ENTITY dropTSTemplate SYSTEM "drop_tstemplate.sgml"> +<!ENTITY dropType SYSTEM "drop_type.sgml"> +<!ENTITY dropUser SYSTEM "drop_user.sgml"> +<!ENTITY dropUserMapping SYSTEM "drop_user_mapping.sgml"> +<!ENTITY dropView SYSTEM "drop_view.sgml"> +<!ENTITY end SYSTEM "end.sgml"> +<!ENTITY execute SYSTEM "execute.sgml"> +<!ENTITY explain SYSTEM "explain.sgml"> +<!ENTITY fetch SYSTEM "fetch.sgml"> +<!ENTITY grant SYSTEM "grant.sgml"> +<!ENTITY importForeignSchema SYSTEM "import_foreign_schema.sgml"> +<!ENTITY insert SYSTEM "insert.sgml"> +<!ENTITY listen SYSTEM "listen.sgml"> +<!ENTITY load SYSTEM "load.sgml"> +<!ENTITY lock SYSTEM "lock.sgml"> +<!ENTITY move SYSTEM "move.sgml"> +<!ENTITY notify SYSTEM "notify.sgml"> +<!ENTITY prepare SYSTEM "prepare.sgml"> +<!ENTITY prepareTransaction SYSTEM "prepare_transaction.sgml"> +<!ENTITY reassignOwned SYSTEM "reassign_owned.sgml"> +<!ENTITY refreshMaterializedView SYSTEM "refresh_materialized_view.sgml"> +<!ENTITY reindex SYSTEM "reindex.sgml"> +<!ENTITY releaseSavepoint SYSTEM "release_savepoint.sgml"> +<!ENTITY reset SYSTEM "reset.sgml"> +<!ENTITY revoke SYSTEM "revoke.sgml"> +<!ENTITY rollback SYSTEM "rollback.sgml"> +<!ENTITY rollbackPrepared SYSTEM "rollback_prepared.sgml"> +<!ENTITY rollbackTo SYSTEM "rollback_to.sgml"> +<!ENTITY savepoint SYSTEM "savepoint.sgml"> +<!ENTITY securityLabel SYSTEM "security_label.sgml"> +<!ENTITY select SYSTEM "select.sgml"> +<!ENTITY selectInto SYSTEM "select_into.sgml"> +<!ENTITY set SYSTEM "set.sgml"> +<!ENTITY setConstraints SYSTEM "set_constraints.sgml"> +<!ENTITY setRole SYSTEM "set_role.sgml"> +<!ENTITY setSessionAuth SYSTEM "set_session_auth.sgml"> +<!ENTITY setTransaction SYSTEM "set_transaction.sgml"> +<!ENTITY show SYSTEM "show.sgml"> +<!ENTITY startTransaction SYSTEM "start_transaction.sgml"> +<!ENTITY truncate SYSTEM "truncate.sgml"> +<!ENTITY unlisten SYSTEM "unlisten.sgml"> +<!ENTITY update SYSTEM "update.sgml"> +<!ENTITY vacuum SYSTEM "vacuum.sgml"> +<!ENTITY values SYSTEM "values.sgml"> +--> + +<!-- applications and utilities --> +<!-- +<!ENTITY clusterdb SYSTEM "clusterdb.sgml"> +<!ENTITY createdb SYSTEM "createdb.sgml"> +<!ENTITY createlang SYSTEM "createlang.sgml"> +<!ENTITY createuser SYSTEM "createuser.sgml"> +<!ENTITY dropdb SYSTEM "dropdb.sgml"> +<!ENTITY droplang SYSTEM "droplang.sgml"> +<!ENTITY dropuser SYSTEM "dropuser.sgml"> +<!ENTITY ecpgRef SYSTEM "ecpg-ref.sgml"> +<!ENTITY initdb SYSTEM "initdb.sgml"> +<!ENTITY pgarchivecleanup SYSTEM "pgarchivecleanup.sgml"> +<!ENTITY pgBasebackup SYSTEM "pg_basebackup.sgml"> +<!ENTITY pgbench SYSTEM "pgbench.sgml"> +<!ENTITY pgConfig SYSTEM "pg_config-ref.sgml"> +<!ENTITY pgControldata SYSTEM "pg_controldata.sgml"> +<!ENTITY pgCtl SYSTEM "pg_ctl-ref.sgml"> +<!ENTITY pgDump SYSTEM "pg_dump.sgml"> +<!ENTITY pgDumpall SYSTEM "pg_dumpall.sgml"> +<!ENTITY pgIsready SYSTEM "pg_isready.sgml"> +<!ENTITY pgReceivexlog SYSTEM "pg_receivexlog.sgml"> +<!ENTITY pgRecvlogical SYSTEM "pg_recvlogical.sgml"> +<!ENTITY pgResetxlog SYSTEM "pg_resetxlog.sgml"> +<!ENTITY pgRestore SYSTEM "pg_restore.sgml"> +<!ENTITY pgRewind SYSTEM "pg_rewind.sgml"> +<!ENTITY pgtestfsync SYSTEM "pgtestfsync.sgml"> +<!ENTITY pgtesttiming SYSTEM "pgtesttiming.sgml"> +<!ENTITY pgupgrade SYSTEM "pgupgrade.sgml"> +<!ENTITY pgxlogdump SYSTEM "pg_xlogdump.sgml"> +<!ENTITY postgres SYSTEM "postgres-ref.sgml"> +<!ENTITY postmaster SYSTEM "postmaster.sgml"> +<!ENTITY psqlRef SYSTEM "psql-ref.sgml"> +<!ENTITY reindexdb SYSTEM "reindexdb.sgml"> +<!ENTITY vacuumdb SYSTEM "vacuumdb.sgml"> +--> +<!ENTITY pcpNodeCount SYSTEM "pcp_node_count.sgml"> diff --git a/doc/src/sgml/ref/pcp_node_count.sgml b/doc/src/sgml/ref/pcp_node_count.sgml new file mode 100644 index 000000000..1e0e5975b --- /dev/null +++ b/doc/src/sgml/ref/pcp_node_count.sgml @@ -0,0 +1,107 @@ +<!-- +doc/src/sgml/ref/pcp_node_count.sgml +Pgpool-II documentation +--> + +<refentry id="PCP-NODE-COUNT"> + <indexterm zone="pcp-node-count"> + <primary>pcp_node_count</primary> + </indexterm> + + <refmeta> + <refentrytitle>pcp_node_count</refentrytitle> + <manvolnum>1</manvolnum> + <refmiscinfo>PCP Command</refmiscinfo> + </refmeta> + + <refnamediv> + <refname>pcp_node_count</refname> + <refpurpose> + displays the total number of database nodes</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis> + <command>pcp_node_count</command> + <arg rep="repeat"><replaceable>option</replaceable></arg> + <group choice="plain"> + <group choice="opt"> + <arg choice="plain"><option>--pgdata</option></arg> + <arg choice="plain"><option>-D</option></arg> + </group> + <replaceable> directory</replaceable> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1 id="R1-PCP-NODE-COUNT-1"> + <title> + Description + </title> + <para> + <command>pcp_node_count</command> + displays the total number of database nodes defined in <filename>pgpool.conf</filename>. It does + not distinguish between nodes status, ie attached/detached. ALL nodes are counted. + </para> + </refsect1> + + <refsect1> + <title>Options</title> + + <para> + <variablelist> + + <varlistentry> + <term><option>-h <replaceable class="parameter">hostname</replaceable></option></term> + <term><option>--host=<replaceable class="parameter">hostname</replaceable></option></term> + <listitem> + <para> + The host name of the machine on which the server is running. If the + value begins with a slash, it is used as the directory for the Unix-domain socket. + </para> + </listitem> + </varlistentry> + + </variablelist> + </para> + + </refsect1> + + <refsect1> + <title>Environment</title> + + <variablelist> + <varlistentry> + <term><envar>PCPPASSFILE</envar></term> + + <listitem> + <para> + Specifies the path to pcp password file. + </para> + </listitem> + </varlistentry> + + </variablelist> + + </refsect1> + + <refsect1> + <title>Notes</title> + + <para> + Notes... + </para> + </refsect1> + +<!-- + <refsect1> + <title>See Also</title> + + <simplelist type="inline"> + <member><xref linkend="app-pg-ctl"></member> + <member><xref linkend="app-postgres"></member> + </simplelist> + </refsect1> +--> + +</refentry> diff --git a/doc/src/sgml/reference.sgml b/doc/src/sgml/reference.sgml new file mode 100644 index 000000000..765a4de35 --- /dev/null +++ b/doc/src/sgml/reference.sgml @@ -0,0 +1,275 @@ +<!-- doc/src/sgml/reference.sgml --> + +<part id="reference"> + <title>Reference</title> + + <partintro> + <para> + About pgool-II reference... + </para> + + <para> + The reference entries are also available as traditional + <quote>man</quote> pages. + </para> + </partintro> + +<!-- + + <reference id="sql-commands"> + <title>SQL Commands</title> + + <partintro> + <para> + This part contains reference information for the + <acronym>SQL</acronym> commands supported by + <productname>PostgreSQL</productname>. By <quote>SQL</quote> the + language in general is meant; information about the standards + conformance and compatibility of each command can be found on the + respective reference page. + </para> + </partintro> + + &abort; + &alterAggregate; + &alterCollation; + &alterConversion; + &alterDatabase; + &alterDefaultPrivileges; + &alterDomain; + &alterEventTrigger; + &alterExtension; + &alterForeignDataWrapper; + &alterForeignTable; + &alterFunction; + &alterGroup; + &alterIndex; + &alterLanguage; + &alterLargeObject; + &alterMaterializedView; + &alterOperator; + &alterOperatorClass; + &alterOperatorFamily; + &alterPolicy; + &alterRole; + &alterRule; + &alterSchema; + &alterSequence; + &alterServer; + &alterSystem; + &alterTable; + &alterTableSpace; + &alterTSConfig; + &alterTSDictionary; + &alterTSParser; + &alterTSTemplate; + &alterTrigger; + &alterType; + &alterUser; + &alterUserMapping; + &alterView; + &analyze; + &begin; + &checkpoint; + &close; + &cluster; + &commentOn; + &commit; + &commitPrepared; + &copyTable; + &createAggregate; + &createCast; + &createCollation; + &createConversion; + &createDatabase; + &createDomain; + &createEventTrigger; + &createExtension; + &createForeignDataWrapper; + &createForeignTable; + &createFunction; + &createGroup; + &createIndex; + &createLanguage; + &createMaterializedView; + &createOperator; + &createOperatorClass; + &createOperatorFamily; + &createPolicy; + &createRole; + &createRule; + &createSchema; + &createSequence; + &createServer; + &createTable; + &createTableAs; + &createTableSpace; + &createTSConfig; + &createTSDictionary; + &createTSParser; + &createTSTemplate; + &createTransform; + &createTrigger; + &createType; + &createUser; + &createUserMapping; + &createView; + &deallocate; + &declare; + &delete; + &discard; + &do; + &dropAggregate; + &dropCast; + &dropCollation; + &dropConversion; + &dropDatabase; + &dropDomain; + &dropEventTrigger; + &dropExtension; + &dropForeignDataWrapper; + &dropForeignTable; + &dropFunction; + &dropGroup; + &dropIndex; + &dropLanguage; + &dropMaterializedView; + &dropOperator; + &dropOperatorClass; + &dropOperatorFamily; + &dropOwned; + &dropPolicy; + &dropRole; + &dropRule; + &dropSchema; + &dropSequence; + &dropServer; + &dropTable; + &dropTableSpace; + &dropTSConfig; + &dropTSDictionary; + &dropTSParser; + &dropTSTemplate; + &dropTransform; + &dropTrigger; + &dropType; + &dropUser; + &dropUserMapping; + &dropView; + &end; + &execute; + &explain; + &fetch; + &grant; + &importForeignSchema; + &insert; + &listen; + &load; + &lock; + &move; + &notify; + &prepare; + &prepareTransaction; + &reassignOwned; + &refreshMaterializedView; + &reindex; + &releaseSavepoint; + &reset; + &revoke; + &rollback; + &rollbackPrepared; + &rollbackTo; + &savepoint; + &securityLabel; + &select; + &selectInto; + &set; + &setConstraints; + &setRole; + &setSessionAuth; + &setTransaction; + &show; + &startTransaction; + &truncate; + &unlisten; + &update; + &vacuum; + &values; + + </reference> + + <reference id="reference-client"> + <title>PostgreSQL Client Applications</title> + + <partintro> + <para> + This part contains reference information for + <productname>PostgreSQL</productname> client applications and + utilities. Not all of these commands are of general utility; some + might require special privileges. The common feature of these + applications is that they can be run on any host, independent of + where the database server resides. + </para> + + <para> + When specified on the command line, user and database names have + their case preserved &mdash; the presence of spaces or special + characters might require quoting. Table names and other identifiers + do not have their case preserved, except where documented, and + might require quoting. + </para> + </partintro> + + &clusterdb; + &createdb; + &createlang; + &createuser; + &dropdb; + &droplang; + &dropuser; + &ecpgRef; + &pgBasebackup; + &pgbench; + &pgConfig; + &pgDump; + &pgDumpall; + &pgIsready; + &pgReceivexlog; + &pgRecvlogical; + &pgRestore; + &psqlRef; + &reindexdb; + &vacuumdb; + + </reference> + +--> + + <reference id="pcp-commands"> + <title>PCP commands</title> + + <partintro> + <para> + This part contains reference information for pcp commands... + </para> + </partintro> + +<!-- + &initdb; + &pgarchivecleanup; + &pgControldata; + &pgCtl; + &pgResetxlog; + &pgRewind; + &pgtestfsync; + &pgtesttiming; + &pgupgrade; + &pgxlogdump; + &postgres; + &postmaster; +--> + &pcpNodeCount; + </reference> + + +</part> diff --git a/doc/src/sgml/start.sgml b/doc/src/sgml/start.sgml new file mode 100644 index 000000000..b990737cf --- /dev/null +++ b/doc/src/sgml/start.sgml @@ -0,0 +1,13 @@ +<!-- doc/src/sgml/start.sgml --> + + <chapter id="tutorial-start"> + <title>Getting Started</title> + + <sect1 id="tutorial-install"> + <title>Installation</title> + + <para> + How to install... + </para> + </sect1> + </chapter> diff --git a/doc/src/sgml/stylesheet-common.xsl b/doc/src/sgml/stylesheet-common.xsl new file mode 100644 index 000000000..de3637624 --- /dev/null +++ b/doc/src/sgml/stylesheet-common.xsl @@ -0,0 +1,85 @@ +<?xml version="1.0" encoding="utf-8"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<!-- + This file contains XSLT stylesheet customizations that are common to + all output formats (HTML, HTML Help, XSL-FO, etc.). + --> + + +<!-- Parameters --> + +<xsl:param name="pg.fast" select="'0'"/> + +<!-- +<xsl:param name="draft.mode"> + <xsl:choose> + <xsl:when test="contains($pg.version, 'devel')">yes</xsl:when> + <xsl:otherwise>no</xsl:otherwise> + </xsl:choose> +</xsl:param> +--> + +<xsl:param name="show.comments"> + <xsl:choose> + <xsl:when test="contains($pg.version, 'devel')">1</xsl:when> + <xsl:otherwise>0</xsl:otherwise> + </xsl:choose> +</xsl:param> + +<xsl:param name="callout.graphics" select="'0'"></xsl:param> +<xsl:param name="toc.section.depth">2</xsl:param> +<xsl:param name="linenumbering.extension" select="'0'"></xsl:param> +<xsl:param name="generate.index" select="1 - $pg.fast"></xsl:param> +<xsl:param name="section.autolabel" select="1 - $pg.fast"></xsl:param> +<xsl:param name="section.label.includes.component.label" select="1 - $pg.fast"></xsl:param> +<xsl:param name="refentry.xref.manvolnum" select="0"/> +<xsl:param name="formal.procedures" select="0"></xsl:param> +<xsl:param name="punct.honorific" select="''"></xsl:param> +<xsl:param name="variablelist.term.break.after">1</xsl:param> +<xsl:param name="variablelist.term.separator"></xsl:param> + + +<!-- Change display of some elements --> + +<xsl:template match="productname"> + <xsl:call-template name="inline.charseq"/> +</xsl:template> + +<xsl:template match="structfield"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<xsl:template match="structname"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<xsl:template match="symbol"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<xsl:template match="systemitem"> + <xsl:call-template name="inline.charseq"/> +</xsl:template> + +<xsl:template match="token"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<xsl:template match="type"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<xsl:template match="programlisting/emphasis"> + <xsl:call-template name="inline.boldseq"/> +</xsl:template> + + +<!-- Special support for Tcl synopses --> + +<xsl:template match="optional[@role='tcl']"> + ?<xsl:call-template name="inline.charseq"/>? +</xsl:template> + +</xsl:stylesheet> diff --git a/doc/src/sgml/stylesheet-fo.xsl b/doc/src/sgml/stylesheet-fo.xsl new file mode 100644 index 000000000..434e69d8e --- /dev/null +++ b/doc/src/sgml/stylesheet-fo.xsl @@ -0,0 +1,34 @@ +<?xml version="1.0" encoding="utf-8"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0" + xmlns:fo="http://www.w3.org/1999/XSL/Format"> + +<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/> +<xsl:include href="stylesheet-common.xsl" /> + +<xsl:param name="fop1.extensions" select="1"></xsl:param> +<xsl:param name="tablecolumns.extension" select="0"></xsl:param> +<xsl:param name="toc.max.depth">3</xsl:param> +<xsl:param name="ulink.footnotes" select="1"></xsl:param> +<xsl:param name="use.extensions" select="1"></xsl:param> +<xsl:param name="variablelist.as.blocks" select="1"></xsl:param> + +<xsl:attribute-set name="monospace.verbatim.properties" + use-attribute-sets="verbatim.properties monospace.properties"> + <xsl:attribute name="wrap-option">wrap</xsl:attribute> +</xsl:attribute-set> + +<!-- Change display of some elements --> + +<xsl:template match="command"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<!-- bug fix from <https://sourceforge.net/p/docbook/bugs/1360/#831b> --> + +<xsl:template match="varlistentry/term" mode="xref-to"> + <xsl:param name="verbose" select="1"/> + <xsl:apply-templates mode="no.anchor.mode"/> +</xsl:template> + +</xsl:stylesheet> diff --git a/doc/src/sgml/stylesheet-hh.xsl b/doc/src/sgml/stylesheet-hh.xsl new file mode 100644 index 000000000..09a95041d --- /dev/null +++ b/doc/src/sgml/stylesheet-hh.xsl @@ -0,0 +1,41 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0' + xmlns="http://www.w3.org/TR/xhtml1/transitional" + exclude-result-prefixes="#default"> + +<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/> +<xsl:include href="stylesheet-common.xsl" /> + +<!-- Parameters --> +<xsl:param name="htmlhelp.use.hhk" select="'1'"/> + +<xsl:param name="html.stylesheet" select="'stylesheet.css'"></xsl:param> +<xsl:param name="use.id.as.filename" select="'1'"></xsl:param> +<xsl:param name="make.valid.html" select="1"></xsl:param> +<xsl:param name="generate.id.attributes" select="1"></xsl:param> +<xsl:param name="generate.legalnotice.link" select="1"></xsl:param> +<xsl:param name="link.mailto.url">pgsql-docs@postgresql.org</xsl:param> +<xsl:param name="chunker.output.indent" select="'yes'"/> +<xsl:param name="chunk.quietly" select="1"></xsl:param> + + +<!-- Change display of some elements --> + +<xsl:template match="command"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<!-- + Format multiple terms in varlistentry vertically, instead + of comma-separated. + --> + +<xsl:template match="varlistentry/term[position()!=last()]"> + <span class="term"> + <xsl:call-template name="anchor"/> + <xsl:apply-templates/> + </span><br/> +</xsl:template> + +</xsl:stylesheet> diff --git a/doc/src/sgml/stylesheet-man.xsl b/doc/src/sgml/stylesheet-man.xsl new file mode 100644 index 000000000..1feb4f5ec --- /dev/null +++ b/doc/src/sgml/stylesheet-man.xsl @@ -0,0 +1,211 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:exsl="http://exslt.org/common" + version='1.0' + exclude-result-prefixes="exsl"> + +<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"/> +<xsl:import href="stylesheet-common.xsl" /> + + +<!-- Parameters --> + +<xsl:param name="man.authors.section.enabled">0</xsl:param> +<xsl:param name="man.copyright.section.enabled">0</xsl:param> +<xsl:param name="man.output.base.dir"></xsl:param> +<xsl:param name="man.output.in.separate.dir" select="1"></xsl:param> +<xsl:param name="refentry.meta.get.quietly" select="0"></xsl:param> +<xsl:param name="man.th.title.max.length">32</xsl:param> <!-- enough room for "CREATE TEXT SEARCH CONFIGURATION" --> +<xsl:param name="man.th.extra3.max.length">40</xsl:param> <!-- enough room for "PostgreSQL X.Ydevel Documentation" --> +<xsl:param name="refentry.xref.manvolnum" select="1"/> <!-- overridden from stylesheet-common.xsl --> + +<!-- Fixup for apostrophe groff output. See the following references: + <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=457839> + <https://sourceforge.net/tracker/?func=detail&aid=2412738&group_id=21935&atid=373747> + --> +<xsl:param name="man.string.subst.map.local.post"> + <substitution oldstring="\'" newstring="\(aq"></substitution> +</xsl:param> + + +<!-- Custom templates --> + +<!-- Improve output of email element. See also + <https://sourceforge.net/tracker/?func=detail&aid=3524417&group_id=21935&atid=373747> + --> +<xsl:template match="email"> + <xsl:text>&lt;</xsl:text> + <xsl:apply-templates/> + <xsl:text>&gt;</xsl:text> +</xsl:template> + + +<xsl:template match="refentry" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + + <xsl:choose> + <!-- If the refname contains a space, we construct a reference + like CREATE DATABASE (CREATE_DATABASE(7)), so the reader + knows both the command name being referred to and the name of + the man page to read about it. --> + <xsl:when test="contains(refnamediv/refname[1],' ')"> + <xsl:variable name="mangled.title"> + <xsl:value-of select="translate(refnamediv/refname[1],' ','_')"/> + </xsl:variable> + <xsl:apply-templates select="refnamediv/refname[1]"/> + <xsl:text> (</xsl:text> + <xsl:call-template name="bold"> + <xsl:with-param name="node" select="exsl:node-set($mangled.title)"/> + <xsl:with-param name="context" select="."/> + </xsl:call-template> + <xsl:apply-templates select="refmeta/manvolnum"/> + <xsl:text>)</xsl:text> + </xsl:when> + + <!-- This is the original case, except that boldness has been + added, per the convention mentioned in man-pages(7). --> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="refmeta/refentrytitle"> + <xsl:call-template name="bold"> + <xsl:with-param name="node" select="refmeta/refentrytitle"/> + <xsl:with-param name="context" select="."/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="bold"> + <xsl:with-param name="node" select="refnamediv/refname[1]"/> + <xsl:with-param name="context" select="."/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + <xsl:apply-templates select="refmeta/manvolnum"/> + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + + +<!-- For refentries we don't man to generate a man page for, leave out + manvolnum, let it default to 0, and skip writing out man files + with section 0. --> + +<!-- overridden from common/refentry.xsl --> +<xsl:template name="get.refentry.section"> + <xsl:choose> + <xsl:when test="refmeta/manvolnum"> + <xsl:value-of select="refmeta/manvolnum"/> + </xsl:when> + <xsl:otherwise> + <xsl:text>0</xsl:text> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- overridden from manpages/other.xsl --> + <xsl:template name="write.man.file"> + <xsl:param name="name"/> + <xsl:param name="section"/> + <xsl:param name="lang"/> + <xsl:param name="content"/> + <xsl:param name="filename"> + <xsl:call-template name="make.adjusted.man.filename"> + <xsl:with-param name="name" select="$name"/> + <xsl:with-param name="section" select="$section"/> + <xsl:with-param name="lang" select="$lang"/> + </xsl:call-template> + </xsl:param> + <xsl:if test="$section != 0"> + <xsl:call-template name="write.text.chunk"> + <xsl:with-param name="filename" select="$filename"/> + <xsl:with-param name="suppress-context-node-name" select="1"/> + <xsl:with-param name="quiet" select="$man.output.quietly"/> + <xsl:with-param + name="message-prolog" + >Note: </xsl:with-param> + <xsl:with-param name="encoding" select="$man.output.encoding"/> + <xsl:with-param name="content" select="$content"/> + </xsl:call-template> + </xsl:if> + </xsl:template> + + +<!-- Overridden template as workaround for this problem: + <https://sourceforge.net/tracker/?func=detail&aid=2831602&group_id=21935&atid=373747> +--> + <xsl:template name="write.stubs"> + <xsl:param name="first.refname"/> + <xsl:param name="section"/> + <xsl:param name="lang"/> + <xsl:for-each select="refnamediv/refname"> + <xsl:if test=". != $first.refname"> + <xsl:call-template name="write.text.chunk"> + <xsl:with-param name="filename"> + <xsl:call-template name="make.adjusted.man.filename"> + <xsl:with-param name="name" select="."/> + <xsl:with-param name="section" select="$section"/> + <xsl:with-param name="lang" select="$lang"/> + </xsl:call-template> + </xsl:with-param> + <xsl:with-param name="quiet" select="$man.output.quietly"/> + <xsl:with-param name="suppress-context-node-name" select="1"/> + <xsl:with-param name="message-prolog">Note: </xsl:with-param> + <xsl:with-param name="message-epilog"> (soelim stub)</xsl:with-param> + <xsl:with-param name="content"> + <xsl:choose> + <xsl:when test="$man.output.in.separate.dir = 0"> + <xsl:value-of select="concat('.so man', $section, '/')"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="'.so '"/> <!-- added case --> + </xsl:otherwise> + </xsl:choose> + <xsl:call-template name="make.adjusted.man.filename"> + <xsl:with-param name="name" select="$first.refname"/> + <xsl:with-param name="section" select="$section"/> + </xsl:call-template> + <xsl:text>&#10;</xsl:text> + </xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:for-each> + </xsl:template> + + + <!-- https://sourceforge.net/tracker/?func=detail&aid=3545150&group_id=21935&atid=373747 --> + <xsl:template match="step/title"> + <xsl:apply-templates/> + <xsl:text>: </xsl:text> + </xsl:template> + + + <!-- http://sourceforge.net/p/docbook/bugs/1340/ --> + <xsl:template match="indexterm"/> + + +<!-- Gentext customization --> + +<!-- see http://www.sagehill.net/docbookxsl/CustomGentext.html --> +<xsl:param name="local.l10n.xml" select="document('')"/> +<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"> + <l:l10n language="en"> + <!-- Use ISO 8601 date format. --> + <l:context name="datetime"> + <l:template name="format" text="Y-m-d"/> + </l:context> + + <!-- Slight rephrasing to indicate that missing sections are found + in the documentation. --> + <l:context name="xref-number-and-title"> + <l:template name="chapter" text="Chapter %n, %t, in the documentation"/> + <l:template name="sect1" text="Section %n, “%t”, in the documentation"/> + <l:template name="sect2" text="Section %n, “%t”, in the documentation"/> + <l:template name="sect3" text="Section %n, “%t”, in the documentation"/> + <l:template name="sect4" text="Section %n, “%t”, in the documentation"/> + <l:template name="sect5" text="Section %n, “%t”, in the documentation"/> + </l:context> + </l:l10n> +</l:i18n> + +</xsl:stylesheet> diff --git a/doc/src/sgml/stylesheet.css b/doc/src/sgml/stylesheet.css new file mode 100644 index 000000000..60dcc7620 --- /dev/null +++ b/doc/src/sgml/stylesheet.css @@ -0,0 +1,98 @@ +/* doc/src/sgml/stylesheet.css */ + +/* color scheme similar to www.postgresql.org */ + +BODY { + color: #000000; + background: #FFFFFF; + font-family: verdana, sans-serif; +} + +A:link { color:#0066A2; } +A:visited { color:#004E66; } +A:active { color:#0066A2; } +A:hover { color:#000000; } + +H1 { + font-size: 1.4em; + font-weight: bold; + margin-top: 0em; + margin-bottom: 0em; + color: #EC5800; +} + +H2 { + font-size: 1.2em; + margin: 1.2em 0em 1.2em 0em; + font-weight: bold; + color: #666; +} + +H3 { + font-size: 1.1em; + margin: 1.2em 0em 1.2em 0em; + font-weight: bold; + color: #666; +} + +H4 { + font-size: 0.95em; + margin: 1.2em 0em 1.2em 0em; + font-weight: normal; + color: #666; +} + +H5 { + font-size: 0.9em; + margin: 1.2em 0em 1.2em 0em; + font-weight: normal; +} + +H6 { + font-size: 0.85em; + margin: 1.2em 0em 1.2em 0em; + font-weight: normal; +} + +/* center some titles */ + +.BOOK .TITLE, .BOOK .CORPAUTHOR, .BOOK .COPYRIGHT { + text-align: center; +} + +/* decoration for formal examples */ + +DIV.EXAMPLE { + padding-left: 15px; + border-style: solid; + border-width: 0px; + border-left-width: 2px; + border-color: black; + margin: 0.5ex; +} + +/* less dense spacing of TOC */ + +.BOOK .TOC DL DT { + padding-top: 1.5ex; + padding-bottom: 1.5ex; +} + +.BOOK .TOC DL DL DT { + padding-top: 0ex; + padding-bottom: 0ex; +} + +/* miscellaneous */ + +PRE.LITERALLAYOUT, .SCREEN, .SYNOPSIS, .PROGRAMLISTING { + margin-left: 4ex; +} + +.COMMENT { color: red; } + +VAR { font-family: monospace; font-style: italic; } +/* Konqueror's standard style for ACRONYM is italic. */ +ACRONYM { font-style: inherit; } + +.OPTION { white-space: nowrap; } diff --git a/doc/src/sgml/stylesheet.dsl b/doc/src/sgml/stylesheet.dsl new file mode 100644 index 000000000..61d2963b1 --- /dev/null +++ b/doc/src/sgml/stylesheet.dsl @@ -0,0 +1,841 @@ +<!-- doc/src/sgml/stylesheet.dsl --> +<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [ + +<!-- must turn on one of these with -i on the jade command line --> +<!ENTITY % output-html "IGNORE"> +<!ENTITY % output-print "IGNORE"> +<!ENTITY % output-text "IGNORE"> + +<![ %output-html; [ +<!ENTITY dbstyle PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA DSSSL> +]]> + +<![ %output-print; [ +<!ENTITY dbstyle PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN" CDATA DSSSL> +]]> + +<![ %output-text; [ +<!ENTITY dbstyle PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA DSSSL> +]]> + +]> + +<style-sheet> + <style-specification use="docbook"> + <style-specification-body> + +<!-- general customization ......................................... --> + +<!-- (applicable to all output formats) --> + +(define draft-mode #f) + +(define pgsql-docs-list "pgsql-docs@postgresql.org") + +;; Don't show manpage volume numbers +(define %refentry-xref-manvolnum% #f) + +;; Don't use graphics for callouts. (We could probably do that, but +;; it needs extra work.) +(define %callout-graphics% #f) + +;; Show comments during the development stage. +(define %show-comments% draft-mode) + +;; Don't append period if run-in title ends with any of these +;; characters. We had to add the colon here. This is fixed in +;; stylesheets version 1.71, so it can be removed sometime. +(define %content-title-end-punct% + '(#\. #\! #\? #\:)) + +;; No automatic punctuation after honorific name parts +(define %honorific-punctuation% "") + +;; Change display of some elements +(element command ($mono-seq$)) +(element envar ($mono-seq$)) +(element lineannotation ($italic-seq$)) +(element literal ($mono-seq$)) +(element option ($mono-seq$)) +(element parameter ($mono-seq$)) +(element structfield ($mono-seq$)) +(element structname ($mono-seq$)) +(element symbol ($mono-seq$)) +(element token ($mono-seq$)) +(element type ($mono-seq$)) +(element varname ($mono-seq$)) +(element (programlisting emphasis) ($bold-seq$)) ;; to highlight sections of code + +;; Special support for Tcl synopses +(element optional + (if (equal? (attribute-string (normalize "role")) "tcl") + (make sequence + (literal "?") + ($charseq$) + (literal "?")) + (make sequence + (literal %arg-choice-opt-open-str%) + ($charseq$) + (literal %arg-choice-opt-close-str%)))) + +;; Avoid excessive cross-reference labels +(define (auto-xref-indirect? target ancestor) + (cond +; ;; Always add indirect references to another book +; ((member (gi ancestor) (book-element-list)) +; #t) + ;; Add indirect references to the section or component a block + ;; is in iff chapters aren't autolabelled. (Otherwise "Figure 1-3" + ;; is sufficient) + ((and (member (gi target) (block-element-list)) + (not %chapter-autolabel%)) + #t) + ;; Add indirect references to the component a section is in if + ;; the sections are not autolabelled + ((and (member (gi target) (section-element-list)) + (member (gi ancestor) (component-element-list)) + (not %section-autolabel%)) + #t) + (else #f))) + + +;; Bibliography things + +;; Use the titles of bibliography entries in cross-references +(define biblio-xref-title #t) + +;; Process bibliography entry components in the order shown below, not +;; in the order they appear in the document. (I suppose this should +;; be made to fit some publishing standard.) +(define %biblioentry-in-entry-order% #f) + +(define (biblioentry-inline-elements) + (list + (normalize "author") + (normalize "authorgroup") + (normalize "title") + (normalize "subtitle") + (normalize "volumenum") + (normalize "edition") + (normalize "othercredit") + (normalize "contrib") + (normalize "editor") + (normalize "publishername") + (normalize "confgroup") + (normalize "publisher") + (normalize "isbn") + (normalize "issn") + (normalize "pubsnumber") + (normalize "date") + (normalize "pubdate") + (normalize "pagenums") + (normalize "bibliomisc"))) + +(mode biblioentry-inline-mode + + (element confgroup + (make sequence + (literal "Proc. ") + (next-match))) + + (element isbn + (make sequence + (literal "ISBN ") + (process-children))) + + (element issn + (make sequence + (literal "ISSN ") + (process-children)))) + + +;; The rules in the default stylesheet for productname format it as a +;; paragraph. This may be suitable for productname directly within +;; *info, but it's nonsense when productname is used inline, as we do. +(mode book-titlepage-recto-mode + (element (para productname) ($charseq$))) +(mode book-titlepage-verso-mode + (element (para productname) ($charseq$))) +;; Add more here if needed... + + +;; Replace a sequence of whitespace in a string by a single space +(define (normalize-whitespace str #!optional (whitespace '(#\space #\U-000D))) + (let loop ((characters (string->list str)) + (result '()) + (prev-was-space #f)) + (if (null? characters) + (list->string (reverse result)) + (let ((c (car characters)) + (rest (cdr characters))) + (if (member c whitespace) + (if prev-was-space + (loop rest result #t) + (loop rest (cons #\space result) #t)) + (loop rest (cons c result) #f)))))) + + +<!-- HTML output customization ..................................... --> + +<![ %output-html; [ + +(define %section-autolabel% #t) +(define %label-preface-sections% #f) +(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 website-stylesheet #f) +(define %stylesheet% (if website-stylesheet "http://www.postgresql.org/media/css/docs.css" "stylesheet.css")) +(define %graphic-default-extension% "gif") +(define %body-attr% '()) +(define ($generate-book-lot-list$) '()) +(define use-output-dir #t) +(define %output-dir% "html") +(define html-index-filename "../HTML.index") + + +;; Only build HTML.index or the actual HTML output, not both. Saves a +;; *lot* of time. (overrides docbook.dsl) +(root + (if (not html-index) + (make sequence + (process-children) + (with-mode manifest + (process-children))) + (with-mode htmlindex + (process-children)))) + + +;; Do not combine first section into chapter chunk. +(define (chunk-skip-first-element-list) '()) + +;; Returns the depth of auto TOC that should be made at the nd-level +(define (toc-depth nd) + (cond ((string=? (gi nd) (normalize "book")) 2) + ((string=? (gi nd) (normalize "part")) 2) + ((string=? (gi nd) (normalize "chapter")) 2) + (else 1))) + +;; Add character encoding and time of creation into HTML header +(define %html-header-tags% + (list (list "META" '("HTTP-EQUIV" "Content-Type") '("CONTENT" "text/html; charset=ISO-8859-1")) + (list "META" '("NAME" "creation") (list "CONTENT" (time->string (time) #t))))) + + +;; Block elements are allowed in PARA in DocBook, but not in P in +;; HTML. With %fix-para-wrappers% turned on, the stylesheets attempt +;; to avoid putting block elements in HTML P tags by outputting +;; additional end/begin P pairs around them. +(define %fix-para-wrappers% #t) + +;; ...but we need to do some extra work to make the above apply to PRE +;; as well. (mostly pasted from dbverb.dsl) +(define ($verbatim-display$ indent line-numbers?) + (let ((content (make element gi: "PRE" + attributes: (list + (list "CLASS" (gi))) + (if (or indent line-numbers?) + ($verbatim-line-by-line$ indent line-numbers?) + (process-children))))) + (if %shade-verbatim% + (make element gi: "TABLE" + attributes: ($shade-verbatim-attr$) + (make element gi: "TR" + (make element gi: "TD" + content))) + (make sequence + (para-check) + content + (para-check 'restart))))) + +;; ...and for notes. +(element note + (make sequence + (para-check) + ($admonition$) + (para-check 'restart))) + +;;; XXX The above is very ugly. It might be better to run 'tidy' on +;;; the resulting *.html files. + + +;; Format multiple terms in varlistentry vertically, instead +;; of comma-separated. +(element (varlistentry term) + (make sequence + (process-children-trim) + (if (not (last-sibling?)) + (make empty-element gi: "BR") + (empty-sosofo)))) + + +;; Customization of header +;; - make title a link to the home page +;; - add tool tips to Prev/Next links +;; - add Up link +;; (overrides dbnavig.dsl) +(define (default-header-nav-tbl-noff elemnode prev next prevsib nextsib) + (let* ((r1? (nav-banner? elemnode)) + (r1-sosofo (make element gi: "TR" + (make element gi: "TH" + attributes: (list + (list "COLSPAN" "4") + (list "ALIGN" "center") + (list "VALIGN" "bottom")) + (make element gi: "A" + attributes: (list + (list "HREF" (href-to (nav-home elemnode)))) + (nav-banner elemnode))))) + (r2? (or (not (node-list-empty? prev)) + (not (node-list-empty? next)) + (nav-context? elemnode))) + (r2-sosofo (make element gi: "TR" + (make element gi: "TD" + attributes: (list + (list "WIDTH" "10%") + (list "ALIGN" "left") + (list "VALIGN" "top")) + (if (node-list-empty? prev) + (make entity-ref name: "nbsp") + (make element gi: "A" + attributes: (list + (list "TITLE" (element-title-string prev)) + (list "HREF" + (href-to + prev)) + (list "ACCESSKEY" + "P")) + (gentext-nav-prev prev)))) + (make element gi: "TD" + attributes: (list + (list "WIDTH" "10%") + (list "ALIGN" "left") + (list "VALIGN" "top")) + (if (nav-up? elemnode) + (nav-up elemnode) + (nav-home-link elemnode))) + (make element gi: "TD" + attributes: (list + (list "WIDTH" "60%") + (list "ALIGN" "center") + (list "VALIGN" "bottom")) + (nav-context elemnode)) + (make element gi: "TD" + attributes: (list + (list "WIDTH" "20%") + (list "ALIGN" "right") + (list "VALIGN" "top")) + (if (node-list-empty? next) + (make entity-ref name: "nbsp") + (make element gi: "A" + attributes: (list + (list "TITLE" (element-title-string next)) + (list "HREF" + (href-to + next)) + (list "ACCESSKEY" + "N")) + (gentext-nav-next next))))))) + (if (or r1? r2?) + (make element gi: "DIV" + attributes: '(("CLASS" "NAVHEADER")) + (make element gi: "TABLE" + attributes: (list + (list "SUMMARY" "Header navigation table") + (list "WIDTH" %gentext-nav-tblwidth%) + (list "BORDER" "0") + (list "CELLPADDING" "0") + (list "CELLSPACING" "0")) + (if r1? r1-sosofo (empty-sosofo)) + (if r2? r2-sosofo (empty-sosofo))) + (make empty-element gi: "HR" + attributes: (list + (list "ALIGN" "LEFT") + (list "WIDTH" %gentext-nav-tblwidth%)))) + (empty-sosofo)))) + + +;; Put index "quicklinks" (A | B | C | ...) at the top of the bookindex page. + +(element index + (let ((preamble (node-list-filter-by-not-gi + (children (current-node)) + (list (normalize "indexentry")))) + (indexdivs (node-list-filter-by-gi + (children (current-node)) + (list (normalize "indexdiv")))) + (entries (node-list-filter-by-gi + (children (current-node)) + (list (normalize "indexentry"))))) + (html-document + (with-mode head-title-mode + (literal (element-title-string (current-node)))) + (make element gi: "DIV" + attributes: (list (list "CLASS" (gi))) + ($component-separator$) + ($component-title$) + (if (node-list-empty? indexdivs) + (empty-sosofo) + (make element gi: "P" + attributes: (list (list "CLASS" "INDEXDIV-QUICKLINKS")) + (with-mode indexdiv-quicklinks-mode + (process-node-list indexdivs)))) + (process-node-list preamble) + (if (node-list-empty? entries) + (empty-sosofo) + (make element gi: "DL" + (process-node-list entries))))))) + + +(mode indexdiv-quicklinks-mode + (element indexdiv + (make sequence + (make element gi: "A" + attributes: (list (list "HREF" (href-to (current-node)))) + (element-title-sosofo)) + (if (not (last-sibling?)) + (literal " | ") + (literal ""))))) + + +;; Changed to strip and normalize index term content (overrides +;; dbindex.dsl) +(define (htmlindexterm) + (let* ((attr (gi (current-node))) + (content (data (current-node))) + (string (strip (normalize-whitespace content))) ;; changed + (sortas (attribute-string (normalize "sortas")))) + (make sequence + (make formatting-instruction data: attr) + (if sortas + (make sequence + (make formatting-instruction data: "[") + (make formatting-instruction data: sortas) + (make formatting-instruction data: "]")) + (empty-sosofo)) + (make formatting-instruction data: " ") + (make formatting-instruction data: string) + (htmlnewline)))) + + +]]> <!-- %output-html --> + + +<!-- Print output customization .................................... --> + +<![ %output-print; [ + +(define %section-autolabel% #t) +(define %default-quadding% 'justify) + +;; Don't know how well hyphenation works with other backends. Might +;; turn this on if desired. +(define %hyphenation% + (if tex-backend #t #f)) + +;; Put footnotes at the bottom of the page (rather than end of +;; section), and put the URLs of links into footnotes. +;; +;; bop-footnotes only works with TeX, otherwise it's ignored. But +;; when both of these are #t and TeX is used, you need at least +;; stylesheets 1.73 because otherwise you don't get any footnotes at +;; all for the links. +(define bop-footnotes #t) +(define %footnote-ulinks% #t) + +(define %refentry-new-page% #t) +(define %refentry-keep% #f) + +;; Disabled because of TeX problems +;; (http://archives.postgresql.org/pgsql-docs/2007-12/msg00056.php) +(define ($generate-book-lot-list$) '()) + +;; Indentation of verbatim environments. (This should really be done +;; with start-indent in DSSSL.) +;; Use of indentation in this area exposes a bug in openjade, +;; http://archives.postgresql.org/pgsql-docs/2006-12/msg00064.php +;; (define %indent-programlisting-lines% " ") +;; (define %indent-screen-lines% " ") +;; (define %indent-synopsis-lines% " ") + + +;; Default graphic format: Jadetex wants eps, pdfjadetex wants pdf. +;; (Note that pdfjadetex will not accept eps, that's why we need to +;; create a different .tex file for each.) What works with RTF? + +(define texpdf-output #f) ;; override from command line + +(define %graphic-default-extension% + (cond (tex-backend (if texpdf-output "pdf" "eps")) + (rtf-backend "gif") + (else "XXX"))) + +;; Need to add pdf here so that the above works. Default setup +;; doesn't know about PDF. +(define preferred-mediaobject-extensions + (list "eps" "ps" "jpg" "jpeg" "pdf" "png")) + + +;; Don't show links when citing a bibliography entry. This fouls up +;; the footnumber counting. To get the link, one can still look into +;; the bibliography itself. +(mode xref-title-mode + (element ulink + (process-children))) + + +;; Format legalnotice justified and with space between paragraphs. +(mode book-titlepage-verso-mode + (element (legalnotice para) + (make paragraph + use: book-titlepage-verso-style ;; alter this if ever it needs to appear elsewhere + quadding: %default-quadding% + line-spacing: (* 0.8 (inherited-line-spacing)) + font-size: (* 0.8 (inherited-font-size)) + space-before: (* 0.8 %para-sep%) + space-after: (* 0.8 %para-sep%) + first-line-start-indent: (if (is-first-para) + (* 0.8 %para-indent-firstpara%) + (* 0.8 %para-indent%)) + (process-children)))) + + +;; Fix spacing problems in variablelists + +(element (varlistentry term) + (make paragraph + space-before: (if (first-sibling?) + %para-sep% + 0pt) + keep-with-next?: #t + (process-children))) + +(define %varlistentry-indent% 2em) + +(element (varlistentry listitem) + (make sequence + start-indent: (+ (inherited-start-indent) %varlistentry-indent%) + (process-children))) + + +;; Whitespace fixes for itemizedlists and orderedlists + +(define (process-listitem-content) + (if (absolute-first-sibling?) + (make sequence + (process-children-trim)) + (next-match))) + + +;; Default stylesheets format simplelists as tables. This spells +;; trouble for Jade. So we just format them as plain lines. + +(define %simplelist-indent% 1em) + +(define (my-simplelist-vert members) + (make display-group + space-before: %para-sep% + space-after: %para-sep% + start-indent: (+ %simplelist-indent% (inherited-start-indent)) + (process-children))) + +(element simplelist + (let ((type (attribute-string (normalize "type"))) + (cols (if (attribute-string (normalize "columns")) + (if (> (string->number (attribute-string (normalize "columns"))) 0) + (string->number (attribute-string (normalize "columns"))) + 1) + 1)) + (members (select-elements (children (current-node)) (normalize "member")))) + (cond + ((equal? type (normalize "inline")) + (if (equal? (gi (parent (current-node))) + (normalize "para")) + (process-children) + (make paragraph + space-before: %para-sep% + space-after: %para-sep% + start-indent: (inherited-start-indent)))) + ((equal? type (normalize "vert")) + (my-simplelist-vert members)) + ((equal? type (normalize "horiz")) + (simplelist-table 'row cols members))))) + +(element member + (let ((type (inherited-attribute-string (normalize "type")))) + (cond + ((equal? type (normalize "inline")) + (make sequence + (process-children) + (if (not (last-sibling?)) + (literal ", ") + (literal "")))) + ((equal? type (normalize "vert")) + (make paragraph + space-before: 0pt + space-after: 0pt)) + ((equal? type (normalize "horiz")) + (make paragraph + quadding: 'start + (process-children)))))) + + +;; Jadetex doesn't handle links to the content of tables, so +;; indexterms that point to table entries will go nowhere. We fix +;; this by pointing the index entry to the table itself instead, which +;; should be equally useful in practice. + +(define (find-parent-table nd) + (let ((table (ancestor-member nd ($table-element-list$)))) + (if (node-list-empty? table) + nd + table))) + +;; (The function below overrides the one in print/dbindex.dsl.) + +(define (indexentry-link nd) + (let* ((id (attribute-string (normalize "role") nd)) + (prelim-target (find-indexterm id)) + (target (find-parent-table prelim-target)) + (preferred (not (node-list-empty? + (select-elements (children (current-node)) + (normalize "emphasis"))))) + (sosofo (if (node-list-empty? target) + (literal "?") + (make link + destination: (node-list-address target) + (with-mode toc-page-number-mode + (process-node-list target)))))) + (if preferred + (make sequence + font-weight: 'bold + sosofo) + sosofo))) + + +;; By default, the part and reference title pages get wrong page +;; numbers: The first title page gets roman numerals carried over from +;; preface/toc -- we want Arabic numerals. We also need to make sure +;; that page-number-restart is set of #f explicitly, because otherwise +;; it will carry over from the previous component, which is not good. +;; +;; (This looks worse than it is. It's copied from print/dbttlpg.dsl +;; and common/dbcommon.dsl and modified in minor detail.) + +(define (first-part?) + (let* ((book (ancestor (normalize "book"))) + (nd (ancestor-member (current-node) + (append + (component-element-list) + (division-element-list)))) + (bookch (children book))) + (let loop ((nl bookch)) + (if (node-list-empty? nl) + #f + (if (equal? (gi (node-list-first nl)) (normalize "part")) + (if (node-list=? (node-list-first nl) nd) + #t + #f) + (loop (node-list-rest nl))))))) + +(define (first-reference?) + (let* ((book (ancestor (normalize "book"))) + (nd (ancestor-member (current-node) + (append + (component-element-list) + (division-element-list)))) + (bookch (children book))) + (let loop ((nl bookch)) + (if (node-list-empty? nl) + #f + (if (equal? (gi (node-list-first nl)) (normalize "reference")) + (if (node-list=? (node-list-first nl) nd) + #t + #f) + (loop (node-list-rest nl))))))) + + +(define (part-titlepage elements #!optional (side 'recto)) + (let ((nodelist (titlepage-nodelist + (if (equal? side 'recto) + (reference-titlepage-recto-elements) + (reference-titlepage-verso-elements)) + elements)) + ;; partintro is a special case... + (partintro (node-list-first + (node-list-filter-by-gi elements (list (normalize "partintro")))))) + (if (part-titlepage-content? elements side) + (make simple-page-sequence + page-n-columns: %titlepage-n-columns% + ;; Make sure that page number format is correct. + page-number-format: ($page-number-format$) + ;; Make sure that the page number is set to 1 if this is the + ;; first part in the book + page-number-restart?: (first-part?) + input-whitespace-treatment: 'collapse + use: default-text-style + + ;; This hack is required for the RTF backend. If an external-graphic + ;; is the first thing on the page, RTF doesn't seem to do the right + ;; thing (the graphic winds up on the baseline of the first line + ;; of the page, left justified). This "one point rule" fixes + ;; that problem. + (make paragraph + line-spacing: 1pt + (literal "")) + + (let loop ((nl nodelist) (lastnode (empty-node-list))) + (if (node-list-empty? nl) + (empty-sosofo) + (make sequence + (if (or (node-list-empty? lastnode) + (not (equal? (gi (node-list-first nl)) + (gi lastnode)))) + (part-titlepage-before (node-list-first nl) side) + (empty-sosofo)) + (cond + ((equal? (gi (node-list-first nl)) (normalize "subtitle")) + (part-titlepage-subtitle (node-list-first nl) side)) + ((equal? (gi (node-list-first nl)) (normalize "title")) + (part-titlepage-title (node-list-first nl) side)) + (else + (part-titlepage-default (node-list-first nl) side))) + (loop (node-list-rest nl) (node-list-first nl))))) + + (if (and %generate-part-toc% + %generate-part-toc-on-titlepage% + (equal? side 'recto)) + (make display-group + (build-toc (current-node) + (toc-depth (current-node)))) + (empty-sosofo)) + + ;; PartIntro is a special case + (if (and (equal? side 'recto) + (not (node-list-empty? partintro)) + %generate-partintro-on-titlepage%) + ($process-partintro$ partintro #f) + (empty-sosofo))) + + (empty-sosofo)))) + + +(define (reference-titlepage elements #!optional (side 'recto)) + (let ((nodelist (titlepage-nodelist + (if (equal? side 'recto) + (reference-titlepage-recto-elements) + (reference-titlepage-verso-elements)) + elements)) + ;; partintro is a special case... + (partintro (node-list-first + (node-list-filter-by-gi elements (list (normalize "partintro")))))) + (if (reference-titlepage-content? elements side) + (make simple-page-sequence + page-n-columns: %titlepage-n-columns% + ;; Make sure that page number format is correct. + page-number-format: ($page-number-format$) + ;; Make sure that the page number is set to 1 if this is the + ;; first part in the book + page-number-restart?: (first-reference?) + input-whitespace-treatment: 'collapse + use: default-text-style + + ;; This hack is required for the RTF backend. If an external-graphic + ;; is the first thing on the page, RTF doesn't seem to do the right + ;; thing (the graphic winds up on the baseline of the first line + ;; of the page, left justified). This "one point rule" fixes + ;; that problem. + (make paragraph + line-spacing: 1pt + (literal "")) + + (let loop ((nl nodelist) (lastnode (empty-node-list))) + (if (node-list-empty? nl) + (empty-sosofo) + (make sequence + (if (or (node-list-empty? lastnode) + (not (equal? (gi (node-list-first nl)) + (gi lastnode)))) + (reference-titlepage-before (node-list-first nl) side) + (empty-sosofo)) + (cond + ((equal? (gi (node-list-first nl)) (normalize "author")) + (reference-titlepage-author (node-list-first nl) side)) + ((equal? (gi (node-list-first nl)) (normalize "authorgroup")) + (reference-titlepage-authorgroup (node-list-first nl) side)) + ((equal? (gi (node-list-first nl)) (normalize "corpauthor")) + (reference-titlepage-corpauthor (node-list-first nl) side)) + ((equal? (gi (node-list-first nl)) (normalize "editor")) + (reference-titlepage-editor (node-list-first nl) side)) + ((equal? (gi (node-list-first nl)) (normalize "subtitle")) + (reference-titlepage-subtitle (node-list-first nl) side)) + ((equal? (gi (node-list-first nl)) (normalize "title")) + (reference-titlepage-title (node-list-first nl) side)) + (else + (reference-titlepage-default (node-list-first nl) side))) + (loop (node-list-rest nl) (node-list-first nl))))) + + (if (and %generate-reference-toc% + %generate-reference-toc-on-titlepage% + (equal? side 'recto)) + (make display-group + (build-toc (current-node) + (toc-depth (current-node)))) + (empty-sosofo)) + + ;; PartIntro is a special case + (if (and (equal? side 'recto) + (not (node-list-empty? partintro)) + %generate-partintro-on-titlepage%) + ($process-partintro$ partintro #f) + (empty-sosofo))) + + (empty-sosofo)))) + +]]> <!-- %output-print --> + + +<!-- Plain text output customization ............................... --> + +<!-- +This is used for making the INSTALL file and others. We customize the +HTML stylesheets to be suitable for dumping plain text (via Netscape, +Lynx, or similar). +--> + +<![ %output-text; [ + +(define %section-autolabel% #f) +(define %chapter-autolabel% #f) +(define $generate-chapter-toc$ (lambda () #f)) + +;; For text output, produce "ASCII markup" for emphasis and such. + +(define ($asterix-seq$ #!optional (sosofo (process-children))) + (make sequence + (literal "*") + sosofo + (literal "*"))) + +(define ($dquote-seq$ #!optional (sosofo (process-children))) + (make sequence + (literal (gentext-start-quote)) + sosofo + (literal (gentext-end-quote)))) + +(element (para command) ($dquote-seq$)) +(element (para emphasis) ($asterix-seq$)) +(element (para filename) ($dquote-seq$)) +(element (para option) ($dquote-seq$)) +(element (para replaceable) ($dquote-seq$)) +(element (para userinput) ($dquote-seq$)) + +]]> <!-- %output-text --> + + </style-specification-body> + </style-specification> + + <external-specification id="docbook" document="dbstyle"> +</style-sheet> diff --git a/doc/src/sgml/stylesheet.xsl b/doc/src/sgml/stylesheet.xsl new file mode 100644 index 000000000..7967b361d --- /dev/null +++ b/doc/src/sgml/stylesheet.xsl @@ -0,0 +1,61 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0' + xmlns="http://www.w3.org/TR/xhtml1/transitional" + exclude-result-prefixes="#default"> + +<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl"/> +<xsl:include href="stylesheet-common.xsl" /> + + +<!-- Parameters --> +<xsl:param name="base.dir" select="'html/'"></xsl:param> +<xsl:param name="use.id.as.filename" select="'1'"></xsl:param> +<xsl:param name="make.valid.html" select="1"></xsl:param> +<xsl:param name="generate.id.attributes" select="1"></xsl:param> +<xsl:param name="generate.legalnotice.link" select="1"></xsl:param> +<xsl:param name="link.mailto.url">pgsql-docs@postgresql.org</xsl:param> +<xsl:param name="chunk.first.sections" select="1"/> +<xsl:param name="chunk.quietly" select="1"></xsl:param> +<xsl:param name="toc.max.depth">2</xsl:param> + +<xsl:param name="website.stylesheet" select="0"/> + +<xsl:param name="html.stylesheet"> + <xsl:choose> + <xsl:when test="$website.stylesheet = 0">stylesheet.css</xsl:when> + <xsl:otherwise>http://www.postgresql.org/media/css/docs.css</xsl:otherwise> + </xsl:choose> +</xsl:param> + + +<!-- Change display of some elements --> + +<xsl:template match="command"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + + +<!-- table of contents configuration --> + +<xsl:param name="generate.toc"> +appendix toc,title +article/appendix nop +article toc,title +book toc,title +chapter toc,title +part toc,title +preface toc,title +qandadiv toc +qandaset toc +reference toc,title +sect1 toc +sect2 toc +sect3 toc +sect4 toc +sect5 toc +section toc +set toc,title +</xsl:param> + +</xsl:stylesheet> diff --git a/doc/src/sgml/version.sgml b/doc/src/sgml/version.sgml new file mode 100644 index 000000000..0474bcd90 --- /dev/null +++ b/doc/src/sgml/version.sgml @@ -0,0 +1 @@ +<!ENTITY version "3.5.0"> diff --git a/doc/src/stylesheet-common.xsl b/doc/src/stylesheet-common.xsl new file mode 100644 index 000000000..9c8f61310 --- /dev/null +++ b/doc/src/stylesheet-common.xsl @@ -0,0 +1,85 @@ +<?xml version="1.0" encoding="utf-8"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<!-- + This file contains XSLT stylesheet customizations that are common to + all output formats (HTML, HTML Help, XSL-FO, etc.). + --> + + +<!-- Parameters --> + +<xsl:param name="pg.fast" select="'0'"/> + +<!-- +<xsl:param name="draft.mode"> + <xsl:choose> + <xsl:when test="contains($pgpool.version, 'devel')">yes</xsl:when> + <xsl:otherwise>no</xsl:otherwise> + </xsl:choose> +</xsl:param> +--> + +<xsl:param name="show.comments"> + <xsl:choose> + <xsl:when test="contains($pgpool.version, 'devel')">1</xsl:when> + <xsl:otherwise>0</xsl:otherwise> + </xsl:choose> +</xsl:param> + +<xsl:param name="callout.graphics" select="'0'"></xsl:param> +<xsl:param name="toc.section.depth">2</xsl:param> +<xsl:param name="linenumbering.extension" select="'0'"></xsl:param> +<xsl:param name="generate.index" select="1 - $pg.fast"></xsl:param> +<xsl:param name="section.autolabel" select="1 - $pg.fast"></xsl:param> +<xsl:param name="section.label.includes.component.label" select="1 - $pg.fast"></xsl:param> +<xsl:param name="refentry.xref.manvolnum" select="0"/> +<xsl:param name="formal.procedures" select="0"></xsl:param> +<xsl:param name="punct.honorific" select="''"></xsl:param> +<xsl:param name="variablelist.term.break.after">1</xsl:param> +<xsl:param name="variablelist.term.separator"></xsl:param> + + +<!-- Change display of some elements --> + +<xsl:template match="productname"> + <xsl:call-template name="inline.charseq"/> +</xsl:template> + +<xsl:template match="structfield"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<xsl:template match="structname"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<xsl:template match="symbol"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<xsl:template match="systemitem"> + <xsl:call-template name="inline.charseq"/> +</xsl:template> + +<xsl:template match="token"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<xsl:template match="type"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<xsl:template match="programlisting/emphasis"> + <xsl:call-template name="inline.boldseq"/> +</xsl:template> + + +<!-- Special support for Tcl synopses --> + +<xsl:template match="optional[@role='tcl']"> + ?<xsl:call-template name="inline.charseq"/>? +</xsl:template> + +</xsl:stylesheet> diff --git a/doc/src/stylesheet.css b/doc/src/stylesheet.css new file mode 100644 index 000000000..0fd0f0178 --- /dev/null +++ b/doc/src/stylesheet.css @@ -0,0 +1,96 @@ +/* doc/src/sgml/stylesheet.css */ + +/* color scheme similar to www.postgresql.org */ + +BODY { + color: #000000; + background: #FFFFFF; + font-family: verdana, sans-serif; +} + +A:link { color:#0066A2; } +A:visited { color:#004E66; } +A:active { color:#0066A2; } +A:hover { color:#000000; } + +H1 { + font-size: 1.4em; + font-weight: bold; + margin-top: 0em; + margin-bottom: 0em; + color: #EC5800; +} + +H2 { + font-size: 1.2em; + margin: 1.2em 0em 1.2em 0em; + font-weight: bold; + color: #666; +} + +H3 { + font-size: 1.1em; + margin: 1.2em 0em 1.2em 0em; + font-weight: bold; + color: #666; +} + +H4 { + font-size: 0.95em; + margin: 1.2em 0em 1.2em 0em; + font-weight: normal; + color: #666; +} + +H5 { + font-size: 0.9em; + margin: 1.2em 0em 1.2em 0em; + font-weight: normal; +} + +H6 { + font-size: 0.85em; + margin: 1.2em 0em 1.2em 0em; + font-weight: normal; +} + +/* center some titles */ + +.BOOK .TITLE, .BOOK .CORPAUTHOR, .BOOK .COPYRIGHT { + text-align: center; +} + +/* decoration for formal examples */ + +DIV.EXAMPLE { + padding-left: 15px; + border-style: solid; + border-width: 0px; + border-left-width: 2px; + border-color: black; + margin: 0.5ex; +} + +/* less dense spacing of TOC */ + +.BOOK .TOC DL DT { + padding-top: 1.5ex; + padding-bottom: 1.5ex; +} + +.BOOK .TOC DL DL DT { + padding-top: 0ex; + padding-bottom: 0ex; +} + +/* miscellaneous */ + +PRE.LITERALLAYOUT, .SCREEN, .SYNOPSIS, .PROGRAMLISTING { + margin-left: 4ex; +} + +.COMMENT { color: red; } + +VAR { font-family: monospace; font-style: italic; } +/* Konqueror's standard style for ACRONYM is italic. */ +ACRONYM { font-style: inherit; } diff --git a/doc/src/stylesheet.dsl b/doc/src/stylesheet.dsl new file mode 100644 index 000000000..01b3069e5 --- /dev/null +++ b/doc/src/stylesheet.dsl @@ -0,0 +1,28 @@ +<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [ +<!ENTITY % html "IGNORE"> +<![%html;[ +<!ENTITY % print "IGNORE"> +<!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA dsssl> +]]> +<!ENTITY % print "INCLUDE"> +<![%print;[ +<!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN" CDATA dsssl> +]]> +]> +<style-sheet> +<style-specification id="print" use="docbook"> +<style-specification-body> + +;; customize the print stylesheet + +</style-specification-body> +</style-specification> +<style-specification id="html" use="docbook"> +<style-specification-body> + +;; customize the html stylesheet + +</style-specification-body> +</style-specification> +<external-specification id="docbook" document="docbook.dsl"> +</style-sheet> diff --git a/doc/src/stylesheet.xsl b/doc/src/stylesheet.xsl new file mode 100644 index 000000000..7967b361d --- /dev/null +++ b/doc/src/stylesheet.xsl @@ -0,0 +1,61 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0' + xmlns="http://www.w3.org/TR/xhtml1/transitional" + exclude-result-prefixes="#default"> + +<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl"/> +<xsl:include href="stylesheet-common.xsl" /> + + +<!-- Parameters --> +<xsl:param name="base.dir" select="'html/'"></xsl:param> +<xsl:param name="use.id.as.filename" select="'1'"></xsl:param> +<xsl:param name="make.valid.html" select="1"></xsl:param> +<xsl:param name="generate.id.attributes" select="1"></xsl:param> +<xsl:param name="generate.legalnotice.link" select="1"></xsl:param> +<xsl:param name="link.mailto.url">pgsql-docs@postgresql.org</xsl:param> +<xsl:param name="chunk.first.sections" select="1"/> +<xsl:param name="chunk.quietly" select="1"></xsl:param> +<xsl:param name="toc.max.depth">2</xsl:param> + +<xsl:param name="website.stylesheet" select="0"/> + +<xsl:param name="html.stylesheet"> + <xsl:choose> + <xsl:when test="$website.stylesheet = 0">stylesheet.css</xsl:when> + <xsl:otherwise>http://www.postgresql.org/media/css/docs.css</xsl:otherwise> + </xsl:choose> +</xsl:param> + + +<!-- Change display of some elements --> + +<xsl:template match="command"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + + +<!-- table of contents configuration --> + +<xsl:param name="generate.toc"> +appendix toc,title +article/appendix nop +article toc,title +book toc,title +chapter toc,title +part toc,title +preface toc,title +qandadiv toc +qandaset toc +reference toc,title +sect1 toc +sect2 toc +sect3 toc +sect4 toc +sect5 toc +section toc +set toc,title +</xsl:param> + +</xsl:stylesheet> diff --git a/src/Makefile.in b/src/Makefile.in index f5541003c..6dc95a367 100644 --- a/src/Makefile.in +++ b/src/Makefile.in @@ -85,11 +85,11 @@ DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ $(top_srcdir)/mkinstalldirs config/pool_config.c \ $(top_srcdir)/depcomp $(top_srcdir)/ylwrap ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \ - $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ - $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ - $(top_srcdir)/c-compiler.m4 $(top_srcdir)/c-library.m4 \ - $(top_srcdir)/general.m4 \ +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ $(top_srcdir)/ac_func_accept_argtypes.m4 \ $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ @@ -289,9 +289,11 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +CATALOG = @CATALOG@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ CPP = @CPP@ CPPFLAGS = @CPPFLAGS@ CYGPATH_W = @CYGPATH_W@ @@ -300,6 +302,7 @@ DEFS = @DEFS@ \ DEPDIR = @DEPDIR@ DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ DSYMUTIL = @DSYMUTIL@ DUMPBIN = @DUMPBIN@ ECHO_C = @ECHO_C@ @@ -314,6 +317,7 @@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_SCRIPT = @INSTALL_SCRIPT@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ LD = @LD@ LDFLAGS = @LDFLAGS@ LEX = @LEX@ @@ -325,6 +329,7 @@ LIBTOOL = @LIBTOOL@ LIPO = @LIPO@ LN_S = @LN_S@ LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ MAINT = @MAINT@ MAKEINFO = @MAKEINFO@ MANIFEST_TOOL = @MANIFEST_TOOL@ @@ -335,8 +340,10 @@ MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ MKDIR_P = @MKDIR_P@ NM = @NM@ NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ OBJDUMP = @OBJDUMP@ OBJEXT = @OBJEXT@ +OSX = @OSX@ OTOOL = @OTOOL@ OTOOL64 = @OTOOL64@ PACKAGE = @PACKAGE@ @@ -347,6 +354,7 @@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ PGCONFIG = @PGCONFIG@ PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ @@ -355,7 +363,10 @@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ STRIP = @STRIP@ +STYLE = @STYLE@ VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ YACC = @YACC@ YFLAGS = @YFLAGS@ abs_builddir = @abs_builddir@ @@ -382,6 +393,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ diff --git a/src/include/Makefile.in b/src/include/Makefile.in index 7bc76c808..b435ffc33 100644 --- a/src/include/Makefile.in +++ b/src/include/Makefile.in @@ -81,11 +81,11 @@ subdir = src/include DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ $(srcdir)/config.h.in $(top_srcdir)/mkinstalldirs ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \ - $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ - $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ - $(top_srcdir)/c-compiler.m4 $(top_srcdir)/c-library.m4 \ - $(top_srcdir)/general.m4 \ +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ $(top_srcdir)/ac_func_accept_argtypes.m4 \ $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ @@ -142,9 +142,11 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +CATALOG = @CATALOG@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ CPP = @CPP@ CPPFLAGS = @CPPFLAGS@ CYGPATH_W = @CYGPATH_W@ @@ -153,6 +155,7 @@ DEFS = @DEFS@ \ DEPDIR = @DEPDIR@ DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ DSYMUTIL = @DSYMUTIL@ DUMPBIN = @DUMPBIN@ ECHO_C = @ECHO_C@ @@ -167,6 +170,7 @@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_SCRIPT = @INSTALL_SCRIPT@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ LD = @LD@ LDFLAGS = @LDFLAGS@ LEX = @LEX@ @@ -178,6 +182,7 @@ LIBTOOL = @LIBTOOL@ LIPO = @LIPO@ LN_S = @LN_S@ LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ MAINT = @MAINT@ MAKEINFO = @MAKEINFO@ MANIFEST_TOOL = @MANIFEST_TOOL@ @@ -188,8 +193,10 @@ MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ MKDIR_P = @MKDIR_P@ NM = @NM@ NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ OBJDUMP = @OBJDUMP@ OBJEXT = @OBJEXT@ +OSX = @OSX@ OTOOL = @OTOOL@ OTOOL64 = @OTOOL64@ PACKAGE = @PACKAGE@ @@ -200,6 +207,7 @@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ PGCONFIG = @PGCONFIG@ PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ @@ -208,7 +216,10 @@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ STRIP = @STRIP@ +STYLE = @STYLE@ VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ YACC = @YACC@ YFLAGS = @YFLAGS@ abs_builddir = @abs_builddir@ @@ -235,6 +246,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ diff --git a/src/libs/Makefile.in b/src/libs/Makefile.in index 2fe9a2172..78e153cd1 100644 --- a/src/libs/Makefile.in +++ b/src/libs/Makefile.in @@ -81,11 +81,11 @@ subdir = src/libs DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ $(top_srcdir)/mkinstalldirs ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \ - $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ - $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ - $(top_srcdir)/c-compiler.m4 $(top_srcdir)/c-library.m4 \ - $(top_srcdir)/general.m4 \ +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ $(top_srcdir)/ac_func_accept_argtypes.m4 \ $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ @@ -183,15 +183,18 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +CATALOG = @CATALOG@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ CPP = @CPP@ CPPFLAGS = @CPPFLAGS@ CYGPATH_W = @CYGPATH_W@ DEFS = @DEFS@ DEPDIR = @DEPDIR@ DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ DSYMUTIL = @DSYMUTIL@ DUMPBIN = @DUMPBIN@ ECHO_C = @ECHO_C@ @@ -206,6 +209,7 @@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_SCRIPT = @INSTALL_SCRIPT@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ LD = @LD@ LDFLAGS = @LDFLAGS@ LEX = @LEX@ @@ -217,6 +221,7 @@ LIBTOOL = @LIBTOOL@ LIPO = @LIPO@ LN_S = @LN_S@ LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ MAINT = @MAINT@ MAKEINFO = @MAKEINFO@ MANIFEST_TOOL = @MANIFEST_TOOL@ @@ -227,8 +232,10 @@ MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ MKDIR_P = @MKDIR_P@ NM = @NM@ NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ OBJDUMP = @OBJDUMP@ OBJEXT = @OBJEXT@ +OSX = @OSX@ OTOOL = @OTOOL@ OTOOL64 = @OTOOL64@ PACKAGE = @PACKAGE@ @@ -239,6 +246,7 @@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ PGCONFIG = @PGCONFIG@ PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ @@ -247,7 +255,10 @@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ STRIP = @STRIP@ +STYLE = @STYLE@ VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ YACC = @YACC@ YFLAGS = @YFLAGS@ abs_builddir = @abs_builddir@ @@ -274,6 +285,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ diff --git a/src/libs/pcp/Makefile.in b/src/libs/pcp/Makefile.in index 8ec51fde5..0fc7d4e0f 100644 --- a/src/libs/pcp/Makefile.in +++ b/src/libs/pcp/Makefile.in @@ -84,11 +84,11 @@ DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ $(top_srcdir)/mkinstalldirs $(top_srcdir)/depcomp \ $(include_HEADERS) ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \ - $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ - $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ - $(top_srcdir)/c-compiler.m4 $(top_srcdir)/c-library.m4 \ - $(top_srcdir)/general.m4 \ +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ $(top_srcdir)/ac_func_accept_argtypes.m4 \ $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ @@ -209,15 +209,18 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +CATALOG = @CATALOG@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ CPP = @CPP@ CPPFLAGS = @CPPFLAGS@ CYGPATH_W = @CYGPATH_W@ DEFS = @DEFS@ DEPDIR = @DEPDIR@ DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ DSYMUTIL = @DSYMUTIL@ DUMPBIN = @DUMPBIN@ ECHO_C = @ECHO_C@ @@ -232,6 +235,7 @@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_SCRIPT = @INSTALL_SCRIPT@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ LD = @LD@ LDFLAGS = @LDFLAGS@ LEX = @LEX@ @@ -243,6 +247,7 @@ LIBTOOL = @LIBTOOL@ LIPO = @LIPO@ LN_S = @LN_S@ LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ MAINT = @MAINT@ MAKEINFO = @MAKEINFO@ MANIFEST_TOOL = @MANIFEST_TOOL@ @@ -253,8 +258,10 @@ MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ MKDIR_P = @MKDIR_P@ NM = @NM@ NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ OBJDUMP = @OBJDUMP@ OBJEXT = @OBJEXT@ +OSX = @OSX@ OTOOL = @OTOOL@ OTOOL64 = @OTOOL64@ PACKAGE = @PACKAGE@ @@ -265,6 +272,7 @@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ PGCONFIG = @PGCONFIG@ PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ @@ -273,7 +281,10 @@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ STRIP = @STRIP@ +STYLE = @STYLE@ VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ YACC = @YACC@ YFLAGS = @YFLAGS@ abs_builddir = @abs_builddir@ @@ -300,6 +311,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ diff --git a/src/parser/Makefile.in b/src/parser/Makefile.in index 3d62eaff9..15b07e50a 100644 --- a/src/parser/Makefile.in +++ b/src/parser/Makefile.in @@ -84,11 +84,11 @@ DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ $(top_srcdir)/mkinstalldirs gram.h gram.c \ $(top_srcdir)/depcomp $(top_srcdir)/ylwrap ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \ - $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ - $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ - $(top_srcdir)/c-compiler.m4 $(top_srcdir)/c-library.m4 \ - $(top_srcdir)/general.m4 \ +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ $(top_srcdir)/ac_func_accept_argtypes.m4 \ $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ @@ -207,15 +207,18 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +CATALOG = @CATALOG@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ CPP = @CPP@ CPPFLAGS = @CPPFLAGS@ CYGPATH_W = @CYGPATH_W@ DEFS = @DEFS@ DEPDIR = @DEPDIR@ DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ DSYMUTIL = @DSYMUTIL@ DUMPBIN = @DUMPBIN@ ECHO_C = @ECHO_C@ @@ -230,6 +233,7 @@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_SCRIPT = @INSTALL_SCRIPT@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ LD = @LD@ LDFLAGS = @LDFLAGS@ LEX = @LEX@ @@ -241,6 +245,7 @@ LIBTOOL = @LIBTOOL@ LIPO = @LIPO@ LN_S = @LN_S@ LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ MAINT = @MAINT@ MAKEINFO = @MAKEINFO@ MANIFEST_TOOL = @MANIFEST_TOOL@ @@ -251,8 +256,10 @@ MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ MKDIR_P = @MKDIR_P@ NM = @NM@ NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ OBJDUMP = @OBJDUMP@ OBJEXT = @OBJEXT@ +OSX = @OSX@ OTOOL = @OTOOL@ OTOOL64 = @OTOOL64@ PACKAGE = @PACKAGE@ @@ -263,6 +270,7 @@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ PGCONFIG = @PGCONFIG@ PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ @@ -271,7 +279,10 @@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ STRIP = @STRIP@ +STYLE = @STYLE@ VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ YACC = @YACC@ YFLAGS = @YFLAGS@ abs_builddir = @abs_builddir@ @@ -298,6 +309,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ diff --git a/src/tools/Makefile.in b/src/tools/Makefile.in index c595c24ba..1d4101755 100644 --- a/src/tools/Makefile.in +++ b/src/tools/Makefile.in @@ -81,11 +81,11 @@ subdir = src/tools DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ $(top_srcdir)/mkinstalldirs ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \ - $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ - $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ - $(top_srcdir)/c-compiler.m4 $(top_srcdir)/c-library.m4 \ - $(top_srcdir)/general.m4 \ +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ $(top_srcdir)/ac_func_accept_argtypes.m4 \ $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ @@ -183,15 +183,18 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +CATALOG = @CATALOG@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ CPP = @CPP@ CPPFLAGS = @CPPFLAGS@ CYGPATH_W = @CYGPATH_W@ DEFS = @DEFS@ DEPDIR = @DEPDIR@ DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ DSYMUTIL = @DSYMUTIL@ DUMPBIN = @DUMPBIN@ ECHO_C = @ECHO_C@ @@ -206,6 +209,7 @@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_SCRIPT = @INSTALL_SCRIPT@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ LD = @LD@ LDFLAGS = @LDFLAGS@ LEX = @LEX@ @@ -217,6 +221,7 @@ LIBTOOL = @LIBTOOL@ LIPO = @LIPO@ LN_S = @LN_S@ LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ MAINT = @MAINT@ MAKEINFO = @MAKEINFO@ MANIFEST_TOOL = @MANIFEST_TOOL@ @@ -227,8 +232,10 @@ MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ MKDIR_P = @MKDIR_P@ NM = @NM@ NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ OBJDUMP = @OBJDUMP@ OBJEXT = @OBJEXT@ +OSX = @OSX@ OTOOL = @OTOOL@ OTOOL64 = @OTOOL64@ PACKAGE = @PACKAGE@ @@ -239,6 +246,7 @@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ PGCONFIG = @PGCONFIG@ PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ @@ -247,7 +255,10 @@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ STRIP = @STRIP@ +STYLE = @STYLE@ VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ YACC = @YACC@ YFLAGS = @YFLAGS@ abs_builddir = @abs_builddir@ @@ -274,6 +285,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ diff --git a/src/tools/pcp/Makefile.in b/src/tools/pcp/Makefile.in index 4e4a64ea4..3e9d06dc0 100644 --- a/src/tools/pcp/Makefile.in +++ b/src/tools/pcp/Makefile.in @@ -88,11 +88,11 @@ subdir = src/tools/pcp DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ $(top_srcdir)/mkinstalldirs $(top_srcdir)/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \ - $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ - $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ - $(top_srcdir)/c-compiler.m4 $(top_srcdir)/c-library.m4 \ - $(top_srcdir)/general.m4 \ +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ $(top_srcdir)/ac_func_accept_argtypes.m4 \ $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ @@ -222,15 +222,18 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +CATALOG = @CATALOG@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ CPP = @CPP@ CPPFLAGS = @CPPFLAGS@ CYGPATH_W = @CYGPATH_W@ DEFS = @DEFS@ DEPDIR = @DEPDIR@ DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ DSYMUTIL = @DSYMUTIL@ DUMPBIN = @DUMPBIN@ ECHO_C = @ECHO_C@ @@ -245,6 +248,7 @@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_SCRIPT = @INSTALL_SCRIPT@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ LD = @LD@ LDFLAGS = @LDFLAGS@ LEX = @LEX@ @@ -256,6 +260,7 @@ LIBTOOL = @LIBTOOL@ LIPO = @LIPO@ LN_S = @LN_S@ LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ MAINT = @MAINT@ MAKEINFO = @MAKEINFO@ MANIFEST_TOOL = @MANIFEST_TOOL@ @@ -266,8 +271,10 @@ MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ MKDIR_P = @MKDIR_P@ NM = @NM@ NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ OBJDUMP = @OBJDUMP@ OBJEXT = @OBJEXT@ +OSX = @OSX@ OTOOL = @OTOOL@ OTOOL64 = @OTOOL64@ PACKAGE = @PACKAGE@ @@ -278,6 +285,7 @@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ PGCONFIG = @PGCONFIG@ PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ @@ -286,7 +294,10 @@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ STRIP = @STRIP@ +STYLE = @STYLE@ VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ YACC = @YACC@ YFLAGS = @YFLAGS@ abs_builddir = @abs_builddir@ @@ -313,6 +324,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ diff --git a/src/tools/pgmd5/Makefile.in b/src/tools/pgmd5/Makefile.in index 786b19bde..472cb38fd 100644 --- a/src/tools/pgmd5/Makefile.in +++ b/src/tools/pgmd5/Makefile.in @@ -84,11 +84,11 @@ DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ $(top_srcdir)/mkinstalldirs pool_config.c \ $(top_srcdir)/depcomp $(top_srcdir)/ylwrap ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \ - $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ - $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ - $(top_srcdir)/c-compiler.m4 $(top_srcdir)/c-library.m4 \ - $(top_srcdir)/general.m4 \ +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ $(top_srcdir)/ac_func_accept_argtypes.m4 \ $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ @@ -189,9 +189,11 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +CATALOG = @CATALOG@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ CPP = @CPP@ CPPFLAGS = @CPPFLAGS@ CYGPATH_W = @CYGPATH_W@ @@ -200,6 +202,7 @@ DEFS = @DEFS@ \ DEPDIR = @DEPDIR@ DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ DSYMUTIL = @DSYMUTIL@ DUMPBIN = @DUMPBIN@ ECHO_C = @ECHO_C@ @@ -214,6 +217,7 @@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_SCRIPT = @INSTALL_SCRIPT@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ LD = @LD@ LDFLAGS = @LDFLAGS@ LEX = @LEX@ @@ -225,6 +229,7 @@ LIBTOOL = @LIBTOOL@ LIPO = @LIPO@ LN_S = @LN_S@ LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ MAINT = @MAINT@ MAKEINFO = @MAKEINFO@ MANIFEST_TOOL = @MANIFEST_TOOL@ @@ -235,8 +240,10 @@ MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ MKDIR_P = @MKDIR_P@ NM = @NM@ NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ OBJDUMP = @OBJDUMP@ OBJEXT = @OBJEXT@ +OSX = @OSX@ OTOOL = @OTOOL@ OTOOL64 = @OTOOL64@ PACKAGE = @PACKAGE@ @@ -247,6 +254,7 @@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ PGCONFIG = @PGCONFIG@ PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ @@ -255,7 +263,10 @@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ STRIP = @STRIP@ +STYLE = @STYLE@ VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ YACC = @YACC@ YFLAGS = @YFLAGS@ abs_builddir = @abs_builddir@ @@ -282,6 +293,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ diff --git a/src/watchdog/Makefile.in b/src/watchdog/Makefile.in index 99b64c60d..f56289664 100644 --- a/src/watchdog/Makefile.in +++ b/src/watchdog/Makefile.in @@ -82,11 +82,11 @@ subdir = src/watchdog DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \ $(top_srcdir)/mkinstalldirs $(top_srcdir)/depcomp ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \ - $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ - $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ - $(top_srcdir)/c-compiler.m4 $(top_srcdir)/c-library.m4 \ - $(top_srcdir)/general.m4 \ +am__aclocal_m4_deps = $(top_srcdir)/m4/docbook.m4 \ + $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ + $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ + $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/c-compiler.m4 \ + $(top_srcdir)/c-library.m4 $(top_srcdir)/general.m4 \ $(top_srcdir)/ac_func_accept_argtypes.m4 \ $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ @@ -182,15 +182,18 @@ AUTOCONF = @AUTOCONF@ AUTOHEADER = @AUTOHEADER@ AUTOMAKE = @AUTOMAKE@ AWK = @AWK@ +CATALOG = @CATALOG@ CC = @CC@ CCDEPMODE = @CCDEPMODE@ CFLAGS = @CFLAGS@ +COLLATEINDEX = @COLLATEINDEX@ CPP = @CPP@ CPPFLAGS = @CPPFLAGS@ CYGPATH_W = @CYGPATH_W@ DEFS = @DEFS@ DEPDIR = @DEPDIR@ DLLTOOL = @DLLTOOL@ +DOCBOOKSTYLE = @DOCBOOKSTYLE@ DSYMUTIL = @DSYMUTIL@ DUMPBIN = @DUMPBIN@ ECHO_C = @ECHO_C@ @@ -205,6 +208,7 @@ INSTALL_DATA = @INSTALL_DATA@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_SCRIPT = @INSTALL_SCRIPT@ INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +JADE = @JADE@ LD = @LD@ LDFLAGS = @LDFLAGS@ LEX = @LEX@ @@ -216,6 +220,7 @@ LIBTOOL = @LIBTOOL@ LIPO = @LIPO@ LN_S = @LN_S@ LTLIBOBJS = @LTLIBOBJS@ +LYNX = @LYNX@ MAINT = @MAINT@ MAKEINFO = @MAKEINFO@ MANIFEST_TOOL = @MANIFEST_TOOL@ @@ -226,8 +231,10 @@ MEMCACHED_RPATH_OPT = @MEMCACHED_RPATH_OPT@ MKDIR_P = @MKDIR_P@ NM = @NM@ NMEDIT = @NMEDIT@ +NSGMLS = @NSGMLS@ OBJDUMP = @OBJDUMP@ OBJEXT = @OBJEXT@ +OSX = @OSX@ OTOOL = @OTOOL@ OTOOL64 = @OTOOL64@ PACKAGE = @PACKAGE@ @@ -238,6 +245,7 @@ PACKAGE_TARNAME = @PACKAGE_TARNAME@ PACKAGE_URL = @PACKAGE_URL@ PACKAGE_VERSION = @PACKAGE_VERSION@ PATH_SEPARATOR = @PATH_SEPARATOR@ +PERL = @PERL@ PGCONFIG = @PGCONFIG@ PGSQL_INCLUDE_DIR = @PGSQL_INCLUDE_DIR@ PGSQL_LIB_DIR = @PGSQL_LIB_DIR@ @@ -246,7 +254,10 @@ SED = @SED@ SET_MAKE = @SET_MAKE@ SHELL = @SHELL@ STRIP = @STRIP@ +STYLE = @STYLE@ VERSION = @VERSION@ +XSLTPROC = @XSLTPROC@ +XSLTPROC_HTML_FLAGS = @XSLTPROC_HTML_FLAGS@ YACC = @YACC@ YFLAGS = @YFLAGS@ abs_builddir = @abs_builddir@ @@ -273,6 +284,7 @@ datarootdir = @datarootdir@ docdir = @docdir@ dvidir = @dvidir@ exec_prefix = @exec_prefix@ +have_docbook = @have_docbook@ host = @host@ host_alias = @host_alias@ host_cpu = @host_cpu@ [parent: 52573fce9d13]