From: Tom Lane Date: Mon, 15 Jun 2026 17:07:57 +0000 (-0400) Subject: Doc: reword discussion of asterisk after table names in FROM. X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8ebbf79a83e4fe87285243dde03b969b81f3439a;p=thirdparty%2Fpostgresql.git Doc: reword discussion of asterisk after table names in FROM. The syntax "tablename *" has been obsolete for years, but we want to retain it and its documentation for backward compatibility reasons. However, the documentation wording was confusing and could be understood to mean that "tablename *" is the same as "ONLY tablename". Reported-by: Jochen Bandhauer Author: Laurenz Albe Reviewed-by: Tom Lane Discussion: https://postgr.es/m/178125831604.1285960.8250607197280951685@wrigleys.postgresql.org --- diff --git a/doc/src/sgml/queries.sgml b/doc/src/sgml/queries.sgml index ec4ca01cd16..d8d4c3c53ef 100644 --- a/doc/src/sgml/queries.sgml +++ b/doc/src/sgml/queries.sgml @@ -143,11 +143,13 @@ FROM table_reference , table_r - Instead of writing ONLY before the table name, you can write - * after the table name to explicitly specify that descendant - tables are included. There is no real reason to use this syntax any more, - because searching descendant tables is now always the default behavior. - However, it is supported for compatibility with older releases. + You can write * after the table name to explicitly + specify that descendant tables are included, which is the opposite of + ONLY. There is no real reason to write + * any more, because searching descendant tables has + been the default behavior since PostgreSQL + version 10. However, it remains supported for compatibility with older + releases.