Unclear Wording

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: pg(at)kirasoft(dot)com
Subject: Unclear Wording
Date: 2022-06-06 22:11:54
Message-ID: 165455351426.573551.7050474465030525109@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/14/plpgsql-errors-and-messages.html
Description:

Dear Sirs,
From the page on RAISE ...
I read this 3 times and tripped over "write a format", which should be use
(or specify) a format string ...

Current:
After level if any, you can write a format (which must be a simple string
literal, not an expression). The format string specifies the error message
text to be reported.

Suggested Rewrite:
After level if any, you can specify a format string (which must be a simple
string literal, not an expression). The format string specifies the error
message text to be reported.

PS: Thank you for some of the best documentation ever published!

The link, just in case:
https://www.postgresql.org/docs/14/plpgsql-errors-and-messages.html

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message ideriha.takeshi@fujitsu.com 2022-06-07 08:28:55 No documentation exists about ecpg ORACLE comptaible mode
Previous Message PG Doc comments form 2022-06-06 21:19:17 Section I - 2.9: Use SELECT to confirm set of rows before DELETE