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 1u3RRY-00FqAE-RF for pgsql-general@arkaria.postgresql.org; Sat, 12 Apr 2025 03:22:08 +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 1u3RRX-000OMa-7G for pgsql-general@arkaria.postgresql.org; Sat, 12 Apr 2025 03:22:07 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1u3RRW-000OMF-B0 for pgsql-general@lists.postgresql.org; Sat, 12 Apr 2025 03:22:06 +0000 Received: from mail-oa1-x31.google.com ([2001:4860:4864:20::31]) by makus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.96) (envelope-from ) id 1u3RRU-004PMA-2i for pgsql-general@lists.postgresql.org; Sat, 12 Apr 2025 03:22:05 +0000 Received: by mail-oa1-x31.google.com with SMTP id 586e51a60fabf-2cc89c59cc0so2149610fac.0 for ; Fri, 11 Apr 2025 20:22:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1744428124; x=1745032924; darn=lists.postgresql.org; h=cc:to:subject:message-id:date:from:references:in-reply-to :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=LGtIWqGICP7jDEafEBD+ztPpl/CxnVDD4u9n2JJ0rcQ=; b=hxWiUTEa4omlF98lcg1VtM0FpRjm90TDvhjoHYP9RBPGGF6I0WoDOeHP1XDsGUzDAo TuL978AXOr7ufz2rdJURrS7NAT7YtKqUnRlB//xxukdnu431ygUo8Fm98BU7o496dX/Z 4QQS1H3hgzEEPUAHWD7U6DKMNQ3avj3BXzGjR/831EAOW5AR2og1GZ5fBEAzpkufmZiF MmNJa48c5dc5+t/KJ1Q8xXkmRg8n/JMTxoBRLK525F8EN0EQzNuzt6pvqH2Bw+tkh0UT GXtkF5CFaYXeULEwUr9oOidnrhbYbOah+jb86+OrZp4L19Y8P18l20bQ4+qSJDlvDrC8 pAiQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1744428124; x=1745032924; h=cc:to:subject:message-id:date:from:references:in-reply-to :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=LGtIWqGICP7jDEafEBD+ztPpl/CxnVDD4u9n2JJ0rcQ=; b=o6/dAKRTNZkprD/uA/WvWJNwrcE5wUNh5CWY2kFA6KW+QOZRMigRtXkDcdqPWecIqk VzGo0wqgPboIO+4jcgkiNakYfrpNN4lsBs/F2t6lXE4x5w0qO1Cc4yvBOD/KustW5WYF 1u227emD5AJ1/4U3zMsfCJvTdsssUFUyQIQuGyrjF8RxSpN6RG7kMwJ+Tpv00VW2h/9J 7joOcpZfxG1vT3vpD06fwy4DtmdCpXmMp27sXCzGrrhe6N56MfQU+l++QscconacCpR6 JjP2UBpYbkNYQkkGxQjgieJNw869mf6KOfLv9GRQubOV8FV44reQDlN5ZRKr5QfS5ybE a7qA== X-Gm-Message-State: AOJu0YwB7plQpR2kUqcJ3RRdKwYSfpl1xuczv6Gq8xwmczW4rau5/pRk Z807BIchoKgx1vB6QDdWB9DHU9RoQMNajYum4ssu4+FCDxLqTdK8sEeDdOIMWfTfYeC8O4ov+5j O4uOrhPalzz+0xLt8IOeqFcJFmCCQUA== X-Gm-Gg: ASbGncvocZwtUTR/z+TvkxrnAxr21v3C1N/Jia4Wpcf0Q/vivPShsQvrzcPXam4LhOD AmQTBpptW+xZlallzGieYi64NImF2Yjat9Jk6l8R5CNWD40j65B66+7PwE5AT0TYlj6Bm8yol9h Ax+N+l3lYdfA2hKoAECjOf X-Google-Smtp-Source: AGHT+IHHXE6P+lN7kH5IuIX/WVhfaCrmQZ7w4WW+mCHjMlqA9pmnXEo6f9UgP4HlNqogSUMt7LMdIT9tY9NLRn51RmM= X-Received: by 2002:a05:6870:71cc:b0:297:281b:fb6d with SMTP id 586e51a60fabf-2d0d3697d78mr3124129fac.3.1744428123922; Fri, 11 Apr 2025 20:22:03 -0700 (PDT) MIME-Version: 1.0 Received: by 2002:ac9:5f03:0:b0:589:13f9:e937 with HTTP; Fri, 11 Apr 2025 20:22:03 -0700 (PDT) In-Reply-To: References: From: "David G. Johnston" Date: Fri, 11 Apr 2025 20:22:03 -0700 X-Gm-Features: ATxdqUF9JyQ5fgRfj4QYw2WAeQPXqalkrTEddZQkq9DLF5N5kVdpo8WLy_uFjYo Message-ID: Subject: Re: Clarification on the docs To: Igor Korot Cc: "pgsql-generallists.postgresql.org" Content-Type: multipart/alternative; boundary="000000000000a9a99706328c52ad" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --000000000000a9a99706328c52ad Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Friday, April 11, 2025, Igor Korot wrote: > Hi, David, > > On Fri, Apr 11, 2025 at 9:04=E2=80=AFPM David G. Johnston < > david.g.johnston@gmail.com> wrote: > >> On Fri, Apr 11, 2025 at 6:49=E2=80=AFPM Igor Korot = wrote: >> >>> Hi, ALL, >>> On the https://www.postgresql.org/docs/17/sql-createindex.html# >>> SQL-CREATEINDEX-STORAGE-PARAMETERS >>> its said: >>> >>> [quote] >>> The optional WITH clause specifies storage parameters for the index. >>> Each index method has its own set of allowed storage parameters. The >>> B-tree, hash, GiST and SP-GiST index methods all accept this >>> parameter: >>> [/quote] >>> >>> >> These are the index methods and the valid lists for each. The docs are >> correct in how they remove duplication. I'm undecided on whether that i= s >> the best presentation choice. I would at minimum place a new paragraph >> after "own set of allowed storage parameters." so that "The B-tree, >> hash..." begins its own line. >> > > This above looks much better. What stops you from pushing it? > > There is no double meaning and everything is split nicely. > Because I=E2=80=99m undecided on what exactly would be an improvement and d= on=E2=80=99t care enough on the basis of this single question to put effort into figuring that out. Committers read these and if one of them wants to act on my new paragraph suggestion great. If not, it isn=E2=80=99t that big a = deal. For me, this doesn=E2=80=99t warrant a CF entry. David J. --000000000000a9a99706328c52ad Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Friday, April 11, 2025, Igor Korot <ikorot01@gmail.com> wrote:
Hi, David,

