Re: 7.1. Overview (The SQL Language) - Mailing list pgsql-docs

From Robert Haas
Subject Re: 7.1. Overview (The SQL Language)
Date
Msg-id BANLkTinnLZxhLyjYBFePBDCtOKga17FS2A@mail.gmail.com
Whole thread Raw
In response to 7.1. Overview (The SQL Language)  (Grzegorz Szpetkowski <gszpetkowski@gmail.com>)
Responses Re: 7.1. Overview (The SQL Language)  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
On Wed, May 11, 2011 at 3:38 PM, Grzegorz Szpetkowski
<gszpetkowski@gmail.com> wrote:
> http://www.postgresql.org/docs/9.0/static/queries-overview.html
>
> "Assuming that there is a table called table1, this command would
> retrieve all rows and all columns from table1."
>
> Maybe it's worth adding:
>
> "Assuming that there is a table called table1, this command would
> retrieve all rows and all columns (excluding system columns described
> at Section 5.4) from table1."

Since this is a basic SQL tutorial, we don't want to get too far down
into the weeds, or people will get confused.  The next sentence would
need some thought, too:

 The select list specification <literal>*</literal> means all columns
that the table expression happens to provide.

Possibly we could add a footnote?

--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company

pgsql-docs by date:

Previous
From: Robert Haas
Date:
Subject: Re: psql's ON_ERROR_STOP is misdocumented
Next
From: Robert Haas
Date:
Subject: Re: Please help me to build docs on the latest 9.1