Beta testing of xml2rfc version 2

IETF Chair <chair@ietf.org> Sat, 19 January 2013 02:47 UTC

Return-Path: <chair@ietf.org>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id A22B921F85FC; Fri, 18 Jan 2013 18:47:29 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -102.949
X-Spam-Level:
X-Spam-Status: No, score=-102.949 tagged_above=-999 required=5 tests=[AWL=-0.349, BAYES_00=-2.599, USER_IN_WHITELIST=-100]
Received: from mail.ietf.org ([64.170.98.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id HKqLXP4rHHec; Fri, 18 Jan 2013 18:47:28 -0800 (PST)
Received: from mail.amsl.com (mail.amsl.com [IPv6:2001:1890:123a::1:14]) by ietfa.amsl.com (Postfix) with ESMTP id E328621F84DD; Fri, 18 Jan 2013 18:47:28 -0800 (PST)
Received: from localhost (c8a.amsl.com [127.0.0.1]) by c8a.amsl.com (Postfix) with ESMTP id D0A311244F4; Fri, 18 Jan 2013 18:47:28 -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 JqNTwA2ILhKC; Fri, 18 Jan 2013 18:47:28 -0800 (PST)
Received: from [192.168.2.105] (pool-96-255-37-162.washdc.fios.verizon.net [96.255.37.162]) by c8a.amsl.com (Postfix) with ESMTPSA id 42FD81244F1; Fri, 18 Jan 2013 18:47:28 -0800 (PST)
Subject: Beta testing of xml2rfc version 2
Mime-Version: 1.0 (Apple Message framework v1085)
Content-Type: text/plain; charset="us-ascii"
From: IETF Chair <chair@ietf.org>
In-Reply-To: <50EDF9D2.1070303@levkowetz.com>
Date: Fri, 18 Jan 2013 19:52:41 -0500
Content-Transfer-Encoding: quoted-printable
Message-Id: <99A1B3AF-EDE8-4767-9F6A-DD9BA14CF8B7@ietf.org>
References: <50EDE851.2020207@levkowetz.com> <D8E4800F-1561-4ED3-B0A2-C28E669BD944@vigilsec.com> <29F1CEC4-BCF4-4B24-BA74-94BBF5D27A6E@gmail.com> <50EDF9D2.1070303@levkowetz.com>
To: IETF Announce <ietf-announce@ietf.org>
X-Mailer: Apple Mail (2.1085)
Cc: xml2rfc@ietf.org, IETF <ietf@ietf.org>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/ietf>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 19 Jan 2013 02:47:29 -0000

This announces the new xml2rfc implementation for beta testing.  There are two components: a command line interface and graphical user interfaces.

XML2RFC Version 2
-----------------

The rewrite of xml2rfc in python, tagged with version numbers 2.x.y, have been unofficially available for some time, and it is now officially announced as available for use.

This package is a complete rewrite of the xml2rfc command-line functionality in python.  The command line tool is available from the main Python package repository, PyPi:

 http://pypi.python.org/pypi/xml2rfc

or alternatively from:

 http://tools.ietf.org/tools/xml2rfc2/cli/

A number of alternative installation methods are available, described on the PyPi page for xml2rfc.

There are some known issues with the current release, none of them major.  These are listed in the issue tracker:

 http://tools.ietf.org/tools/xml2rfc/trac/report/9

Bug fixing is actively happening.  If you find bugs which are not already listed in the tracker, please add them.  Please help us find the bugs.  They cannot be fixed if we do not know about them.  Also, suggestions for improvements are welcome.

New releases will be announced at the xml2rfc mail list.


GUI Frontends
-------------

There are also GUI frontends available for Mac, Linux and Windows.  These are not undergoing active bugfixing at the moment, but should overall be in good enough shape for production use if you prefer a GUI interface instead of command-line for your XML to draft/rfc operations.

If you are going to install the GUI version, it is suggested that you first install the latest command-line version, and then the GUI front-end.

The GUI components can be downloaded from here:

 http://tools.ietf.org/tools/xml2rfc2/gui/

Please note that in some cases, the GUI installers come with an embedded version of the base tool, and this version will not necessarily be the latest version available.  If you download and install a later version of the command-line tool, the GUI component should use that if it comes before the embedded version in your PATH, which will normally be the case.


Feedback
--------

I hope you'll find that the rewrite of xml2rfc works well for you; it will certainly be easier to extend and bugfix than the previous version.  If you have feedback, regarding bugs or enhancement suggestions, please use the issue tracker at:

 http://tools.ietf.org/tools/xml2rfc/trac/newticket


Best regards,

   Russ Housley
   IETF Chair

   Henrik Levkowetz
   IETF Tools Program Manager