Updated docs needed for 7.0

Started by Bruce Momjianabout 26 years ago11 messagesdocs
Jump to latest
#1Bruce Momjian
bruce@momjian.us

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
#2Tatsuo Ishii
t-ishii@sra.co.jp
In reply to: Bruce Momjian (#1)
Re: Updated docs needed for 7.0

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

#3Peter Eisentraut
peter_e@gmx.net
In reply to: Bruce Momjian (#1)
Re: Updated docs needed for 7.0

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

#4Jan Wieck
JanWieck@Yahoo.com
In reply to: Bruce Momjian (#1)
Re: 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)

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

Attachments:

diff4text/plain; charset=US-ASCIIDownload+606-30
#5Tom Lane
tgl@sss.pgh.pa.us
In reply to: Peter Eisentraut (#3)
Re: Updated docs needed for 7.0

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

#6Bruce Momjian
bruce@momjian.us
In reply to: Jan Wieck (#4)
Re: 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)

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
#7Bruce Momjian
bruce@momjian.us
In reply to: Peter Eisentraut (#3)
Re: Updated docs needed for 7.0

[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
#8Bruce Momjian
bruce@momjian.us
In reply to: Tatsuo Ishii (#2)
Re: Updated docs needed for 7.0

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
#9Peter Eisentraut
peter_e@gmx.net
In reply to: Tom Lane (#5)
Re: Updated docs needed for 7.0

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

#10Tom Lane
tgl@sss.pgh.pa.us
In reply to: Peter Eisentraut (#9)
Re: Updated docs needed for 7.0

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

#11Bruce Momjian
bruce@momjian.us
In reply to: Peter Eisentraut (#9)
Re: Updated docs needed for 7.0

[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