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

From: Karen Jex <karenhjex(at)gmail(dot)com>
To: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
Cc: Daniel Gustafsson <daniel(at)yesql(dot)se>, 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-13 09:14:02
Message-ID: CAOpR_fbswiArEK_7JNqwzMTBFdc-WbfC+NPPCvpGd84LrhpMYA@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Le ven. 13 nov. 2026 à 09:44, Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at> a écrit :
>
> On Thu, 2026-11-12 at 17:37 +0100, Karen Jex wrote:
> > >
> > > I've created a V2 patch (attached) including the glossary terms, and
> > > with a verbose commit message as suggested by Laurenz.
> >
> > 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.

Thank you for the review.

>
> 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.
>

Good catch - the semicolon is an error. As suggested, I won't create a
new version just to change that.

Commitfest entry: https://commitfest.postgresql.org/patch/7630/

Best regards
--
Karen

In response to

Browse pgsql-docs by date

  From Date Subject
Previous Message Daniel Gustafsson 2026-11-13 09:13:51 Re: TDL Language links incorrect