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.94.2) (envelope-from ) id 1sWZbl-00G0DG-T3 for pgsql-docs@arkaria.postgresql.org; Wed, 24 Jul 2024 10:52:33 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1sWZbj-003ZEV-Ro for pgsql-docs@arkaria.postgresql.org; Wed, 24 Jul 2024 10:52:32 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1sWZbj-003ZEM-IT for pgsql-docs@lists.postgresql.org; Wed, 24 Jul 2024 10:52:32 +0000 Received: from mail-ej1-x634.google.com ([2a00:1450:4864:20::634]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.94.2) (envelope-from ) id 1sWZbh-001DC8-NO for pgsql-docs@lists.postgresql.org; Wed, 24 Jul 2024 10:52:31 +0000 Received: by mail-ej1-x634.google.com with SMTP id a640c23a62f3a-a7a9a369055so166693966b.3 for ; Wed, 24 Jul 2024 03:52:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cybertec-at.20230601.gappssmtp.com; s=20230601; t=1721818348; x=1722423148; darn=lists.postgresql.org; h=mime-version:user-agent:autocrypt:references:in-reply-to:date:to :from:subject:message-id:from:to:cc:subject:date:message-id:reply-to; bh=hiO97zir/702ldC1MQZkf9wrx5z4Zg+Yvs6rpKzcfqg=; b=Wvdv/8vhizzcqyASo7C0j/DQQiBRGHK0/mJtrgJzfGr56haJDFM9bH9UPAq/n9vykZ ellB11lD0BJmQLMVbBdXpTsZMEfwiMo5SS89EMGqC4kFD3lr5naPdLhGnd3BvZ3U82ZJ k8f/uIriL6izihSjaVsseDHIJs4oJm0YIg7g7h9Vh4Xu4mvxvftBKPWp7gzmFKOoM9rw f0ARd/Hp1WPApxYjEbATG+KjDloEC92hWWxWXQqna8YBYA1Qm0MGvgh1veR2gv1c13CA N5rBW+EvoVVhChL530VcVp6hZN942Jhxj5tB+um1mjsS1zOTad8gUjfu6lRmA0iRm3kT ixDg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1721818348; x=1722423148; h=mime-version:user-agent:autocrypt:references:in-reply-to:date:to :from:subject:message-id:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=hiO97zir/702ldC1MQZkf9wrx5z4Zg+Yvs6rpKzcfqg=; b=YHjoHdmdhW/Bn/ABH1vgospv+ANwfty7lQKKgQI9kzdsqQtPOKkeeNmqo91cYzU8rp snVdcbimmvBs/d49ZZhoBolwGGBbD3Bu/ebBxOKxj0FnsCCjX8WKNTVWoG2kGowugtYy RUw7lD9xBoHXCroEu3z/gDF6i7l5BRob4xa7Kk5u0z5p+8rxPYZpU8AfKrLnUk9FE7Dt 4c9KoarYgWlLtYNn0VXBkcM3PmdvDN6w9rKxJzsoVNXeEbKd8+61Rw9wocwJOMlhYgX4 GxYVVpK6v9krOLHeSkcn/CB0iFFZR8CjOIamaazU65mC/Q+vIfAfl7QbMPYzJxtwNjlR stYg== X-Forwarded-Encrypted: i=1; AJvYcCUxh2bv9lGrXHd1wb8iih+YDfrUcCJBorfO5bdA2iERLGI8A+aUKlO3YZ0boso3TFB0VUExPXULdkZt/cKD2my0BIrCXaxngE7IaGMswn9i X-Gm-Message-State: AOJu0YyPGa+3165J09pE3EFTXjxI0wAyQ94nyBqCTuc4HOijRcU94jf4 seEtQ9vO7yp6dLOreHosXcDG8tJjzDpl5j07uj/rOF7nTmQTqpNCSsPT0A94A98JpbTR5uXnZs3 G X-Google-Smtp-Source: AGHT+IGvqg5WfZb/SDYiDFC4MHBvcnxzPaxYJbhUg0lmbfzec4VT6EgU8LwhXqoluOoDZWP4FUDKww== X-Received: by 2002:a17:907:86a7:b0:a7a:a06b:eecd with SMTP id a640c23a62f3a-a7ab0e251a3mr135138566b.5.1721818347662; Wed, 24 Jul 2024 03:52:27 -0700 (PDT) Received: from localhost.localdomain ([2001:871:5e:ba6d:bf11:107b:5b76:b25a]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-a7ab7fed535sm33751466b.180.2024.07.24.03.52.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 24 Jul 2024 03:52:26 -0700 (PDT) Message-ID: <054ae54ad248783aefeb59813080d29faad5a11f.camel@cybertec.at> Subject: Re: Incorrect grammar in 15.2 From: Laurenz Albe To: grantgryczan@gmail.com, pgsql-docs@lists.postgresql.org Date: Wed, 24 Jul 2024 12:52:25 +0200 In-Reply-To: <172179789219.915368.16590585529628354757@wrigleys.postgresql.org> References: <172179789219.915368.16590585529628354757@wrigleys.postgresql.org> Autocrypt: addr=laurenz.albe@cybertec.at; prefer-encrypt=mutual; keydata=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 +AnW5l0HsQcY9ntFL/zEBOaonjdJf Content-Type: multipart/mixed; boundary="=-viQRuFc+dSikqOoLKgIn" User-Agent: Evolution 3.50.4 (3.50.4-1.fc39) MIME-Version: 1.0 List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --=-viQRuFc+dSikqOoLKgIn Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Wed, 2024-07-24 at 05:11 +0000, PG Doc comments form wrote: > The following documentation comment has been logged on the website: >=20 > Page: https://www.postgresql.org/docs/16/when-can-parallel-query-be-used.= html > Description: >=20 > Unless I'm misunderstanding the sentence structure here, I believe the wo= rd > "a" is missing before "parallel query plan" in the following sentence fro= m > section 15.2: >=20 > > Even when parallel query plan is generated for a particular query, ther= e > are several circumstances under which it will be impossible to execute th= at > plan in parallel at execution time. >=20 > This should say: >=20 > > Even when a parallel query plan is generated for a particular query, th= ere > are several circumstances under which it will be impossible to execute th= at > plan in parallel at execution time. +1 Here is a patch for that; it may be the smallest patch I've ever written for PostgreSQL. Yours, Laurenz Albe --=-viQRuFc+dSikqOoLKgIn Content-Disposition: attachment; filename="v1-0001-Fix-a-missing-article-in-the-documentation.patch" Content-Transfer-Encoding: base64 Content-Type: text/x-patch; name="v1-0001-Fix-a-missing-article-in-the-documentation.patch"; charset="UTF-8" RnJvbSA2OGVlZGQwMWM3NTRmZmQyZGZiYjExY2QyOWY1Njg4NDFkN2RiN2E2IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBMYXVyZW56IEFsYmUgPGxhdXJlbnouYWxiZUBjeWJlcnRlYy5h dD4KRGF0ZTogV2VkLCAyNCBKdWwgMjAyNCAxMjo1MDo0OSArMDIwMApTdWJqZWN0OiBbUEFUQ0gg djFdIEZpeCBhIG1pc3NpbmcgYXJ0aWNsZSBpbiB0aGUgZG9jdW1lbnRhdGlvbgoKUGVyIGNvbXBs YWludCBmcm9tIEdyYW50IEdyeWN6YW4uCi0tLQogZG9jL3NyYy9zZ21sL3BhcmFsbGVsLnNnbWwg fCAyICstCiAxIGZpbGUgY2hhbmdlZCwgMSBpbnNlcnRpb24oKyksIDEgZGVsZXRpb24oLSkKCmRp ZmYgLS1naXQgYS9kb2Mvc3JjL3NnbWwvcGFyYWxsZWwuc2dtbCBiL2RvYy9zcmMvc2dtbC9wYXJh bGxlbC5zZ21sCmluZGV4IGRhZTlkZDdmMmYuLjU5MGNiMzg1ZGQgMTAwNjQ0Ci0tLSBhL2RvYy9z cmMvc2dtbC9wYXJhbGxlbC5zZ21sCisrKyBiL2RvYy9zcmMvc2dtbC9wYXJhbGxlbC5zZ21sCkBA IC0yMDIsNyArMjAyLDcgQEAgRVhQTEFJTiBTRUxFQ1QgKiBGUk9NIHBnYmVuY2hfYWNjb3VudHMg V0hFUkUgZmlsbGVyIExJS0UgJyV4JSc7CiAgIDwvaXRlbWl6ZWRsaXN0PgogCiAgIDxwYXJhPgot ICAgIEV2ZW4gd2hlbiBwYXJhbGxlbCBxdWVyeSBwbGFuIGlzIGdlbmVyYXRlZCBmb3IgYSBwYXJ0 aWN1bGFyIHF1ZXJ5LCB0aGVyZQorICAgIEV2ZW4gd2hlbiBhIHBhcmFsbGVsIHF1ZXJ5IHBsYW4g aXMgZ2VuZXJhdGVkIGZvciBhIHBhcnRpY3VsYXIgcXVlcnksIHRoZXJlCiAgICAgYXJlIHNldmVy YWwgY2lyY3Vtc3RhbmNlcyB1bmRlciB3aGljaCBpdCB3aWxsIGJlIGltcG9zc2libGUgdG8gZXhl Y3V0ZQogICAgIHRoYXQgcGxhbiBpbiBwYXJhbGxlbCBhdCBleGVjdXRpb24gdGltZS4gIElmIHRo aXMgb2NjdXJzLCB0aGUgbGVhZGVyCiAgICAgd2lsbCBleGVjdXRlIHRoZSBwb3J0aW9uIG9mIHRo ZSBwbGFuIGJlbG93IHRoZSA8bGl0ZXJhbD5HYXRoZXI8L2xpdGVyYWw+Ci0tIAoyLjQ1LjIKCg== --=-viQRuFc+dSikqOoLKgIn--