Thread: Updated docs needed for 7.0
OK, I have talked to Thomas and have found which items need work for 7.0. Comments please. --------------------------------------------------------------------------- > Add CmdTuples() to libpq++(Vince) > New CREATE CONSTRAINT TRIGGER and SET CONSTRAINTS commands(Jan) > ALTER TABLE CONSTRAINT > First real FOREIGN KEY constraint trigger functionality (Jan) > Add FOREIGN KEY ... MATCH FULL ... ON DELETE CASCADE (Jan) > Add FOREIGN KEY ... MATCH referential actions (Don Baccus) > Add ALTER TABLE ... ADD FOREIGN KEY (Stephan Szabo) Needs much more work. > Add ecpg EXEC SQL IFDEF, EXEC SQL IFNDEF, EXEC SQL ELSE, EXEC SQL ELIF > and EXEC SQL ENDIF directives ecpg.sgml? > Updated user interfaces on initdb, initlocation, pg_dump, ipcclean (Peter E) Need updating of switches. > New libpq functions PQsetClientEncoding(), PQclientEncoding() (Tatsuo) Documented, but only in README.mb. Is that OK? > New lztext data type for compressed text fields Not documented. I think we want to document it, no? > New C-routines to implement a BIT and BIT VARYING type in /contrib > (Adriaan Joubert) Let's hold on this one. -- Bruce Momjian | http://www.op.net/~candle 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
> > New libpq functions PQsetClientEncoding(), PQclientEncoding() (Tatsuo) > > Documented, but only in README.mb. Is that OK? It seems I'm not looking forward to announce widely them since we will go into a direction supporting the national character and when they would be available, application interfaces might be changed dramatically. Comments? -- Tatsuo Ishii
On Mon, 10 Apr 2000, Bruce Momjian wrote: > > Updated user interfaces on initdb, initlocation, pg_dump, ipcclean (Peter E) > > Need updating of switches. initdb is up to date. initlocation and ipcclean don't even have any switches. pg_dump switches seem up to date but I don't have anything to do with that. > > New libpq functions PQsetClientEncoding(), PQclientEncoding() (Tatsuo) > > Documented, but only in README.mb. Is that OK? Seemingly, since README.mb is the de facto authorative source for MB documentation. > > New lztext data type for compressed text fields > > Not documented. I think we want to document it, no? No. :) -- Peter Eisentraut Sernanders väg 10:115 peter_e@gmx.net 75262 Uppsala http://yi.org/peter-e/ Sweden
> OK, I have talked to Thomas and have found which items need work for
> 7.0. Comments please.
>
> ---------------------------------------------------------------------------
>
> > Add CmdTuples() to libpq++(Vince)
>
> > New CREATE CONSTRAINT TRIGGER and SET CONSTRAINTS commands(Jan)
> > ALTER TABLE CONSTRAINT
> > First real FOREIGN KEY constraint trigger functionality (Jan)
> > Add FOREIGN KEY ... MATCH FULL ... ON DELETE CASCADE (Jan)
> > Add FOREIGN KEY ... MATCH referential actions (Don Baccus)
> > Add ALTER TABLE ... ADD FOREIGN KEY (Stephan Szabo)
Attached is are diffs for CREATE/ALTER table doc I've
forgotten in my mailbox (sorry). Haven't tried to apply and
since I don't have working sgml stuff cannot check.
> > New lztext data type for compressed text fields
>
> Not documented. I think we want to document it, no?
If at all, only in the release notes because it has to be
removed again as soon as we implement TOAST.
Jan
--
#======================================================================#
# It's easier to get forgiveness for being wrong than for being right. #
# Let's break this rule - forgive me. #
#========================================= wieck@debis.com (Jan Wieck) #
Attachment
Peter Eisentraut <e99re41@DoCS.UU.SE> writes:
> On Mon, 10 Apr 2000, Bruce Momjian wrote:
>>>> Updated user interfaces on initdb, initlocation, pg_dump, ipcclean (Peter E)
>>
>> Need updating of switches.
> initdb is up to date. initlocation and ipcclean don't even have any
> switches. pg_dump switches seem up to date but I don't have anything to do
> with that.
initlocation has switches ... look at the source ...
regards, tom lane
> > OK, I have talked to Thomas and have found which items need work for > > 7.0. Comments please. > > > > --------------------------------------------------------------------------- > > > > > Add CmdTuples() to libpq++(Vince) > > > > > New CREATE CONSTRAINT TRIGGER and SET CONSTRAINTS commands(Jan) > > > ALTER TABLE CONSTRAINT > > > First real FOREIGN KEY constraint trigger functionality (Jan) > > > Add FOREIGN KEY ... MATCH FULL ... ON DELETE CASCADE (Jan) > > > Add FOREIGN KEY ... MATCH referential actions (Don Baccus) > > > Add ALTER TABLE ... ADD FOREIGN KEY (Stephan Szabo) > > Attached is are diffs for CREATE/ALTER table doc I've > forgotten in my mailbox (sorry). Haven't tried to apply and > since I don't have working sgml stuff cannot check. Added. Thanks. > > > > New lztext data type for compressed text fields > > > > Not documented. I think we want to document it, no? > > If at all, only in the release notes because it has to be > removed again as soon as we implement TOAST. OK, I will remove the item from the list of needed doc changes. -- Bruce Momjian | http://www.op.net/~candle 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
[Charset iso-8859-1 unsupported, filtering to ASCII...] > On Mon, 10 Apr 2000, Bruce Momjian wrote: > > > > Updated user interfaces on initdb, initlocation, pg_dump, ipcclean (Peter E) > > > > Need updating of switches. > > initdb is up to date. initlocation and ipcclean don't even have any > switches. pg_dump switches seem up to date but I don't have anything to do > with that. OK, thanks, I will mark it as done. > > > > New libpq functions PQsetClientEncoding(), PQclientEncoding() (Tatsuo) > > > > Documented, but only in README.mb. Is that OK? > > Seemingly, since README.mb is the de facto authorative source for MB > documentation. OK, I will remove it. > > > > New lztext data type for compressed text fields > > > > Not documented. I think we want to document it, no? > > No. :) > OK, everyone seems to agree. -- Bruce Momjian | http://www.op.net/~candle 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
> > > New libpq functions PQsetClientEncoding(), PQclientEncoding() (Tatsuo) > > > > Documented, but only in README.mb. Is that OK? > > It seems I'm not looking forward to announce widely them since we will > go into a direction supporting the national character and when they > would be available, application interfaces might be changed > dramatically. > > Comments? OK, removed from list. -- Bruce Momjian | http://www.op.net/~candle 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
Tom Lane writes: > initlocation has switches ... look at the source ... They also come with this notice # These options are not really necessary, but what the heck. I think the change was actually to not require the option switch as such anymore (because there's nothing else you could do anyway), so the documentation could be considered up to date. :) Maybe I can put in a note though. -- Peter Eisentraut Sernanders väg 10:115 peter_e@gmx.net 75262 Uppsala http://yi.org/peter-e/ Sweden
Peter Eisentraut <peter_e@gmx.net> writes:
> Tom Lane writes:
>> initlocation has switches ... look at the source ...
> They also come with this notice
> # These options are not really necessary, but what the heck.
> I think the change was actually to not require the option switch as such
> anymore (because there's nothing else you could do anyway), so the
> documentation could be considered up to date. :) Maybe I can put in a note
> though.
OK, I hadn't actually stopped to look at what the options were ;-),
I was just skimming through Bruce's list of potential trouble spots
as fast as I could.
If you think there's no need to add more documentation, I'm cool with
that. The point of this exercise was just to make sure nothing had
slipped through the cracks. Making a conscious decision not to document
something is not dropping the ball.
regards, tom lane
[Charset ISO-8859-1 unsupported, filtering to ASCII...] > Tom Lane writes: > > > initlocation has switches ... look at the source ... > > They also come with this notice > > # These options are not really necessary, but what the heck. > > I think the change was actually to not require the option switch as such > anymore (because there's nothing else you could do anyway), so the > documentation could be considered up to date. :) Maybe I can put in a note > though. That's all I needed to hear. Doc TODO item removed. -- Bruce Momjian | http://www.op.net/~candle 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