Documentation improvement patch

2025-09-10 Thread Oleg

Dear all,

I have prepared a patch containing some minor inconsistencies in the 
documentation. Please, take a look.


I will be looking forward to your feedback.

The patch shall be applied to the REL_18_STABLE branch.

--
Regards,
Oleg Sibiryakov
Technical Writer
Postgres Professional, The Russian Postgres Company
https://postgrespro.ru
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index d1e103ed779..e589a8d6884 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -1234,7 +1234,7 @@ include_dir 'conf.d'
   
   

-The library/libraries to use for validating OAuth connection tokens. If
+Sets the library/libraries to use for validating OAuth connection tokens. If
 only one validator library is provided, it will be used by default for
 any OAuth connections; otherwise, all
 oauth HBA entries
@@ -1400,7 +1400,7 @@ include_dir 'conf.d'

 Specifies a list of cipher suites that are allowed by connections using
 TLS version 1.3.  Multiple cipher suites can be
-specified by using a colon separated list. If left blank, the default
+specified by using a colon-separated list. If left blank, the default
 set of cipher suites in OpenSSL will be used.

 
@@ -2432,7 +2432,7 @@ include_dir 'conf.d'
   
   

-Sets the maximum number of open files each server subprocess is
+Sets the maximum number of files each server subprocess is
 allowed to open simultaneously;  files already opened in the
 postmaster are not counted toward this limit. The default is one
 thousand files.
diff --git a/doc/src/sgml/postgres-fdw.sgml b/doc/src/sgml/postgres-fdw.sgml
index 781a01067f7..9b032fbf675 100644
--- a/doc/src/sgml/postgres-fdw.sgml
+++ b/doc/src/sgml/postgres-fdw.sgml
@@ -1226,7 +1226,7 @@ postgres=# SELECT postgres_fdw_disconnect_all();
 PostgresFdwCleanupResult
 
  
-  Waiting for transaction abort on remote server.
+  Waiting for transaction abort on a remote server.
  
 

diff --git a/doc/src/sgml/postgres.sgml b/doc/src/sgml/postgres.sgml
index af476c82fcc..2101442c90f 100644
--- a/doc/src/sgml/postgres.sgml
+++ b/doc/src/sgml/postgres.sgml
@@ -49,7 +49,7 @@ break is not needed in a wider output rendering.

 

-After you have successfully completed this tutorial you will want to
+After you have successfully completed this tutorial, you will want to
 read the  section to gain a better understanding
 of the SQL language, or  for
 information about developing applications with
diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml
index d336ee38f58..80eadfc0e1a 100644
--- a/doc/src/sgml/protocol.sgml
+++ b/doc/src/sgml/protocol.sgml
@@ -1636,7 +1636,7 @@ SELCT 1/0;

  Likewise the server expects the client to not begin
  the SSL negotiation until it receives the server's
- single byte response to the SSL request.  If the
+ single-byte response to the SSL request.  If the
  client begins the SSL negotiation immediately without
  waiting for the server response to be received it can reduce connection
  latency by one round-trip.  However this comes at the cost of not being
@@ -2394,7 +2394,7 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;"
  
  
   
-   Change the definition of a replication slot.
+   Changes the definition of a replication slot.
See  for more about
replication slots. This command is currently only supported for logical
replication slots.
diff --git a/doc/src/sgml/ref/pg_recvlogical.sgml b/doc/src/sgml/ref/pg_recvlogical.sgml
index 263ebdeeab4..2a0de0cfb63 100644
--- a/doc/src/sgml/ref/pg_recvlogical.sgml
+++ b/doc/src/sgml/ref/pg_recvlogical.sgml
@@ -84,7 +84,7 @@ PostgreSQL documentation

 

-The --slot and --dbname are required
+The --slot and --dbname options are required
 for this action.

 
@@ -104,7 +104,7 @@ PostgreSQL documentation

 

-The --slot is required for this action.
+The --slot option is required for this action.

   
  
@@ -121,8 +121,8 @@ PostgreSQL documentation

 

-The --slot and --dbname,
---file are required for this action.
+The --slot, --dbname, and
+--file options are required for this action.

 

diff --git a/doc/src/sgml/ref/pgbench.sgml b/doc/src/sgml/ref/pgbench.sgml
index ab252d9fc74..e2b2a0ea26f 100644
--- a/doc/src/sgml/ref/pgbench.sgml
+++ b/doc/src/sgml/ref/pgbench.sgml
@@ -2826,7 +2826,7 @@ statement latencies in milliseconds, failures and retries:
  start a connection to the database server / the socket for connecting
  the client to the database server has become invalid). In such cases
  all clients of this thread stop while

Re: Adding clarification on extension_control_path when extension is present in multiple folders

2025-09-10 Thread Matheus Alcantara
On Fri Sep 5, 2025 at 10:53 AM -03, Pierrick wrote:
> When playing with the new GUC extension_control_path, I found that the 
> paths are evaluated one by one
> (like search_path)and if an extension is present in multiple paths, only 
> the on in the first path
> will be considered.I think this is totally fine, but I'd like to adda 
> documentation patch to explain
> this (attached file).
>
> What do you think ?
>

Hi, thanks for working on this!

Just to mention that I have this on my plate, I'm just waiting for a
conclusion on discussion at [1] so that I can make a proper review here.

Thanks!

[1] 
https://www.postgresql.org/message-id/[email protected]

--
Matheus Alcantara