Overhaul the "External Projects" chapter in the manual. Replace

the variabelist with a more concise table, add a URL for each project,
remove some orphaned projects, add PL/Py, and various other changes.
Initial patch from Robert Treat, subsequent work by Neil Conway.

diff --git a/doc/src/sgml/external-projects.sgml b/doc/src/sgml/external-projects.sgml
index 1a7a07416910f7911531c5e7e454389b2d5ceb3f..5ff952dfa557b84b105f22959b3e2508feb0ab38 100644 (file)
--- a/doc/src/sgml/external-projects.sgml
+++ b/doc/src/sgml/external-projects.sgml
@@ -1,139 +1,243 @@
-
+
 
  
-  <span class="marked">PgFoundry and </span>External Projects
+  External Projects
 
   
    PostgreSQL is a complex software project,
    and managing the project is difficult. We have found that many
    enhancements to PostgreSQL can be more
-   efficiently developed separately from the core project. 
-  
-  
-  
-   To help our community with the development of their external projects,
-   we have created the PgFoundry.
-   PgFoundry is built using the
-   GForge software project and is similar to SourceForge in its feature set. If
-   you have a PostgreSQL related Open Source project that you would like to 
-   develop and need project management resources such as mailing lists, forums,
-   bug tracking, and CVS, please feel free to create a new project.   
+   efficiently developed separately from the core project.
   
 
   
-   Secondly, many PostgreSQL-related projects are
-   still hosted at GBorg. 
-   GBorg is the original external community developer site, and while it is 
-   currently closed to new projects in favor of PgFoundry, it still contains 
-   many active and relevant projects. There are other popular PostgreSQL 
-   related projects that are hosted independently as well at other community 
-   sites such as SourceForge. You should 
-   search the web if you don't find the project you are looking for.
+   To help our community with the development of their external projects, we
+   have created PgFoundry, a
+   website that provides hosting for PostgreSQL-related
+   projects that are maintained outside the core PostgreSQL
+   distribution. PgFoundry is built using the GForge software project and is
+   similar to SourceForge.net in its
+   feature set, providing mailing lists, forums, bug tracking, CVS, and web
+   hosting. If you have a PostgreSQL-related open source
+   project that you would like to have hosted at PgFoundy, please feel free
+   to create a new project.
   
 
+  
+   
+    Many PostgreSQL-related projects are still
+    hosted at GBorg.  GBorg is
+    the original external community developer site, and while it is
+    currently closed to new projects in favor of PgFoundry, it still
+    contains many active and relevant projects. Other popular
+    PostgreSQL-related projects are hosted
+    independently, or on other project-hosting sites such such as 
+    url="http://sourceforge.net/">SourceForge.net. You should search
+    the web if you don't find the project you are looking for.
+   
+  
+
  
-  <span class="marked">Externally Developed</span> Interfaces
+  <span class="marked">Client</span> Interfaces
 
   
    interfaces
+   externally maintained
   
 
   
