Remove more traces of libpgtcl from the source tree. Also, make some

semi-related SGML cleanup. Original patch from ljb220@mindspring.com,
additional cleanup by Neil Conway.
This commit is contained in:
Neil Conway 2004-10-01 02:00:44 +00:00
parent d2af5f8a3e
commit 3738510c2c
7 changed files with 50 additions and 149 deletions

9
README
View File

@ -7,12 +7,11 @@ database management system.
PostgreSQL is an advanced object-relational database management system PostgreSQL is an advanced object-relational database management system
that supports an extended subset of the SQL standard, including that supports an extended subset of the SQL standard, including
transactions, foreign keys, subqueries, triggers, user-defined types transactions, foreign keys, subqueries, triggers, user-defined types
and functions. This distribution also contains several language and functions. This distribution also contains C language bindings.
bindings, including C and Tcl.
The JDBC, ODBC, C++, and Python interfaces have been moved to the PostgreSQL The JDBC, ODBC, C++, Python, and Tcl interfaces have been moved to the
Projects Web Site at http://gborg.postgresql.org for separate maintenance. PostgreSQL Projects Web Site at http://gborg.postgresql.org for separate
A Perl DBI/DBD driver is available from CPAN. maintenance. A Perl DBI/DBD driver is available from CPAN.
See the file INSTALL for instructions on how to build and install See the file INSTALL for instructions on how to build and install
PostgreSQL. That file also lists supported operating systems and PostgreSQL. That file also lists supported operating systems and

4
configure vendored
View File

@ -859,7 +859,7 @@ Optional Packages:
--with-libraries=DIRS look for additional libraries in DIRS --with-libraries=DIRS look for additional libraries in DIRS
--with-libs=DIRS alternative spelling of --with-libraries --with-libs=DIRS alternative spelling of --with-libraries
--with-pgport=PORTNUM change default port number 5432 --with-pgport=PORTNUM change default port number 5432
--with-tcl build Tcl and Tk interfaces --with-tcl build Tcl modules (PL/Tcl)
--with-tclconfig=DIR tclConfig.sh is in DIR --with-tclconfig=DIR tclConfig.sh is in DIR
--with-perl build Perl modules (PL/Perl) --with-perl build Perl modules (PL/Perl)
--with-python build Python modules (PL/Python) --with-python build Python modules (PL/Python)
@ -2995,7 +2995,7 @@ echo "${ECHO_T}$enable_thread_safety" >&6
# #
# Tcl/Tk # Optionally build Tcl modules (PL/Tcl)
# #
echo "$as_me:$LINENO: checking whether to build with Tcl" >&5 echo "$as_me:$LINENO: checking whether to build with Tcl" >&5
echo $ECHO_N "checking whether to build with Tcl... $ECHO_C" >&6 echo $ECHO_N "checking whether to build with Tcl... $ECHO_C" >&6

View File

@ -1,5 +1,5 @@
dnl Process this file with autoconf to produce a configure script. dnl Process this file with autoconf to produce a configure script.
dnl $PostgreSQL: pgsql/configure.in,v 1.378 2004/09/27 02:17:14 pgsql Exp $ dnl $PostgreSQL: pgsql/configure.in,v 1.379 2004/10/01 02:00:41 neilc Exp $
dnl dnl
dnl Developers, please strive to achieve this order: dnl Developers, please strive to achieve this order:
dnl dnl
@ -371,10 +371,10 @@ AC_MSG_RESULT([$enable_thread_safety])
AC_SUBST(enable_thread_safety) AC_SUBST(enable_thread_safety)
# #
# Tcl/Tk # Optionally build Tcl modules (PL/Tcl)
# #
AC_MSG_CHECKING([whether to build with Tcl]) AC_MSG_CHECKING([whether to build with Tcl])
PGAC_ARG_BOOL(with, tcl, no, [ --with-tcl build Tcl and Tk interfaces]) PGAC_ARG_BOOL(with, tcl, no, [ --with-tcl build Tcl modules (PL/Tcl)])
AC_MSG_RESULT([$with_tcl]) AC_MSG_RESULT([$with_tcl])
AC_SUBST([with_tcl]) AC_SUBST([with_tcl])

