Received: from sss.pgh.pa.us ([192.204.191.242])
	by postgresql.org (8.11.3/8.11.4) with ESMTP id f7QFOkf73293;
	Sun, 26 Aug 2001 11:24:46 -0400 (EDT)
	(envelope-from tgl@sss.pgh.pa.us)
Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1])
	by sss.pgh.pa.us (8.11.4/8.11.4) with ESMTP id f7QFOYK18560;
	Sun, 26 Aug 2001 11:24:34 -0400 (EDT)
To: Cedar Cox <cedarc@visionforisrael.com>
cc: pgsql-sql@postgresql.org, pgsql-docs@postgresql.org
Subject: Re: [SQL] undocumented setval() 
In-reply-to: 
 <Pine.LNX.4.21.0108261139340.6505-100000@nanu.visionforisrael.com>
References: <Pine.LNX.4.21.0108261139340.6505-100000@nanu.visionforisrael.com>
Comments: In-reply-to Cedar Cox <cedarc@visionforisrael.com>
	message dated "Sun, 26 Aug 2001 11:40:33 +0300"
Date: Sun, 26 Aug 2001 11:24:34 -0400
Message-ID: <18557.998839474@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>
X-Archive-Number: 200108/21
X-Sequence-Number: 908

Cedar Cox <cedarc@visionforisrael.com> writes:
> When looking through a dump file, I noticed a setval(text, int,
> bool).  What is this?  It doesn't appear to be documented.

The bool parameter sets the is_called state bit of the sequence.
Without this you can't restore a sequence to a virgin "never nextval'd"
state.

Actually, none of the sequence-related functions are documented in
what I'd call a proper way.  I think there should be a separate section
of the user's guide "Functions and Operators" chapter that describes
them --- not a large section, but a section nonetheless.  Any
volunteers to write it?

			regards, tom lane