-   PostgreSQL includes very few interfaces
-   with the base distribution. libpq is packaged because
-   it is the primary C interface and many other interfaces
-   are build on top of it.  ecpg is also packaged because it is
-   tied to the server-side grammar so is very dependent on the database
-   version. All the other interfaces, such as ODBC, Java, Perl, Python, and
-   others, are external projects and must be installed separately.
+   There are only two client interfaces included in the base
+   PostgreSQL distribution:
+   
+    
+     
+      libpq is included because it is the
+      primary C language interface, and because many other client interfaces
+      are built on top of it.
+     
+    
+
+    
+     
+      ecpg is included because it depends on the
+      server-side SQL grammar, and is therefore sensitive to changes in
+      PostgreSQL itself.
+     
+    
+   
+
+   All other language interfaces are external projects and are distributed
+   separately.  includes a list of
+   some of these projects. Note that some of these packages may not be
+   released under the same license as PostgreSQL. For more
+   information on each language interface, including licensing terms, refer to
+   its website and documentation.
   
 
+  
+   Externally Maintained Client Interfaces</></div>
<div class="diff add">+</div>
<div class="diff add">+   <tgroup cols="4"></div>
<div class="diff add">+    <thead></div>
<div class="diff add">+     <row></div>
<div class="diff add">+      <entry>Name</entry></div>
<div class="diff add">+      <entry>Language</entry></div>
<div class="diff add">+      <entry>Comments</entry></div>
<div class="diff add">+      <entry>Website</entry></div>
<div class="diff add">+     </row></div>
<div class="diff add">+    </thead></div>
<div class="diff add">+</div>
<div class="diff add">+    <tbody></div>
<div class="diff add">+     <row></div>
<div class="diff add">+      <entry>DBD::Pg</entry></div>
<div class="diff add">+      <entry>Perl</entry></div>
<div class="diff add">+      <entry>Perl DBI driver</entry></div>
<div class="diff add">+      <entry><ulink url="http://search.cpan.org/dist/DBD-Pg/">http://search.cpan.org/dist/DBD-Pg/</ulink></entry></div>
<div class="diff add">+     </row></div>
<div class="diff add">+</div>
<div class="diff add">+     <row></div>
<div class="diff add">+      <entry>JDBC</entry></div>
<div class="diff add">+      <entry>JDBC</entry></div>
<div class="diff add">+      <entry>Type 4 JDBC driver</entry></div>
<div class="diff add">+      <entry><ulink url="http://jdbc.postgresql.org/">http://jdbc.postgresql.org/</ulink></entry></div>
<div class="diff add">+     </row></div>
<div class="diff add">+</div>
<div class="diff add">+     <row></div>
<div class="diff add">+      <entry>libpqxx</entry></div>
<div class="diff add">+      <entry>C++</entry></div>
<div class="diff add">+      <entry>New-style C++ interface</entry></div>
<div class="diff add">+      <entry><ulink url="http://thaiopensource.org/development/libpqxx/">http://thaiopensource.org/development/libpqxx/</ulink></entry></div>
<div class="diff add">+     </row></div>
<div class="diff add">+</div>
<div class="diff add">+     <row></div>
<div class="diff add">+      <entry>libpq++</entry></div>
<div class="diff add">+      <entry>C++</entry></div>
<div class="diff add">+      <entry>Old-style C++ interface</entry></div>
<div class="diff add">+      <entry><ulink url="http://gborg.postgresql.org/project/libpqpp/">http://gborg.postgresql.org/project/libpqpp/</ulink></entry></div>
<div class="diff add">+     </row></div>
<div class="diff add">+</div>
<div class="diff add">+     <row></div>
<div class="diff add">+      <entry>Npgsql</entry></div>
<div class="diff add">+      <entry>.NET</entry></div>
<div class="diff add">+      <entry>.NET data provider</entry></div>
<div class="diff add">+      <entry><ulink url="http://pgfoundry.org/projects/npgsql/">http://pgfoundry.org/projects/npgsql/</ulink></entry></div>
<div class="diff add">+     </row></div>
<div class="diff add">+</div>
<div class="diff add">+     <row></div>
<div class="diff add">+      <entry>ODBCng</entry></div>
<div class="diff add">+      <entry>ODBC</entry></div>
<div class="diff add">+      <entry>An alternative ODBC driver</entry></div>
<div class="diff add">+      <entry><ulink url="http://projects.commandprompt.com/public/odbcng/">http://projects.commandprompt.com/public/odbcng/</ulink></entry></div>
<div class="diff add">+     </row></div>
<div class="diff add">+</div>
<div class="diff add">+     <row></div>
<div class="diff add">+      <entry>pgtclng</entry></div>
<div class="diff add">+      <entry>Tcl</entry></div>
<div class="diff add">+      <entry></entry></div>
<div class="diff add">+      <entry><ulink url="http://pgfoundry.org/projects/pgtclng/">http://pgfoundry.org/projects/pgtclng/</ulink></entry></div>
<div class="diff add">+     </row></div>
<div class="diff add">+</div>
<div class="diff add">+     <row></div>
<div class="diff add">+      <entry>psqlODBC</entry></div>
<div class="diff add">+      <entry>ODBC</entry></div>
<div class="diff add">+      <entry>The most commonly-used ODBC driver</entry></div>
<div class="diff add">+      <entry><ulink url="http://odbc.postgresql.org/">http://odbc.postgresql.org/</ulink></entry></div>
<div class="diff add">+     </row></div>
<div class="diff add">+</div>
<div class="diff add">+     <row></div>
<div class="diff add">+      <entry>psycopg</entry></div>
<div class="diff add">+      <entry>Python</entry></div>
<div class="diff add">+      <entry>DB API 2.0-compliant</entry></div>
<div class="diff add">+      <entry><ulink url="http://www.initd.org/">http://www.initd.org/</ulink></entry></div>
<div class="diff add">+     </row></div>
<div class="diff add">+    </tbody></div>
<div class="diff add">+   </tgroup></div>
<div class="diff add">+  </table></div>
<div class="diff add">+ </sect1></div>
<div class="diff add">+</div>
<div class="diff add">+ <sect1 id="external-pl"></div>
<div class="diff add">+  <title>Procedural Languages
+
+  
+   procedural language
+   externally maintained
+  
+
   
-   Some of the more popular interfaces are:
-
-   
-    
-     psqlODBC
-     
-      
-       This is the most common interface for Windows
-       applications. Website.
-      
-     
-    
-
-    
-     ODBCng
-     
-      
-       Another ODBC driver for PostgreSQL. 
-       Website.
-      
-     
-    
-
-    
-     PostgreSQL JDBC Driver
-     
-      
-       A JDBC interface.
-       Website.
-      
-     
-    
-
-    
-     Npgsql
-     
-      
-       .Net data provider for C# applications.
-       Website.
-      
-     
-    
-
-    
-     libpqxx
-     
-      
-       A C++ interface.
-       Website.
-      
-     
-    
-
-    
-     DBD::Pg
-     
-      
-       A Perl DBI driver for PostgreSQL.
-       Website.
-      
-     
-    
-
-    
-     pgtclng
-     
-      
-       A Tcl interface.
-       Website.
-      
-     
-    
-
-    
-     pyscopg
-     
-      
-       A Python interface library that is DB API 2.0 compliant.
-       Website.
-      
-     
-    
-   
-   
+   PostgreSQL includes several procedural
+   languages with the base distribution: 
+   linkend="plpgsql">PL/PgSQL, PL/Tcl,
+   PL/Perl, and 
+   linkend="plpython">PL/Python.
+  
+
+  
+   In addition, there are a number of procedural languages that are developed
+   and maintained outside the core PostgreSQL
+   distribution.  lists some of these
+   packages. Note that some of these projects may not be released under the same
+   license as PostgreSQL. For more information on each
+   procedural language, including licensing information, refer to its website
+   and documentation.
+  
+
+  
+   Externally Maintained Procedural Languages
 
