Re: [HACKERS] contrib/README

2011-12-29 Thread Alvaro Herrera

Excerpts from Dimitri Fontaine's message of mié dic 28 15:12:48 -0300 2011:
 Tom Lane t...@sss.pgh.pa.us writes:
  I wonder whether it's time to drop that file altogether ... it served a
  purpose back before we integrated contrib into the SGML docs, but now
  I'm not quite sure why we should bother with it.
 
 I wonder if we shouldn't keep the file and have it just point to the
 relevant documentation chapters (extend, contribs).

+1

Only start-scripts needs to be listed separately.

-- 
Álvaro Herrera alvhe...@commandprompt.com
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

-- 
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers


Re: [HACKERS] contrib/README

2011-12-28 Thread Dimitri Fontaine
Tom Lane t...@sss.pgh.pa.us writes:
 I wonder whether it's time to drop that file altogether ... it served a
 purpose back before we integrated contrib into the SGML docs, but now
 I'm not quite sure why we should bother with it.

I wonder if we shouldn't keep the file and have it just point to the
relevant documentation chapters (extend, contribs).

Regards,
-- 
dim

-- 
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers


[HACKERS] contrib/README

2011-12-26 Thread Alvaro Herrera

Apparently we forgot to update the README file in contrib/.  I wonder if
it's necessary to explain that within each directory you find one or
more .control file that determines what can be run ... or maybe just
mention the pg_extensions views?

What about this?

diff --git a/contrib/README b/contrib/README
index a1d42a1..8900693 100644
--- a/contrib/README
+++ b/contrib/README
@@ -11,11 +11,11 @@ User documentation for each module appears in the main SGML 
documentation.
 Most items can be built with `gmake all' and installed with
 `gmake install' in the usual fashion, after you have run the `configure'
 script in the top-level directory.  Some directories supply new
-user-defined functions, operators, or types.  In these cases, after you have
+user-defined Postgres extensions.  In these cases, after you have
 installed the files you need to register the new entities in the database
-system by running the commands in the supplied .sql file.  For example,
+system by running an appropriate CREATE EXTENSION command.  For example,
 
-   $ psql -d dbname -f module.sql
+   $ psql -d dbname -c CREATE EXTENSION pg_trgm
 
 See the PostgreSQL documentation for more information about this
 procedure.


-- 
Álvaro Herrera alvhe...@alvh.no-ip.org

-- 
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers


Re: [HACKERS] contrib/README

2011-12-26 Thread Tom Lane
Alvaro Herrera alvhe...@alvh.no-ip.org writes:
 Apparently we forgot to update the README file in contrib/.

I wonder whether it's time to drop that file altogether ... it served a
purpose back before we integrated contrib into the SGML docs, but now
I'm not quite sure why we should bother with it.

regards, tom lane

-- 
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers