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 1jME0j-0005E0-2V for pgsql-hackers@arkaria.postgresql.org; Wed, 08 Apr 2020 16:57:09 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1jME0h-0004lr-Tu for pgsql-hackers@arkaria.postgresql.org; Wed, 08 Apr 2020 16:57:07 +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 1jME0h-0004lk-I5 for pgsql-hackers@lists.postgresql.org; Wed, 08 Apr 2020 16:57:07 +0000 Received: from mail-qk1-x734.google.com ([2607:f8b0:4864:20::734]) by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1jME0Z-0002xU-Ah for pgsql-hackers@lists.postgresql.org; Wed, 08 Apr 2020 16:57:06 +0000 Received: by mail-qk1-x734.google.com with SMTP id b62so898757qkf.6 for ; Wed, 08 Apr 2020 09:56:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telsasoft-com.20150623.gappssmtp.com; s=20150623; h=date:from:to:subject:message-id:mime-version:content-disposition :user-agent; bh=o8J7jHn4YyeS1wzN5YSK58k3ibfSO/VTlmMTcFPuaAA=; b=RS/IRuqC/6Lb4LV0qyeqlzLf8dCmdBTwFHnuWuFsoRUrbq+qiR+EPRVfQvpf8OQtXP he/eCZEFIWI3FhlaBVU6W1dFju8q/yw8wmeC9e+eLNaIBlJ9ka8ZHg70miN/B7vry8ag go+pIW71OJJ5F0UVE+KweYaHf1Ss8e5gElUzw7eTWaT424/Lu9DvB3IlccL8q0lP9gG2 /ZLUqpeBfeQHFCAVGFWgX/w4LyoEq/Nj9KYsyX5pTQnistp14O28+KrwobhpriU+yUbm f5+NC31GWFEp4DVieAa/5QuTMUxoUEUTUUFZEnn0zvl3lg+8rQkdarXDUCUjYqOu7W/H TZuQ== 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:subject:message-id:mime-version :content-disposition:user-agent; bh=o8J7jHn4YyeS1wzN5YSK58k3ibfSO/VTlmMTcFPuaAA=; b=N/e13I/kS224rVjjip8Bs3AkrtCZk0b0yZ56VBuXkjlHVTCKRwFYh7f1kRWeajfcpC Ob+njniWMTQiRIUR7eOl5UTrV28p8WpB7Q2s1H8xCq8nPnvjdvvtvoDUI0fUXdvVFvqA vX6KQwOqW7oB84qqrz9u8hmruNFX1l3vHrFTVxyMA2y0yonKVF+mjl6puu4jfsCq/N9s J2DrllOZy00DIkpqozgLGfGIc4utrKGXCnKqJRmrUrncWjD4pMZOgT02LadN730m5IO4 0c4buHnpP1JjMXrpD6yWb2EdPsEr9F0A8sZSuzy3LR7AOdJMYxBfyZ2lUAIkrVrEYPyC 9N5g== X-Gm-Message-State: AGi0PubH4QhHE1aoxxGyTI7YZjtle7zlrMp0R6lWn+WVwlEKTTqJwZdg eZuV7PU+GXS+XRYZg/2nFY1RbZTZW64= X-Google-Smtp-Source: APiQypKHPe9Nj45PgO3/ywFrpiSpc733I1wZB2hP1hZ2KOwLgk60qkQc4FvDZZ2zLoMMEivZis0jlA== X-Received: by 2002:a05:620a:12fa:: with SMTP id f26mr8467320qkl.374.1586365016964; Wed, 08 Apr 2020 09:56:56 -0700 (PDT) Received: from pryzbyj (charmander.telsasoft.com. [50.244.222.1]) by smtp.gmail.com with ESMTPSA id n13sm10986347qtf.15.2020.04.08.09.56.54 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 08 Apr 2020 09:56:55 -0700 (PDT) Received: by pryzbyj (Postfix, from userid 1000) id A8789800897; Wed, 8 Apr 2020 11:56:53 -0500 (CDT) Date: Wed, 8 Apr 2020 11:56:53 -0500 From: Justin Pryzby To: pgsql-hackers@lists.postgresql.org Subject: doc review for v13 Message-ID: <20200408165653.GF2228@telsasoft.com> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="4ybNbZnZ8tziJ7D6" Content-Disposition: inline User-Agent: Mutt/1.5.23 (2014-03-12) List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk --4ybNbZnZ8tziJ7D6 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline I reviewed docs for v13, like: git log --cherry-pick origin/master...origin/REL_12_STABLE -p doc I did something similar for v12 [0]. I've included portions of that here which still seem lacking 12 months later (but I'm not intending to continue defending each individual patch hunk). I previously mailed separately about a few individual patches, some of which have separate, ongoing discussion and aren't included here (incr sort, parallel vacuum). Justin [0] https://www.postgresql.org/message-id/flat/20190709161256.GH22387%40telsasoft.com#56889b868e5886e36b90e9f5a1165186 --4ybNbZnZ8tziJ7D6 Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="v1-0001-docs-pg_statistic_ext.stxstattarget.patch"