On Fri, Apr 11, 2025 at 9:04=E2=80=AFPM Davi= d G. Johnston <david.g.johnston@gmail.com> wrote:
=
On Fri, Apr 11, 2025 at 6:49=E2=80=AFPM Igor Korot <ikorot01@gmail.com> wrote:
Hi, ALL,
On the htt= ps://www.postgresql.org/docs/17/sql-createindex.html#SQL-CREATEIN= DEX-STORAGE-PARAMETERS
its said:

[quote]
The optional WITH clause specifies storage parameters for the index.
Each index method has its own set of allowed storage parameters. The
B-tree, hash, GiST and SP-GiST index methods all accept this
parameter:
[/quote]


These are the index methods = and the valid lists for each.=C2=A0 The docs are correct in how they remove= duplication.=C2=A0 I'm undecided on whether that is the best presentat= ion choice.=C2=A0 I would at minimum place a new paragraph after "own = set of allowed storage parameters." so that "The B-tree, hash...&= quot; begins its own line.
=C2=A0
This above looks much better. What= stops you from pushing it?

There is no double meaning and everything is split nicely.
<= /div>

Because I=E2=80=99m undecided on what= exactly would be an improvement and don=E2=80=99t care enough on the basis= of this single question to put effort into figuring that out.=C2=A0 Commit= ters read these and if one of them wants to act on my new paragraph suggest= ion great.=C2=A0 If not, it isn=E2=80=99t that big a deal.=C2=A0 For me, th= is doesn=E2=80=99t warrant a CF entry.

David J.

--000000000000a9a99706328c52ad--