First version of external projects manual section.

diff --git a/doc/src/sgml/external-projects.sgml b/doc/src/sgml/external-projects.sgml
new file mode 100644 (file)
index 0000000..d23bf24
--- /dev/null
+++ b/doc/src/sgml/external-projects.sgml
@@ -0,0 +1,223 @@
+
+
+ 
+  External Projects
+
+  
+   PostgreSQL is a large piece of very
+   complex software, and managing the code is a difficult process. We
+   have found that many enhancements to
+   PostgreSQL can be more efficiently
+   developed independently of the main project. They can have their own
+   developer teams, email lists, their own bug tracking, and their own
+   release schedule. While their independence makes development easier,
+   it makes users job harder. They have to hunt around looking for
+   database enhancements to meet their needs.
+  
+
+  
+   This section will outlines some of the more popular externally
+   developed enhancements and guides you on how to find them.
+  
+
+ 
+  Externally Developed Interfaces
+
+  
+   interfaces
+  
+
+  
+   PostgreSQL packages very few interfaces
+   with the base distribution. libpq is packaged because
+   it is the primary C interface and many other
+   interfaces are built on top of it. ecpg is packaged
+   because it is tied to the server-side grammar so it is very dependent
+   on the database version. All the other interfaces are independent
+   projects.
+  
+
+  
+   To use other interfaces, you have to do some searching. For example,
+   GBorg at 
+   http://gborg.postgresql.org has over thirty interfaces listed
+   in its Drivers/Interfaces section. Some of the more
+   popular interfaces are:
+
+   
+    
+     ODBC
+     
+      
+       This is the most common interface for Windows
+       applications.
+      
+     
+    
+
+    
+     psqlODBC
+     
+      
+       This is the most common interface for Windows
+       applications.
+      
+     
+    
+
+    
+     Npgsql
+     
+      
+       .Net interface for more recent
+       Windows applications.
+      
+     
+    
+
+    
+     libpq++
+     
+      
+       An older C++ interface.
+      
+     
+    
+
+    
+     libpqxx
+     
+      
+       A newer C++ interface.
+      
+     
+    
+
+    
+     pgperl
+     
+      
+       A Perl interface with an API similar
+       to libpq.
+      
+     
+    
+
+    
+     DBD-Pg
+     
+      
+       A Perl interface that uses the
+       DBD-standard API.
+      
+     
+    
+
+    
+     pgtcl
+     
+      
+       The original version of the TCL interface.
+      
+     
+    
+
+    
+     PyGreSQL
+     
+      
+       A Python interface library.
+      
+     
+    
+
+    
+     pgjdbc
+     
+      
+       A JDBC interface.
+      
+     
+    
+
+    
+     pgtclng
+     
+      
+       A newer version of the TCL interface.
+      
+     
+    
+
+   
+   
+
+  
+   That section also contains several server-side languages that are
+   separate projects. pgFoundry at 
+   url="http://pgfoundry.org">http://pgfoundry.org contains
+   even more projects. Other projects are not even hosted on these
+   servers and you will have to do an internet search to find them.
+  
+
+ 
+ 
+ 
+ Extensions
+
+  
+   extensions
+  
+
+  
+   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
+   /contrib directory shipped with the source code
+   contains a large number of extensions. The READMD 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 is a popular master/slave replication solution
+   that is developed independently from the main projects.
+  
+
+ 
+
+ 
+ Administration Tools
+
+  
+   administration tools
+  
+
+  
+   There are several administration tools available for
+   PostgreSQL. The most popular is
+   pgadmin, and there are several commercially
+   available ones.
+   
+
+ 
+
+
+


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

index 427b4739ece3d426e04d04bd2e93e5cf436c11c1..3dc13f44fb3ee7297b6339521da25563376dbac8 100644 (file)

--- a/doc/src/sgml/filelist.sgml
+++ b/doc/src/sgml/filelist.sgml
@@ -1,4 +1,4 @@
-
+
 
 
 
@@ -48,6 +48,7 @@
 
 
 
+
 
 
 


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

index 493f352157c0a6f63556e31b9549dd84d7579ed1..2f65f54d09bec8d0be1fac874f44da0e93fd80bf 100644 (file)

--- a/doc/src/sgml/postgres.sgml
+++ b/doc/src/sgml/postgres.sgml
@@ -1,5 +1,5 @@
 
 
 
@@ -179,7 +179,7 @@ $PostgreSQL: pgsql/doc/src/sgml/postgres.sgml,v 1.67 2004/12/03 01:23:38 momjian
   &lobj;
   &ecpg;
   &infoschema;
-  &external_projects;
+  &external-projects;
 
  
 
@@ -236,6 +236,7 @@ $PostgreSQL: pgsql/doc/src/sgml/postgres.sgml,v 1.67 2004/12/03 01:23:38 momjian
   &geqo;
   &indexcost;
   &gist;
+  &filelayout;
   &page;
   &bki;
 

diff --git a/doc/src/sgml/filelist.sgml b/doc/src/sgml/filelist.sgml
index 427b4739ece3d426e04d04bd2e93e5cf436c11c1..3dc13f44fb3ee7297b6339521da25563376dbac8 100644 (file)
--- a/doc/src/sgml/filelist.sgml
+++ b/doc/src/sgml/filelist.sgml
@@ -1,4 +1,4 @@
-
+
 
 
 
@@ -48,6 +48,7 @@
 
 
 
+
 
 
 

diff --git a/doc/src/sgml/postgres.sgml b/doc/src/sgml/postgres.sgml
index 493f352157c0a6f63556e31b9549dd84d7579ed1..2f65f54d09bec8d0be1fac874f44da0e93fd80bf 100644 (file)
--- a/doc/src/sgml/postgres.sgml
+++ b/doc/src/sgml/postgres.sgml
@@ -1,5 +1,5 @@
 
 
 
@@ -179,7 +179,7 @@ $PostgreSQL: pgsql/doc/src/sgml/postgres.sgml,v 1.67 2004/12/03 01:23:38 momjian
   &lobj;
   &ecpg;
   &infoschema;
-  &external_projects;
+  &external-projects;
 
  
 
@@ -236,6 +236,7 @@ $PostgreSQL: pgsql/doc/src/sgml/postgres.sgml,v 1.67 2004/12/03 01:23:38 momjian
   &geqo;
   &indexcost;
   &gist;
+  &filelayout;
   &page;
   &bki;