Re: typos

From: Justin Pryzby <pryzby(at)telsasoft(dot)com>
To: David Rowley <dgrowleyml(at)gmail(dot)com>
Cc: Robert Haas <robertmhaas(at)gmail(dot)com>, Joe Conway <mail(at)joeconway(dot)com>, pgsql-hackers(at)postgresql(dot)org, Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>, Amit Kapila <akapila(at)postgresql(dot)org>, Masahiko Sawada <sawada(dot)mshk(at)gmail(dot)com>
Subject: Re: typos
Date: 2022-04-11 10:10:05
Message-ID: 20220411101005.GD26620@telsasoft.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Mon, Apr 11, 2022 at 04:39:30PM +1200, David Rowley wrote:
> I'm not entirely certain this is an improvement. Your commit message
> I'd say is not true going by git grep "compression algorithm". There
> are 3 matches in the docs and take [1], for example. I'd say in that
> one it's better to use "algorithm". In that case, "method" could be
> talking about client or server.

I am not wedded to this change; but, for context, I wrote this patch before
basebackup supported multiple compression ... "things". I didn't touch
basebackup here, since Robert defended that choice of words in another thread
(starting at 20220320194050(dot)GX28503(at)telsasoft(dot)com).

This change is for pg_column_compression(), and the only other use of
"compression algorithm" in the docs is in pgcrypto (which is in contrib). That
the docs consistently use "method" suggests continuing to use that rather than
something else. It could be described in some central place (like if we
support common syntax between interfaces which expose compression).

> 0010:
> I don't understand this change.

The commit message mentions 959f6d6a1, which makes newbindir optional. But the
documentation wasn't updated, and seems to indicate that it's still required.
https://www.postgresql.org/docs/devel/pgupgrade.html

> 0011:
> I can't quite parse the original. I might not have enough context
> here. Robert, Joe? (new to master)

See the link in the commit message where someone else reported the same
problem.

> 0019:
> -1. pgindent will fix these.

But two of those are from 2016.

Thanks for amending and pushing those. There's some more less obvious ones
attached.

Amit or Masahiko may want to comment on 0012 (doc review: Add ALTER
SUBSCRIPTION ... SKIP).

Attachment Content-Type Size
0001-doc-Remove-synchronized-from-no-sync.patch text/x-diff 1.1 KB
0002-doc-pg_column_compression-we-say-method-not-algorith.patch text/x-diff 970 bytes
0003-doc-review-update-synopsis-pg_upgrade-optional-newbi.patch text/x-diff 1.1 KB
0004-doc-review-basebackup_to_shell.required_role.patch text/x-diff 1.1 KB
0005-Extraneous-blank-lines.patch text/x-diff 18.2 KB
0006-f-blanks-which-involve-tabs.patch text/x-diff 29.5 KB
0007-comment-spaces.patch text/x-diff 1.9 KB
0008-doc-fixes-productname.patch text/x-diff 4.8 KB
0009-doc-review-locales.patch text/x-diff 3.8 KB
0010-doc-review-compute_query_id-regress.patch text/x-diff 1.1 KB
0011-doc-review-row-filters-for-logical-replication.patch text/x-diff 1.1 KB
0012-doc-review-Add-ALTER-SUBSCRIPTION-.-SKIP.patch text/x-diff 4.4 KB
0013-doc-comma.patch text/x-diff 1.1 KB

In response to

  • Re: typos at 2022-04-11 04:39:30 from David Rowley

Responses

  • Re: typos at 2022-04-11 10:25:14 from Masahiko Sawada
  • Re: typos at 2022-04-13 20:56:22 from David Rowley

Browse pgsql-hackers by date

  From Date Subject
Next Message John Naylor 2022-04-11 10:11:47 Re: A qsort template
Previous Message Julien Rouhaud 2022-04-11 09:16:59 Re: Outdated copyright year in parse_jsontable.c