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 1xR62b-00000000g4Z-03Jt for pgsql-docs@arkaria.postgresql.org; Wed, 11 Nov 2026 10:58:57 +0000 Received: from localhost ([127.0.0.1]:54326 helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.98.2) (envelope-from ) id 1xR62Z-0000000AKM1-2PR1 for pgsql-docs@arkaria.postgresql.org; Wed, 11 Nov 2026 10:58:55 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]:55284) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1xR62Z-0000000AKLt-1SPx for pgsql-docs@lists.postgresql.org; Wed, 11 Nov 2026 10:58:55 +0000 Received: from fhigh-a6-smtp.messagingengine.com ([103.168.172.157]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1xR62V-00000000RnA-2yrJ for pgsql-docs@lists.postgresql.org; Wed, 11 Nov 2026 10:58:55 +0000 Received: from phl-compute-06.internal (phl-compute-06.internal [10.202.2.46]) by mailfhigh.phl.internal (Postfix) with ESMTP id 85F9B1400166 for ; Wed, 11 Nov 2026 05:58:50 -0500 (EST) Received: from phl-frontend-04 ([10.202.2.163]) by phl-compute-06.internal (MEProxy); Wed, 11 Nov 2026 05:58:50 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eisentraut.org; h=cc:cc:content-transfer-encoding:content-type:content-type :date:date:from:from:in-reply-to:in-reply-to:message-id :mime-version:references:reply-to:subject:subject:to:to; s=fm2; t=1794394730; x=1794481130; bh=rdDtkpc4TXjKVRbR5M288ZhTCnC891Si CN0s3qcOczA=; b=wIVfqMF1xJ5ttq4E2BEmStUQOWCceBnTx699OQVZ0cB9NWPV ie0I79/IfKHk54I9/QK8yTnq2fyEVCPjG7NlkXnZg5L0qJ7T2gx36dEv4aZ/6/3L sazk9tT0oKCBSyYfhGb9I+Pa6TdIpk/7ISCsWzFrKGS1ZRlyuhwRr3S7sGfNF6b+ favz9UareF1+4JareytQDhEi+99aB952xnW83wqvxyh84aFulnGWlzYspY2IbbDM tgBuDePTbUmvMxHGSX0yhagfMWKNSKMtx7GjL8GVutTk7eCPLyPtkfUppLZLnvfr vYH4O1FvCfeNzezjf/CD9rq3YsI2vCNrI5h0wg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1794394730; x= 1794481130; bh=rdDtkpc4TXjKVRbR5M288ZhTCnC891SiCN0s3qcOczA=; b=E qsPb8eLmCrcvUZnno4FDNGrBAoQSxkEIuj3L7cyl4sMbkT2HUUnMAZ2VAvs1h89P 2jcP6UOZFM/YaISPUSCu/TxKwBWK00drJe/ng59HanazRPFEzN3usNUTYt/IxSLJ pfgapGbAorUk460RhOdTnU/ya6AUEbRAlT7p1IoLHVCBW4Eg5yqz67qF1heC1vtU Zy5oDI4yNdeDcchnPLe4uguNDxJbDcROA5K5/ParAIMjavmZxaa8EtSq63m30kfv Q3iVNM0uLtVaBicVhdITarr2KYDp3hr9tUA1I6EPYoUir2b1vRSJuP2k0XZYltad lVo2eDCtgr+JcGfXHgidg== X-DKIM2-Info: draft=ietf-dkim-dkim2-spec-09; repo=github.com/dkim2wg/interop; date=2026-11-03; sw=lmtpprox; action=sign d=eisentraut.org a=rsa-sha256; DKIM2-Signature: i=1; m=1; t=1794394730; d=eisentraut.org; mf=PHBldGVyQGVpc2VudHJhdXQub3JnPg==; rt=PHBnc3FsLWRvY3NAbGlzdHMucG9zdGdyZXNxbC5vcmc+; s=fm2:rsa-sha256:T0lH/e4u4wouJZ0lePVRNGroZh5Jf7LhY/rBrTaEUnnkqnm DftTAfthz9ITvY2nFF6MWxG6HUodLEq1ctnULZfBUORjl2GvJWjXJJpY6fGM1dUO X87Jq1mrR/5DjMXVnoftJIFSQ3WrLI+tRLmrFRNUVgR57OdYLkZsbGECouBgIpux 94tVjYeWLyAc8yMTZ3yi7qOQm7l2LJXNndrgYmaLSSO4Pj+ykLd/6OSGQml4If6w 4oF9qLxwpqL7ROSV9q+SjS4Nl1WkOwUSKL3pwCKqt72YG2zsfFpZx3JbQfYX0jZF eh8ZPTO4DpSZ9Ui3OMhXFa8Ifg92M8VCZ1pO35A==; X-DKIM2-Info: draft=ietf-dkim-dkim2-spec-09; repo=github.com/dkim2wg/interop; date=2026-11-03; sw=lmtpprox; action=mi-m=1; hc=14; hn=cc,content-language,content-transfer-encoding,content-type, date,feedback-id,from,in-reply-to,message-id,mime-version, references,subject,to,user-agent; Message-Instance: m=1; h=sha256:WWAFiTVQxSWRlxj22FYxbLe8xaZiizJ9CPNYNP7+x80=:cKiBPorDpiWionrhuni92ibRCzMriEjLxo0ayYYdh0A=; X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: dmFkZTGXh5yRghrsmAUQeU+ipw9bRKAFnPDEvYPOF9OmRPFqnYAVa9SCisEHphV35LMEiD hPU+kOu/dDTJaLbXmhhprrf6C5srypMfD5kXLYWK3xhSEM/ljrbRUSBcO+lM0ZopF3bTpk IwaVp3+Y8p29eOP0Jyr9XGC8R3CDrE3NCDUaduGCY4wdLux2/DWgAC0UOEBuRYl21Mx4oG ilXSsAEGhjyKpP3i1Qlvzy2brOa4bZFNO7TuiExbO1ritCdkHaVMn2XoiD9pxCyVe578Ti 7pqL1AFlN8sLXSq2VxWu9nMuQ8ZLZzGWx0s/8tMmp9C6oVNcZzFbSa+F5wjCdjUr0G6QY6 A/ggnwENNAtTNtRRllTEd3TYc2/EinPdJprTi81/cXoS6xszMfVInAuTQ/perp0cgMXVYt 7x+TYwkm4VxgS0hteQ1vfyanG9GkBE4D9/RmAfshKvogRFecXcx6GypDI+8N5ccJuuJcRK U+JVIpXjq8nn3FHvsOtFWq+GuYq12mO+Wk4Lb6wgYjWlzBccCID9yop+O0SiXkqrhlZsPk zlwvgfcdsvCD0NuLZWrpHpxb+clLFqNdBbAA2VZp7eO3Ck4TtRjwOETYe5glKttR3nK1hM 5LMp/UHZY+IfFgPC8Md+HL/btnSb6Tna+/31dfjzXembzYROTybyC4iO9wpQ X-ME-Proxy: Feedback-ID: ie0a040ee:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed, 11 Nov 2026 05:58:49 -0500 (EST) Message-ID: <72a2c1fe-5782-463a-a216-7d77eceeac4d@eisentraut.org> Date: Wed, 11 Nov 2026 11:58:48 +0100 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: Good beginner doc-hacking task: clear-text vs. cleartext vs. clear text vs. plaintext etc.. To: "David E. Wheeler" , Karen Jex Cc: Daniel Gustafsson , "pgsql-docs@lists.postgresql.org" References: <0979E710-8C50-4051-87BD-6DE9ABF58938@justatheory.com> Content-Language: en-US From: Peter Eisentraut In-Reply-To: <0979E710-8C50-4051-87BD-6DE9ABF58938@justatheory.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On 06.11.26 15:49, David E. Wheeler wrote: > On Nov 6, 2026, at 09:44, Karen Jex wrote: > >> I would love to take this on - thank you for flagging it as a potential first doc-hacking task. > > > Yay! > >> Just to confirm my understanding: >> 1. We should use "cleartext" and "plaintext" throughout, not "clear-text", "clear text", "plain text" or "plain-text". >> 2. There is at least one case where "plaintext" is used incorrectly in place of "cleartext”. > > I thought these were synonyms, in contrast to “ciphertext”. Should we not pick one to replace all of the others? Searching around a bit, it seems like “ciphertext” and “plaintext” are most often contrasting terms, e.g., https://en.wikipedia.org/wiki/Ciphertext. My understanding is/was that plaintext is data meant for encryption, after which it becomes ciphertext. Cleartext is data not meant for encryption. So you would use plaintext and ciphertext when describing the steps of an encryption method. And you would use cleartext when describing what goes over the wire when you do do LDAP authentication in PostgreSQL. But it seems like these terms are not actually universally used that way. If we tidy this up, consider adding glossary entries.