Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nylWv-0006Es-6I for pgsql-docs@arkaria.postgresql.org; Wed, 08 Jun 2022 02:34:45 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1nylWt-0001Yn-Gt for pgsql-docs@arkaria.postgresql.org; Wed, 08 Jun 2022 02:34:43 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nylWt-0001Vm-5N for pgsql-docs@lists.postgresql.org; Wed, 08 Jun 2022 02:34:43 +0000 Received: from mail-wm1-x333.google.com ([2a00:1450:4864:20::333]) by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1nylWq-0000c7-Dj for pgsql-docs@lists.postgresql.org; Wed, 08 Jun 2022 02:34:42 +0000 Received: by mail-wm1-x333.google.com with SMTP id o37-20020a05600c512500b0039c4ba4c64dso4637002wms.2 for ; Tue, 07 Jun 2022 19:34:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cybertec-at.20210112.gappssmtp.com; s=20210112; h=message-id:subject:from:to:date:in-reply-to:references:user-agent :mime-version:content-transfer-encoding; bh=x3lRrntEHlyxc/v29FEKge+nGDsq7fgmx3ZcH6abOUQ=; b=CTPgbn2OWSg17iqAo2T9SKxvhaqnzjssiYwUBQZ9ALktN9L44MdywvBKlofwvN7Q61 Ht3SkkyEfDZdTf+RyqysjI5Xeu7dqhbryOSI8nskyPvVu+33SbTBvE5IbsFiPjfFMVrI dSvQftTz9hzlSVAyxBTMVJafCpii1E+qS+3jzT4+Zc6RChP4jCI1NNgxFd0/BB398YQW OEnk57khvGzS8luAgTU0de2gXLLo7LQIP97ImJ7JYueHo/o8NvBF0SWN5Es2eWFT3ZDh qL+YUNNTVXVmEtOLQqM6Ki1sZVi1O8ygpfanEUmR5cP1ogjF1BAVRr9PD9WmF4QVfYip Ha3w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:message-id:subject:from:to:date:in-reply-to :references:user-agent:mime-version:content-transfer-encoding; bh=x3lRrntEHlyxc/v29FEKge+nGDsq7fgmx3ZcH6abOUQ=; b=peRv4ir4oJK/CuNuyo9k4P3I3nZyVwJbLt8L/K+jnaulTxxXrbfRrgQq89hZRAVWWu m+hCtWPvWRoLYJPMlz3tosnLLOGPB6kX9/V3Oqy7PzuRLhStaizfatZXmzQjzO5lyDHR 2hA96EafMR39pMNBNwwTt471HwECY7wsStUhTTvvdoI6W2lfexWi64SQJuC4p0gvX4Qp 6VTqmC5zExoQBNVI0f42WCMoJu40UMlhAhasUd498ZSuVVuA6N08Bu6tgxH2Rw+qiJNl Jjzjg4dTGcMjRTxO/YUG8N5CHxCfF82zKIElzmsVih+clxJahPCiIBvwaDLo5mQezWGG xlHw== X-Gm-Message-State: AOAM533Y90JhU4+864F2ifmCIyfqUV866E+QhOfG4/kxEKL1HrMSROKZ cSvUmoRdzSyrUci6dLOe7lSGVw== X-Google-Smtp-Source: ABdhPJwYMOUqydKC3i46B/24bRugt3QD5aYKJ4XA4Hawmez15+jL4vmYZadZY2EW4wm+CZMy9IvUzg== X-Received: by 2002:a1c:7416:0:b0:39c:5a0a:3884 with SMTP id p22-20020a1c7416000000b0039c5a0a3884mr6814595wmc.179.1654655678682; Tue, 07 Jun 2022 19:34:38 -0700 (PDT) Received: from localhost.localdomain (178-190-182-230.adsl.highway.telekom.at. [178.190.182.230]) by smtp.gmail.com with ESMTPSA id w6-20020a7bc746000000b0039c5224bfcbsm6800009wmk.46.2022.06.07.19.34.38 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 07 Jun 2022 19:34:38 -0700 (PDT) Message-ID: <3f27cc04de0b6d1d8df0a22a2811dd99b823d1e9.camel@cybertec.at> Subject: Re: Unclear Wording From: Laurenz Albe To: Bruce Momjian , pg@kirasoft.com, pgsql-docs@lists.postgresql.org Date: Wed, 08 Jun 2022 04:34:37 +0200 In-Reply-To: References: <165455351426.573551.7050474465030525109@wrigleys.postgresql.org> Content-Type: text/plain; charset="UTF-8" User-Agent: Evolution 3.42.4 (3.42.4-2.fc35) MIME-Version: 1.0 Content-Transfer-Encoding: 8bit List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On Tue, 2022-06-07 at 20:15 -0400, Bruce Momjian wrote: > > 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. > > Good idea, patch attached. +1 Yours, Laurenz Albe