pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Alex <cdalxndr@yahoo.com>
Cc: Tatsuo Ishii <ishii@sraoss.co.jp>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Invalid idle_in_transaction_session_timeout data type
Date: Thu, 11 Mar 2021 11:20:05 -0500
Message-ID: <2294219.1615479605@sss.pgh.pa.us> (raw)
In-Reply-To: <c0e06b0927222.cf42cafcd23b9@yahoo.com>
References: <11783b8644ae5.7f3aa1e3b18b4.ref@yahoo.com>
	<11783b8644ae5.7f3aa1e3b18b4@yahoo.com>
	<20210311.211047.1106690547580793701.t-ishii@gmail.com>
	<c0e06b0927222.cf42cafcd23b9@yahoo.com>

[ redirecting to pgsql-docs ]

Alex <cdalxndr@yahoo.com> writes:
> In my opinion, it would be more clear if "Numeric with Unit" would be
> specified on that property documentation, so that I can search more about
> what that means (eventually a link pointing to details).
> I saw "(integer)" so I assumed `show idle_in_transaction_session_timeout `
> will return an integer.

This complaint isn't totally without merit.  I wonder whether there is
any value in listing a unit-ized GUC's default unit as part of the
type info, so that we'd have entries like

	work_mem  (integer, kilobytes)

	statement_timeout  (integer, milliseconds)

That'd both provide some concrete info about which unit applies,
and cue unwary users that there might be more to it than just a
number.

I'm not sure whether this could replace the existing boilerplate
phrases about "If this value is specified without units, it is taken
as kilobytes", but it's sure more compact.

			regards, tom lane





view thread (9+ messages)  latest in thread

Message-ID: <2294219.1615479605@sss.pgh.pa.us>
Permalink:  ../2294219.1615479605@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/2294219.1615479605@sss.pgh.pa.us

 · 

reply
Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: tgl@sss.pgh.pa.us, cdalxndr@yahoo.com, ishii@sraoss.co.jp, pgsql-docs@lists.postgresql.org
  Subject: Re: Invalid idle_in_transaction_session_timeout data type
  In-Reply-To: <2294219.1615479605@sss.pgh.pa.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox