Re: [Rfc-markdown] [xml2rfc] New xml2rfc release: v2.31.0

Henrik Levkowetz <henrik@levkowetz.com> Wed, 25 September 2019 21:09 UTC

Return-Path: <henrik@levkowetz.com>
X-Original-To: rfc-markdown@ietfa.amsl.com
Delivered-To: rfc-markdown@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 0128A1207FD; Wed, 25 Sep 2019 14:09:17 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-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 LWlvVHQAr_oM; Wed, 25 Sep 2019 14:09:15 -0700 (PDT)
Received: from zinfandel.tools.ietf.org (zinfandel.tools.ietf.org [IPv6:2001:1890:126c::1:2a]) (using TLSv1.2 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id C156C12022C; Wed, 25 Sep 2019 14:09:15 -0700 (PDT)
Received: from h-202-242.a357.priv.bahnhof.se ([158.174.202.242]:52828 helo=tannat.localdomain) by zinfandel.tools.ietf.org with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.80) (envelope-from <henrik@levkowetz.com>) id 1iDEXC-0005Ec-Ni; Wed, 25 Sep 2019 14:09:15 -0700
To: Robert Moskowitz <rgm@htt-consult.com>, xml2rfc-dev@ietf.org, xml2rfc@ietf.org
References: <E1iDE6u-0004WP-Ev@durif.tools.ietf.org> <445c7666-57bb-cb3b-f95e-e2186aea92a7@htt-consult.com>
Cc: rfc-markdown@ietf.org
From: Henrik Levkowetz <henrik@levkowetz.com>
Message-ID: <0b295bd9-8f2a-6eb9-bf04-911f5635aeab@levkowetz.com>
Date: Wed, 25 Sep 2019 23:09:06 +0200
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:45.0) Gecko/20100101 Thunderbird/45.8.0
MIME-Version: 1.0
In-Reply-To: <445c7666-57bb-cb3b-f95e-e2186aea92a7@htt-consult.com>
Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="UqOvv7TkHCdI9aSmqKo8IaeA4CsnHFVNu"
X-SA-Exim-Connect-IP: 158.174.202.242
X-SA-Exim-Rcpt-To: rfc-markdown@ietf.org, xml2rfc@ietf.org, xml2rfc-dev@ietf.org, rgm@htt-consult.com
X-SA-Exim-Mail-From: henrik@levkowetz.com
X-SA-Exim-Version: 4.2.1 (built Mon, 26 Dec 2011 16:24:06 +0000)
X-SA-Exim-Scanned: Yes (on zinfandel.tools.ietf.org)
X-Clacks-Overhead: GNU Terry Pratchett
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/h_0YpBN8CnhkVQHOQFOofN5lVNk>
Subject: Re: [Rfc-markdown] [xml2rfc] New xml2rfc release: v2.31.0
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "rfc-markdown is a discussion list for people writing I-Ds and RFCs in Markdown and the authors of the tools used for that." <rfc-markdown.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-markdown/>
List-Post: <mailto:rfc-markdown@ietf.org>
List-Help: <mailto:rfc-markdown-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 25 Sep 2019 21:09:18 -0000

Hi Bob,

On 2019-09-25 22:56, Robert Moskowitz wrote:
> This does not fix my character problem (probably was not intended to do 
> that):
> 
> $ xml2rfc draft-moskowitz-hip-new-crypto-01.xml
> Warning: Illegal character replaced in string: &#128;
> Warning: Illegal character replaced in string: &#147;
>   Created file draft-moskowitz-hip-new-crypto-01.txt

No, this release addressed some issues raised by the RFC-Editor staff.

FWIW, if you intend to move to v3, the seriesInfo name (where the
problem is, in this case) will not allow non-ASCII characters.  The
most straightforward approach is to include the reference information
in your document directly, and replace the unicode en-dash with an
ASCII dash:

<reference anchor='ASIACRYPT-2017' >
  <front>
    <title>Full-State Keyed Duplex with Built-In Multi-user Support</title>
    <author initials="J." surname="Daemen" fullname="Joan Daemen">
      <organization></organization>
    </author>
    <author initials="B." surname="Mennink" fullname="Bart Mennink">
      <organization></organization>
    </author>
    <author initials="G." surname="Van Assche" fullname="Gilles Van Assche">
      <organization></organization>
    </author>
    <date year="2017"/>
  </front>
  <seriesInfo name="Advances in Cryptology - ASIACRYPT 2017" value="pp. 606-637"/>
  <seriesInfo name="DOI" value="10.1007/978-3-319-70697-9_21"/>
</reference>

The more general solution (which isn't available immediately) is that the
bibxml7 script is modified to transcode non-ASCII punctuation to ASCII
equivalents.

xml2rfc does this for body text, to avoid unnecessary issues with smart
quotes etc., but it does not look at attribute values in reference entries
when doing this.  I don't know, maybe it should.  Or maybe not.


Regards,

	Henrik



> 
> $ xml2rfc --version
> xml2rfc 2.31.0
> 
> 
> On 9/25/19 4:42 PM, Henrik Levkowetz wrote:
>> Hi,
>>
>> This is an automatic notification about a new xml2rfc release,
>> v2.31.0, generated when running the mkrelease script.
>>
>> Release notes:
>>
>> xml2rfc (2.31.0) ietf; urgency=medium
>>
>>    This release adds a feature to help with conditional line breaking
>>    inside table cells, and tweaks the layout of text in cells slightly.  It
>>    also fixes an incorrect line-break point and second-line indentation for
>>    long section titles in the v3 text formatter.  From the commit log:
>>
>>    * Fixed an issue with leading and trailing space padding in table cells,
>>      and refined it to consider the alignment setting.
>>
>>    * Modified the text formatter to accept &zwsp; as a potential line-break
>>      point.
>>
>>    * Included zwsp in allowed special characters (in addition to nbsp, nbhy,
>>      word-joiner and line-separator).
>>
>>    * Fixed the line-breaking and second-line indentation of section titles
>>      in v3 text output.
>>
>>    * The start of an emacs nXML mode schema which explicitly mentions
>>      xinclud in a couple of places.
>>
>>    * Removed code left in pdf.py by mistake, and set options.pdf=True when
>>      in the PdfWriter.
>>
>>   -- Henrik Levkowetz <henrik@levkowetz.com>  25 Sep 2019 13:38:34 -0700
>>
>> The preferred way to install xml2rfc is by doing 'pip install xml2rfc',
>> and 'pip install --upgrade xml2rfc' to upgrade.  If there are system-
>> installed python modules which pip will not upgrade, you may have to
>> use 'pip install --upgrade --no-deps xml2rfc' and install dependencies
>> manually.
>>
>> The new version is also available through SVN checkout, with
>>    'svn checkout http://svn.tools.ietf.org/svn/tools/xml2rfc/tags/cli/2.31.0'
>>
>> Regards,
>>
>> 	Henrik
>> 	(via the mkrelease script)
>>
>> _______________________________________________
>> xml2rfc mailing list
>> xml2rfc@ietf.org
>> https://www.ietf.org/mailman/listinfo/xml2rfc
> 
>