PostgreSQL 15 minor fixes in protocol.sgml
От
Ekaterina Kiryanova
Тема
PostgreSQL 15 minor fixes in protocol.sgml
Дата
Msg-id
745414e7-efb2-a6ae-5b83-fcbdf35aabc8@postgrespro.ru
Ответ на
Typo in "43.9.1. Reporting Errors and Messages"? (PG Doc comments form)
Список
Дерево обсуждения
Typo in "43.9.1. Reporting Errors and Messages"? PG Doc comments form <noreply@postgresql.org>
PostgreSQL 15 minor fixes in protocol.sgml Ekaterina Kiryanova <e.kiryanova@postgrespro.ru>
Re: PostgreSQL 15 minor fixes in protocol.sgml Michael Paquier <michael@paquier.xyz>
Re: Typo in "43.9.1. Reporting Errors and Messages"? "Euler Taveira" <euler@eulerto.com>
Re: Typo in "43.9.1. Reporting Errors and Messages"? Bruce Momjian <bruce@momjian.us>
Re: Typo in "43.9.1. Reporting Errors and Messages"? Alexander Lakhin <exclusion@gmail.com>
Re: Typo in "43.9.1. Reporting Errors and Messages"? Michael Paquier <michael@paquier.xyz>
Re: Typo in "43.9.1. Reporting Errors and Messages"? Michael Paquier <michael@paquier.xyz>
Hello! I've come across some typos in protocol.sgml for PostgreSQL 15 so please have a look at the attached patch. I didn't include it in the patch but I also suggest removing single quotes around 'method' for the COMPRESSION option to help avoid confusion. (All the supported compression methods consist of a single word so in my opinion there is no need to use quotes in this case.) -- COMPRESSION 'method' I've also noticed that there are two ways to describe an option: "If set to true" / "If true". As far as I know, the option here is specified by its name rather than being explicitly set to true so "if true" seems to be more correct, and this could be a slight improvement for this page. Please correct me if I'm wrong. Another point worth mentioning is that only this file contains the phrase "two-phase transaction". I believe that "two-phase commit transaction" or "transaction prepared for two-phase commit" depending on the situation would be better wording. And finally, could you please clarify this part? -- The end LSN of the prepare transaction. Is it a typo of "prepared transaction"? Or is it the LSN of the transaction for Prepare? If it's the latter, perhaps it'd make more sense to capitalize it. -- Best regards, Ekaterina Kiryanova Technical Writer Postgres Professional the Russian PostgreSQL Company
В списке pgsql-docs по дате отправления