Postgres Pro
Downloads
Home   >   mailing lists

Thread: commented out para in docs

commented out para in docs

From
Andrew Dunstan
Date:

We have this para in the CREATE TABLE docs, commented out, as shown. It 
seems to have been like that for a long time (see 
<http://anoncvs.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/ref/create_table.sgml?annotate=1.48>).

Surely we should either include it or remove it. Having it commented out 
in the docs seems like just noise.

cheers

andrew


<!--    <para>     <productname>PostgreSQL</> automatically allows the    created table to inherit     functions on
tablesabove it in the inheritance hierarchy; that     is, if we create table <literal>foo</literal> inheriting from
<literal>bar</literal>,then functions that accept the tuple     type <literal>bar</literal> can also be applied to
instancesof     <literal>foo</literal>.  (Currently, this works reliably for     functions on the first or only parent
table,but not so well for     functions on additional parents.)    </para>
 
-->

Re: commented out para in docs

From
"Kevin Grittner"
Date:
Andrew Dunstan <andrew@dunslane.net> wrote:
> We have this para in the CREATE TABLE docs, commented out
> Surely we should either include it or remove it.
+1
If it's deleted, it'll still be in CVS history if someone wants it....
-Kevin

Re: commented out para in docs

From
Bruce Momjian
Date:
Andrew Dunstan wrote:
> 
> 
> We have this para in the CREATE TABLE docs, commented out, as shown. It 
> seems to have been like that for a long time (see 
> <http://anoncvs.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/ref/create_table.sgml?annotate=1.48>).
> 
> Surely we should either include it or remove it. Having it commented out 
> in the docs seems like just noise.
> 
> cheers
> 
> andrew
> 
> 
> <!--
>      <para>
>       <productname>PostgreSQL</> automatically allows the
>      created table to inherit
>       functions on tables above it in the inheritance hierarchy; that
>       is, if we create table <literal>foo</literal> inheriting from
>       <literal>bar</literal>, then functions that accept the tuple
>       type <literal>bar</literal> can also be applied to instances of
>       <literal>foo</literal>.  (Currently, this works reliably for
>       functions on the first or only parent table, but not so well for
>       functions on additional parents.)
>      </para>
> -->

Agreed, removed.

--  Bruce Momjian  <bruce@momjian.us>        http://momjian.us EnterpriseDB
http://enterprisedb.comPG East:  http://www.enterprisedb.com/community/nav-pg-east-2010.do + If your life is a hard
drive,Christ can be your backup. +