Thread: contrib/README

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-leveldirectory.  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 haveinstalled the files you need to register the new
entitiesin 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
thisprocedure.


--
Álvaro Herrera <alvherre@alvh.no-ip.org>

Alvaro Herrera <alvherre@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

Tom Lane <tgl@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

Excerpts from Dimitri Fontaine's message of mié dic 28 15:12:48 -0300 2011:
> Tom Lane <tgl@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 <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support