public inbox for [email protected]
help / color / mirror / Atom feedFrom: Bruce Momjian <[email protected]>
To: Heikki Linnakangas <[email protected]>
Cc: Thom Brown <[email protected]>
Cc: pgsql-docs <[email protected]>
Subject: Re: Foreign server version and type
Date: Wed, 15 Aug 2012 11:47:41 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <CAA-aLv4xVYzcsE9k2mAT8BoBnJ+XeR8s4xDpH6CojQ3iiS5wPQ@mail.gmail.com>
<[email protected]>
On Mon, Aug 15, 2011 at 08:36:36PM +0300, Heikki Linnakangas wrote:
> On 15.08.2011 19:58, Thom Brown wrote:
> >I'm looking at the CREATE SERVER page on the documentation (
> >http://www.postgresql.org/docs/9.1/static/sql-createserver.html) and noticed
> >that there's a server_version parameter which can be provided with the
> >keyword VERSION and server_type specified after TYPE.
> >
> >However, there's zero information about what these are used for, whether
> >they have any bearing on anything or why you'd want to use them. Are these
> >parameters used for anything, or are they purely for future functionality?
> > Whatever the case, could some kind of elaboration be added to justify the
> >existence of these options? They have been in the docs since the CREATE
> >SERVER syntax was introduced in 8.4.
>
> It's in the SQL spec. It isn't used anything by PostgreSQL itself,
> but a wrapper could look at it. It would probably be good to say
> that explicitly in the docs.
I have applied the attached patch to document that these fields are only
potentially useful to foreign data wrappers.
--
Bruce Momjian <[email protected]> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ It's impossible for everything to be true. +
Attachments:
[text/x-diff] foreign.diff (1.2K, 2-foreign.diff)
download | inline diff:
diff --git a/doc/src/sgml/ref/create_server.sgml b/doc/src/sgml/ref/create_server.sgml
new file mode 100644
index be9be50..60744b2
*** a/doc/src/sgml/ref/create_server.sgml
--- b/doc/src/sgml/ref/create_server.sgml
*************** CREATE SERVER <replaceable class="parame
*** 69,75 ****
<term><replaceable class="parameter">server_type</replaceable></term>
<listitem>
<para>
! Optional server type.
</para>
</listitem>
</varlistentry>
--- 69,75 ----
<term><replaceable class="parameter">server_type</replaceable></term>
<listitem>
<para>
! Optional server type, potentially useful to foreign-data wrappers.
</para>
</listitem>
</varlistentry>
*************** CREATE SERVER <replaceable class="parame
*** 78,84 ****
<term><replaceable class="parameter">server_version</replaceable></term>
<listitem>
<para>
! Optional server version.
</para>
</listitem>
</varlistentry>
--- 78,84 ----
<term><replaceable class="parameter">server_version</replaceable></term>
<listitem>
<para>
! Optional server version, potentially useful to foreign-data wrappers.
</para>
</listitem>
</varlistentry>
view thread (4+ messages) latest in thread
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected], [email protected]
Subject: Re: Foreign server version and type
In-Reply-To: <[email protected]>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox