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 1lAa2F-00080a-T0 for pgsql-bugs@arkaria.postgresql.org; Fri, 12 Feb 2021 15:07:07 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1lAa2E-0005EV-QS for pgsql-bugs@arkaria.postgresql.org; Fri, 12 Feb 2021 15:07:06 +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 1lAa2E-0005EO-KN for pgsql-bugs@lists.postgresql.org; Fri, 12 Feb 2021 15:07:06 +0000 Received: from sss.pgh.pa.us ([66.207.139.130]) by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lAa28-0006Xx-7F for pgsql-bugs@lists.postgresql.org; Fri, 12 Feb 2021 15:07:06 +0000 Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1]) by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 11CF6vJ11551471; Fri, 12 Feb 2021 10:06:58 -0500 From: Tom Lane To: Francisco Olarte cc: boshomi@gmail.com, PostgreSQL mailing lists Subject: Re: BUG #16860: Documentation: GUC Parameters are not explained In-reply-to: References: <16860-3c4cef71e32b4233@postgresql.org> <1452087.1613063895@sss.pgh.pa.us> Comments: In-reply-to Francisco Olarte message dated "Fri, 12 Feb 2021 09:22:48 +0100" MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <1551469.1613142417.1@sss.pgh.pa.us> Date: Fri, 12 Feb 2021 10:06:57 -0500 Message-ID: <1551470.1613142417@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk Francisco Olarte writes: > I ( not the OP ) knew the meaning ( although I had forgotten the exact > words ), and managed to find it, but had to do a full search. IMO an > entry in the index could be useful for it, even if it is just an > acronym ( I went to the HTML manual, searched in the TOC, searched in > the first couple server configuration pages, searched in the index and > then resorted to full search and got the acronyms hit in the middle, > it seems a bit hidden for me ). Hmm. I'd supposed that the entries in the acronym list (and the glossary, now that we've got that ... I wonder why they are separate) had s, but now I see they don't. I would not be opposed to adding index entries. regards, tom lane