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

help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: David G. Johnston <david.g.johnston@gmail.com>
Cc: Marcos Pegoraro <marcos@f10.com.br>
Cc: jian he <jian.universality@gmail.com>
Cc: Jeff Davis <pgsql@j-davis.com>
Cc: Yugo NAGATA <nagata@sraoss.co.jp>
Cc: Peter Eisentraut <peter@eisentraut.org>
Cc: David Rowley <dgrowleyml@gmail.com>
Cc: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Subject: Re: Document NULL
Date: Tue, 11 Mar 2025 16:43:49 -0400
Message-ID: <1649111.1741725829@sss.pgh.pa.us> (raw)
In-Reply-To: <CAKFQuwY6ctmky5e+ahKGB2e3p48_fJ15xjmvVA4kTb1sOU650A@mail.gmail.com>
References: <CAKFQuwbwNue2bDA4_SW2UZ-Yrj91FVre76SJXVsvBrJf2cteUQ@mail.gmail.com>
	<CAApHDvpPjq461bFPznAP6WEybmV4yaQ8ngY5K59VOwEg31a4og@mail.gmail.com>
	<2074118.1714625223@sss.pgh.pa.us>
	<CAKFQuwZ5=WYz0bLXj3ryqqecFvZRbxP20fo1GiDMFiqh-qODeg@mail.gmail.com>
	<6c11f5a2-478c-42af-9208-e82bb710e78a@eisentraut.org>
	<CAKFQuwZgmwUDegus9WFK5WgKRp9i89b7g0ea4dXzBJNysuHHuw@mail.gmail.com>
	<2674591.1714751043@sss.pgh.pa.us>
	<CAKFQuwbsd-ktyf--vL1+uLFzGzzkt9RtM8ULUHif666TNnz6vQ@mail.gmail.com>
	<CAKFQuwZVC49Cf6953J3CYSo=_Ra9JGf4ntNj6YJ7cDtqwhX=og@mail.gmail.com>
	<20240619123412.7bd1f5fd827120192a24674a@sraoss.co.jp>
	<CAKFQuwb5cDjoBLmoRWojBrR1MP4Z6+WYmPEmqpT2qkVNVA0fLA@mail.gmail.com>
	<20240619141520.9fefb69d051fb112f41bf1d1@sraoss.co.jp>
	<54757.1718775943@sss.pgh.pa.us>
	<CAKFQuwbwXMUrPiGhqgZecgicsHyD+e0KgeUsf8OxaOaJbNoCOQ@mail.gmail.com>
	<20240627121425.e0b6fa51b8f3682da11b3a6c@sranhm.sraoss.co.jp>
	<CAKFQuwbHuT82b3jYwH+yhuKrpLoa0Ebr+sT6mTFS+nfjAAGUFQ@mail.gmail.com>
	<505f9dfcc6e84a442c6fbdf600! ab1df1e5030603.camel@j-davis.com>
	<CAKFQuwZoeWrM0WuH2io+MoiFKtQjp+Y+8gO1PUDRs8iEzwj16w@mail.gmail.com>
	<5fbbebb78a9e5ecea8adbbc1ba720dd0ca6d5205.camel@j-davis.com>
	<CAKFQuwbfzvDWv0Pk3Ue=1ucNcmMTa6h=+OXb6Suyv=XeX9Xrmw@mail.gmail.com>
	<CACJufxFsZOaJ3d9yGSj2bWJOBrMe-98YrA3NG-=0zCY=NHViqA@mail.gmail.com>
	<CAKFQuwY7=us5wG2SxLTdLLT-9M+BNDOz5d=84VGQv+JVG-W7pQ@mail.gmail.com>
	<CAB-JLwavLhXvmGodtLgZJf8j5fbFrNZyhJU7Xe-pYdzM6sDoHg@mail.gmail.com>
	<CAKFQuwaORD0X=Vu=Hfc6wY0BTE-JRHFrpjGAgxrNnCPFqCJ0rQ@mail.gmail.com>
	<CAB-JLwZ5czprg8y+EGqDYTruyRBN1a3KAkHM-=fR57FLSU6FCw@mail.gmail.com>
	<CAKFQuwaL+XKvyKvRXeB6G1DMjtxUGveMRiRpna35UHyT+f8KNg@mail.gmail.com>
	<CAB-JLwZ8mxd9Hv_WiRpg+Yo7kn9KGYeukwPo1PM6dhqaiX-OpA@mail.gmail.com>
	<CACJufxG75TO7CvC8vJ6h8iC1ojgBdY-VW_71p+5jBFr0nAsDGw@mail.gmail.com>
	<CAKFQuwZY28qeYB0s_gU0eOg0_GAerLpbB=Wtc27_PTZGwKyFgw@mail.gmail.com>
	<CACJufxE_9FEqyJECBEDexx2qj2-yJTE7OVAdAEThGagOfUO7eQ@mail.gmail.com>
	<CAKFQuwbQcwF+dr0jStrRJev5ntCDXkiQfV6jz1qMTKb03ArU4Q@mail.gmail.c! om>
	<CAKFQuwawRTo6pVmyj2FQqKKjgiV=XPU5PTu07yNJoE_gGt_OBg@mail.gmail.com>
	<CAB-JLwY-nOpxcpCWjT3DNuC+fTAa-6AuXSWZPmJvRzS2BRbajA@mail.gmail.com>
	<CAKFQuwYbRds-whA9FRJn3pJ0JeGiwC_z4A8hORa1Tu-EnNcrcA@mail.gmail.com>
	<CAKFQuwZP+xFHYWWRBbji=R8=Ghe+X6wV6J7=LC8KNf3iPD04-Q@mail.gmail.com>

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> On Tue, Mar 11, 2025 at 1:19 PM Marcos Pegoraro <marcos@f10.com.br> wrote:
>> I understand that this page we have more NULL values than everywhere else
>> combined, but it's a good opportunity to set a standard for all
>> documentation

> If someone writes a patch to make everywhere <null> and changes this page
> in the process I wouldn't complain.  For now there is no such standard, we
> use empty string everywhere else, and that isn't a good choice here IMO.
> It is probably a good choice for elsewhere since the empty string is our
> default.  While specific to this page \N reads the best for these examples
> IMO.  But I'll concede to whatever if others think this choice is a
> review/commit blocker.

I think that idea (changing all the docs) is a complete nonstarter
because people would not understand why the results they get don't
look like what it says in the docs.  Of course, we could fix that
by changing the factory default for \pset null, but that seems like
even more of a nonstarter.

We can probably get away with having one page that assumes a
different \pset null setting, as long as there's a clear <note>
about it at the top of the page.

			regards, tom lane





view thread (93+ messages)  latest in thread

Message-ID: <1649111.1741725829@sss.pgh.pa.us>
Permalink:  ../1649111.1741725829@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/1649111.1741725829@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-hackers@postgresql.org
  Cc: tgl@sss.pgh.pa.us, david.g.johnston@gmail.com, marcos@f10.com.br, jian.universality@gmail.com, pgsql@j-davis.com, nagata@sraoss.co.jp, peter@eisentraut.org, dgrowleyml@gmail.com, pgsql-hackers@lists.postgresql.org
  Subject: Re: Document NULL
  In-Reply-To: <1649111.1741725829@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