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.94.2) (envelope-from ) id 1uJYga-001nyH-2o for pgsql-hackers@arkaria.postgresql.org; Mon, 26 May 2025 14:20:16 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1uJYgY-0022bV-IF for pgsql-hackers@arkaria.postgresql.org; Mon, 26 May 2025 14:20:14 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1uJYgY-0022bN-0Q for pgsql-hackers@lists.postgresql.org; Mon, 26 May 2025 14:20:14 +0000 Received: from mail-yw1-x1129.google.com ([2607:f8b0:4864:20::1129]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.96) (envelope-from ) id 1uJYgU-000Cs5-2w for pgsql-hackers@lists.postgresql.org; Mon, 26 May 2025 14:20:13 +0000 Received: by mail-yw1-x1129.google.com with SMTP id 00721157ae682-70e3980757bso11461587b3.1 for ; Mon, 26 May 2025 07:20:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=joeconway.com; s=google; t=1748269209; x=1748874009; darn=lists.postgresql.org; h=content-transfer-encoding:in-reply-to:autocrypt:from :content-language:references:cc:to:subject:user-agent:mime-version :date:message-id:from:to:cc:subject:date:message-id:reply-to; bh=2cD0kHDvDDAB5CfRUky+fn4mjNBoJeO/K4KiOpdpQSI=; b=oo1x6j9uheG195kX+vm2rz27vXBT4kdZnGDoaOHokoUKELIOjbMT8dIifXrTVsLQEc bZzo7cx/aTRdN7e/5VwKKxlsf4OTke0g683RjzJ63kRHQdV6/VcRXaHoe1rYTpIC18EY pYyqu7x4elBGupgdd5AJdRK5rDmExSkdX5NRD3FCGhg4QtqoZG7+ZeRGUYGAVK9Eb14W m4dnz6rMpwZ3NzBjd8TDRk71iEpBLvkJC5SI9osFHzNaYWVwKa/SajykYUeC4U4hcFzq SxsJpB0UAxxBUpGZ32/ymz6ZMFesW5XoBRL6xy4f2gQdP5G9NOxPxGBSsqJ76WBW5P27 LLjg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1748269209; x=1748874009; h=content-transfer-encoding:in-reply-to:autocrypt:from :content-language:references:cc:to:subject:user-agent:mime-version :date:message-id:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=2cD0kHDvDDAB5CfRUky+fn4mjNBoJeO/K4KiOpdpQSI=; b=AzQdzbwz8sPiRL8tmC2XdTBbNmBeo1TXpa8jxj9os1Z8HkdYhGpThL0xrUq/G8Vu+3 2ERI3gPU3DW81bjYgCY3eC3+09RmPhflRXs4ayMEg2Sr6s6+Q5x3itMmZZzAAfqM+VG7 /1YmmSPQInLqZ7+GwW1KPXlAQllncuY73Bnrc9AydUK9Nv1vNmZGdhxm1htfH9flNbJ5 Q9dYFrIjuln4OO3WVAzwHzdVu3wwKOoo0XEVl43Sorn7EFkhPfTfAYDFNKc2tRjeiHkz BqFf7OZC3/7oV6Rc08oXjZcn6C4Evwrg/hOyPiL/1XgF4lJzafDENzmf+A/kdOeCRodx BhGw== X-Forwarded-Encrypted: i=1; AJvYcCX1qWpnhDDBFrP8ASL6CfIKQF7B/lrEABd8GH1E6Y8l/FIukjtB9woyY4KtsAP4U2KkMscw28H26NGquvPO@lists.postgresql.org X-Gm-Message-State: AOJu0YwEqdQJ3g4pmup4bNsnat/VSb14dPLz9xhRwSohZT+KtR2bJpta 54uIY3psLtPojNksC5Htwk1N2Z/LrDLcjQxuBXs03LQSI08f8CRgrkZYmWyOQkm7+kw= X-Gm-Gg: ASbGncvPoNegoIxoHxzaHpLpAjmX3QuGqpwVWqPD/xJxzr8aFjE6firYXwna2I//sZL QUU8zx1QDL9Xi9Q99dGmSDqhu4mZd+oaXr1J/0vsgJtgpg3wQZkHwpHI/TXN9bHMbYFw3F2lBrl iMP+lScj2+euotPCQuTeIRxEa283tFDljFpbmm5dj9E6aMthtFA7yov7HmlC5gJubupLHRsSWrO 7xdhEbxxHUyWayftciaROYkM+L30Pg40V+sS491J0D4GpWmRU5429rNEsnf01MEpMvEtxEY1Kxv cUQKelSxIVo95XFfr4CknpXBAOoS8+5N3Adh/gPZxxm/ioOoqu6ha7ryYd+iACvM8RKFIK7PJOc ba/jcOu4FejyOCE95W5X7Ncq36cxlApI= X-Google-Smtp-Source: AGHT+IHhvVsRjnNq4BeBfCRwcaxcQZKCkkEplnzA2kPMm3swa7jFSaLGs/6wrqBpCQ3YF9rvrKwh3g== X-Received: by 2002:a05:690c:312:b0:6f9:4c00:53ae with SMTP id 00721157ae682-70e2cb841b5mr112447227b3.8.1748269209566; Mon, 26 May 2025 07:20:09 -0700 (PDT) Received: from [192.168.4.41] (162-239-31-113.lightspeed.dybhfl.sbcglobal.net. [162.239.31.113]) by smtp.gmail.com with ESMTPSA id 00721157ae682-70e1d4234a5sm14318877b3.100.2025.05.26.07.20.08 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 26 May 2025 07:20:08 -0700 (PDT) Message-ID: <03b04188-02e2-4bd8-b65b-18c3e1cc40c4@joeconway.com> Date: Mon, 26 May 2025 10:20:08 -0400 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: PG 18 release notes draft committed To: Bruce Momjian , =?UTF-8?Q?=C3=81lvaro_Herrera?= Cc: Nazir Bilal Yavuz , PostgreSQL-development , Thomas Munro References: <202505230754.fsspbpqhybqt@alvherre.pgsql> Content-Language: en-US From: Joe Conway Autocrypt: addr=mail@joeconway.com; keydata= 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 In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On 5/23/25 09:47, Bruce Momjian wrote: > On Fri, May 23, 2025 at 09:54:54AM +0200, Álvaro Herrera wrote: >> I also think that showing an XML-ish format of a commit message is >> unhelpful, not to mention hard to read. Showing a few actual examples >> would be better. > > Agreed, but the XML came from Joe Conway so I am hesitant to remove it > myself without feedback from him. I am not married to it, but I would say that I find pure examples confusing/ambiguous. To me at least the XML-ish specification is easier to understand. Perhaps both the specification as-is and one or two examples added? -- Joe Conway PostgreSQL Contributors Team RDS Open Source Databases Amazon Web Services: https://aws.amazon.com