| Lists: | pgsql-hackers |
|---|
| From: | Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org> |
|---|---|
| To: | Pg Hackers <pgsql-hackers(at)postgresql(dot)org> |
| Cc: | Dimitri Fontaine <dimitri(at)2ndquadrant(dot)fr> |
| Subject: | contrib/README |
| Date: | 2011-12-26 22:56:13 |
| Message-ID: | 1324940000-sup-2881@alvh.no-ip.org |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Lists: | pgsql-hackers |
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 <alvherre(at)alvh(dot)no-ip(dot)org>
| From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
|---|---|
| To: | Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org> |
| Cc: | Pg Hackers <pgsql-hackers(at)postgresql(dot)org>, Dimitri Fontaine <dimitri(at)2ndquadrant(dot)fr> |
| Subject: | Re: contrib/README |
| Date: | 2011-12-27 01:18:03 |
| Message-ID: | 27210.1324948683@sss.pgh.pa.us |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Lists: | pgsql-hackers |
Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)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
| From: | Dimitri Fontaine <dfontaine(at)hi-media(dot)com> |
|---|---|
| To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
| Cc: | Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Pg Hackers <pgsql-hackers(at)postgresql(dot)org>, Dimitri Fontaine <dimitri(at)2ndquadrant(dot)fr> |
| Subject: | Re: contrib/README |
| Date: | 2011-12-28 18:12:48 |
| Message-ID: | m3aa6c1s67.fsf@hi-media.com |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Lists: | pgsql-hackers |
Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)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
| From: | Alvaro Herrera <alvherre(at)commandprompt(dot)com> |
|---|---|
| To: | Dimitri Fontaine <dfontaine(at)hi-media(dot)com> |
| Cc: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Pg Hackers <pgsql-hackers(at)postgresql(dot)org>, Dimitri Fontaine <dimitri(at)2ndquadrant(dot)fr> |
| Subject: | Re: contrib/README |
| Date: | 2011-12-29 13:22:39 |
| Message-ID: | 1325164828-sup-9344@alvh.no-ip.org |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Lists: | pgsql-hackers |
Excerpts from Dimitri Fontaine's message of mié dic 28 15:12:48 -0300 2011:
> Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)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 <alvherre(at)commandprompt(dot)com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support