|
From: Gregory L. <gle...@cu...> - 2001-05-24 17:47:06
|
On 24 May 2001 18:25:06 +0100, László Kovács wrote:
> Gregory Leblanc wrote:
> >
> > On 24 May 2001 16:37:59 +0100, Mary Dwyer wrote:
> > > Laszlo Kovacs wrote:
> > > > >
> > > > > 2. If an indexterm occurs more than once in the original document then will
> > > > > result in a duplicate entry such as this eg.
> > > > > <primary>
> > > > > <title linkid="idx-a2" id="id10715">Panel</title>
> > > > > <title linkid="idx-a9" id="id10715">Panel</title>
> > > > >
> > > > > - this is not ideal, but not sure how to get round this.
> > > > We probably need to find some solution for this. Is this like there are
> > > > actually two different Panel descriptions in the text? Because if yes
> > > > then the document is probably incorrectly written.
> > >
> > > - yes, it's because there are two indexterm entries in the original document as
> > > follows:
> > > <indexterm id="idx-a2"><primary>Panel</primary></indexterm>
> > > <indexterm id="idx-a9"><primary>Panel</primary></indexterm>
> > >
> > > granted, in a correctly written help document this shouldn't occur ...
> >
> > That's clearly not correct. Open up a book that you have which contains
> > an index, and you'll see a very large number of index terms that show up
> > on multiple pages. Usually something like
> >
> > Cats, Big.... 13, 25, 256
> >
> > So this is not a error in the document, as far as I'm concerned.
> > Greg
>
> Yeah, I was probably to tired. It is correct of course. It raises a
> couple of issues though.
>
> 1. I wonder how we implement this in the GUI.
Dunno, I'm not a GUI designer. :-)
> 2. If we have a See Also: Panel, then to which Panel definition we jump.
Ah, that one is easy (erm, I think it's easy)! You don't like to an
entry in the document, you link the the Index entry for the Panel.
Didn't GNOME recruit some indexing professionals to do some volunteer
work? Can we sucker^W volunteer them for this discussion?
Greg
--
Troll, troll, troll your post
Gently down the feed
Merrily, merrily troll along
A life is what you need...
|