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

From: Jürgen Purtz <juergen(at)purtz(dot)de>
To: Heikki Linnakangas <hlinnaka(at)iki(dot)fi>, Erik Rijkers <er(at)xs4all(dot)nl>
Cc: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>, Justin Pryzby <pryzby(at)telsasoft(dot)com>
Subject: Re: Additional Chapter for Tutorial - arch-dev.sgml
Date: 2021-01-19 06:37:25
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs pgsql-hackers

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

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

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2021-01-19 10:16:58 Windows Powershell
Previous Message Tom Lane 2021-01-18 20:39:02 Re: the doc should mention one particular aspect of partial indexes

Browse pgsql-hackers by date

  From Date Subject
Next Message Dilip Kumar 2021-01-19 06:42:14 Re: Is Recovery actually paused?
Previous Message 2021-01-19 06:32:56 RE: Global snapshots