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 have made 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
