Re: Additional Chapter for Tutorial - arch-dev.sgml

On 18.01.21 15:13, Heikki Linnakangas wrote:
> On 20/11/2020 23:52, Erik Rijkers wrote:
>> (smallish) Changes to arch-dev.sgml
>
> This looks good to me. One little complaint:
>
>> @@ -125,7 +122,7 @@
>>      use a <firstterm>supervisor process</firstterm> (also
>>      <firstterm>master process</firstterm>) that spawns a new
>>      server process every time a connection is requested. This 
>> supervisor
>> -    process is called <literal>postgres</literal> and listens at a
>> +    process is called <literal>postgres</literal> (formerly 
>> 'postmaster') and listens at a
>>      specified TCP/IP port for incoming connections. Whenever a request
>>      for a connection is detected the <literal>postgres</literal>
>>      process spawns a new server process. The server tasks
>
> I believe we still call it the postmaster process. We renamed the 
> binary a long time ago (commit 5266f221a2), and the above text was 
> changed as part of that commit. I think that was a mistake, and this 
> should say simply:
>
> ... This supervisor process is called <literal>postmaster</literal> 
> and ...
>
> like it did before we renamed the binary.
>
> Barring objections, I'll commit this with that change (as attached).
>
> - Heikki

I fear that the patch 'Additional chapter for Tutorial' grows beyond 
manageable limits. It runs since nearly one year, the size of 228 KB is 
very huge, many people havemade significant contributions. But a commit 
seems to be in far distance. Having said that, I'm pleased with Heikki's 
proposal to split changes in the existing file 'arch-dev.sgml' from the 
rest of the patch and commit them separately.

But I have some concerns with the chapter '51.2. How Connections Are 
Established'. It uses central terms like 'client process', 'server 
process','supervisor process', 'master process', 'server tasks', 
'backend (server)', 'frontend (client)', 'server', 'client'. Some month 
ago, we have cleared his terminology in the new chapter 'glossary'. As 
long as it leads to readable text, we shall use the glossary-terms 
instead of the current ones. And we shall include some links to the 
glossary.

I propose to start a new thread which contains only changes to 
'arch-dev.sgml'. In pgsql-hackers or in pgsql-docs list? Initialized by 
Heikki or by me?

--

Jürgen Purtz