commented out para in docs

Started by Andrew Dunstanover 16 years ago3 messages
#1Andrew Dunstan
andrew@dunslane.net

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&gt;).

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>
-->

#2Kevin Grittner
Kevin.Grittner@wicourts.gov
In reply to: Andrew Dunstan (#1)
Re: commented out para in docs

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

#3Bruce Momjian
bruce@momjian.us
In reply to: Andrew Dunstan (#1)
Re: commented out para in docs

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&gt;).

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.com
  PG East:  http://www.enterprisedb.com/community/nav-pg-east-2010.do
  + If your life is a hard drive, Christ can be your backup. +