From nobody Thu May 11 13:37:11 2017 Return-Path: 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 AA552129C56 for ; Thu, 11 May 2017 13:37:09 -0700 (PDT) X-Virus-Scanned: amavisd-new at amsl.com X-Spam-Flag: NO X-Spam-Score: -1.5 X-Spam-Level: X-Spam-Status: No, score=-1.5 tagged_above=-999 required=5 tests=[BAYES_50=0.8, RCVD_IN_DNSWL_MED=-2.3] 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 5yHpIJ9C8Xws for ; Thu, 11 May 2017 13:37:07 -0700 (PDT) Received: from mailhost.informatik.uni-bremen.de (mailhost.informatik.uni-bremen.de [IPv6:2001:638:708:30c9::12]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 92F941274D0 for ; Thu, 11 May 2017 13:31:28 -0700 (PDT) X-Virus-Scanned: amavisd-new at informatik.uni-bremen.de Received: from submithost.informatik.uni-bremen.de (submithost.informatik.uni-bremen.de [134.102.201.11]) by mailhost.informatik.uni-bremen.de (8.14.5/8.14.5) with ESMTP id v4BKVO9I005589 for ; Thu, 11 May 2017 22:31:24 +0200 (CEST) Received: from client-0238.vpn.uni-bremen.de (client-0238.vpn.uni-bremen.de [134.102.107.238]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by submithost.informatik.uni-bremen.de (Postfix) with ESMTPSA id 3wP4Wc45R7zDHDs; Thu, 11 May 2017 22:31:24 +0200 (CEST) From: Carsten Bormann Content-Type: text/plain; charset=utf-8 X-Mao-Original-Outgoing-Id: 516227483.777429-2484fd417deaf4417ef33feb56b1bede Content-Transfer-Encoding: quoted-printable Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) Date: Thu, 11 May 2017 22:31:23 +0200 Message-Id: <7A4DF5E7-2DE0-4F23-A757-718C0C58B657@tzi.org> To: RFC Markdown X-Mailer: Apple Mail (2.3273) Archived-At: Subject: [Rfc-markdown] kramdown-rfc2629 now has "kdrfc" tool X-BeenThere: rfc-markdown@ietf.org X-Mailman-Version: 2.1.22 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." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 11 May 2017 20:37:10 -0000 Version 1.2.0 of the kramdown-rfc2629 gem features a tool called = =E2=80=9Ckdrfc=E2=80=9D. You feed it a .md (or a .mkd) and it makes a .txt for you: $ kdrfc mydraft.md $ (Now there is a mydraft.txt to behold.) One nice feature is that you don=E2=80=99t have to have xml2rfc = installed for that: The tool falls back to the online version if the local xml2rfc call = cannot find xml2rfc. (The online version is usually only a second or so slower if you have = decent connectivity. The only real disadvantage is that any error messages from xml2rfc look = a bit weird.) $ kdrfc Usage: kdrfc [options] file.md|file.mkd|file.xml -v, --[no-]verbose Run verbosely -r, --[no-]remote Run xml2rfc remotely even if there = is a local one -x, --[no-]xml Convert to xml only This tool is laughably simple, but it still might make the life of some = of us a bit less painful. Update to 1.2.0 as usual: $ gem update Feedback welcome. Gr=C3=BC=C3=9Fe, Carsten From nobody Wed May 31 05:36:46 2017 Return-Path: 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 3B7C8129BD7 for ; Wed, 31 May 2017 05:36:44 -0700 (PDT) X-Virus-Scanned: amavisd-new at amsl.com X-Spam-Flag: NO X-Spam-Score: -4.199 X-Spam-Level: X-Spam-Status: No, score=-4.199 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_MED=-2.3] 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 WaH24ouUs7BJ for ; Wed, 31 May 2017 05:36:41 -0700 (PDT) Received: from mailhost.informatik.uni-bremen.de (mailhost.informatik.uni-bremen.de [IPv6:2001:638:708:30c9::12]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id B418912946D for ; Wed, 31 May 2017 05:36:40 -0700 (PDT) X-Virus-Scanned: amavisd-new at informatik.uni-bremen.de Received: from submithost.informatik.uni-bremen.de (submithost.informatik.uni-bremen.de [134.102.201.11]) by mailhost.informatik.uni-bremen.de (8.14.5/8.14.5) with ESMTP id v4VCaZJL000045 for ; Wed, 31 May 2017 14:36:35 +0200 (CEST) Received: from client-0118.vpn.uni-bremen.de (client-0118.vpn.uni-bremen.de [134.102.107.118]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by submithost.informatik.uni-bremen.de (Postfix) with ESMTPSA id 3wd92W4QRWzDHyk; Wed, 31 May 2017 14:36:35 +0200 (CEST) From: Carsten Bormann Content-Type: multipart/alternative; boundary="Apple-Mail=_D24C7DB4-BA15-45D7-900E-E61870C87996" X-Mao-Original-Outgoing-Id: 517926994.911122-638f9586cb6ebf6ba0ef89a9a0384260 Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) Date: Wed, 31 May 2017 14:36:35 +0200 Message-Id: References: To: RFC Markdown X-Mailer: Apple Mail (2.3273) Archived-At: Subject: [Rfc-markdown] Fwd: New xml2rfc release: v2.6.0 X-BeenThere: rfc-markdown@ietf.org X-Mailman-Version: 2.1.22 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." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 May 2017 12:36:44 -0000 --Apple-Mail=_D24C7DB4-BA15-45D7-900E-E61870C87996 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 This release marks a new version of xml2rfc after a long time with no = updates. A quick smoke test I did didn=E2=80=99t uncover any problems with = kramdown-rfc, and I look forward in particular to much fewer bugs in the = HTML generation. If you used pip to install xml2rfc, upgrade with: pip install --upgrade xml2rfc If you are using Martin Thomson=E2=80=99s github template, the CI = platforms should automatically use this new version from this moment, so = not updating on your laptop isn=E2=80=99t really a very useful option. Gr=C3=BC=C3=9Fe, Carsten > Begin forwarded message: >=20 > From: Henrik Levkowetz > > Subject: [codesprints] New xml2rfc release: v2.6.0 > Date: May 31, 2017 at 14:07:26 GMT+2 >=20 > Hi, >=20 > This is an automatic notification about a new xml2rfc release,=20 > v2.6.0, generated when running the mkrelease script. >=20 > Release notes: >=20 > xml2rfc (2.6.0) ietf; urgency=3Dmedium > * The implementation of the 'authorship' PI in the original TCL tool = would > suppress the Author's Address section when set to "no", while in = the > current implementation it removed author information on the first = page. > Changed to the original semantics. Also author organisation = handling on > the first page changed to use the submissionType setting to trigger = the > behaviour described in issue #311. Fixes issue #311 without = overlaying > this on the 'authorship' PI. > * Added a check for the 'needLines' PI within lists. > * Fixed a bug in the code for the 'sectionorphans' PI. Added a PI > 'tocpagebreak' to force a page break before the ToC. This, = together with > the fix for #311 and needLines within lists, lets xml2rfc produce > rfc7754.txt correctly from suitable xml without postprocessing. > * Tweaked the eref output in text mode to avoid generating extraneous=20= > space characters. Fixes issue #329. > * Merged in [2251] from ietf@augustcellars.com = : > Changed to use the emph character in spanex so that the same thing = happens > in both html and text if an unknown attribute is given. Fixes = issue #297" > * Merged in [2250] from ietf@augustcellars.com = , with tweaks: > Added code to emit sections in two sections, numbered and = un-numbered, > separately. Then emit the numbered appendixes, the index, the = unnumbered > appendixes, cref items, authors at the end of the document. Fixes = issue > #310. > * Merged in [2249] from ietf@augustcellars.com = : > If you have an xref or similar element in an annotation in a = reference, > any text that follows the xref is absent from the output HTML file. = Text > files emit correctly. Fixed the html generation. > * Merged in [2248] from ietf@augustcellars.com = :=20 > The HTML rendering for elements were inconsistent with the = text > rendering. Fixed this by doing something completely different than = is > called for in the bug report: > We follow the layout of what the V3 HTML document says to do. This > means that we use the child text of the xref when it exists to the > exclusion of any generated text. When the child text does not = exist > then we use the synthesized text string as the text for the anchor > element. In all cases the anchor element is emitted with an href = of the > target. Fixes issue #293. > * Merged in [2247] from ietf@augustcellars.com = : > Added true and false as legal values for the attribute numbered on = a > section.xml Fixes issue #313 > * Eliminated redundant PI parsing, now that each element carries the = local=20 > PI settings. > * Merged in patch from martin.thomson@gmail.com = , see ticket #307: > Fixed a problem where if there are no authors, references in HTML = are > badly formatted. Fixes issue #307 and #309. > * Merged in [2215] from ietf@augustcellars.com = , with some tweaks to make > things work under python 3.x: > Don't split special terms with embedded forward slash on the slash > character. Fixes issue #288. Also added code to deal with an = extra tab > in the middle of a sentence. > * Changed the handling of PIs such that each element in the parsed = xml=20 > tree holds the PI state at that point of the xml document. This = provides=20 > the ability to use different PI settings at different points in the=20= > document. This only makes sense for some PIs, though. The = following PIs=20 > will now be honoured if changed inside the document, in order to = provide=20 > more flexibility: 'multiple-initials', 'artworkdelimiter', = 'compact',=20 > 'subcompact', 'text-list-symbols', 'colonspace'. > * Honour the way double initials are given in the XML, with or = without=20 > interleaved spaces. See issue #303, which says of multiple = initials '...=20 > Expectation was that it would exactly match the initials attribute = in the=20 > XML' > * Merged in [2070] from ietf@augustcellars.com = : > Enabled the multiple-initial PI again. The code now also looks for = the PI > as the first element of the author element, to apply for that = author entry > only, with a default of 'no'. > * Merged in [2064] from ietf@augustcellars.com = : > Added handling for absent author initials for the html generator. > * Merged in [2062] from ietf@augustcellars.com = : > This commit provides support for multiple author initials. Fixes = issue > #303. Also fixes the issue of extra commas showing up when there = are no > initials, just a surname. > * Merged in [2059] from ietf@augustcellars.com = : > Changet to emit html not xhtml. Addresses issues #263 and #279. > * Updated additional test masters needed to make the tox tests pass, = and > changed the html encoding and decoding to use utf-8, to work with = the > unicode and utf-8 tests. > * Removed python 2.6 from tox texting (a previous commit added python = 3.5). > * Don't let the value of 'title' be None, make it an empty string if = that=20 > happens. Fixes issue #328 > * Someone might want to set hangIndent to zero. Test the value = against None > explicitly to permit this to succeed. > * Added an --utf8 switch to xml2rfc. In nroff mode, the output will=20= > contain utf-8 characters, not \[u8FD9] escapes; use groff with the = -Kutf8=20 > switch to process the resulting nroff. > * Removed all references to xml.resource.org = ; it is not useful for=20 > fallback purposes any more. >=20 > The new version is available through SVN checkout, with > 'svn checkout = http://svn.tools.ietf.org/svn/tools/xml2rfc/tags/cli/2.6.0' = >=20 > Regards, >=20 > Henrik > (via the mkrelease script) --Apple-Mail=_D24C7DB4-BA15-45D7-900E-E61870C87996 Content-Transfer-Encoding: quoted-printable Content-Type: text/html; charset=utf-8 This release marks a new version of xml2rfc after a long time = with no updates.

A = quick smoke test I did didn=E2=80=99t uncover any problems with = kramdown-rfc, and I look forward in particular to much fewer bugs in the = HTML generation.

If you used pip to install xml2rfc, upgrade with:

pip = install --upgrade xml2rfc

If you are using Martin Thomson=E2=80=99s github template, = the CI platforms should automatically use this new version from this = moment, so not updating on your laptop isn=E2=80=99t really a very = useful option.

Gr=C3=BC=C3=9Fe, Carsten


Begin = forwarded message:

From: = Henrik Levkowetz <henrik@levkowetz.com>
Subject: = [codesprints] New = xml2rfc release: v2.6.0
Date: = May 31, 2017 at 14:07:26 = GMT+2

Hi,

This is an automatic notification about a new = xml2rfc release,
v2.6.0, generated when running the = mkrelease script.

Release notes:

xml2rfc (2.6.0) ietf; urgency=3Dmedium
 * The implementation of the 'authorship' PI in the = original TCL tool would
   suppress the = Author's Address section when set to "no", while in the
=    current implementation it removed author information = on the first page.
   Changed to the = original semantics.  Also author organisation handling on
   the first page changed to use the = submissionType setting to trigger the
=    behaviour described in issue #311.  Fixes issue = #311 without overlaying
   this on the = 'authorship' PI.
 * Added a check for the = 'needLines' PI within lists.
 * Fixed a bug in the = code for the 'sectionorphans' PI. Added a PI
=    'tocpagebreak' to force a page break before the ToC. =  This, together with
   the fix for = #311 and needLines within lists, lets xml2rfc produce
=    rfc7754.txt correctly from suitable xml without = postprocessing.
 * Tweaked the eref output in text = mode to avoid generating extraneous
=    space characters.  Fixes issue #329.
=  * Merged in [2251] from ietf@augustcellars.com:
=    Changed to use the emph character in spanex so that = the same thing happens
   in both html and = text if an unknown attribute is given.  Fixes issue #297"
 * Merged in [2250] from ietf@augustcellars.com, with tweaks:
=    Added code to emit sections in two sections, numbered = and un-numbered,
   separately.  Then = emit the numbered appendixes, the index, the unnumbered
=    appendixes, cref items, authors at the end of the = document.  Fixes issue
   #310.
 * Merged in [2249] from ietf@augustcellars.com:
=    If you have an xref or similar element in an = annotation in a reference,
   any text = that follows the xref is absent from the output HTML file.  Text
   files emit correctly.  Fixed the html = generation.
 * Merged in [2248] from ietf@augustcellars.com:
=    The HTML rendering for <xref> elements were = inconsistent with the text
   rendering. =  Fixed this by doing something completely different than is
   called for in the bug report:
=    We follow the layout of what the V3 HTML document = says to do.  This
   means that we = use the child text of the xref when it exists to the
=    exclusion of any generated text.  When the child = text does not exist
   then we use the = synthesized text string as the text for the anchor
=    element.  In all cases the anchor element is = emitted with an href of the
   target. =  Fixes issue #293.
 * Merged in [2247] from ietf@augustcellars.com:
=    Added true and false as legal values for the attribute = numbered on a
   section.xml Fixes issue = #313
 * Eliminated redundant PI parsing, now that = each element carries the local
   PI = settings.
 * Merged in patch from martin.thomson@gmail.com, see ticket #307:
=    Fixed a problem where if there are no authors, = references in HTML are
   badly formatted. =  Fixes issue #307 and #309.
 * Merged in [2215] = from ietf@augustcellars.com, with some tweaks to make
   things work under python 3.x:
=    Don't split special terms with embedded forward slash = on the slash
   character.  Fixes = issue #288.  Also added code to deal with an extra tab
=    in the middle of a sentence.
 * = Changed the handling of PIs such that each element in the parsed xml
   tree holds the PI state at that point of = the xml document.  This provides
=    the ability to use different PI settings at different = points in the
   document.  This = only makes sense for some PIs, though.  The following PIs
   will now be honoured if changed inside the = document, in order to provide
   more = flexibility: 'multiple-initials', 'artworkdelimiter', 'compact',
   'subcompact', 'text-list-symbols', = 'colonspace'.
 * Honour the way double initials are = given in the XML, with or without
=    interleaved spaces.  See issue #303, which says = of multiple initials '...
   Expectation = was that it would exactly match the initials attribute in the
   XML'
 * Merged in = [2070] from ietf@augustcellars.com:
=    Enabled the multiple-initial PI again.  The code = now also looks for the PI
   as the first = element of the author element, to apply for that author entry
   only, with a default of 'no'.
=  * Merged in [2064] from ietf@augustcellars.com:
=    Added handling for absent author initials for the html = generator.
 * Merged in [2062] from ietf@augustcellars.com:
=    This commit provides support for multiple author = initials.  Fixes issue
   #303. =  Also fixes the issue of extra commas showing up when there are = no
   initials, just a surname.
 * Merged in [2059] from ietf@augustcellars.com:
=    Changet to emit html not xhtml.  Addresses issues = #263 and #279.
 * Updated additional test masters = needed to make the tox tests pass, and
=    changed the html encoding and decoding to use utf-8, = to work with the
   unicode and utf-8 = tests.
 * Removed python 2.6 from tox texting (a = previous commit added python 3.5).
 * Don't let the = value of 'title' be None, make it an empty string if that
=    happens.  Fixes issue #328
 * = Someone might want to set hangIndent to zero.  Test the value = against None
   explicitly to permit this = to succeed.
 * Added an --utf8 switch to xml2rfc. =  In nroff mode, the output will
=    contain utf-8 characters, not \[u8FD9] escapes; use = groff with the -Kutf8
   switch to = process the resulting nroff.
 * Removed all = references to xml.resource.org; it is not useful for
=    fallback purposes any more.

The new version is available through SVN checkout, with
 'svn checkout http://svn.tools.ietf.org/svn/tools/xml2rfc/tags/cli/2.6.0'=

Regards,

Henrik
= (via the mkrelease = script)
= --Apple-Mail=_D24C7DB4-BA15-45D7-900E-E61870C87996-- From nobody Wed May 31 16:04:38 2017 Return-Path: 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 B52521270A3 for ; Wed, 31 May 2017 16:04:36 -0700 (PDT) X-Virus-Scanned: amavisd-new at amsl.com X-Spam-Flag: NO X-Spam-Score: -2.001 X-Spam-Level: X-Spam-Status: No, score=-2.001 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, MIME_QP_LONG_LINE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RP_MATCHES_RCVD=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=packetizer.com 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 mVIvAN3guuRu for ; Wed, 31 May 2017 16:04:34 -0700 (PDT) Received: from dublin.packetizer.com (dublin.packetizer.com [75.101.130.125]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 40CDF124D37 for ; Wed, 31 May 2017 16:04:34 -0700 (PDT) Received: from [192.168.1.20] (cpe-098-122-167-029.nc.res.rr.com [98.122.167.29] (may be forged)) (authenticated bits=0) by dublin.packetizer.com (8.15.2/8.15.2) with ESMTPSA id v4VN4WK5019370 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO) for ; Wed, 31 May 2017 19:04:33 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=packetizer.com; s=dublin; t=1496271873; bh=heQVzms8dV1HM+L5IkXav8zvGoYfJTPXvIP+2yhra6g=; h=From:To:Subject:Date:In-Reply-To:References:Reply-To; b=qzwu+L62kZx2zftUxfRJYoVkZueEZEZAYgW/54fp2bu8CsfKrl63vs2lxREVRbOEY dFA2FcGjAZdExujtq+5EOJCoTuYxhnEaVwrurFsDev0OxQ9DarAPvAN5Gu+3BjM03R BSz9wHtj0lQnJrPevh9jnSY2jh7IfTtj/1ZtuEnI= From: "Paul E. Jones" To: rfc-markdown@ietf.org Date: Wed, 31 May 2017 23:04:32 +0000 Message-Id: In-Reply-To: References: Reply-To: "Paul E. Jones" User-Agent: eM_Client/7.0.30068.0 Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="------=_MB94DAA28B-7DA8-4DC0-A0C8-ADBB7BCE3C80" X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.6.1 (dublin.packetizer.com [10.165.122.250]); Wed, 31 May 2017 19:04:33 -0400 (EDT) Archived-At: Subject: Re: [Rfc-markdown] Fwd: New xml2rfc release: v2.6.0 X-BeenThere: rfc-markdown@ietf.org X-Mailman-Version: 2.1.22 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." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 May 2017 23:04:37 -0000 --------=_MB94DAA28B-7DA8-4DC0-A0C8-ADBB7BCE3C80 Content-Type: text/plain; format=flowed; charset=utf-8 Content-Transfer-Encoding: quoted-printable For those interested in using mmark and xml2rfc via docker to create=20 RFCs from markdown, I have updated the paulej/rfctools docker image to=20 include xml2rfc 2.6.0. The docker image is published here: https://hub.docker.com/r/paulej/rfctools/tags/ The source repository used to create that can be found here: https://github.com/paulej/rfctools Paul ------ Original Message ------ From: "Carsten Bormann" To: "RFC Markdown" Sent: 5/31/2017 8:36:35 AM Subject: [Rfc-markdown] Fwd: New xml2rfc release: v2.6.0 >This release marks a new version of xml2rfc after a long time with no=20 >updates. > >A quick smoke test I did didn=E2=80=99t uncover any problems with kramdown= -rfc,=20 >and I look forward in particular to much fewer bugs in the HTML=20 >generation. > >If you used pip to install xml2rfc, upgrade with: > >pip install --upgrade xml2rfc > >If you are using Martin Thomson=E2=80=99s github template, the CI platform= s=20 >should automatically use this new version from this moment, so not=20 >updating on your laptop isn=E2=80=99t really a very useful option. > >Gr=C3=BC=C3=9Fe, Carsten > > >>Begin forwarded message: >> >>From: Henrik Levkowetz >>Subject: [codesprints] New xml2rfc release: v2.6.0 >>Date: May 31, 2017 at 14:07:26 GMT+2 >> >>Hi, >> >>This is an automatic notification about a new xml2rfc release, >>v2.6.0, generated when running the mkrelease script. >> >>Release notes: >> >>xml2rfc (2.6.0) ietf; urgency=3Dmedium >> * The implementation of the 'authorship' PI in the original TCL tool=20 >>would >> suppress the Author's Address section when set to "no", while in=20 >>the >> current implementation it removed author information on the first=20 >>page. >> Changed to the original semantics. Also author organisation=20 >>handling on >> the first page changed to use the submissionType setting to trigger= =20 >>the >> behaviour described in issue #311. Fixes issue #311 without=20 >>overlaying >> this on the 'authorship' PI. >> * Added a check for the 'needLines' PI within lists. >> * Fixed a bug in the code for the 'sectionorphans' PI. Added a PI >> 'tocpagebreak' to force a page break before the ToC. This,=20 >>together with >> the fix for #311 and needLines within lists, lets xml2rfc produce >> rfc7754.txt correctly from suitable xml without postprocessing. >> * Tweaked the eref output in text mode to avoid generating extraneous >> space characters. Fixes issue #329. >> * Merged in [2251] from ietf@augustcellars.com: >> Changed to use the emph character in spanex so that the same thing=20 >>happens >> in both html and text if an unknown attribute is given. Fixes=20 >>issue #297" >> * Merged in [2250] from ietf@augustcellars.com, with tweaks: >> Added code to emit sections in two sections, numbered and=20 >>un-numbered, >> separately. Then emit the numbered appendixes, the index, the=20 >>unnumbered >> appendixes, cref items, authors at the end of the document. Fixes=20 >>issue >> #310. >> * Merged in [2249] from ietf@augustcellars.com: >> If you have an xref or similar element in an annotation in a=20 >>reference, >> any text that follows the xref is absent from the output HTML file.= =20 >> Text >> files emit correctly. Fixed the html generation. >> * Merged in [2248] from ietf@augustcellars.com: >> The HTML rendering for elements were inconsistent with the=20 >>text >> rendering. Fixed this by doing something completely different than= =20 >>is >> called for in the bug report: >> We follow the layout of what the V3 HTML document says to do. This >> means that we use the child text of the xref when it exists to the >> exclusion of any generated text. When the child text does not=20 >>exist >> then we use the synthesized text string as the text for the anchor >> element. In all cases the anchor element is emitted with an href=20 >>of the >> target. Fixes issue #293. >> * Merged in [2247] from ietf@augustcellars.com: >> Added true and false as legal values for the attribute numbered on=20 >>a >> section.xml Fixes issue #313 >> * Eliminated redundant PI parsing, now that each element carries the=20 >>local >> PI settings. >> * Merged in patch from martin.thomson@gmail.com, see ticket #307: >> Fixed a problem where if there are no authors, references in HTML=20 >>are >> badly formatted. Fixes issue #307 and #309. >> * Merged in [2215] from ietf@augustcellars.com, with some tweaks to=20 >>make >> things work under python 3.x: >> Don't split special terms with embedded forward slash on the slash >> character. Fixes issue #288. Also added code to deal with an=20 >>extra tab >> in the middle of a sentence. >> * Changed the handling of PIs such that each element in the parsed=20 >>xml >> tree holds the PI state at that point of the xml document. This=20 >>provides >> the ability to use different PI settings at different points in the >> document. This only makes sense for some PIs, though. The=20 >>following PIs >> will now be honoured if changed inside the document, in order to=20 >>provide >> more flexibility: 'multiple-initials', 'artworkdelimiter',=20 >>'compact', >> 'subcompact', 'text-list-symbols', 'colonspace'. >> * Honour the way double initials are given in the XML, with or=20 >>without >> interleaved spaces. See issue #303, which says of multiple=20 >>initials '... >> Expectation was that it would exactly match the initials attribute=20 >>in the >> XML' >> * Merged in [2070] from ietf@augustcellars.com: >> Enabled the multiple-initial PI again. The code now also looks for= =20 >>the PI >> as the first element of the author element, to apply for that=20 >>author entry >> only, with a default of 'no'. >> * Merged in [2064] from ietf@augustcellars.com: >> Added handling for absent author initials for the html generator. >> * Merged in [2062] from ietf@augustcellars.com: >> This commit provides support for multiple author initials. Fixes=20 >>issue >> #303. Also fixes the issue of extra commas showing up when there=20 >>are no >> initials, just a surname. >> * Merged in [2059] from ietf@augustcellars.com: >> Changet to emit html not xhtml. Addresses issues #263 and #279. >> * Updated additional test masters needed to make the tox tests pass,=20 >>and >> changed the html encoding and decoding to use utf-8, to work with=20 >>the >> unicode and utf-8 tests. >> * Removed python 2.6 from tox texting (a previous commit added python= =20 >>3.5). >> * Don't let the value of 'title' be None, make it an empty string if=20 >>that >> happens. Fixes issue #328 >> * Someone might want to set hangIndent to zero. Test the value=20 >>against None >> explicitly to permit this to succeed. >> * Added an --utf8 switch to xml2rfc. In nroff mode, the output will >> contain utf-8 characters, not \[u8FD9] escapes; use groff with the=20 >>-Kutf8 >> switch to process the resulting nroff. >> * Removed all references to xml.resource.org; it is not useful for >> fallback purposes any more. >> >>The new version is available through SVN checkout, with >> 'svn checkout=20 >>http://svn.tools.ietf.org/svn/tools/xml2rfc/tags/cli/2.6.0' >> >>Regards, >> >>Henrik >>(via the mkrelease script) --------=_MB94DAA28B-7DA8-4DC0-A0C8-ADBB7BCE3C80 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable
For those interested in using mmark and xml2rf= c via docker to create RFCs from markdown, I have updated the paulej/rfctoo= ls docker image to include xml2rfc 2.6.0. =C2=A0The docker image is publish= ed here:

The source repository used to create that can be found here:
https://github.com/paulej/= rfctools

Paul

------ Original Message ------
From: "Carsten Bormann" <cabo@tzi.o= rg>
To: "RFC Markdown" <rfc-markdown@ietf.org>
Sent: 5/31/2017 8:36:35 AM
Subject: [Rfc-markdown] Fwd: New xml2rfc release: v2.6.0

This release marks a new version of xml2rfc after a long time with no updat= es.

A quick smoke tes= t I did didn=E2=80=99t uncover any problems with kramdown-rfc, and I look f= orward in particular to much fewer bugs in the HTML generation.

If you used pip = to install xml2rfc, upgrade with:

pip install --upgrade xml2rfc

If you are using Martin Thomson=E2=80=99s github t= emplate, the CI platforms should automatically use this new version from th= is moment, so not updating on your laptop isn=E2=80=99t really a very usefu= l option.

Gr=C3=BC=C3=9Fe, Carsten


Begin forwarded message:

From: Henrik Levkowetz <henrik@levkowetz.com>
Subject: [codesprints] N= ew xml2rfc release: v2.6.0
= Date: May 31, 2017 at 14:07:26 GMT+2

Hi,

This is an automatic notification about a new xml2rfc= release,
v2.6.0, generated when running the mkrelease scri= pt.

Release notes:

xml2rfc (2.6.0) ietf; urgency=3Dmedium
=C2=A0* T= he implementation of the 'authorship' PI in the original TCL tool would =C2=A0=C2=A0=C2=A0suppress the Author's Address section when= set to "no", while in the
=C2=A0=C2=A0=C2=A0current implem= entation it removed author information on the first page.
= =C2=A0=C2=A0=C2=A0Changed to the original semantics. =C2=A0Also author org= anisation handling on
=C2=A0=C2=A0=C2=A0the first page cha= nged to use the submissionType setting to trigger the
=C2= =A0=C2=A0=C2=A0behaviour described in issue #311. =C2=A0Fixes issue #311 wi= thout overlaying
=C2=A0=C2=A0=C2=A0this on the 'authorship= ' PI.
=C2=A0* Added a check for the 'needLines' PI within= lists.
=C2=A0* Fixed a bug in the code for the 'sectionorp= hans' PI. Added a PI
=C2=A0=C2=A0=C2=A0'tocpagebreak' to f= orce a page break before the ToC. =C2=A0This, together with
=C2=A0=C2=A0=C2=A0the fix for #311 and needLines within lists, lets xml2r= fc produce
=C2=A0=C2=A0=C2=A0rfc7754.txt correctly from su= itable xml without postprocessing.
=C2=A0* Tweaked the ere= f output in text mode to avoid generating extraneous
=C2= =A0=C2=A0=C2=A0space characters. =C2=A0Fixes issue #329.
= =C2=A0* Merged in [2251] from ietf@augustcellars.com:
=C2=A0=C2=A0=C2=A0Cha= nged to use the emph character in spanex so that the same thing happens =C2=A0=C2=A0=C2=A0in both html and text if an unknown attribu= te is given. =C2=A0Fixes issue #297"
=C2=A0* Merged in [22= 50] from ietf@augustce= llars.com, with tweaks:
=C2=A0=C2=A0=C2=A0Added code t= o emit sections in two sections, numbered and un-numbered,
= =C2=A0=C2=A0=C2=A0separately. =C2=A0Then emit the numbered appendixes, the = index, the unnumbered
=C2=A0=C2=A0=C2=A0appendixes, cref= items, authors at the end of the document. =C2=A0Fixes issue
=C2=A0=C2=A0=C2=A0#310.
=C2=A0* Merged in [2249] from <= a href=3D"mailto:ietf@augustcellars.com" class=3D"">ietf@augustcellars.com<= /a>:
=C2=A0=C2=A0=C2=A0If you have an xref or similar elem= ent in an annotation in a reference,
=C2=A0=C2=A0=C2=A0any = text that follows the xref is absent from the output HTML file. =C2=A0Text=
=C2=A0=C2=A0=C2=A0files emit correctly. =C2=A0Fixed the h= tml generation.
=C2=A0* Merged in [2248] from ietf@augustcellars.com:
=C2=A0=C2=A0=C2=A0The HTML rendering for <xref> elements= were inconsistent with the text
=C2=A0=C2=A0=C2=A0renderin= g. =C2=A0Fixed this by doing something completely different than is
=C2=A0=C2=A0=C2=A0called for in the bug report:
= =C2=A0=C2=A0=C2=A0We follow the layout of what the V3 HTML document says t= o do. =C2=A0This
=C2=A0=C2=A0=C2=A0means that we use the c= hild text of the xref when it exists to the
=C2=A0=C2=A0= =C2=A0exclusion of any generated text. =C2=A0When the child text does not e= xist
=C2=A0=C2=A0=C2=A0then we use the synthesized text st= ring as the text for the anchor
=C2=A0=C2=A0=C2=A0element. = =C2=A0In all cases the anchor element is emitted with an href of the
=C2=A0=C2=A0=C2=A0target. =C2=A0Fixes issue #293.
=C2=A0* Merged in [2247] from ietf@augustcellars.com:
=C2=A0=C2=A0=C2=A0= Added true and false as legal values for the attribute numbered on a
=C2=A0=C2=A0=C2=A0section.xml Fixes issue #313
= =C2=A0* Eliminated redundant PI parsing, now that each element carries the = local
=C2=A0=C2=A0=C2=A0PI settings.
= =C2=A0* Merged in patch from martin.thomson@gmail.com, see ticket #307:
=C2= =A0=C2=A0=C2=A0Fixed a problem where if there are no authors, references in = HTML are
=C2=A0=C2=A0=C2=A0badly formatted. =C2=A0Fixes i= ssue #307 and #309.
=C2=A0* Merged in [2215] from ietf@augustcellars.com, w= ith some tweaks to make
=C2=A0=C2=A0=C2=A0things work unde= r python 3.x:
=C2=A0=C2=A0=C2=A0Don't split special terms= with embedded forward slash on the slash
=C2=A0=C2=A0=C2= =A0character. =C2=A0Fixes issue #288. =C2=A0Also added code to deal with an = extra tab
=C2=A0=C2=A0=C2=A0in the middle of a sentence.<= br class=3D"" /> =C2=A0* Changed the handling of PIs such that each element = in the parsed xml
=C2=A0=C2=A0=C2=A0tree holds the PI st= ate at that point of the xml document. =C2=A0This provides
=C2=A0=C2=A0=C2=A0the ability to use different PI settings at different p= oints in the
=C2=A0=C2=A0=C2=A0document. =C2=A0This only= makes sense for some PIs, though. =C2=A0The following PIs
= =C2=A0=C2=A0=C2=A0will now be honoured if changed inside the document, in= order to provide
=C2=A0=C2=A0=C2=A0more flexibility: 'mul= tiple-initials', 'artworkdelimiter', 'compact',
=C2=A0=C2= =A0=C2=A0'subcompact', 'text-list-symbols', 'colonspace'.
= =C2=A0* Honour the way double initials are given in the XML, with or witho= ut
=C2=A0=C2=A0=C2=A0interleaved spaces. =C2=A0See issue= #303, which says of multiple initials '...
=C2=A0=C2=A0= =C2=A0Expectation was that it would exactly match the initials attribute in = the
=C2=A0=C2=A0=C2=A0XML'
=C2=A0* Merg= ed in [2070] from ietf= @augustcellars.com:
=C2=A0=C2=A0=C2=A0Enabled the mult= iple-initial PI again. =C2=A0The code now also looks for the PI
=C2=A0=C2=A0=C2=A0as the first element of the author element, to appl= y for that author entry
=C2=A0=C2=A0=C2=A0only, with a def= ault of 'no'.
=C2=A0* Merged in [2064] from ietf@augustcellars.com:
=C2=A0=C2=A0=C2=A0Added handling for absent author initials for th= e html generator.
=C2=A0* Merged in [2062] from ietf@augustcellars.com:
=C2=A0=C2=A0=C2=A0This commit provides support for multiple au= thor initials. =C2=A0Fixes issue
=C2=A0=C2=A0=C2=A0#303. = =C2=A0Also fixes the issue of extra commas showing up when there are no
=C2=A0=C2=A0=C2=A0initials, just a surname.
= =C2=A0* Merged in [2059] from ietf@augustcellars.com:
=C2=A0=C2=A0=C2=A0Cha= nget to emit html not xhtml. =C2=A0Addresses issues #263 and #279.
=C2=A0* Updated additional test masters needed to make the tox tes= ts pass, and
=C2=A0=C2=A0=C2=A0changed the html encoding a= nd decoding to use utf-8, to work with the
=C2=A0=C2=A0=C2= =A0unicode and utf-8 tests.
=C2=A0* Removed python 2.6 fro= m tox texting (a previous commit added python 3.5).
=C2=A0= * Don't let the value of 'title' be None, make it an empty string if that <= br class=3D"" /> =C2=A0=C2=A0=C2=A0happens. =C2=A0Fixes issue #328
=C2=A0* Someone might want to set hangIndent to zero. =C2=A0Test t= he value against None
=C2=A0=C2=A0=C2=A0explicitly to perm= it this to succeed.
=C2=A0* Added an --utf8 switch to xml2= rfc. =C2=A0In nroff mode, the output will
=C2=A0=C2=A0=C2= =A0contain utf-8 characters, not \[u8FD9] escapes; use groff with the -Kutf= 8
=C2=A0=C2=A0=C2=A0switch to process the resulting nroff= .
=C2=A0* Removed all references to xml.resource.org; it is not useful for
=C2=A0=C2=A0=C2=A0fallback purposes any more.
The new version is available through SVN checkout, with
=C2=A0'svn checkout http://svn.tools.ietf.org/svn/tool= s/xml2rfc/tags/cli/2.6.0'

Regards,
Henrik
(via the mkrelease script)
--------=_MB94DAA28B-7DA8-4DC0-A0C8-ADBB7BCE3C80--