RE: [dita] treating index-see as index-see-also

["Esrig, Bruce \(Bruce\)" <esrig@lucent.com>]

Do we have a set of scenarios in which it makes sense to treat an
index-see as an index-see-also? I tried to construct one, and had
difficulty.

The question has to do with the root cause for the clash. Is the root
cause a disagreement (or unintentional inconsistency) over what term to
use? Is it an erroneous use in one place compared with another?

A viable scenario should show a sequence of source materials being
processed, an intended behavior implemented by processing, and the
resulting output. There would need to be more than one scenario in order
to show different ways that a clash could arise.

Best wishes,

Bruce Esrig

-----Original Message-----
From: Grosso, Paul [mailto:pgrosso@ptc.com] 
Sent: Monday, October 02, 2006 4:28 PM
To: dita@lists.oasis-open.org
Subject: [dita] indexterm proposed wording

Proposed additional wording for indexterm.

> -----Original Message-----
> From: Grosso, Paul [mailto:pgrosso@ptc.com]
> Sent: Tuesday, 2006 September 26 11:37
> To: dita@lists.oasis-open.org
> Subject: RE: [dita] review of index* elements

> > indexterm
> > ---------

> Issue:  What if an an indexterm contains both an index-see and an 
> index-see-also.
> 
> Proposed resolution:
> 
> It is an error if an indexterm contains both an index-see and an 
> index-see-also.  An implementation may (but need
> not) give an error message, and may (but need not) recover by treating

> the index-see as an index-see-also (in which case the page number 
> where the index-see-also occurred will also appear in the index 
> entry).
> 
> ACTION to Paul:  Provide suggested wording.

Add as the final para of the first section:

It is an error if an indexterm containing no indexterm children contains
both an index-see and an index-see-also.  (Note:
index-see and index-see-also elements within indexterms that do contain
indexterm children are ignored.)  In the case of this error condition,
an implementation may (but need
not) give an error message, and may (but need not) recover by treating
all such index-see elements as index-see-also elements.