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>
Cc: Erik Rijkers <er(at)xs4all(dot)nl>, "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-21 12:38:26
Message-ID: 67d7240f-8596-83fc-5e15-af06c128a0f5@purtz.de
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
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

Some additional changes in 51.2:

 - smaller number of different terms

 - aligning with Glossary

 - active voice instead of passive voice

 - commas

---

J. Purtz

Attachment Content-Type Size
arch-dev.sgml.20210121.diff text/x-patch 6.7 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tatsuo Ishii 2021-01-22 01:04:24 Need help on translating documentation
Previous Message Chaouki Dhib 2021-01-19 21:23:52 Re: the doc should mention one particular aspect of partial indexes

Browse pgsql-hackers by date

  From Date Subject
Next Message Yugo NAGATA 2021-01-21 12:49:23 Re: Is Recovery actually paused?
Previous Message Yugo NAGATA 2021-01-21 12:30:48 Re: Columns correlation and adaptive query optimization