[Xml-sg-cmt] index question

Sandy Ginoza <sginoza@amsl.com> Fri, 12 March 2021 22:24 UTC

Return-Path: <sginoza@amsl.com>
X-Original-To: xml-sg-cmt@ietfa.amsl.com
Delivered-To: xml-sg-cmt@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 27E453A1681 for <xml-sg-cmt@ietfa.amsl.com>; Fri, 12 Mar 2021 14:24:30 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id ow9bTNZI3BCP for <xml-sg-cmt@ietfa.amsl.com>; Fri, 12 Mar 2021 14:24:27 -0800 (PST)
Received: from mail.amsl.com (c8a.amsl.com [4.31.198.40]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 55A633A1679 for <xml-sg-cmt@ietf.org>; Fri, 12 Mar 2021 14:24:27 -0800 (PST)
Received: from localhost (localhost [127.0.0.1]) by c8a.amsl.com (Postfix) with ESMTP id 39C0E389888 for <xml-sg-cmt@ietf.org>; Fri, 12 Mar 2021 14:24:27 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
Received: from c8a.amsl.com ([127.0.0.1]) by localhost (c8a.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id UNUjoRp6mQfA for <xml-sg-cmt@ietf.org>; Fri, 12 Mar 2021 14:24:27 -0800 (PST)
Received: from 2603-8000-9603-b513-b862-8e2e-1fd2-5e3e.res6.spectrum.com (2603-8000-9603-b513-b862-8e2e-1fd2-5e3e.res6.spectrum.com [IPv6:2603:8000:9603:b513:b862:8e2e:1fd2:5e3e]) by c8a.amsl.com (Postfix) with ESMTPSA id 1C3403815B9 for <xml-sg-cmt@ietf.org>; Fri, 12 Mar 2021 14:24:27 -0800 (PST)
From: Sandy Ginoza <sginoza@amsl.com>
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\))
Message-Id: <7133140B-73BE-4301-8AD8-7A085994AA15@amsl.com>
Date: Fri, 12 Mar 2021 14:24:27 -0800
To: XML weed whackers <xml-sg-cmt@ietf.org>
X-Mailer: Apple Mail (2.3273)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml-sg-cmt/lbnir0cQ2KN3riH-8PwxFZVcD7M>
Subject: [Xml-sg-cmt] index question
X-BeenThere: xml-sg-cmt@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Working list for the xml and style guide change management team <xml-sg-cmt.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml-sg-cmt>, <mailto:xml-sg-cmt-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml-sg-cmt/>
List-Post: <mailto:xml-sg-cmt@ietf.org>
List-Help: <mailto:xml-sg-cmt-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml-sg-cmt>, <mailto:xml-sg-cmt-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 12 Mar 2021 22:24:30 -0000

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.  

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.  

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


Partially formatted v3 files are here: 

https://www.rfc-editor.org/rfc/v3test/test-index-ietf-extra-imap4rev2-30.html
https://www.rfc-editor.org/rfc/v3test/test-index-ietf-extra-imap4rev2-30.pdf
https://www.rfc-editor.org/rfc/v3test/test-index-ietf-extra-imap4rev2-30.txt
https://www.rfc-editor.org/rfc/v3test/test-index-ietf-extra-imap4rev2-30.xml


Thanks,
Sandy