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 1hG3e5-0001Yq-4A for pgsql-docs@arkaria.postgresql.org; Mon, 15 Apr 2019 15:35:45 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1hG3e3-0003Sg-L5 for pgsql-docs@arkaria.postgresql.org; Mon, 15 Apr 2019 15:35:43 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hG3e3-0003Pz-9u for pgsql-docs@lists.postgresql.org; Mon, 15 Apr 2019 15:35:43 +0000 Received: from mail-qt1-x841.google.com ([2607:f8b0:4864:20::841]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hG3e0-0007M4-7z for pgsql-docs@postgresql.org; Mon, 15 Apr 2019 15:35:41 +0000 Received: by mail-qt1-x841.google.com with SMTP id v20so19560993qtv.12 for ; Mon, 15 Apr 2019 08:35:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=2ndquadrant-com.20150623.gappssmtp.com; s=20150623; h=date:from:to:cc:subject:message-id:mime-version:content-disposition :content-transfer-encoding:in-reply-to:user-agent; bh=/oeMkRMvSXRmP5lNXH0TeEOhho62jaPxWa7/kZzqA8g=; b=YknYsQ2lNSn/w2YahIs70p2cqsHs3cp7qmAcU1i7EjNKLer4tzQu3bn2D4k85ufPD4 /Mf9CdjrFZ3Qp5841+/sRe2Bq9oUViSBSKVn1S85fWToxZRR360nlRdmb4JRAELqsZ7i G+9cySxG+Nwl/0wV6lV5x6UgWqOZeD+s54y38NfHcxPZ6vNAHZW4ozd7pyZVDRqSE7lh 2udDsWivqR55C3m9PhMxeKUMArGTPUDhV/CruFWwtXIVzLmEdO6xmaJzJ6j6Yz2/5VSj mlArbS3zdiw95Bg0bMWUq4VkJN/2zvzSFyIpam/94fPAM4Yr3q4AtoBUcdKMeWGpOVxA Ne8A== 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:mime-version :content-disposition:content-transfer-encoding:in-reply-to :user-agent; bh=/oeMkRMvSXRmP5lNXH0TeEOhho62jaPxWa7/kZzqA8g=; b=LrBnIPX2rzZIg7HWYW0k0qiPf9fE+qDAO1XDz6CVdKA0E6pyiM+g9onhHA/ZhKXYJ8 jAAhQHLot5EuAvvvMx3lcBfkIph3Dt8ABkS6axScLh1gsb7ETxqo0Atd0jXEezsbXLfc yxUmpshxLm6ycphMaADazfPbacSpe1x/I2j8dbla1bcuafrk/JvEmw+e0NJl5V42prux SlC04n4o6aV6IjCnuuTlqIQdIetET1qrjsXS1PkhHjspMRT2SDS+xTzhWdrzNAb+CxO2 ilLYd85z+4LKdj7IoDCnT9/B5fHA3Re/teaIRdf/dFJDBlxUKKqawlKefqNQKj9yd9db TzXA== X-Gm-Message-State: APjAAAXg1+i0I0wrhCIVo0rU7Rh1uYZCcOOsnQNp6MQ4I0a9z0VjDm1L O5BdOE0JdJibHlyw5dCefEHYkw== X-Google-Smtp-Source: APXvYqwIEN5iFILF83GcUs0I9vZGYHVnsDu6v5DEJT8Rg6l1CrLtmvt4J6Q3r+BnWM0xiJSeEooSRw== X-Received: by 2002:a0c:afc8:: with SMTP id t8mr59878433qvc.123.1555342539247; Mon, 15 Apr 2019 08:35:39 -0700 (PDT) Received: from nimloth.alvh.no-ip.org ([201.186.80.67]) by smtp.gmail.com with ESMTPSA id n10sm39733798qta.86.2019.04.15.08.35.38 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 15 Apr 2019 08:35:38 -0700 (PDT) Received: by nimloth.alvh.no-ip.org (Postfix, from userid 1000) id 48217120F72; Mon, 15 Apr 2019 11:35:36 -0400 (-04) Date: Mon, 15 Apr 2019 11:35:36 -0400 From: Alvaro Herrera To: Fujii Masao Cc: pgsql-docs Subject: Re: Mark a reloption as indexterm Message-ID: <20190415153536.GA10348@alvherre.pgsql> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: User-Agent: Mutt/1.9.4 (2018-02-28) List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk On 2019-Apr-16, Fujii Masao wrote: > On Sat, Apr 13, 2019 at 1:30 AM Alvaro Herrera wrote: > > > > On 2019-Apr-12, Fujii Masao wrote: > > > > > > > OTOH, originally I thought that the following style is smarter. > > > > > > xxx > > > configuration parameter, XXX > > > storage parameter, Storage Parameter > > > > Ah. Well, I like this style. Let's do that. > > So I used tag again for the above style if both reloption > and guc with the same parameter name exist. Attached is the updated > version of the patch. This patch also marks index-reloption as indexterm. I checked the HTML output. For autovacuum it says "configuration parameters" rather than "configuration parameter". Other than that, it looks good to me. (I didn't check that all storage options were covered.) -- Álvaro Herrera https://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services