[Rfc-markdown] New xml2rfc release: v2.16.0

Henrik Levkowetz <henrik@levkowetz.com> Sat, 22 December 2018 16:30 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 5AAF712872C; Sat, 22 Dec 2018 08:30:40 -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, 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 V0lDQ54QLzxh; Sat, 22 Dec 2018 08:30:37 -0800 (PST)
Received: from durif.tools.ietf.org (durif.tools.ietf.org [IPv6:2001:1900:3001:11::3d]) (using TLSv1.2 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 29D4F127AC2; Sat, 22 Dec 2018 08:30:37 -0800 (PST)
Received: from henrik by durif.tools.ietf.org with local (Exim 4.80) (envelope-from <henrik@levkowetz.com>) id 1gakAe-0003ON-Tb; Sat, 22 Dec 2018 08:30:36 -0800
To: xml2rfc-dev@ietf.org, xml2rfc@ietf.org
Cc: rfc-markdown@ietf.org
Message-Id: <E1gakAe-0003ON-Tb@durif.tools.ietf.org>
From: Henrik Levkowetz <henrik@levkowetz.com>
Date: Sat, 22 Dec 2018 08:30:36 -0800
X-SA-Exim-Connect-IP: <locally generated>
X-SA-Exim-Rcpt-To: rfc-markdown@ietf.org, xml2rfc-dev@ietf.org, xml2rfc@ietf.org
X-SA-Exim-Mail-From: henrik@levkowetz.com
X-SA-Exim-Scanned: No (on durif.tools.ietf.org); SAEximRunCond expanded to false
X-Clacks-Overhead: GNU Terry Pratchett
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/vEWh8LVmY96l7voGGRuWhyTVqdY>
Subject: [Rfc-markdown] New xml2rfc release: v2.16.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: Sat, 22 Dec 2018 16:30:41 -0000

Hi,

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

Release notes:

xml2rfc (2.16.0) ietf; urgency=medium

  This release provides support for generation of xml2rfc PDF output.
  However, a default pip install will only install the xml2rfc module
  itself; additional installation work is needed to enable PDF generation:

  In order to generate PDFs, xml2rfc uses the WeasyPrint module, which
  depends on external libaries that must be installed as native packages
  on your platform, separately from the xml2rfc install.

  First, install the Cairo, Pango, and GDK-PixBuf libs on your system.
  See installation instructions on the WeasyPrint Docs:

      https://weasyprint.readthedocs.io/en/stable/install.html

  (Python 3 is not needed if your system Python is 2.7, though).

  (On some OS X systems with System Integrity Protection active, you may
  need to create a symlink from your home directory to the library installation
  directory (often /opt/local/lib):

      ln -s /opt/local/lib ~/lib

  in order for weasyprint to find the installed cairo and pango libraries.
  Whether this is needed or not depends on whether you used macports or
  homebrew to install cairo and pango, and the homebrew / macport version.)

  Next, install the pycairo and weasyprint python modules using pip.
  Depending on your system, you may need to use 'sudo' or install in
  user-specific directories, using the --user switch.  On OS X in particular,
  you may also need to install a newer version of setuptools using --user
  switch before weasyprint can be installed.  If you install with the --user
  switch, you may also need to set PYTHONPATH in your shell environment, e.g.,

      PYTHONPATH=/Users/username/Library/Python/2.7/lib/python/site-packages

  for Python 2.7.

  The basic pip command (modify as needed according to the text above) is:

      pip install 'pycairo>=1.18' 'weasyprint<=0.42.3'

  With these installed and available to xml2rfc, the --pdf switch will be
  enabled.

  For correct PDF output, you also need to install the Noto font set.
  Download the full set from:

    https://noto-website-2.storage.googleapis.com/pkgs/Noto-unhinted.zip,

  and install as appropriate for your platform.

 -- Henrik Levkowetz <henrik@levkowetz.com>  22 Dec 2018 15:58:44 +0000

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.16.0'

Regards,

	Henrik
	(via the mkrelease script)