Re: [Xml-sg-cmt] index question

[Peter Saint-Andre <[e-mail]>]

Hi Sandy!

On 3/12/21 3:24 PM, Sandy Ginoza wrote:
> Hi team,
> 
> draft-ietf-extra-imap4rev2-30, which is currently in our queue, contains an index.  As noted in ticket 603, xml2rfc crashes when making the PDF file.  Temporarily, we have removed “$” from the <iref>s so we’re able to create the PDF.  
> 
>    https://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/603
> 
> Please note I changed the priority of 603 to critical (it’s not yet a blocker).
> We also see <https://trac.tools.ietf.org/tools/xml2rfc/trac/ticket/418> related to index.
> 
> Looking at the index in the output files, we have a few questions/comments.  See
> https://www.rfc-editor.org/rfc/v3test/test-index-ietf-extra-imap4rev2-30.html#name-index
> 
> a) Does the index look as expected?  The terms appear twice, once as text and once as a link.  

Yes, that seems off - we'd want one instance but linked.

> b) In the text, the index is formatted differently.  Also, I think the index needs to be present so the content in the various outputs is the same, but the index is essentially useless because there are no links and no page numbers.  

Naturally we can't include links in the TXT files, but page numbers are
essential. :-)

> c) The index does not appear in the toc; I’ll file a ticket for this. 

Thanks.

Peter