pg.ddx.io pgsql-committers@postgresql.org mailing list archivehelp / color / mirror / Atom feed
pgsql: doc: Explain when to use the WAIT NO_THROW option 2+ messages / 1 participants [nested] [flat]
* pgsql: doc: Explain when to use the WAIT NO_THROW option @ 2026-09-17 06:36 Alexander Korotkov <akorotkov@postgresql.org> 0 siblings, 0 replies; 2+ messages in thread From: Alexander Korotkov @ 2026-09-17 06:36 UTC (permalink / raw) To: pgsql-committers@lists.postgresql.org doc: Explain when to use the WAIT NO_THROW option The description of NO_THROW covered what the option does but not when an application would want it. Explain that it suits callers that treat timeout or not in recovery as expected results to be handled as part of ordinary control flow, note the obligation to check the returned status, and give the reason to omit the option. Be precise about the option's scope: it changes only how those two wait outcomes are reported. Soften the description's claim that the command "returns a status string instead of throwing errors" accordingly, and say that invalid input still raises an error, as does any condition checked before the wait begins. Name two of those conditions as examples rather than listing them, since the set grows. Author: Rithvika Devisetti <devisettirithvika@gmail.com> Reported-by: Peter Eisentraut <peter@eisentraut.org> Reviewed-by: Kiran Kaki <itskkpg@gmail.com> Reviewed-by: Xuneng Zhou <xunengzhou@gmail.com> Reviewed-by: Satyanarayana Narlapuram <satyanarlapuram@gmail.com> Reviewed-by: Alexander Korotkov <aekorotkov@gmail.com> Discussion: https://postgr.es/m/14415b05-16d0-446f-ba7d-c891db8b3406%40eisentraut.org Backpatch-through: 19 Branch ------ master Details ------- https://git.postgresql.org/pg/commitdiff/e87c55f4d8b3fc3723e1f5d8ade7278e33bbb869 Modified Files -------------- doc/src/sgml/ref/wait.sgml | 37 +++++++++++++++++++++++++++++++++++-- 1 file changed, 35 insertions(+), 2 deletions(-) ^ permalink raw reply [nested|flat] 2+ messages in thread
* pgsql: doc: Explain when to use the WAIT NO_THROW option @ 2026-09-17 06:37 Alexander Korotkov <akorotkov@postgresql.org> 0 siblings, 0 replies; 2+ messages in thread From: Alexander Korotkov @ 2026-09-17 06:37 UTC (permalink / raw) To: pgsql-committers@lists.postgresql.org doc: Explain when to use the WAIT NO_THROW option The description of NO_THROW covered what the option does but not when an application would want it. Explain that it suits callers that treat timeout or not in recovery as expected results to be handled as part of ordinary control flow, note the obligation to check the returned status, and give the reason to omit the option. Be precise about the option's scope: it changes only how those two wait outcomes are reported. Soften the description's claim that the command "returns a status string instead of throwing errors" accordingly, and say that invalid input still raises an error, as does any condition checked before the wait begins. Name two of those conditions as examples rather than listing them, since the set grows. Author: Rithvika Devisetti <devisettirithvika@gmail.com> Reported-by: Peter Eisentraut <peter@eisentraut.org> Reviewed-by: Kiran Kaki <itskkpg@gmail.com> Reviewed-by: Xuneng Zhou <xunengzhou@gmail.com> Reviewed-by: Satyanarayana Narlapuram <satyanarlapuram@gmail.com> Reviewed-by: Alexander Korotkov <aekorotkov@gmail.com> Discussion: https://postgr.es/m/14415b05-16d0-446f-ba7d-c891db8b3406%40eisentraut.org Backpatch-through: 19 Branch ------ REL_19_STABLE Details ------- https://git.postgresql.org/pg/commitdiff/3f8b8ddea08a110e9f44af2b2e52312fca901eac Modified Files -------------- doc/src/sgml/ref/wait.sgml | 37 +++++++++++++++++++++++++++++++++++-- 1 file changed, 35 insertions(+), 2 deletions(-) ^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2026-09-17 06:37 UTC | newest] Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2026-09-17 06:36 pgsql: doc: Explain when to use the WAIT NO_THROW option Alexander Korotkov <akorotkov@postgresql.org> 2026-09-17 06:37 pgsql: doc: Explain when to use the WAIT NO_THROW option Alexander Korotkov <akorotkov@postgresql.org>
This inbox is served by DDX for PostgreSQL; see mirroring instructions for how to clone and mirror all data and code used for this inbox