Re: DOCBOOK: Tertiaryie Error

[Norman Walsh <ndw at nwalsh dot com>]

/ Todd Babinski <todd.babinski@dynetics.com> was heard to say:
| I am using DocBook v4.1 (SGML) with v1.57 of the stylesheets.  I am
| working on a document and am constructing the index by hand since I do
| not want to rely on having Perl installed on every machine in order to
| construct the index.  All was going well until I got an odd error and I
| cannot figure out what is going wrong.
| 
| Here is a sample of what I have:
|     <indexentry>
|       <primaryie>Commands</primaryie>
|         <secondaryie>Help Stuff, see <xref
| linkend="hmcommands"></secondaryie> 
|           <tertiaryie>activate, see <xref
| linkend="activatep"></tertiaryie>
|        ...
| 
| The error I am getting for the tertiaryie line is the message:
| 	xref to COMMAND unsupported

The xref element requires the stylesheets to generate text, and the
stylesheets don't know what to generate for xrefs to a command. I
suppose the name of the command is the obvious thing. But in an index,
'see' should probably point to another index entry. And I would have
expected you to code the index like this:

     <indexentry>
       <primaryie>Commands</primaryie>
         <secondaryie>Help Stuff</secondaryie>
           <seeie>whatever indexentry has hmcommands in it</seeie>
           <tertiaryie>activate</tertiaryie>
           <seeie>whatever indexentry has activatep in it</seeie>
     </indexentry>

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | No one gossips about other
http://www.oasis-open.org/docbook/ | people's secret virtues.--Bertrand
Chair, DocBook Technical Committee | Russell