+   
+    
+     
+      Name
+      Language
+      Website
+     
+    
+
+    
+     
+      PL/Java
+      Java
+      http://pljava.projects.postgresql.org/
+     
+
+     
+      PL/PHP
+      PHP
+      http://www.commandprompt.com/community/plphp/
+     
+
+     
+      PL/Py
+      Python
+      http://python.projects.postgresql.org/
+     
+
+     
+      PL/R
+      R
+      http://www.joeconway.com/plr/
+     
+
+     
+      PL/Ruby
+      Ruby
+      http://raa.ruby-lang.org/project/pl-ruby/
+     
+
+     
+      PL/Scheme
+      Scheme
+      http://plscheme.projects.postgresql.org/
+     
+
+     
+      PL/sh
+      Unix shell
+      http://plsh.projects.postgresql.org/
+     
+    
+   
+  
  
  
  
@@ -144,18 +248,21 @@
   
 
   
-   PostgreSQL was designed from the start to be
-   extensible. For this reason, extensions loaded into the database can
-   function just like features that are packaged with the database. The
+   PostgreSQL is designed to be easily extensible. For
+   this reason, extensions loaded into the database can function just
+   like features that are packaged with the database. The
    contrib/ directory shipped with the source code
    contains a large number of extensions. The README file
-   in that directory contains a summary. They include conversion tools,
-   full-text indexing, XML tools, and additional data types
-   and indexing methods. Other extensions are developed independently,
-   like PostGIS. Even PostgreSQL
-   replication solutions are developed externally. For example,
-   Slony-I is a popular master/slave replication solution
-   that is developed independently from the core project.
+   in that directory contains a summary. They include conversion
+   tools, full-text indexing, XML tools, and additional
+   data types and indexing methods. Other extensions are developed
+   independently, like 
+   url="http://www.postgis.org/">PostGIS.  Even
+   PostgreSQL replication solutions are developed
+   externally. For example,  
+   url="http://www.slony.info">Slony-I is a popular
+   master/slave replication solution that is developed independently
+   from the core project.
   
 
   
@@ -163,7 +270,6 @@
    PostgreSQL. The most popular is
    pgAdmin III, 
    and there are several commercially available ones as well.
-   
-
+  
  
 


diff --git a/doc/src/sgml/xplang.sgml b/doc/src/sgml/xplang.sgml

index e56e72d6a0820f17d1ced96346ddbb41993f1edb..d4b1163145aa0c5f5beca9af3172ba2b83df4611 100644 (file)

--- a/doc/src/sgml/xplang.sgml
+++ b/doc/src/sgml/xplang.sgml
@@ -1,4 +1,4 @@
-
+
 
  
   Procedural Languages
@@ -31,15 +31,11 @@
    PL/Tcl (),
    PL/Perl (), and
    PL/Python ().
-   Other languages can be defined by users.
-   The basics of developing a new procedural language are covered in 
-   linkend="plhandler">.
-  
-
-  
    There are additional procedural languages available that are not
    included in the core distribution. 
-   has information about finding them.
+   has information about finding them. In addition other languages can 
+   be defined by users; the basics of developing a new procedural 
+   language are covered in .
   
 
   




This is the main PostgreSQL git repository.
RSS
Atom



window.onload = function () {
	var tz_cookie = { name: 'gitweb_tz', expires: 14, path: '/' };
	onloadTZSetup('local', tz_cookie, 'datetime');
};

diff --git a/doc/src/sgml/xplang.sgml b/doc/src/sgml/xplang.sgml
index e56e72d6a0820f17d1ced96346ddbb41993f1edb..d4b1163145aa0c5f5beca9af3172ba2b83df4611 100644 (file)
--- a/doc/src/sgml/xplang.sgml
+++ b/doc/src/sgml/xplang.sgml
@@ -1,4 +1,4 @@
-
+
 
  
   Procedural Languages
@@ -31,15 +31,11 @@
    PL/Tcl (),
    PL/Perl (), and
    PL/Python ().
-   Other languages can be defined by users.
-   The basics of developing a new procedural language are covered in 
-   linkend="plhandler">.
-  
-
-  
    There are additional procedural languages available that are not
    included in the core distribution. 
-   has information about finding them.
+   has information about finding them. In addition other languages can 
+   be defined by users; the basics of developing a new procedural 
+   language are covered in .