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 1qnN7A-00AlKb-Ej for pgsql-hackers@arkaria.postgresql.org; Mon, 02 Oct 2023 17:53:53 +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 1qnN79-00Ga9b-3d for pgsql-hackers@arkaria.postgresql.org; Mon, 02 Oct 2023 17:53: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.94.2) (envelope-from ) id 1qnGcb-00AqOg-Ti for pgsql-hackers@lists.postgresql.org; Mon, 02 Oct 2023 10:57:53 +0000 Received: from meesny.iki.fi ([195.140.195.201]) by makus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1qnF5S-007kvc-AQ for pgsql-hackers@postgresql.org; Mon, 02 Oct 2023 09:19:35 +0000 Received: from [192.168.1.115] (dsl-hkibng22-54f8db-125.dhcp.inet.fi [84.248.219.125]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) (Authenticated sender: hlinnaka) by meesny.iki.fi (Postfix) with ESMTPSA id 4Rzb4d51FBzydx; Mon, 2 Oct 2023 12:19:29 +0300 (EEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=iki.fi; s=meesny; t=1696238371; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=QWbC2Wk1fPh1SXhSQl7HNRnfRWasEHvwtyZA+yQNToc=; b=U011VE3NRenCrN21qUBf6zagBgiXtY/BQWTaHDEWUwg6U2JCAY6ZLg4wGFDBUWZMa9SJQr eiEX8rqBKJsXMmg/R8GRWnTUP6q60UJICrDZQXngWaZlQtXrM5LkqEgJmKEBbo/DbKI30m j0SIXufoFrvUUyYLbTLlhqp2+6KNEOQ= ARC-Seal: i=1; s=meesny; d=iki.fi; t=1696238371; a=rsa-sha256; cv=none; b=xbSlvedqeVrKpeh+cfdNceIgDdwJ+HORj19j9WT9mOsqxE5npfAX8g4kVXEhD4dr5Yhf48 bBU6+bJmpxxuXvALFmqdLoXsN8FaWZ67fk4hvGRVoGi1sVPscVREid+dp25VbxlF2Hxnnu Cs1giYHgWeXMlv7boRCSoSF9NI4Usvg= ARC-Authentication-Results: i=1; ORIGINATING; auth=pass smtp.auth=hlinnaka smtp.mailfrom=hlinnaka@iki.fi ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=iki.fi; s=meesny; t=1696238371; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=QWbC2Wk1fPh1SXhSQl7HNRnfRWasEHvwtyZA+yQNToc=; b=HAh2OCzSXW2RBaknCXuTT1zd81QSZOr2E8Q3Bap15G2Ja1nIVkwv/Rp/Db++/V5EoW24NY D8QNqpEGKJPULjDa5sZCf3/gF6AldsnSsLrCiNSsdZJ6leGlZiv/kGipkCrRDMw/BPMx8X CUAG2d8VnYRkaeCvYBEwQ/7I3nENG+0= Message-ID: Date: Mon, 2 Oct 2023 12:19:29 +0300 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.15.1 Subject: Re: Show various offset arrays for heap WAL records Content-Language: en-US To: Melanie Plageman Cc: Peter Geoghegan , Andres Freund , pgsql-hackers@postgresql.org, Robert Haas , Peter Eisentraut References: <20230411002315.oyaicmcqrq2hb3ek@liskov> <9159daf7-f42d-781b-458f-1b2cf32cb256@iki.fi> From: Heikki Linnakangas In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On 04/09/2023 23:02, Melanie Plageman wrote: > I might phrase the last bit as "neither the description functions nor > the output format should be considered part of a stable API" > > +Guidelines for rmgrdesc output format > +===================================== > > I noticed you used === for both headings and wondered if it was > intentional. Other READMEs I looked at in src/backend/access tend to > have a single heading underlined with ==== and then subsequent > headings are underlined with -----. I could see an argument either way > here, but I just thought I would bring it up in case it was not a > conscious choice. > > Otherwise, LGTM. Made these changes and committed. Thank you! -- Heikki Linnakangas Neon (https://neon.tech)