contrib/README

Started by Alvaro Herreraabout 14 years ago4 messages
#1Alvaro Herrera
alvherre@alvh.no-ip.org

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@alvh.no-ip.org>

#2Tom Lane
tgl@sss.pgh.pa.us
In reply to: Alvaro Herrera (#1)
Re: contrib/README

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

#3Dimitri Fontaine
dfontaine@hi-media.com
In reply to: Tom Lane (#2)
Re: contrib/README

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

#4Alvaro Herrera
alvherre@commandprompt.com
In reply to: Dimitri Fontaine (#3)
Re: contrib/README

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