Feedback-ID: i131946ab:Fastmail
Message-ID: <9fde5de1-8560-361b-2107-82d617aa2c99@enterprisedb.com>
Date: Tue, 1 Nov 2022 11:39:40 +0100
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0)
 Gecko/20100101 Thunderbird/102.3.1
Subject: Re: real/float example for testlibpq3
Content-Language: en-US
To: Mark Wong <markwkm@gmail.com>, Tom Lane <tgl@sss.pgh.pa.us>
Cc: Robert Haas <robertmhaas@gmail.com>, Greg Stark <stark@mit.edu>,
 Chapman Flack <chap@anastigmatix.net>,
 Ashutosh Bapat <ashutosh.bapat.oss@gmail.com>,
 PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
References: <Yhf70G9OYIKueYZi@workstation-mark-wong>
 <CAExHW5tm1FyoLZXdTjdrfRO7ObuoL_p2krc65C5s8D3eWFB50g@mail.gmail.com>
 <2511609.1646061540@sss.pgh.pa.us> <621D4CF3.6090808@anastigmatix.net>
 <2746817.1646088530@sss.pgh.pa.us>
 <CAM-w4HM2t7TonV7bz+V27Vvoo0j6hN9-omDo9SHmQ7O58UFYQg@mail.gmail.com>
 <YqjH9qGaIixfZXQo@workstation-mark-wong>
 <CA+TgmobLR929aHtOfC=JKqz+qzDxdYo_dssj06TyOpnU+HbT6A@mail.gmail.com>
 <967228.1655408510@sss.pgh.pa.us> <Yr8sXL9J/nel7BEM@workstation-mark-wong>
From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
In-Reply-To: <Yr8sXL9J/nel7BEM@workstation-mark-wong>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Archived-At: 
 <https://www.postgresql.org/message-id/9fde5de1-8560-361b-2107-82d617aa2c99%40enterprisedb.com>
Precedence: bulk

On 01.07.22 19:18, Mark Wong wrote:
> Just wanted to do another quick check in before I go too far.  How do
> does this start look?  Extending the libpq section with a code snippet
> and description per data type?

If we want to start documenting the binary format for all data types, it 
should go into the "Data Types" chapter.  There, we already document the 
text format in great detail, so putting the binary format in there as 
well would make sense.

The libpq chapter could then contain some examples of applying that 
information in the context of libpq.  But the libpq documentation 
shouldn't be the primary place where the formats are documented.