Re: Good beginner doc-hacking task: clear-text vs. cleartext vs. clear text vs. plaintext etc..

From: Peter Smith <smithpb2250(at)gmail(dot)com>
To: Karen Jex <karenhjex(at)gmail(dot)com>
Cc: Daniel Gustafsson <daniel(at)yesql(dot)se>, Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>, Peter Eisentraut <peter(at)eisentraut(dot)org>, "David E(dot) Wheeler" <david(at)justatheory(dot)com>, "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org>, xavier_fischer(at)hotmail(dot)fr
Subject: Re: Good beginner doc-hacking task: clear-text vs. cleartext vs. clear text vs. plaintext etc..
Date: 2026-11-17 20:34:17
Message-ID: CAHut+PucaGPt0x27e5jWaLzDoJdi6E7rwQYAGJ9yjNn8wUDncw@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tue, Nov 17, 2026 at 7:52 PM Karen Jex <karenhjex(at)gmail(dot)com> wrote:
>
> Le lun. 16 nov. 2026 à 10:22, Daniel Gustafsson <daniel(at)yesql(dot)se> a écrit :
> >
> > > On 13 Nov 2026, at 10:14, Karen Jex <karenhjex(at)gmail(dot)com> wrote:
> >
> > > Commitfest entry: https://commitfest.postgresql.org/patch/7630/
> >
> > Thanks for the new version, I think this is pretty much done, just a few small
> > comments from reviewing it again:
> >
> > user passwords to connect to the remote server. This avoids storing
> > - plain-text user passwords in PostgreSQL system catalogs.
> > + cleartext user passwords in PostgreSQL system catalogs.
> >
> > ..and:
> >
> > - plain-text user passwords to connect to the remote server. This
> > - avoids storing plain-text user passwords in PostgreSQL system
> > + cleartext user passwords to connect to the remote server. This
> > + avoids storing cleartext user passwords in PostgreSQL system
> >
> > I think there is potential for additional cleanup here since it is the storage
> > system we are referring to and not an inherent quality of a specific password.
> > Something like the below (though I don't particularly like the double "in", but
> > I fail at english today) would be an improvement I think.
> >
> > "This avoids storing user passwords in cleartext in PostgreSQL system
> > catalogs."
>
> +1 This makes it clearer. I don't mind the double "in" - I can't think
> of a better alternative.
>

How about.

"This avoids storing user passwords as cleartext in PostgreSQL system catalogs."

======
Kind Regards,
Peter Smith.
Fujitsu Australia

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Daniel Gustafsson 2026-11-17 20:57:54 Re: Good beginner doc-hacking task: clear-text vs. cleartext vs. clear text vs. plaintext etc..
Previous Message Daniel Gustafsson 2026-11-17 09:35:03 Re: Introductory docs-hacking task: Example markup