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

Jürgen Purtz <juergen@purtz.de>

From: Jürgen Purtz <juergen@purtz.de>
To: Heikki Linnakangas <hlinnaka@iki.fi>
Cc: Erik Rijkers <er@xs4all.nl>, "David G. Johnston" <david.g.johnston@gmail.com>, PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>, Justin Pryzby <pryzby@telsasoft.com>
Date: 2021-01-21T12:38:26Z
Lists: pgsql-hackers, pgsql-docs

Attachments

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


Commits

  1. Align some terms in arch-dev.sgml to glossary

  2. doc: Copy-edit the "Overview of PostgreSQL Internals" chapter

  3. Merge postmaster and postgres command into just postgres. postmaster