Re: DocBook 5.2
Yeah, I think we'd have to convert all the supported versions to make this palatable. If the conversion is sufficiently automated, that might not be a big lift. (If it's*not* automated, I think the change would never get off the ground even for HEAD, because the docs are too much of a moving target.) +1 The process is totally automated. There are general steps which work for every DocBook 4.x book. And there are Postgres-specific steps (doRealModifictions.sh) which looks for individual patterns per file. This is the critical part. Currently it's tested only with HEAD. My expectation is, that it should work also for translations to other languages because the patterns contain only elements and attributes, no text. But if they run against older versions it's likely that we need some changes or additional patterns. I'm willing to work on this if a) there is a consensus in the community that the work should go on and b) someone helps me to resolve the reported unacceptable runtime problem during PDF generation. -- J. Purtz
Minor documentation fixes
Hello everybody, My colleagues from the Postgres Pro documentation team and I noticed a few minor inconsistencies in recently updated sections of the PostgreSQL 15 documentation. The attached patch fixes them. Two contributor names in the Release Notes are changed to match the names of commit authors with those in the Acknowledgements list. -- Elena Indrupskaya Lead Technical Writer Postgres Professional http://www.postgrespro.comdiff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 2fe902eed2..53b178da95 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -6757,11 +6757,11 @@ local0.*/var/log/postgresql For example, if syncing the data directory takes 25 seconds and thereafter resetting unlogged relations takes 8 seconds, and if this setting has the default value of 10 seconds, then a messages will be logged for syncing the data directory after it has been in progress for 10 seconds and again after it has been in progress for 20 seconds, - but nothing will be logged for resetting unlogged operations. + but nothing will be logged for resetting unlogged relations. diff --git a/doc/src/sgml/release-15.sgml b/doc/src/sgml/release-15.sgml index 9b752e26f2..9cc6dc0d9e 100644 --- a/doc/src/sgml/release-15.sgml +++ b/doc/src/sgml/release-15.sgml @@ -1282,11 +1282,11 @@ Author: Fujii Masao Allow pg_stat_reset_single_table_counters() to reset the counters of relations shared across all databases -(B Sadhu, Prasad Patro) +(Sadhuprasad Patro) -Adjust subscriber server variables to match the publisher so +Adjust subscriber server variables to match the publisher so that datetime and float8 values are interpreted consistently (Japin Li) Some publishers might be relying on inconsistent behavior. @@ -1918,11 +1918,11 @@ Author: Robert Haas Allow CREATE DATABASE to set the database OID - (Shruthi KC, Antonin Houska) + (Shruthi Gowda, Antonin Houska)
Re: suggest about bpchar data type in the document
On Wed, 2022-09-14 at 18:48 +0200, Laurenz Albe wrote: > On Wed, 2022-09-14 at 17:41 +0800, yanliang lei wrote: > > I hope that： > > > > in the https://www.postgresql.org/docs/14/datatype-characterin.html ，It > > needs to be written clearly “bpchar” data type， > > > > and in the above url, Only mentioned “blank padded” ，If someone does not > > know this knowledge point > > （blank padded =bp），he/she will make a detour in the study of character > > datatype。 > > > > so，To make the document more friendly, I suggest that： in the > > https://www.postgresql.org/docs/14/datatype-characterin.htm > > It needs to be written clearly “bpchar” data type。 > > +1 > > I think that adding "bpchar(n)" in table 8.4 would be a good thing. Here is a patch for that. Yours, Laurenz Albe From f5cb97a9ff7f7d0df5f8fe8a8403b5298465784e Mon Sep 17 00:00:00 2001 From: Laurenz Albe Date: Wed, 28 Sep 2022 08:14:11 +0200 Subject: [PATCH] Document "bpchar" as character data type "bpchar" is our internal name for "character", but it should be documented as an alternative name to avoid confusion. Per request from Yanliang Lei. Discussion: https://postgr.es/m/120b3084.56b6.1833b5ffe4b.coremail.msdnch...@163.com --- doc/src/sgml/datatype.sgml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml index 0258b192e0..b844e379b9 100644 --- a/doc/src/sgml/datatype.sgml +++ b/doc/src/sgml/datatype.sgml @@ -1169,7 +1169,7 @@ SELECT '52093.89'::money::numeric::float8; variable-length with limit -character(n), char(n) +character(n), char(n), bpchar(n) fixed-length, blank padded -- 2.37.3
