public inbox for [email protected]
help / color / mirror / Atom feedFrom: Jürgen Purtz <[email protected]>
To: Heikki Linnakangas <[email protected]>
To: Erik Rijkers <[email protected]>
Cc: David G. Johnston <[email protected]>
Cc: PostgreSQL Hackers <[email protected]>
Cc: Justin Pryzby <[email protected]>
Subject: Re: Additional Chapter for Tutorial - arch-dev.sgml
Date: Tue, 19 Jan 2021 07:37:25 +0100
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
<[email protected]>
<CAKFQuwZ_USvnhZ5wQLFtpr8v+iMiwvZOiVZhviQwPYGDVR7w+g@mail.gmail.com>
<[email protected]>
<CAKFQuwbqiZ4Er_e21oXt8J_JDyNucLMcW7murkMr0v=pTy10RA@mail.gmail.com>
<CAKFQuwbtReW3dBO0HmZCb8rF4z-w+oFt24nPko8pbAk4Y2VWEw@mail.gmail.com>
<[email protected]>
<[email protected]>
<[email protected]>
<[email protected]>
<[email protected]>
<[email protected]>
<[email protected]>
<[email protected]>
<[email protected]>
<CAKFQuwaEp3HRgB=C3CfqLWsHqH3p_kmow+n+ERuaCRR=ozt0nw@mail.gmail.com>
<[email protected]>
<[email protected]>
<[email protected]>
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
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected], [email protected], [email protected], [email protected], [email protected]
Subject: Re: Additional Chapter for Tutorial - arch-dev.sgml
In-Reply-To: <[email protected]>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox