DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=mime-version:from:date:message-id:subject:to:content-type;
	b=Gg7B9VomI/BsbsqFcl6f54H0BAfqxZHl/b+wGHZzfYCXSFU+bfkadCHCCCIl5HCraH
	iM0kyF5oIZx6aScVoQSnjpCEM4kE3XUwBxyICFhyEfkZ1ZDCvCd3Ua9z1yuvQtn5nzXW
	J42fygvm5NMFwJTDNukz4xlv3LsZrQJGF/h0M=
MIME-Version: 1.0
From: Josh Kupershmidt <schmiddy@gmail.com>
Date: Tue, 12 Apr 2011 18:52:12 -0400
Message-ID: <BANLkTi=aFRCky-r6ahy50Us2bYpbem8ZcA@mail.gmail.com>
Subject: CREATE EXTENSION: documenting prereqs
To: pgsql-docs <pgsql-docs@postgresql.org>
Content-Type: multipart/mixed; boundary=0016367b6cc824423d04a0c08c4f

--0016367b6cc824423d04a0c08c4f
Content-Type: text/plain; charset=ISO-8859-1

Hi all,

I think users of 9.1 will be interested in quickly seeing what
extensions are all about. Looking at the CREATE EXTENSION page[2],
there's a brief example showing the command:
|  CREATE EXTENSION hstore;

When I try this, I see something like:
|   ERROR:  could not open extension control file
"/Users/josh/runtime/share/postgresql/extension/hstore.control": No
such file or directory

Well, obviously I need to go into ./contrib/hstore/ and run make &&
make install (or install the appropriate -contrib package if I were
using a packaged build of Postgres). I think it'd be nice to give
users some hint about this prerequisite. Appendix F [1] discusses
this, but there's currently no link from [2] to [1]. The way the
CREATE EXTENSION page reads right now, I could forgive a new user
thinking he shouldn't need to install any dependencies.

A complementary approach would be to add an errhint to the "could not
open extension control file..." error suggesting that the user install
the contrib package himself, though I'm not sure offhand about the
wording, especially since a user might be trying to install
who-knows-what extension.

A possible patch for the CREATE EXTENSION page is attached.

Josh

--
[1] http://developer.postgresql.org/pgdocs/postgres/contrib.html
[2] http://developer.postgresql.org/pgdocs/postgres/sql-createextension.html

--0016367b6cc824423d04a0c08c4f
Content-Type: text/x-patch; charset=US-ASCII; name="create_extension.v4.patch"
Content-Disposition: attachment; filename="create_extension.v4.patch"
Content-Transfer-Encoding: base64
X-Attachment-Id: f_gmffblym1

ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9yZWYvY3JlYXRlX2V4dGVuc2lvbi5zZ21sIGIvZG9j
L3NyYy9zZ21sL3JlZi9jcmVhdGVfZXh0ZW5zaW9uLnNnbWwKaW5kZXggODE4YmMwYy4uZTg2MmM3
ZiAxMDA2NDQKKioqIGEvZG9jL3NyYy9zZ21sL3JlZi9jcmVhdGVfZXh0ZW5zaW9uLnNnbWwKLS0t
IGIvZG9jL3NyYy9zZ21sL3JlZi9jcmVhdGVfZXh0ZW5zaW9uLnNnbWwKKioqKioqKioqKioqKioq
IENSRUFURSBFWFRFTlNJT04gaHN0b3JlOwoqKiogMTUzLDE1OCAqKioqCi0tLSAxNTMsMTY5IC0t
LS0KICA8L3Byb2dyYW1saXN0aW5nPgogICAgPC9wYXJhPgogIAorICAgPG5vdGU+CisgICAgPHBh
cmE+CisgICAgIEZvciBtb3JlIGluZm9ybWF0aW9uIG9uIGhvdyB0byB1c2UKKyAgICAgPGNvbW1h
bmQ+Q1JFQVRFIEVYVEVOU0lPTjwvY29tbWFuZD4gdG8gaW5zdGFsbCBtb2R1bGVzCisgICAgIGZv
dW5kIGluIDxwcm9kdWN0bmFtZT5Qb3N0Z3JlU1FMPC9wcm9kdWN0bmFtZT4ncworICAgICA8bGl0
ZXJhbD5jb250cmliPC9saXRlcmFsPiBkaXJlY3RvcnksIHN1Y2ggYXMgdGhlIGhzdG9yZQorICAg
ICBleHRlbnNpb24sIHBsZWFzZSBzZWUKKyAgICAgPGxpbmsgbGlua2VuZD0iY29udHJpYiI+QWRk
aXRpb25hbCBTdXBwbGllZCBNb2R1bGVzPC9saW5rPi4KKyAgICA8L3BhcmE+CisgICA8L25vdGU+
CisgCiAgICA8cGFyYT4KICAgICBVcGRhdGUgYSBwcmUtOS4xIGluc3RhbGxhdGlvbiBvZiA8bGl0
ZXJhbD5oc3RvcmU8Lz4gaW50bwogICAgIGV4dGVuc2lvbiBzdHlsZToK
--0016367b6cc824423d04a0c08c4f--