View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.204 2004/09/23 00:30:13 neilc Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.205 2004/10/01 02:00:43 neilc Exp $ -->
<chapter id="installation"> <chapter id="installation">
<title><![%standalone-include[<productname>PostgreSQL</>]]> <title><![%standalone-include[<productname>PostgreSQL</>]]>
@ -137,11 +137,12 @@ su - postgres
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
To build the server programming language PL/Perl you need a full To build the server programming language
<application>PL/Perl</application> you need a full
<productname>Perl</productname> installation, including the <productname>Perl</productname> installation, including the
<filename>libperl</filename> library and the header files. <filename>libperl</filename> library and the header files.
Since PL/Perl will be a shared library, the Since <application>PL/Perl</application> will be a shared
<indexterm><primary>libperl</primary></indexterm> library, the <indexterm><primary>libperl</primary></indexterm>
<filename>libperl</filename> library must be a shared library <filename>libperl</filename> library must be a shared library
also on most platforms. This appears to be the default in also on most platforms. This appears to be the default in
recent <productname>Perl</productname> versions, but it was not recent <productname>Perl</productname> versions, but it was not
@ -158,28 +159,30 @@ su - postgres
*** the documentation for details. *** the documentation for details.
</screen> </screen>
(If you don't follow the on-screen output you will merely notice (If you don't follow the on-screen output you will merely notice
that the PL/Perl library object, <filename>plperl.so</filename> that the <application>PL/Perl</application> library object,
or similar, will not be installed.) If you see this, you will <filename>plperl.so</filename> or similar, will not be
have to rebuild and install <productname>Perl</productname> installed.) If you see this, you will have to rebuild and
manually to be able to build PL/Perl. During the configuration install <productname>Perl</productname> manually to be able to
process for <productname>Perl</productname>, request a shared build <application>PL/Perl</application>. During the
library. configuration process for <productname>Perl</productname>,
request a shared library.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
To build the PL/Python server programming language, you need a To build the <application>PL/Python</> server programming
<productname>Python</productname> installation with the header language, you need a <productname>Python</productname>
files and the distutils module. The distutils module is installation with the header files and the distutils module.
included by default with <productname>Python</productname> 1.6 The distutils module is included by default with
and later; users of earlier versions of <productname>Python</productname> 1.6 and later; users of
<productname>Python</productname> will need to install it. earlier versions of <productname>Python</productname> will need
to install it.
</para> </para>
<para> <para>
Since PL/Python will be a shared library, the Since <application>PL/Python</application> will be a shared
<indexterm><primary>libpython</primary></indexterm> library, the <indexterm><primary>libpython</primary></indexterm>
<filename>libpython</filename> library must be a shared library <filename>libpython</filename> library must be a shared library
also on most platforms. This is not the case in a default also on most platforms. This is not the case in a default
<productname>Python</productname> installation. If after <productname>Python</productname> installation. If after
@ -209,8 +212,8 @@ su - postgres
<listitem> <listitem>
<para> <para>
If you want to build Tcl or Tk components (clients and the If you want to build the <application>PL/Tcl</application>
PL/Tcl language) you of course need a Tcl installation. procedural language, you of course need a Tcl installation.
</para> </para>
</listitem> </listitem>
@ -723,7 +726,7 @@ su - postgres
<term><option>--with-perl</option></term> <term><option>--with-perl</option></term>
<listitem> <listitem>
<para> <para>
Build the PL/Perl server-side language. Build the <application>PL/Perl</> server-side language.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -732,7 +735,7 @@ su - postgres
<term><option>--with-python</option></term> <term><option>--with-python</option></term>
<listitem> <listitem>
<para> <para>
Build the PL/Python server-side language. Build the <application>PL/Python</> server-side language.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -741,36 +744,21 @@ su - postgres
<term><option>--with-tcl</option></term> <term><option>--with-tcl</option></term>
<listitem> <listitem>
<para> <para>
Build <application>PL/Tcl</>, which requires Tcl/Tk Build the <application>PL/Tcl</> server-side language.
<option>--without-tk</>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--without-tk</option></term>
<listitem>
<para>
If you specify <option>--with-tcl</> and this option, then
the program that requires <productname>Tk</>
(<application>pgtksh</>) will be
excluded.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--with-tclconfig=<replaceable>DIRECTORY</replaceable></option></term> <term><option>--with-tclconfig=<replaceable>DIRECTORY</replaceable></option></term>
<term><option>--with-tkconfig=<replaceable>DIRECTORY</replaceable></option></term>
<listitem> <listitem>
<para> <para>
Tcl/Tk installs the files <filename>tclConfig.sh</filename> and Tcl installs the file <filename>tclConfig.sh</filename>, which
<filename>tkConfig.sh</filename>, which contain contains configuration information needed to build modules
configuration information needed to build modules interfacing to Tcl. This file is normally found automatically
interfacing to Tcl or Tk. These files are normally found at a well-known location, but if you want to use a different
automatically at their well-known locations, but if you want to version of Tcl you can specify the directory in which to look
use a different version of Tcl or Tk you can specify the for it.
directory in which to find them.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>

