Minor documentation fixes

2022-09-27 Thread Elena Indrupskaya

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: DocBook 5.2

2022-09-27 Thread Jürgen Purtz

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