From owner-freebsd-doc  Mon Mar  4 23:13:19 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from nothing-going-on.demon.co.uk (pc-62-31-42-140-hy.blueyonder.co.uk [62.31.42.140])
	by hub.freebsd.org (Postfix) with ESMTP id 8600337B400
	for <doc@FreeBSD.org>; Mon,  4 Mar 2002 23:13:14 -0800 (PST)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id g24IhFq29722;
	Mon, 4 Mar 2002 18:43:15 GMT
	(envelope-from nik)
Date: Mon, 4 Mar 2002 18:43:15 +0000
From: Nik Clayton <nik@freebsd.org>
To: Ceri <setantae@submonkey.net>
Cc: doc@FreeBSD.org
Subject: Re: The FAQ and IndexTerm
Message-ID: <20020304184314.E29209@canyon.nothing-going-on.org>
References: <20020301161045.GA43649@submonkey.net>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-md5;
	protocol="application/pgp-signature"; boundary="Lb0e7rgc7IsuDeGj"
Content-Disposition: inline
User-Agent: Mutt/1.2.5.1i
In-Reply-To: <20020301161045.GA43649@submonkey.net>; from setantae@submonkey.net on Fri, Mar 01, 2002 at 04:10:45PM +0000
Organization: FreeBSD Project <URL:http://www.freebsd.org/>
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


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

On Fri, Mar 01, 2002 at 04:10:45PM +0000, Ceri wrote:
> According to http://www.docbook.org/tdg/en/html/indexterm.html, the index=
term
> element is not valid within <qandaentry> tags, which as I understand (and=
 I
> could be very wrong) leaves me with the only way of doing this to be addi=
ng
> IndexTerm ranges as described on the same page.

Put the indexterms inside the <question> or <answer> elements.

    <qandaset>
      <qandaentry>
        <question id=3D"foo-frobbing">
	  <indexterm>
	    <primary>foo</primary>
	    <secondary>frobbing</secondary>
          </indexterm>

	  <para>How do I frob the foo device?</para>
        </question>

	<answer>
	  <para>Frob the foo device by. . .</para>
        </answer>
      </qandaentry>

      ...
    </qandaset>

which is valid DocBook (but I haven't tested it to see what the output
looks like.

N
--=20
FreeBSD: The Power to Serve      http://www.freebsd.org/               (__)
FreeBSD Documentation Project    http://www.freebsd.org/docproj/    \\\'',)
                                                                      \/  \=
 ^
   --- 15B8 3FFC DDB4 34B0 AA5F  94B7 93A8 0764 2C37 E375 ---         .\._/=
_)

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

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

iEYEARECAAYFAjyDwEEACgkQk6gHZCw343UgKQCfdXeIRQ9khTAgQnrcJLTSslUN
vloAn2vSlKr6ABjaOo3cLjKDpdHXVEt/
=dnGD
-----END PGP SIGNATURE-----

--Lb0e7rgc7IsuDeGj--

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