Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kJh5q-0001oe-1n for pgsql-hackers@arkaria.postgresql.org; Sat, 19 Sep 2020 17:56:14 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1kJh5o-0005eP-Go for pgsql-hackers@arkaria.postgresql.org; Sat, 19 Sep 2020 17:56:12 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kJh5o-0005eG-62 for pgsql-hackers@lists.postgresql.org; Sat, 19 Sep 2020 17:56:12 +0000 Received: from mail-il1-x12c.google.com ([2607:f8b0:4864:20::12c]) by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1kJh5g-0006ma-BT for pgsql-hackers@postgresql.org; Sat, 19 Sep 2020 17:56:11 +0000 Received: by mail-il1-x12c.google.com with SMTP id u18so9536809iln.13 for ; Sat, 19 Sep 2020 10:56:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telsasoft-com.20150623.gappssmtp.com; s=20150623; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=32BoLQdi409wNkpZbLsVO4CUaAfcKuuWVDaJCzUpAWg=; b=zwT+sB+zUOH0fjAWhltoVHJykB4OoNISln3MTcIcl6jSyrcJCzgDoiFjLZS2QZFVL3 ujKlq5XkGtBsM/Eai58I8TiilvpkvUZsJ5fDuCzFtcXjdTB1YoMtVu2Efec3wDBcHgRy aoH5ZzxiO7gE0Q2ZvQ5ft3iJtulD8FA8YMOH+3DAw0EfvONqgshZ0LPatQ4KCuZpJIVI u5GS57QjqZYm0JcSmH++gDU+W/GyahQr/0D2a0z5VB7kahY9rB5M66iYRah6Q/wRjkgI hIoIk5tlb2tIejPIIr/pPgwNiLgfeNqaAp1nuvJ0mDfNa6gNoZdrTcq4M9YVtV7rDKCV lGlQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=32BoLQdi409wNkpZbLsVO4CUaAfcKuuWVDaJCzUpAWg=; b=Bct0gEH74/6cl/Hmb80+eI6v9agiAkCmvAUZRNnnf59sR4GZUvDmgyfjfS9zv4/Ou7 p02fIPURGMR4hjQaQgfPUf09bZDM4X5ocFhUf8jWzH2FebNpAD3W9JIWtwhaNhLpn/Xn GpxgAoVkj0eGRxlZFcPvMVZiLHjbUh/wEUUPvtrt43xpk8SkJ8Hvo90eRbqyhehjC0Bs mVeL+dbqiUHIPSVHgpJPwVOJMTiRlttDOw7lW/R1No+wT5H0OZYCYnt1wAmO8gipP0Jx 93fuSOXkAjFY9PG7MD9CShqspNqgnvjANyPwhxf/mJnkThoTxsAxSD2lJEVtEcenjgQh pClw== X-Gm-Message-State: AOAM5338w0ojyg+mCCTHma8p+YbcS3/cBML0bxXnS6a+F3kl6rFoukRs ipY5PMqDPXqcc3OzL3/fKiA1F1EoO/Vbjg== X-Google-Smtp-Source: ABdhPJwCNedTGqFwJ3pzhebcXUjUc1EPOlXzQdFoeiw4yZIjhlhwaDkS94r4yjNfh1iXyxAI7K1NaA== X-Received: by 2002:a92:96c5:: with SMTP id g188mr20262827ilh.283.1600538161786; Sat, 19 Sep 2020 10:56:01 -0700 (PDT) Received: from pryzbyj.telsasoft (charmander.telsasoft.com. [50.244.222.1]) by smtp.gmail.com with ESMTPSA id 137sm3347067ioc.20.2020.09.19.10.56.00 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Sat, 19 Sep 2020 10:56:01 -0700 (PDT) Received: by pryzbyj.telsasoft (Postfix, from userid 1000) id 283CF800D7F; Sat, 19 Sep 2020 12:55:59 -0500 (CDT) Date: Sat, 19 Sep 2020 12:55:59 -0500 From: Justin Pryzby To: Yaroslav Cc: pgsql-hackers@postgresql.org Subject: Re: Probable documentation errors or improvements Message-ID: <20200919175558.GD30557@telsasoft.com> References: <1599765595731-0.post@n3.nabble.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1599765595731-0.post@n3.nabble.com> User-Agent: Mutt/1.9.4 (2018-02-28) List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk On Thu, Sep 10, 2020 at 12:19:55PM -0700, Yaroslav wrote: > Disclaimer: I'm not a native speaker, so not sure those are actually > incorrect, and can't offer non-trivial suggestions. https://www.postgresql.org/message-id/flat/CAKFQuwZh3k_CX2-%2BNcZ%3DFZss4bX6ASxDFEXJTY6u4wTH%2BG8%2BKA%40mail.gmail.com#9f9eba0cbbf9b57455503537575f5339 Most of these appear to be reasonable corrections or improvements. Would you want to submit a patch against the master branch ? It'll be easier for people to read when it's in a consistent format. And less work to read it than to write it. I suggest to first handle the 10+ changes which are most important and in need of fixing. After a couple rounds, then see if what's left is worth patching. -- Justin