public inbox for [email protected]
help / color / mirror / Atom feedRe: create foreign table
3+ messages / 3 participants
[nested] [flat]
* Re: create foreign table
@ 2011-09-15 16:51 Ray Stell <[email protected]>
2011-09-19 19:01 ` Re: create foreign table Robert Haas <[email protected]>
2012-08-16 00:38 ` Re: create foreign table Bruce Momjian <[email protected]>
0 siblings, 2 replies; 3+ messages in thread
From: Ray Stell @ 2011-09-15 16:51 UTC (permalink / raw)
To: Robert Haas <[email protected]>; +Cc: pgsql-docs
On Thu, Sep 15, 2011 at 06:43:59AM -0500, Robert Haas wrote:
>> On Mon, Sep 12, 2011 at 8:42 AM, Ray Stell <[email protected]> wrote:
>> > http://www.postgresql.org/docs/9.1/static/sql-createforeigntable.html
>> > It would be helpful if "SERVER" was defined if the parameters list
>> > on this page.
>>
>> We don't usually document required keywords - they're just required.
>> We do document the meaning of server_name, which I think is probably
>> what you were after.
>>
>> --
>> Robert Haas
>> EnterpriseDB: http://www.enterprisedb.com
>> The Enterprise PostgreSQL Company
>
>
>Thanks, Robert.
>
>Maybe if you just added a pointer to the "CREATE SERVER" command in
>your definition of server_name it would provide a bread crumb.
>
Oh, I see my mistake. Maybe the inclusion of a link to "CREATE SERVER"
http://www.postgresql.org/docs/9.1/static/sql-createserver.html in the
server_name definition would be helpful, just like in the data_type line.
I was having trouble making the leap since the idea was a new one on me.
different topic 1:
When I put the word "foreign" in the search area on this page
http://www.postgresql.org/docs/9.1/static/index.html
it does not find create foreign table.
different topic 2:
Is there a way to know what chapter you are in when on any page of the docs?
Maybe add to the navigation line at the top:
Home -> Documentation -> Manuals -> PostgreSQL 9.1 -> PUT YOUR CHAPTER HERE?
like this:
Home -> Documentation -> Manuals -> PostgreSQL 9.1 -> I. SQL Commands
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: create foreign table
2011-09-15 16:51 Re: create foreign table Ray Stell <[email protected]>
@ 2011-09-19 19:01 ` Robert Haas <[email protected]>
1 sibling, 0 replies; 3+ messages in thread
From: Robert Haas @ 2011-09-19 19:01 UTC (permalink / raw)
To: Ray Stell <[email protected]>; +Cc: pgsql-docs
On Thu, Sep 15, 2011 at 12:51 PM, Ray Stell <[email protected]> wrote:
> Oh, I see my mistake. Maybe the inclusion of a link to "CREATE SERVER"
> http://www.postgresql.org/docs/9.1/static/sql-createserver.html in the
> server_name definition would be helpful, just like in the data_type line.
> I was having trouble making the leap since the idea was a new one on me.
>
> different topic 1:
>
> When I put the word "foreign" in the search area on this page
> http://www.postgresql.org/docs/9.1/static/index.html
> it does not find create foreign table.
Yes. AFAICT, somehow that search has become hopelessly broken. It
doesn't seem to find anything. I am pretty sure that it did before.
> different topic 2:
>
> Is there a way to know what chapter you are in when on any page of the docs?
> Maybe add to the navigation line at the top:
>
> Home -> Documentation -> Manuals -> PostgreSQL 9.1 -> PUT YOUR CHAPTER HERE?
>
> like this:
>
> Home -> Documentation -> Manuals -> PostgreSQL 9.1 -> I. SQL Commands
That's not a bad idea either.
--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: create foreign table
2011-09-15 16:51 Re: create foreign table Ray Stell <[email protected]>
@ 2012-08-16 00:38 ` Bruce Momjian <[email protected]>
1 sibling, 0 replies; 3+ messages in thread
From: Bruce Momjian @ 2012-08-16 00:38 UTC (permalink / raw)
To: Ray Stell <[email protected]>; +Cc: Robert Haas <[email protected]>; pgsql-docs
On Thu, Sep 15, 2011 at 12:51:57PM -0400, Ray Stell wrote:
> On Thu, Sep 15, 2011 at 06:43:59AM -0500, Robert Haas wrote:
> >> On Mon, Sep 12, 2011 at 8:42 AM, Ray Stell <[email protected]> wrote:
> >> > http://www.postgresql.org/docs/9.1/static/sql-createforeigntable.html
> >> > It would be helpful if "SERVER" was defined if the parameters list
> >> > on this page.
> >>
> >> We don't usually document required keywords - they're just required.
> >> We do document the meaning of server_name, which I think is probably
> >> what you were after.
> >>
> >> --
> >> Robert Haas
> >> EnterpriseDB: http://www.enterprisedb.com
> >> The Enterprise PostgreSQL Company
> >
> >
> >Thanks, Robert.
> >
> >Maybe if you just added a pointer to the "CREATE SERVER" command in
> >your definition of server_name it would provide a bread crumb.
> >
>
> Oh, I see my mistake. Maybe the inclusion of a link to "CREATE SERVER"
> http://www.postgresql.org/docs/9.1/static/sql-createserver.html in the
> server_name definition would be helpful, just like in the data_type line.
> I was having trouble making the leap since the idea was a new one on me.
I have done as you suggested with the attached patch which will appear
in Postgres 9.3.
--
Bruce Momjian <[email protected]> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ It's impossible for everything to be true. +
Attachments:
[text/x-diff] server.diff (708B, 2-server.diff)
download | inline diff:
diff --git a/doc/src/sgml/ref/create_foreign_table.sgml b/doc/src/sgml/ref/create_foreign_table.sgml
new file mode 100644
index 2113d00..f860ad0
*** a/doc/src/sgml/ref/create_foreign_table.sgml
--- b/doc/src/sgml/ref/create_foreign_table.sgml
*************** CREATE FOREIGN TABLE [ IF NOT EXISTS ] <
*** 135,141 ****
<listitem>
<para>
The name of an existing server for the foreign table.
! </para>
</listitem>
</varlistentry>
--- 135,142 ----
<listitem>
<para>
The name of an existing server for the foreign table.
! For details on defining a server, see <xref
! linkend="SQL-CREATESERVER">.
</listitem>
</varlistentry>
^ permalink raw reply [nested|flat] 3+ messages in thread
end of thread, other threads:[~2012-08-16 00:38 UTC | newest]
Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2011-09-15 16:51 Re: create foreign table Ray Stell <[email protected]>
2011-09-19 19:01 ` Robert Haas <[email protected]>
2012-08-16 00:38 ` Bruce Momjian <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox