RESET command seems pretty disjointed now

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-hackers(at)postgreSQL(dot)org
Cc: Neil Conway <neilc(at)samurai(dot)com>, "Marko Kreen" <markokr(at)gmail(dot)com>
Subject: RESET command seems pretty disjointed now
Date: 2007-04-15 21:01:49
Message-ID: 22929.1176670909@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

The current documentation for RESET exhibits a certain lack of, um,
intellectual cohesiveness:

Name

RESET -- restore the value of a run-time parameter to the default value

Synopsis

RESET configuration_parameter
RESET ALL
RESET { PLANS | SESSION | TEMP | TEMPORARY }

That one-line summary has got approximately zip to do with the newly
added options; as does most of the Description section. At the very
least this manual page needs an extensive rewrite. But I wonder whether
the real problem isn't that we chose a bad name for the new commands.
Is there another keyword we could use instead of RESET? A concrete
objection to the current state of affairs is that absolutely anyone,
looking at this set of options with no prior knowledge of PG, would
expect that RESET ALL subsumes all the other cases.

regards, tom lane

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Florian G. Pflug 2007-04-15 22:20:58 Build-Problem with pgc.c on OSX 10.4
Previous Message Peter Eisentraut 2007-04-15 17:44:33 Re: Makefile patch to make gcov work on Postgres contrib modules