7.2 doc comments

Started by Bruno Wolff IIIover 24 years ago3 messagesbugsdocs
Jump to latest
#1Bruno Wolff III
bruno@wolff.to
bugsdocs

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.

#2Bruce Momjian
bruce@momjian.us
In reply to: Bruno Wolff III (#1)
bugsdocs
Re: 7.2 doc comments

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@candle.pha.pa.us               |  (610) 853-3000
  +  If your life is a hard drive,     |  830 Blythe Avenue
  +  Christ can be your backup.        |  Drexel Hill, Pennsylvania 19026
#3Tom Lane
tgl@sss.pgh.pa.us
In reply to: Bruno Wolff III (#1)
bugsdocs
Re: [BUGS] 7.2 doc comments

bruno@wolff.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