Received: from localhost (unknown [200.46.204.182])
	by postgresql.org (Postfix) with ESMTP id 90ED59FB6F4
	for <pgsql-docs-postgresql.org@postgresql.org>;
	Thu, 30 Aug 2007 17:15:43 -0300 (ADT)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.204.182]) (amavisd-maia, port 10024)
	with ESMTP id 83100-04 for <pgsql-docs-postgresql.org@postgresql.org>;
	Thu, 30 Aug 2007 17:15:28 -0300 (ADT)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.5
Received: from momjian.us (momjian.us [70.90.9.53])
	by postgresql.org (Postfix) with ESMTP id F1B789FB7C2
	for <pgsql-docs@postgresql.org>; Thu, 30 Aug 2007 17:15:30 -0300 (ADT)
Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id l7UKFVO16372
	for pgsql-docs@postgresql.org; Thu, 30 Aug 2007 16:15:31 -0400 (EDT)
From: Bruce Momjian <bruce@momjian.us>
Message-Id: <200708302015.l7UKFVO16372@momjian.us>
Subject: Why does SGML <indexterm> use zone=?
To: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Date: Thu, 30 Aug 2007 16:15:31 -0400 (EDT)
X-Mailer: ELM [version 2.4ME+ PL123]
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Archive-Number: 200708/47
X-Sequence-Number: 4394

I see many places in the SGML docs that we do:

   <indexterm zone="functions-info">
    <primary>user</primary>
    <secondary>current</secondary>
   </indexterm>

In almost every case the "zone" tag has the same name as the section it
is in.  However, there are other cases that have no "zone" tag and they
default to the section they are in.  What I am wondering is why we
specify "zone" at all?  Why not just let it default to the section name?
Seems that would make writing and editing easier.

The SGML docs at:

	http://www.oasis-open.org/docbook/documentation/reference/html/indexterm.html

Say:

	Zone
	
	    The use of Zone implies a spanning index entry. Zone holds the IDs
	of the elements to which it applies. The IndexTerm applies to the
	contents of the entire element(s) to which it points. If Zone is used,
	the phyiscal placement of the IndexTerm in the flow of the document is
	irrelavant.


It seems "zone" is for cases where you want to specify index terms
outside of the main document flow, but we don't do that.

-- 
  Bruce Momjian  <bruce@momjian.us>          http://momjian.us
  EnterpriseDB                               http://www.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +