From owner-freebsd-doc  Mon Nov 26  8:40:41 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from mao.stokely.org (mao.stokely.org [65.84.64.228])
	by hub.freebsd.org (Postfix) with ESMTP id AD2A837B416
	for <doc@FreeBSD.org>; Mon, 26 Nov 2001 08:40:25 -0800 (PST)
Received: by mao.stokely.org (Postfix, from userid 2074)
	id A8C8B4B65D; Mon, 26 Nov 2001 08:40:19 -0800 (PST)
Date: Mon, 26 Nov 2001 08:40:19 -0800
From: Murray Stokely <murray@FreeBSD.org>
To: setantae <setantae@submonkey.net>
Cc: doc@FreeBSD.org
Subject: Re: indexterm
Message-ID: <20011126084019.L10670@windriver.com>
References: <20011126153059.GA3648@rhadamanth>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-md5;
	protocol="application/pgp-signature"; boundary="R6sEYoIZpp9JErk7"
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <20011126153059.GA3648@rhadamanth>; from setantae@submonkey.net on Mon, Nov 26, 2001 at 03:30:59PM +0000
X-GPG-Key-ID: 1024D/0E451F7D
X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B  3CB5 B4D7 10A2 0E45 1F7D
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


--R6sEYoIZpp9JErk7
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Mon, Nov 26, 2001 at 03:30:59PM +0000, setantae wrote:
> Can I use anything I like within indexterm ?

  No.  You must use <primary>, <secondary>, <tertiary>, <see>, or
<seealso>.  See http://www.docbook.org/tdg/en/html/indexterm.html for
the complete semantics.

  Inside those tags you can use additional markup, such as <command>
so that we could perhaps have commands followed by ", command" in
the index as is popular in some American technical books (and Greg
Lehey's Complete FreeBSD).

> For example, if the below was committed :
>=20
> 	<indexterm>
> 	  <primary>Foo</primary>
> 	  <secondary>Bar</secondary>
> 	  <secondary>Quux</secondary>
> 	</indexterm>
>=20
> would it break anything ?

  You could always just try. ;)  I don't think this will validate.
You need a separate indexterm/primary for each secondary.  Even if
that primary is identical.

     - Murray

--R6sEYoIZpp9JErk7
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (SunOS)
Comment: For info see http://www.gnupg.org

iD8DBQE8AnBytNcQog5FH30RApTdAJ4o2aX8OAAeCUuTklLjpow85HE2kACgwuu1
6lwWmTTbn/8gbvKuQQiz9sE=
=WI+2
-----END PGP SIGNATURE-----

--R6sEYoIZpp9JErk7--

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message