Re: 7.2 doc comments

Lists: pgsql-bugsPostg배트맨 토토SQL : Postg배트맨 토토SQL 메일 링리스트 : 2001-11-11 이후 PGSQL-DOCS 19:24
From: bruno(at)wolff(dot)to
To: pgsql-bugs(at)postgresql(dot)org
Subject: 7.2 doc comments
Date: 2001-11-11 13:30:45
Message-ID: 20011111073045.A6573@cerberus.csd.uwm.edu
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-bugs pgsql-docs

There seems to be a typo in the GRANT documentation.
REFERENCES
To create of a table with a foreign key constraint, it is
necessary to have this privilege on the table with the primary
key.

I think you just want to remove "of".

I also found it odd that currval, nextval, and setval are covered in
the CREATE SEQUENCE and not in a section under functions. Even if the
main documentation for them stays in CREATE SEQUENCE, a reference to
them from the function documentation would be nice.


From: Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us>
To: bruno(at)wolff(dot)to
Cc: pgsql-bugs(at)postgresql(dot)org
Subject: Re: 7.2 doc comments
Date: 2001-11-11 19:24:51
Message-ID: 200111111924.fABJOpj01984@candle.pha.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-bugs Postg배트맨 토토SQL : Postg배트맨 토토SQL 메일 링리스트 : 2001-11-11 이후 PGSQL-DOCS 19:24

> There seems to be a typo in the GRANT documentation.
> REFERENCES
> To create of a table with a foreign key constraint, it is
> necessary to have this privilege on the table with the primary
> key.
>
> I think you just want to remove "of".

Fixed. Thanks.

> I also found it odd that currval, nextval, and setval are covered in
> the CREATE SEQUENCE and not in a section under functions. Even if the
> main documentation for them stays in CREATE SEQUENCE, a reference to
> them from the function documentation would be nice.

I will let others answer this one. I am not sure.

--
Bruce Momjian | http://candle.pha.pa.us
pgman(at)candle(dot)pha(dot)pa(dot)us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026


From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: bruno(at)wolff(dot)to
Cc: pgsql-docs(at)postgreSQL(dot)org
Subject: Re: [BUGS] 7.2 doc comments
Date: 2001-11-12 02:03:03
Message-ID: 266.1005530583@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-bugs pgsql-docs

bruno(at)wolff(dot)to writes:
> I also found it odd that currval, nextval, and setval are covered in
> the CREATE SEQUENCE and not in a section under functions. Even if the
> main documentation for them stays in CREATE SEQUENCE, a reference to
> them from the function documentation would be nice.

I tend to agree on this: the main docs for the sequence functions should
be in a section under "Functions and Operators", with just a
cross-reference from CREATE SEQUENCE. Comments?

regards, tom lane