Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1wMuvK-000RQN-1f for pgsql-hackers@arkaria.postgresql.org; Tue, 12 May 2026 21:45:55 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.96) (envelope-from ) id 1wMuvH-0069XR-0o for pgsql-hackers@arkaria.postgresql.org; Tue, 12 May 2026 21:45:51 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1wMuvG-0069XJ-2J for pgsql-hackers@lists.postgresql.org; Tue, 12 May 2026 21:45:51 +0000 Received: from mail-lf1-x12e.google.com ([2a00:1450:4864:20::12e]) by makus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.98.2) (envelope-from ) id 1wMuv9-00000000Ge7-1euG for pgsql-hackers@postgresql.org; Tue, 12 May 2026 21:45:49 +0000 Received: by mail-lf1-x12e.google.com with SMTP id 2adb3069b0e04-5a8891f0c88so3592977e87.1 for ; Tue, 12 May 2026 14:45:43 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1778622342; cv=none; d=google.com; s=arc-20240605; b=TtqqoE6fgiP1B6Z/d4qVvl4+lErP2DQyMq47LhUajFM7oLPXrWYd17CKL8lVX05PIr qr4g1JOx0rQHHpaklDclbovhkkprl6gxB1pzuWzc3mHekMYPIHTOiyWKvRidex4sdLoc CvuhbeXN8ozmpt53bnE20Y9KuGe4t0yv4b/NJ10EVm5E2mISn19o+VsF86VLu6KClC3+ OoY7SpGGQc2RIYdLk2aCz1aMCBnc4tg5A7to7IAIrL18H8Ib8uNDPJeGGSXWyf52lWpm szh8919jw55dkVDXiLXtPrpdMV4Nk54rB0Eb5kJsoFBxotA5Wd7aQ4UoP1DV+DdeEEGp nwFg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:dkim-signature; bh=3ARECy6l5D8daynTSuRn13vDjMNsrvAnxfSTFcBs1LQ=; fh=IIq6lHvzsCbwad7YnxQLtNzekF+3oOLpYtpvw/L6MWI=; b=aQASaoc5LgvWp/OBltdr4myVGgyDoiAC3WDd8jDLr0RCaefB+w9bSW53bj0lIbrLHJ tDSlhDfQ0fR37qbYWZJ8qoFmpbxwcK372ieDQGBjfUWRrpq8vJ8SYdWvoSjqpkhACpQU O+CrrX4+pxsAm4uOBH/cFFs/eFZl1zq7mt4rIWHdi8rRaVCDxhuVG4lSFgmbefQ0YfCB 5MSkI+NmHnULGh5XYgPafeq7vZTf7KCe0sZ5Ra3Cbu5yzRjogyMYmhrLxd2xJZeJE5Og emVuWGzt/QqUQikTSKmC4ff4jnAHWrf5lLqAVRNXf3J3umDDx2FSxiP/dz27npStiUQa 4gEA==; darn=postgresql.org ARC-Authentication-Results: i=1; mx.google.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=f10-com-br.20251104.gappssmtp.com; s=20251104; t=1778622342; x=1779227142; darn=postgresql.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=3ARECy6l5D8daynTSuRn13vDjMNsrvAnxfSTFcBs1LQ=; b=m2PikLrbWrm6fYc86UE9QXLYV+FLymyTVOY0YWT1gHXv7xa+kUwQD8iPRO1kIj8TUE wYYU86WkuWDOSugvfMNhQ/lFL+XPwwgCBulfQrgDyvUTxMlI+VF+xK59t/4+KTCpZhdr Dz4OamS+t8XxdRFv3h9CoMYlQPueyXcJmTV9QyE49WQQb6Zq/IOCLrms9dH1t/bI7NZz D4KQCQFDGLxpoY1YcsDW5TKG/6Xl/uPyZfoE4A2at2PnnnxTN04tgfNVjnazMyjtUbvf dksAtLcXPeA4MEJUOyqM0XVLx/koeKj6cRLz9iyBbUenLcNGe4/nPlt2f4LWLg0Av3DP 5k4w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1778622342; x=1779227142; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=3ARECy6l5D8daynTSuRn13vDjMNsrvAnxfSTFcBs1LQ=; b=Me6GiumV8Monqs75Q2uCI6bO2LOBZKOJY09gIoAAXPLRARIi0fqhLQkX9axNzMrkN1 SUNCxnh5wvqSWp/wpRD3JZic1OMUanXEVzcXV+b78sH6VIaRXHp69rYC2Woh9Jr7YeVZ 8ScEib5YehTY2JMkis2tLgbeb5K6/SPnWeeCO0jhGZqzDHpRISzzvU1Gp+bisULCcvBV Fa+uxw+bgzzl4WsmfSVt1wS3dvP2u7irbVizensdnLZssZoDGBXrQix/7IjO1N58ByHr BR6kYsBR3BOIQWlCtLs53jOUUGLtPvVBHrWFTou2TwfjkINkAG7x9vHAO4EZg5ADrnvP cdCg== X-Forwarded-Encrypted: i=1; AFNElJ/TDv2GLQ7IoDLn6ah2WkFQ+3PmsmhiT9T155ctgmGJkv6NthhpzZdw4lRmH/Lz+/bn+TXxctzf/ZsreAad@postgresql.org X-Gm-Message-State: AOJu0YyQMV16xGf/ZCT1Ad3T4EzAhxvXnmsJPOFTZOdhM+wJMxmlq7if YscJ9kNOyqiEMFl9kJVkcgkzm4bzyAWyurCNaGgaG84lUm8jE9Sg0t5D1tPJhPj8H0mw65hpeOi zu5TBkNe3Unza0rmELj5Cb4ifQxJ4iQGN54au3JBl X-Gm-Gg: Acq92OEkWGuKe0mXtMIadcNBUgUMZfjESZr7WFWz6MdjaOo9jURwMv5Ga6SakW8WLDQ uQzPimpj8djs6ytIJJ25P3STrDujzDp71mvOaKzVADcwKEcNkqfLCtqvmOnXoKJ8vcjLwve8ohQ tPeC+Zvg0WMaSJU3SQibcpt6QEPcB2O3x/nNSXEAOoJrSVEzYbIGr5dXg8NDgsw0uUb3gFPp7qL +avaIhetVHJ8oXFU0UjfSLS314msg4+I4hSH1jrpADOJqQfGeItB9viz3G+EI2qZnYV42fuQNAU UXp8mw== X-Received: by 2002:a05:6512:39d1:b0:5a8:f03c:42d8 with SMTP id 2adb3069b0e04-5a8f37cb356mr26911e87.17.1778622342108; Tue, 12 May 2026 14:45:42 -0700 (PDT) MIME-Version: 1.0 References: <2077214.1778512784@sss.pgh.pa.us> In-Reply-To: <2077214.1778512784@sss.pgh.pa.us> From: Marcos Pegoraro Date: Tue, 12 May 2026 18:45:05 -0300 X-Gm-Features: AVHnY4LsIfbg3UPfhZT86FJZ3ViE253qfoSe1WiIeO_OWbN31nuNBH5yyK7MkSs Message-ID: Subject: Re: Missing jsonb_ ... functions on DOCs To: Tom Lane Cc: Michael Paquier , pgsql-hackers Content-Type: multipart/alternative; boundary="000000000000e429d50651a5c81e" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --000000000000e429d50651a5c81e Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Em seg., 11 de mai. de 2026 =C3=A0s 12:19, Tom Lane esc= reveu: > We have a general policy of not documenting functions that underlie > operators, simply because doing otherwise would bloat the > documentation enormously while not adding much value. > And if we have a separate page containing all non documented functions related to their correspondent operators ? Just one page with one table with all undocumented jsonb functions, another table with undocumented interval functions and so on. This way we document them and all main pages are not bloated with duplicated functions. We need only a "Click here to see the functions corresponding to the operators you see in this table.", or something What do you think ? regards Marcos --000000000000e429d50651a5c81e Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Em seg., = 11 de mai. de 2026 =C3=A0s 12:19, Tom Lane <tgl@sss.pgh.pa.us> escreveu:
We have a general policy of not documenting functions that underlie operators, simply because doing otherwise would bloat the
documentation enormously while not adding much value.
=
And if we have a separate page containing all n= on documented functions related to their correspondent operators ?
Just one page with one=C2=A0table with all undocumented json= b functions, another table with undocumented interval functions and so on.<= /div>

This way we document the= m and all main pages are not bloated with duplicated functions.
We need only a "Click here to see the functions correspond= ing to the operators you see in this table.", or something

What do you think ?

regards
Marcos
--000000000000e429d50651a5c81e--