View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_function.sgml,v 1.61 2004/09/20 22:48:29 tgl Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/create_function.sgml,v 1.62 2004/10/01 02:00:44 neilc Exp $
--> -->
<refentry id="SQL-CREATEFUNCTION"> <refentry id="SQL-CREATEFUNCTION">
@ -402,7 +402,8 @@ CREATE FUNCTION add(integer, integer) RETURNS integer
</para> </para>
<para> <para>
Increment an integer, making use of an argument name, in PL/PgSQL: Increment an integer, making use of an argument name, in
<application>PL/pgSQL</application>:
<programlisting> <programlisting>
CREATE OR REPLACE FUNCTION increment(i integer) RETURNS integer AS ' CREATE OR REPLACE FUNCTION increment(i integer) RETURNS integer AS '

View File

@ -1,87 +0,0 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/pgtclsh.sgml,v 1.10 2003/11/29 19:51:39 pgsql Exp $
PostgreSQL documentation
-->
<refentry id="APP-PGTCLSH">
<refmeta>
<refentrytitle>pgtclsh</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo>Application</refmiscinfo>
</refmeta>
<refnamediv>
<refname>pgtclsh</refname>
<refpurpose>
<productname>PostgreSQL</productname> <application>Tcl</application> shell client
</refpurpose>
</refnamediv>
<indexterm zone="app-pgtclsh">
<primary>pgtclsh</primary>
</indexterm>
<refsynopsisdiv>
<cmdsynopsis>
<command>pgtclsh</command>
<arg><replaceable>filename</replaceable> <arg rep="repeat"><replaceable>argument</replaceable></arg></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 id="app-pgtclsh-description">
<title>
Description
</title>
<para>
<command>pgtclsh</command> is a <application>Tcl</application>
shell interface extended with
<productname>PostgreSQL</productname> database access functions.
(Essentially, it is <command>tclsh</command> with
<filename>libpgtcl</filename> loaded.) Like with the regular
<application>Tcl</application> shell, the first command line
argument is a script file, any remaining arguments are passed to
the script. If no script file is named, the shell is
interactive.
</para>
<para>
A <application>Tcl</application> shell with
<application>Tk</application> and
<productname>PostgreSQL</productname> functions is available as <xref
linkend="app-pgtksh">.
</para>
</refsect1>
<refsect1>
<title>See Also</title>
<simplelist type="inline">
<member><xref linkend="app-pgtksh"></member>
<member>
<xref linkend="pgtcl"> (description of <filename>libpgtcl</filename>)
</member>
<member>
<citerefentry><refentrytitle>tclsh</refentrytitle> <manvolnum>1</manvolnum></citerefentry>
</member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil
End:
-->

View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.297 2004/09/24 01:31:32 neilc Exp $ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.298 2004/10/01 02:00:43 neilc Exp $
--> -->
<appendix id="release"> <appendix id="release">
@ -1501,7 +1501,7 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.297 2004/09/24 01:31:32 neilc E
<listitem> <listitem>
<para> <para>
Allow PL/PgSQL parameter names to be referenced in the function (Dennis Bjorklund) Allow PL/pgSQL parameter names to be referenced in the function (Dennis Bjorklund)
</para> </para>
<para> <para>
This basically creates an automatic alias for each named parameter. This basically creates an automatic alias for each named parameter.
@ -1510,7 +1510,7 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.297 2004/09/24 01:31:32 neilc E
<listitem> <listitem>
<para> <para>
Do minimal syntax checking of PL/PgSQL functions at creation time (Tom) Do minimal syntax checking of PL/pgSQL functions at creation time (Tom)
</para> </para>
<para> <para>
This allows us to catch simple syntax errors sooner. This allows us to catch simple syntax errors sooner.
@ -1519,7 +1519,7 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.297 2004/09/24 01:31:32 neilc E
<listitem> <listitem>
<para> <para>
More support for composite types (row and record variables) in PL/PgSQL More support for composite types (row and record variables) in PL/pgSQL
</para> </para>
<para> <para>
For example, it now works to pass a rowtype variable to another function For example, it now works to pass a rowtype variable to another function
@ -1529,14 +1529,14 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.297 2004/09/24 01:31:32 neilc E
<listitem> <listitem>
<para> <para>
Default values for PL/PgSQL variables can now reference previously Default values for PL/pgSQL variables can now reference previously
declared variables declared variables
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve parsing of PL/PgSQL FOR loops (Tom) Improve parsing of PL/pgSQL FOR loops (Tom)
</para> </para>
<para> <para>
Parsing is now driven by presence of ".." rather than datatype of FOR Parsing is now driven by presence of ".." rather than datatype of FOR