Re: startup message -> StartupMessage - Mailing list pgsql-docs

From Dmitry Igrishin
Subject Re: startup message -> StartupMessage
Date
Msg-id CAAfz9KPUpbUszTyjBWsoFpu=9Wcm=7TxZGrNzaHbkJfdY3KfSg@mail.gmail.com
Whole thread Raw
In response to Re: startup message -> StartupMessage  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
2016-06-23 16:38 GMT+03:00 Tom Lane <tgl@sss.pgh.pa.us>:
> Bruce Momjian <bruce@momjian.us> writes:
>> On Thu, Jun 23, 2016 at 07:47:10AM +0300, Dmitry Igrishin wrote:
>>> Yes, but see the next sentence: "This message includes the names of
>>> the user and of the database the user wants to connect to; it also
>>> identifies the particular protocol version to be used." So, it's about
>>> the StartupMessage exactly.
>
>> OK, how is this attached doc patch?
>
> I do not think these are improvements.  This is introductory text,
> not some kind of formal-language specification.
I can agree with this asserting when the text points to some abstract
message, like "The server then sends an appropriate authentication
request message" (because there are several kinds of authentication
messages). But for the concrete messages, there are consistency like
"The frontend must now send a PasswordMessage containing the
password", or "in the normal case the backend will send some
ParameterStatus messages", except the "During this phase the backend
will attempt to apply any additional run-time parameter settings that
were given in the startup message."

--
// Dmitry.


pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: DROP EXTENSION
Next
From: Justin Dearing
Date:
Subject: Some doc suggestions