Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1xRmxP-00000001JmF-1gKE for pgsql-docs@arkaria.postgresql.org; Fri, 13 Nov 2026 08:48:27 +0000 Received: from localhost ([127.0.0.1]:51564 helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.98.2) (envelope-from ) id 1xRmxN-00000009G9D-0HL9 for pgsql-docs@arkaria.postgresql.org; Fri, 13 Nov 2026 08:48:25 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]:43784) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1xRmtq-00000009CVc-15vk for pgsql-docs@lists.postgresql.org; Fri, 13 Nov 2026 08:44:46 +0000 Received: from mail-wm1-x335.google.com ([2a00:1450:4864:20::335]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.98.2) (envelope-from ) id 1xRmto-00000000p9T-0eq3 for pgsql-docs@lists.postgresql.org; Fri, 13 Nov 2026 08:44:45 +0000 Received: by mail-wm1-x335.google.com with SMTP id 5b1f17b1804b1-4bb5b8ef642so486685e9.1 for ; Fri, 13 Nov 2026 00:44:43 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cybertec.at; s=google; t=1794559482; x=1795164282; darn=lists.postgresql.org; h=mime-version:user-agent:content-transfer-encoding:content-type :references:in-reply-to:date:cc:to:from:subject:message-id:from:to :cc:subject:date:message-id:reply-to:content-type; bh=sUoA8+jach0iib2ZT5Q8Aw/nhfMTe5Zdkuv9RLvhTKg=; b=kNhWBXjW5/tsg0+cPWIxP0x8cmXZ2marpmHbsXh97yxJZAA6l/oZj8eWd7In5RO/gj DZbGabze0QnFv/vvr4X1w0ZbO+iVWf7Az7PqtrvhoBGUNmoBVm6K+xWlds9UVwV8zGHV Vmyg/fJ1jLD0ZgfIjH4YdWB9cXq/ih83KhJQftRCi0swAf0nKr5TcM0R8Vo1PaBYphl5 Y/yv+lg1rHmauigMp42/RJD4wR+J2B9QTF3SiS5wcXav3esxdCBWWIkGAnJ21pVyG8su Y7pDoAc/HmpFi+99VnaJ7IKn8+2CleHL1KBDLk9JJtIFQfO+hqsx216sth7VlG7YAAF9 w/Fw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1794559482; x=1795164282; h=mime-version:user-agent:content-transfer-encoding:content-type :references:in-reply-to:date:cc:to:from:subject:message-id:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to :content-type; bh=sUoA8+jach0iib2ZT5Q8Aw/nhfMTe5Zdkuv9RLvhTKg=; b=jPQJ8mNXTNkCodnh/8ZwvyeG2fYlCtQ8WHQJ88H66JBKElfwsnGrnefcwx0q3TOZ+G Qq5WHGXG/aMYD8PwX42jKH/mNuWIA6mwRNDJYnL7Ltv9WBWtseXpLaLNsucEitxR8Bkd Bo2sJVnLBMa0jlJ1BNi0ma1tQMOhmUsEiKQKV8btm9ZDfkWCql7lFjMSz2g7lSDDRgMK L5iBVgf66iuuoYxEx8MKJmu7MOLsdq5vloQyE9uzprcedzNqxM99aUufPWurwLxa0iIy C6P7uCeL58w3PGFSk0JawN5DiB6kXAyU+gvhJSY2nrXWKMT0oAdxw1nwrlX/hQUNZbH0 l5MA== X-Forwarded-Encrypted: i=1; AL+hErHWz09fXpVyZ1Od25BR4VOnE8e5R3P81Z6pHXRE1nWehoEphRSOz+PA4G6HMDisTfjYBuINwvaAYtTq@lists.postgresql.org X-Gm-Message-State: APuU4Z/MKcCnKn8AZSQdj9mmj+ZiHZVQmdJed8lPa+PTDfOQgAvKjjKx ZUxPxfbKtafHsXSOVdX1R11quVkOMCWG90XoKscSnGDb6eGLJi7+gjl7eFYSFu/amw0= X-Gm-Gg: AYBFou0W96bbFcHLPy7DDq/9d6VJXzsll4/zDbAd6Yq3hworFWSwoetH5rkZwZOrp6W sbDkO8eGqyfKD4HGjv+crZXLuo75DSoK2Wg73sgqyDtHZGApIKKaOflHQ06h/O0tCCjvYObSA7z JAbNMn814j4w+fRgR8uGDtD7jbMvXFTxmlsyGrHEqu//jVeWywwbuJde49+AODsJa/OK9pEgMOc OXG4ZPRPjFGUlYBsRfjfVuBCfMqpVzOBkaXl5jrzyhXIStcil0PrDGr0eUJD3kOXwyb+9K0wLvn UnBEqlk+C0nKorBF1Mq/Cc8bepjAJQCy8V7Q5c7w9V+TKC6r8a9evGGIme0I6E/G8BAoNT+HvGD BLaeo1dlFYeg4B4eSuALDX02Ep8F+FfVctCA8alToe02Dx9qXCUiwbuCc4jlF6mnbZuvwM4UFl5 Oo25V0SCsH+lVxSQxA6EVSUSHrnZPPQStPl132vAfa8lSZDNVYqoL3Gj5hEE6eb6zggfVtF61Oe 24aoUbAwCMWmYvB/Ydmw/ZHNCpZSFOrMNJQ4dV0urx39igJlOP6lVWBqVkTrAgh4U5JaFfnziiP am0FlMyYg7ZX2fREmnql5adKJJs/U0c5/GTi5RvCCv1z6FkWhlAoQ41yfNSeZj3bDWdPKA02FPX kplN+zA== X-Received: by 2002:a05:600c:c84:b0:4a1:e57b:667c with SMTP id 5b1f17b1804b1-4bb55a68429mr36325275e9.26.1794559482466; Fri, 13 Nov 2026 00:44:42 -0800 (PST) Received: from laurenz.albe-K4N0CV00F97414D ([2001:871:70:1f4b:393a:19b9:8800:7f0f]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4bb4e252f7fsm144845665e9.2.2026.11.13.00.44.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 13 Nov 2026 00:44:41 -0800 (PST) Message-ID: <5e00a5cf39cb30b7482cd478b23be0a83444f0e9.camel@cybertec.at> Subject: Re: Good beginner doc-hacking task: clear-text vs. cleartext vs. clear text vs. plaintext etc.. From: Laurenz Albe To: Karen Jex , Daniel Gustafsson Cc: Peter Eisentraut , "David E. Wheeler" , "pgsql-docs@lists.postgresql.org" , xavier_fischer@hotmail.fr Date: Fri, 13 Nov 2026 09:44:40 +0100 In-Reply-To: References: <0979E710-8C50-4051-87BD-6DE9ABF58938@justatheory.com> <72a2c1fe-5782-463a-a216-7d77eceeac4d@eisentraut.org> Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable User-Agent: Evolution 3.60.2 (3.60.2-3.fc44) MIME-Version: 1.0 List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On Thu, 2026-11-12 at 17:37 +0100, Karen Jex wrote: > >=20 > > I've created a V2 patch (attached) including the glossary terms, and > > with a verbose commit message as suggested by Laurenz. >=20 > Apologies, I managed to introduce a couple of typos into my commit > message. V3 patch attached with a correction. The patch looks good to me. One sentence in the commit message struck me as weird: > Use cleartext instead of plaintext because; it is consistent [...] I guess that you intend the semicolon as starting an enumeration, but this is a usage I have never seen before. However, the committer will adapt the commit message anyway, so (from my point of view) there is no need for another version. Yours, Laurenz Albe