Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtp (Exim 4.84_2)
	(envelope-from
 <pgsql-docs-owner+M9144=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
	id 1coBRF-0004xd-In
	for pgsql-docs@arkaria.postgresql.org; Wed, 15 Mar 2017 16:06:13 +0000
Received: from localhost ([127.0.0.1] helo=postgresql.org)
	by malur.postgresql.org with smtp (Exim 4.84_2)
	(envelope-from
 <pgsql-docs-owner+M9144=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
	id 1coBRF-0006bx-4F
	for pgsql-docs@arkaria.postgresql.org; Wed, 15 Mar 2017 16:06:13 +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_SHA384:256)
	(Exim 4.84_2)
	(envelope-from <alvherre@alvh.no-ip.org>)
	id 1coBQr-0005Wy-DI
	for pgsql-docs@postgresql.org; Wed, 15 Mar 2017 16:05:49 +0000
Received: from smtprelay0217.b.hostedemail.com ([64.98.42.217]
 helo=smtprelay.b.hostedemail.com)
	by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256)
	(Exim 4.84_2)
	(envelope-from <alvherre@alvh.no-ip.org>)
	id 1coBQn-0006MG-Qu
	for pgsql-docs@postgresql.org; Wed, 15 Mar 2017 16:05:48 +0000
Received: from filter.hostedemail.com (10.5.19.248.rfc1918.com [10.5.19.248])
	by smtprelay01.b.hostedemail.com (Postfix) with ESMTP id 783E92D2B71
	for <pgsql-docs@postgresql.org>; Wed, 15 Mar 2017 16:05:43 +0000 (UTC)
X-Session-Marker: 616C76686572726540616C76682E6E6F2D69702E6F7267
X-Spam-Summary: 
 50,0,0,,d41d8cd98f00b204,alvherre@alvh.no-ip.org,:,RULES_HIT:41:355:379:960:967:973:988:989:1042:1260:1277:1311:1312:1313:1314:1345:1381:1437:1515:1516:1518:1519:1534:1542:1593:1594:1595:1596:1711:1712:1730:1747:1777:1792:1801:2194:2199:2393:2525:2565:2682:2685:2828:2859:2933:2937:2939:2942:2945:2947:2951:2954:3022:3138:3139:3140:3141:3142:3353:3865:3866:3867:3868:3870:3871:3874:3934:3936:3938:3941:3944:3947:3950:3953:3956:3959:4037:4605:5007:6261:6659:7903:8634:8784:8957:8985:9010:9025:9121:10004:10400:10848:11233:11658:11914:12043:12555:12663:12679:13161:13180:13229:13439:13894:13895:14181:14721:21067:21080:21451:30054,0,RBL:none,CacheIP:none,Bayesian:0.5,0.5,0.5,Netcheck:none,DomainCache:0,MSF:not
 bulk,SPF:fn,MSBL:0,DNSBL:none,Custom_rules:0:0:0,LFtime:2,LUA_SUMMARY:none
X-HE-Tag: bear45_883569d2e9251
X-Filterd-Recvd-Size: 3088
Received: from alvin.alvh.no-ip.org (unknown [190.217.209.181])
	(Authenticated sender: alvherre@alvh.no-ip.org)
	by omf11.b.hostedemail.com (Postfix) with ESMTPA
	for <pgsql-docs@postgresql.org>; Wed, 15 Mar 2017 16:05:30 +0000 (UTC)
Received: by alvin.alvh.no-ip.org (Postfix, from userid 1000)
	id BE1237CA; Wed, 15 Mar 2017 13:05:25 -0300 (CLST)
Date: Wed, 15 Mar 2017 13:05:25 -0300
From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: Pg Docs <pgsql-docs@postgresql.org>
Subject: <indexterm> with <secondary>
Message-ID: <20170315160525.42x4wxtdhk3sa522@alvherre.pgsql>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
User-Agent: NeoMutt/20170206-195-7adf12 (1.7.2)
X-Pg-Spam-Score: -1.9 (-)
List-Archive: <http://archives.postgresql.org/pgsql-docs>
List-Help: <mailto:majordomo@postgresql.org?body=help>
List-ID: <pgsql-docs.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@postgresql.org>
List-Post: <mailto:pgsql-docs@postgresql.org>
List-Subscribe: <mailto:majordomo@postgresql.org?body=sub%20pgsql-docs>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
X-Mailing-List: pgsql-docs
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

While reviewing Tomas' extended statistics patch I noticed that the new
docbook toolchain produces additional links for each indexterm, based on
the <secondary> tags there are.  For instance, in 9.5 I see this:

statistics, Aggregate Functions, The Statistics Collector
    of the planner, Statistics Used by the Planner, Updating Planner Statistics
https://www.postgresql.org/docs/9.5/static/bookindex.html#AEN186176

while in 10 I see this for the same source:

statistics, Aggregate Functions, Statistics Used by the Planner, Updating Planner Statistics, The Statistics Collector
    of the planner, Statistics Used by the Planner, Updating Planner Statistics
https://www.postgresql.org/docs/devel/static/bookindex.html#indexdiv-S

Note that the links for entries on the <secondary>of the planner</> also
show up in the first list of links.

Is this intended?  As we get more <secondary> entries, this gets busy
real quick, for no gain that I can see.  For instance, I added this
entry:

  <indexterm zone="extended-statistics">
   <primary>statistics</primary>
   <secondary>of the planner</secondary>
   <tertiary>extended</tertiary>
  </indexterm>

and this results in:

statistics, Aggregate Functions, Statistics Used by the Planner, Updating Planner Statistics, The Statistics Collector, Extended Statistics
    of the planner, Statistics Used by the Planner, Updating Planner Statistics, Extended Statistics
        extended, Extended Statistics

which seems altogether excessive.  Perhaps this is a bug in the index
generation?


FWIW I'm leaning towards removing the <tertiary> in the new entry, which
results in this:

statistics, Aggregate Functions, Statistics Used by the Planner, Updating Planner Statistics, The Statistics Collector, Extended Statistics
    of the planner, Statistics Used by the Planner, Updating Planner Statistics, Extended Statistics

I think this would be better:

statistics, Aggregate Functions, The Statistics Collector
    of the planner, Statistics Used by the Planner, Updating Planner Statistics, Extended Statistics

-- 
Álvaro Herrera                         Developer, https://www.PostgreSQL.org/
Licensee shall have no right to use the Licensed Software
for productive or commercial use. (Licencia de StarOffice 6.0 beta)


-- 
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs