Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1i0yZ7-0001RD-70 for pgsql-docs@arkaria.postgresql.org; Fri, 23 Aug 2019 01:40:34 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1i0yZ6-0002XX-0e for pgsql-docs@arkaria.postgresql.org; Fri, 23 Aug 2019 01:40:32 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1i0yZ4-0002XQ-6f for pgsql-docs@lists.postgresql.org; Fri, 23 Aug 2019 01:40:31 +0000 Received: from wout3-smtp.messagingengine.com ([64.147.123.19]) by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1i0yYz-0003lC-Kr for pgsql-docs@postgresql.org; Fri, 23 Aug 2019 01:40:29 +0000 Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.west.internal (Postfix) with ESMTP id DBCE742E; Thu, 22 Aug 2019 21:40:21 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute4.internal (MEProxy); Thu, 22 Aug 2019 21:40:22 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=paquier.xyz; h= date:from:to:cc:subject:message-id:references:mime-version :content-type:in-reply-to; s=fm2; bh=lKqdj7mrkJ2SYAPgMx3WvCwCTne HFlng/CqsR4bXQXQ=; b=RAG0taxJh5it75oNRcl55gZH86ZXfoFvL7oJiuj8+XL wJIo/7+aXQjFweJdJs2FQ9T75WaUBlladTlOtexESjCGYOI0iEGZrdyF4wWv2SLX HpUvfY8pR+7l3tmgu3bePBYl4QDolh2HwKNemGor9CfKRN3cFoewGiiD17lCvOHj bpiDXBZXvoLtWwERTS/4Mxk0bAkP0nsdlRpGCpHAdE7B0CPKN533EB4JBTN2LRYJ EDVvTp/GB4d/lFDK67EBGpDir3Yx2eoeWcgazxkcNKcFt63x4PiSKnhwKSPa0mxy ecUuny0UX/lI6mUGFsHbY9CjxzYFX5I+GX2SesY39Yg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm3; bh=lKqdj7 mrkJ2SYAPgMx3WvCwCTneHFlng/CqsR4bXQXQ=; b=RsPu35Z1Bz/fea3aJ6HZtY u6oBbgD9cQhVeyndoUJQp0dv9kB75cZoJhUSk7d9dSmCuFx6BCRvekrBeOATCqh2 KMeDRtQo14Ok6wM4Kfz1urvjlyhyEq7RRknKlXescN2KxdC2xvhEBPwHYs0Tvmg4 WKg38MbHSKZyFqGgakjRcMg8TiqDNaPEr+LeYx6sD7yjNZ5B9S8j8OiMpmMMEeLe bVVo8J/NPW+CoB1rrbqbaus1Ix7FnPHt8pE8Np9SsYlFva08NcrqIJ11kHELi4a2 cf2AucVTOMYLRhcsFvvHh3/EquqoG/NVqNsqLe6/lPYsB0miglVr7khM1YRYy3Wg == X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduvddrudegjedggeelucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne gfrhhlucfvnfffucdljedtmdenucfjughrpeffhffvuffkfhggtggujgesghdtreertddt vdenucfhrhhomhepofhitghhrggvlhcurfgrqhhuihgvrhcuoehmihgthhgrvghlsehprg hquhhivghrrdighiiiqeenucfkphepudduuddruddtvddrudektddrudekheenucfrrghr rghmpehmrghilhhfrhhomhepmhhitghhrggvlhesphgrqhhuihgvrhdrgiihiienucevlh hushhtvghrufhiiigvpedt X-ME-Proxy: Received: from paquier.xyz (ee0822lan1.rev.em-net.ne.jp [111.102.180.185]) by mail.messagingengine.com (Postfix) with ESMTPA id 1A2488005A; Thu, 22 Aug 2019 21:40:19 -0400 (EDT) Date: Fri, 23 Aug 2019 10:40:17 +0900 From: Michael Paquier To: Liudmila Mantrova Cc: pgsql-docs Subject: Re: minor doc fixes for REL_12_STABLE Message-ID: <20190823014017.GA2328@paquier.xyz> References: <20190820044809.GA1841@paquier.xyz> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="UugvWAfsgieZRqgk" Content-Disposition: inline In-Reply-To: List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk --UugvWAfsgieZRqgk Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Thu, Aug 22, 2019 at 04:13:00PM +0300, Liudmila Mantrova wrote: > Looks like you have also changed "an SQL" to "a SQL" in some cases (but not > everywhere), and I wonder what's the official guidance here for PostgreSQL > documentation. I see no consistency, but the first version appears more > often, that's why I decided to use it (although I have to admit that I've > been looking for something to confirm my personal preference). This was discussed not long ago, and there was no actual consensus that one was better than the other. We have that in the code tree: $ git grep -i "a sql" | wc -l 875 $ git grep -i "an sql" | wc -l 304 -- Michael --UugvWAfsgieZRqgk Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCgAdFiEEG72nH6vTowiyblFKnvQgOdbyQH0FAl1fRAEACgkQnvQgOdby QH0qVw/+MYcLY3C10NuNXM8ck5HNu2iELp7jb57cTKGU7p0EWJQMDGh6fui8w8HD z9E9YNz1+NfT3ga8dw8EJoVoc3WODv6P718gBdpHj4oRRVN7PBNiaWhZSin1UgYA GcDzBjMdAf1eVKdviBlYPXCihZ5E/2MU1UV6nxpkqsorKzhWCbwcClRpqUGWNSXg uYhh3Mjlcj03VQIXJykJhh1mtcV4ElRU1vL1mT0ICCW5jo6GZDAaZIN5JDsf3/OE cvUylfeva/66oMew1RcJINi793G1KfWBQccxjryKmYtmo/DtN9Ax1OqmJ4+u/Fy1 sgfdnuZaSU60Y5C9lUmJlP/AFDcN9ZxyWO4/PScX2gKLKar9cqL32sdw0g4MVtTI 8MJI5ubj+CoMmf6mfdrH79cquW/ymGgrJo739vrsIwamy6Od64uCQO2oDoFDbxL/ kzaCju/UcCUjkJWh/kz+amz7yduGlrkRP/SS0oAxX1g30lNO4Q0OL+PYdj4lr4u9 YdHRH4IZix1mzTEEhBST01DzA6Uxan8HB0MIBF6vOHmFoiIW4QNSg9M/v2YGN185 B22MHFoRU3rZJavU1IfzUIJvDajbTYTCcU4cnGsZwFG/tdGD7WJylg/k/fgfpFZl M7aXHvYHjwvt50qWYaliO9xJ+s0eKv95TT5rX+MwUNnTm0RXN1s= =DSGB -----END PGP SIGNATURE----- --UugvWAfsgieZRqgk--