First version of inherited templates for NEWs sections.

Change-Id: I3caeaaabf427d39db094d0919fa1fc118e1edb1e

5 files changed, 289 insertions, 222 deletions

diff --git a/components/toolchain/binaries/NEWS.textile b/components/toolchain/binaries/NEWS.textile
deleted file mode 100644
index a165091..0000000
--- a/components/toolchain/binaries/NEWS.textile
+++ /dev/null
@@ -1,3 +0,0 @@
-{# This document uses jinja2 templating markup.  Please refer to the #}
-{# Jinja2 template documentation for further information. #}
-{# http://jinja.pocoo.org/docs/dev/templates/ #}
diff --git a/components/toolchain/binaries/README.textile b/components/toolchain/binaries/README.textile
index 7810a52..ca69785 100644
--- a/components/toolchain/binaries/README.textile
+++ b/components/toolchain/binaries/README.textile
@@ -1,252 +1,115 @@
-{# This document uses jinja2 templating markup.  Please refer to the #}
-{# Jinja2 template documentation for further information. #}
-{# http://jinja.pocoo.org/docs/dev/templates/ #}
-{% if announce == "" -%}
-h1. Linaro *{{ stab_maint }}* Binary Toolchain {{ snap_rc_release }} GCC {{ major }}.{{ minor }}-{{ year }}.{{ dd_month }}{% if spin != "" -%}-{{ spin }}{% endif -%}{% if rc != "" -%}-rc{{ rc }}{% endif %}
-
+{# This document uses jinja2 templating markup.  Please
+   refer to the Jinja2 template documentation for further
+   information.
+
+   http://jinja.pocoo.org/docs/dev/templates/
+
+   This document is the parent template for the binary
+   toolchain release notes.
+
+   README.textile.version is an example of a versioned
+   child template.  The build scripts invoke the child
+   template which.  -#}
+
+{# Pull in the macros that differentiate between textile and no-txt -#}
+{% from "components/toolchain/binaries/macros" import header with context -%}
+{% from "components/toolchain/binaries/macros" import url with context -%}
+{% from "components/toolchain/binaries/macros" import urlind with context -%}
+{% from "components/toolchain/binaries/macros" import email with context -%}
+{% from "components/toolchain/binaries/macros" import format with context -%}
+
+{#- Unfortunately jinja 2.7 doesn't have set blocks so use appending. #}
+{%- set ver_date = major + "." + minor + "-" + year + "." + dd_month -%}
+{% if spin != "" -%}{% set ver_date = ver_date + "-" + spin %}{% endif -%}
+{% if rc != "" -%}{% set ver_date = ver_date + "-rc" + rc %}{% endif -%}
+{%- set release_version = "GCC " + ver_date -%}
+{%- set linaro_gcc_version = "Linaro " + release_version -%}
+
+{% if snap_rc_release == "release" -%}
+    {% set server = "http://releases.linaro.org/components/toolchain" %}
+{% else -%}
+    {% set server = "http://snapshots.linaro.org/components/toolchain" %}
 {% endif -%}
 
-p. The Linaro Toolchain Working Group is pleased to announce the availability of the Linaro *{{ stab_maint }}* Binary Toolchain GCC {{ major }}.{{ minor }}-{{ year }}.{{ dd_month }}{% if spin != "" -%}-{{ spin }}{% endif -%}{% if rc != "" -%}-rc{{ rc }}{% endif %} {{ snap_rc_release }} Archives.
-
-{% if announce == "yes" -%}
-p. http://{% if snap_rc_release|lower == "release" -%}releases{% else -%}snapshots{% endif -%}.linaro.org/components/toolchain/binaries/{{ major }}.{{ minor }}-{{ year }}.{{ dd_month }}{% if spin != "" -%}-{{ spin }}{% endif -%}{% if rc != "" -%}-rc{{ rc }}{% endif %}/
-
-p. http://{% if snap_rc_release|lower == "release" -%}releases{% else -%}snapshots{% endif -%}.linaro.org/components/toolchain/gcc-linaro/{{ major }}.{{ minor }}-{{ year }}.{{ dd_month }}{% if spin != "" -%}-{{ spin }}{% endif -%}{% if rc != "" -%}-rc{{ rc }}{% endif %}/
-
-{% endif -%}{# announce #}
+{%- set srcurl = server + "/gcc-linaro/" + ver_date + "/" -%}
+{%- set binurl = server + "/binaries/" + ver_date + "/" -%}
 
-p. These archives provide cross-toolchain executables (compiler, debugger, linker, etc.) and shared libraries (libstdc++, libc, etc.) that target ARM or Aarch64 GNU/Linux and bare-metal environments.  The cross-toolchain binaries execute on a Linux or MS Windows (under mingw32) host operating-system.
+{%- if announce == "yes" -%} 
+[ANNOUNCE] DRAFT Linaro Binary Toolchain {{ snap_rc_release }} {{ release_version }}
 
-{% if announce == "yes" -%}
-
-p.   Please evaluate this release-candidate for correctness.  Linaro will shortly spin the Linaro GCC {{ major }}.{{ minor }}-{{ year }}.{{ dd_month }}{% if spin != "" -%}-{{ spin }}{% endif %} release if this release-candidate passes stakeholder validation.
-
-
-p.   For bugs related to this release-candidate please email linaro-toolchain@lists.linaro.org or file a bug at http://https://bugs.linaro.org/enter_bug.cgi?product=Linux%20Binary%20toolchain
 {% endif -%}
-{% if announce == "" -%}
-
-p. Beginning with the Linaro 4.9-2014.11 release, Linaro has changed the layout and structure of its prebuilt toolchain binary release archives. The Linaro 4.9-2014.11 release is the first release built with "ABE":https://git.linaro.org/toolchain/abe.git.  ABE provides a maintainable and flexible toolchain building, benchmarking, validation, and release framework. For further details on ABE, please visit https://wiki.linaro.org/ABE.
-
-p. The folders above describe the ARM and Aarch64 target triplets, i.e., the system on which you want your programs/applications to run. For more details on triplets, please click "here":https://wiki.linaro.org/WorkingGroups/ToolChain/FAQ#What_is_the_differences_between_.2BIBw-arm-none-eabi-.2BIB0_and_.2BIBw-arm-linux-gnueabihf.2BIB0.3F_Can_I_use_.2BIBw-arm-linux-gnueabihf.2BIB0_tool_chain_in_bare-metal_environment.3F_How_do_you_know_which_toolchain_binary_to_use_where.3F.
-
-p. Each folder contains a @manifest.txt@ file further describing the target and host systems meant for the toolchain and the toolchain component source versions.
-
-h2. Supported Targets
-
-p. Linaro binary toolchains are provided for the following ARM and Aarch64 targets:
-
-h3. aarch64-linux-gnu
-
-p. _Toolchains for little-endian, 64-bit ARMv8 for GNU/Linux systems_
-
-* @gcc-linaro-*x86_64_aarch64-linux-gnu.tar.xz@
-** Linux 64-bit binaries for the Aarch64 Linux cross-toolchain
-* @gcc-linaro-*i686-mingw32_aarch64-linux-gnu.tar.xz@
-** Windows 32-bit binaries for the Aarch64 Linux cross-toolchain
-
-h3. armv8l-linux-gnueabihf
-
-p. _Toolchains for little-endian, 32-bit ARMv8 for GNU/Linux systems_
-
-* @gcc-linaro-*-x86_64_armv8l-linux-gnueabihf.tar.xz@
-** Linux 64-bit binaries for the Aarch64 Linux cross-toolchain
-* @gcc-linaro-*-i686-mingw32_armv8l-linux-gnueabihf.tar.xz@
-** Windows 32-bit binaries for the Aarch64 Linux cross-toolchain
-
-h3. aarch64-none-elf
-
-p. _Toolchains for little-endian, 64-bit ARMv8 for bare-metal systems_
-
-* @gcc-linaro-*x86_64_aarch64-elf.tar.xz@
-** Linux 64-bit binaries for the Aarch64 bare-metal cross-toolchain
-* @gcc-linaro-*i686-mingw32_aarch64-elf.tar.xz@
-** Windows 32-bit binaries for the Aarch64 bare-metal cross-toolchain
-
-h3. aarch64_be-linux-gnu
-
-p. _Toolchains for big-endian, 64-bit ARMv8 for GNU/Linux systems_
-
-* @gcc-linaro-*x86_64_aarch64_be-linux-gnu.tar.xz@
-** Linux 64-bit binaries for the Aarch64 Linux Big Endian cross-toolchain
-* @gcc-linaro-*i686-mingw32_aarch64_be-linux-gnu.tar.xz@
-** Windows 32-bit binaries for the Aarch64 Linux Big Endian cross-toolchain
-
-h3. aarch64_be-none-elf
-
-p. _Toolchains for big-endian, 64-bit ARMv8 for bare-metal systems_
-
-* @gcc-linaro-*x86_64_aarch64_be-elf.tar.xz@
-** Linux 64-bit binaries for the Aarch64 bare-metal Big Endian cross-toolchain
-* @gcc-linaro-*i686-mingw32_aarch64_be-elf.tar.xz@
-** Windows 32-bit binaries for the Aarch64 bare-metal Big Endian cross-toolchain
-
-h3. arm-linux-gnueabi
-
-p. _Toolchains for little-endian, soft-float, 32-bit ARMv7 (and earlier) for GNU/Linux systems_
-
-* @gcc-linaro-*x86_64_arm-linux-gnueabi.tar.xz@
-** Linux 64-bit binaries for the ARMv7 Linux soft float cross-toolchain
-* @gcc-linaro-*i686-mingw32_arm-linux-gnueabi.tar.xz@
-** Windows 32-bit binaries for the ARMv7 Linux soft float cross-toolchain
-
-h3. arm-linux-gnueabihf
+{{ header(1, 'DRAFT - The Linaro Binary Toolchain') }}
 
-p. _Toolchains for little-endian, hard-float, 32-bit ARMv7 (and earlier) for GNU/Linux systems_
+{{ snap_rc_release }} {{ linaro_gcc_version }} is now available.
 
-* @gcc-linaro-*x86_arm-linux-gnueabihf.tar.xz@
-** Linux 32-bit binaries for the ARMv7 Linux hard float cross-toolchain
-* @gcc-linaro-*x86_64_arm-linux-gnueabihf.tar.xz@
-** Linux 64-bit binaries for the ARMv7 Linux hard float cross-toolchain
-* @gcc-linaro-*i686-mingw32_arm-linux-gnueabihf.tar.xz@
-** Windows 32-bit binaries for the ARMv7 Linux hard float cross-toolchain
+{# Information important for the release goes into the important block
+   in the child NEW.textile.<version> template, if there is any.  #}
+{% block important -%}{% endblock %}
 
-h3. arm-none-eabi
+Download {{ snap_rc_release|lower }} packages from:
 
-p. _Toolchains for little-endian, soft-float, 32-bit ARMv7 (and earlier) for bare-metal systems_
+{{ urlind(8,srcurl) }}
+{{ urlind(8,binurl) }}
 
-* @gcc-linaro-*x86_64_arm-eabi.tar.xz@
-** Linux 64-bit binaries for the ARMv7 bare-metal cross-toolchain
-* @gcc-linaro-*i686-mingw32_arm-eabi.tar.xz@
-** Windows 32-bit binaries for the ARMv7 bare-metal cross-toolchain
+Previous snapshots and release-candidates are at:
 
-h3. armeb-linux-gnueabihf
+{{ urlind(8,"http://snapshots.linaro.org/components/toolchain/binaries/") }}
 
-p. _Toolchains for big-endian, hard-float, 32-bit ARMv7 (and earlier) for GNU/Linux systems_
+Previous releases are at:
 
-* @gcc-linaro-*x86_64_armeb-linux-gnueabihf.tar.xz@
-** Linux 64-bit binaries for the ARMv7 Linux Big Endian hard float cross-toolchain
-* @gcc-linaro-*i686-mingw32_armeb-linux-gnueabihf.tar.xz@
-** Windows 32-bit binaries for the ARMv7 Linux Big Endian hard float cross-toolchain
-
-h3. armeb-none-eabi
-
-p. _Toolchains for big-endian, soft-float, 32-bit ARMv7 (and earlier) for bare-metal systems_
-
-* @gcc-linaro-*x86_64_armeb-eabi.tar.xz@
-** Linux 64-bit binaries for the ARMv7 bare-metal Big Endian cross-toolchain
-* @gcc-linaro-*i686-mingw32_armeb-eabi.tar.xz@
-** Windows 32-bit binaries for the ARMv7 bare-metal Big Endian cross-toolchain
-{% endif %}
-
-h2. NEWS
-
-h3. GCC 5.3 2016.02-rc1
-
-The Linaro GCC 5.3 2016.02-rc1 binary toolchain release-candidate is built from the "Linaro GCC-5.3-2016.02-rc1":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.3-2016.02-rc1/ release-candidate source archive.  The Linaro GCC-5.3-2016.02-rc1 release-candidate source archive is derived from the same sources as the "Linaro GCC-5.3-2016.01":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.3-2016.01/ snapshot source archive. 
+{{ urlind(8,"http://releases.linaro.org/components/toolchain/binaries/") }}
 
+{{ header(2, 'Host Requirements') }}
 {#
-h3. GCC 5.2 2015.11-2-rc1
-
-The Linaro GCC 5.2 2015.11-2-rc1 binary toolchain release-candidate is built from the "Linaro GCC-5.2-2015.11-2-rc1":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.2-2015.11-2-rc1/ release-candidate source archive.  The Linaro GCC-5.2-2015.11-2-rc1 release-candidate source archive is derived from the same sources as the "Linaro GCC-5.2-2015.10":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.2-2015.10/ snapshot source archive. 
-
-This release-candidate includes fixes for the following issues:
-
-* "Linaro bug 1995":https://bugs.linaro.org/show_bug.cgi?id=1995 identified a problem where the installed sysroot was not in the place that the compiler expected the sysroot to be located by default.  This is fixed in the Linaro GCC 5.2 2015.11-2-rc1 binary toolchain release-candidate.
-
-h3. GCC 5.2 2015.11-1
-
-The Linaro GCC 5.2 2015.11-1 binary toolchain release is built from the "Linaro GCC-5.2-2015.11-1":http://releases.linaro.org/components/toolchain/gcc-linaro/5.2-2015.11-1/ release source archive.  The Linaro GCC-5.2-2015.11-1 release source archive is derived from the same sources as the "Linaro GCC-5.2-2015.10":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.2-2015.10/ snapshot source archive. 
-
-This release includes fixes for the issues specified in the Linaro GCC 5.2 2015.11-1-rc1 release-candidate.
-
-h3. GCC 5.2 2015.11-1-rc1
-
-The Linaro GCC 5.2 2015.11-1-rc1 binary toolchain release-candidate is built from the "Linaro GCC-5.2-2015.11-1-rc1":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.2-2015.11-1-rc1/ release-candidate source archive.  The Linaro GCC-5.2-2015.11-1-rc1 release-candidate source archive is derived from the same sources as the "Linaro GCC-5.2-2015.10":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.2-2015.10/ snapshot source archive. 
-
-This release-candidate includes fixes for the following issues:
-
-* The arm-eabi-none multi-libs are now available in the toolchain sysroot as a fix for "Linaro bug 1920":https://bugs.linaro.org/show_bug.cgi?id=1920 and "Linaro bug 1922":https://bugs.linaro.org/show_bug.cgi?id=1922.
-* Linaro glibc 2.21 now provides "ld-linux-aarch64_be.so.1":https://git.linaro.org/toolchain/glibc.git/commit/dbcaca73cb0a19698ea1b424087e8997a9b7c3c4.
-* Linux 32-bit host binaries for the ARMv7 Linux hard float cross-toolchain (arm-linux-gnueabihf triple).
-
-h3. GCC 5.2 2015.11
-
-The Linaro GCC 5.2 2015.11 binary toolchain release is built from the "Linaro GCC-5.2-2015.11":http://releases.linaro.org/components/toolchain/gcc-linaro/5.2-2015.11/ release source archive.  The Linaro GCC-5.2-2015.11 release source archive is derived from the same sources as the "Linaro GCC-5.2-2015.10":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.2-2015.10/ snapshot source archive. 
-
-h3. GCC 5.2 2015.11-rc1
-
-The Linaro GCC 5.2 2015.11-rc1 binary toolchain release-candidate is built from the "Linaro GCC-5.2-2015.11":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.2-2015.11-rc1/ release-candidate source archive.  The Linaro GCC-5.2-2015.11-rc1 release-candidate source archive is derived from the same sources as the "Linaro GCC-5.2-2015.10":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.2-2015.10/ snapshot source archive. 
-
-#}
-{#
-h3. GCC 4.9 2015.11-rc1
-
-The Linaro GCC 5.2 2015.11-rc1 binary toolchain release-candidate is built from the "Linaro GCC-5.2-2015.11":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.2-2015.11-rc1/ release-candidate source archive.  The Linaro GCC-5.2-2015.11 release source archive is derived from the same sources as the "Linaro GCC-5.2-2015.10":http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.2-2015.10/ snapshot source archive. 
-
-#}
-{#
-h3. GCC 4.9 2015.05-1-rc1
-
-The Linaro GCC 4.9 2015.05-1-rc1 binary toolchain release-candidate is based on the Linaro GCC-4.9-2015.05 release source archive.  The only changes between 2015.05 and 2015.05-1-rc1 were the following changes in how the binary toolchains were built.  The compiler itself was not changed.
-
-* @x86_64@ hosted, @armv8l-linux-gnueabihf@ targetted cross toolchains are now available, but were not available in 2015.05.  The cross-compiler targetting @armv8l-linux-gnueabihf@ is now correctly configured with @--with-arch=armv8-a --with-fpu=neon-fp-armv8 --with-float=hard --disable-multilib --enable-multiarch@.
-
-* Glibc's slibdir and libdir were once again modified to address "Linaro Bugzilla 1717":https://bugs.linaro.org/show_bug.cgi?id=1717 - *Linaro-4.9-2015.05 moved system libs from /libc/lib/ to /libc/usr/lib/ which breaks things*.  The following are now the correct locations:
-** libdir=lib/ (linker-scripts and static archives)
-** slibdir=usr/lib/ (shared objects)
-** rtlddir=lib/ (dynamic linker)
-
-
-h3. 2015.08
-
-The Linaro GCC 5.1 2015.08 binary toolchain release is based on the Linaro GCC-5.1-2015.08 source archive release.  The major changes contained in 2015.08 over 2015.05 are described in the sections below on *2015.08-rc1* and *2015.08-rc2*.
+{% call format("para") -%}
+The Linaro binary toolchain is a collection of x86-hosted GNU cross-toolchains targeting an array of 32-bit and 64-bit ARM architecture targets.  More information on Linaro binary toolchains is at:
+{% endcall %}
 
-h3. 2015.08-rc2
+{{ urlind(8,"http://collaborate.linaro.org/display/TCWGPUB/Releases") }}
+ #}
 
-The Linaro GCC 5.1 2015.08-rc2 binary toolchain release-candidate is based on the Linaro GCC-5.1-2015.08-rc1 release-candidate source archive.  The only changes between 2015.08-rc1 and 2015.08-rc2 were the following changes in how the binary toolchains were built.  The compiler itself was not changed.
+{% call format("para") -%}
+Linaro officially supports the current and previous Ubuntu LTS releases (as of the time of this release).  This does not mean that the toolchain will not work on other/older Linux distributions.  See the following for the life-time of Ubuntu LTS releases.
+{% endcall %}
 
-* @x86_64@ hosted, @armv8l-linux-gnueabihf@ targetted cross toolchains are now correctly configured.  This was broken in 2015.08-rc1.  The cross-compiler targetting @armv8l-linux-gnueabihf@ is now correctly configured with @--with-arch=armv8-a --with-fpu=neon-fp-armv8 --with-float=hard --disable-multilib --enable-multiarch@.
+{{ urlind(8,"https://wiki.ubuntu.com/Releases") }}
 
-* Glibc's slibdir and libdir were once again modified to address "Linaro Bugzilla 1717":https://bugs.linaro.org/show_bug.cgi?id=1717 - *Linaro-4.9-2015.05 moved system libs from /libc/lib/ to /libc/usr/lib/ which breaks things*.  The following are now the correct locations:
-** libdir=lib/ (linker-scripts and static archives)
-** slibdir=usr/lib/ (shared objects)
-** rtlddir=lib/ (dynamic linker)
+{% call format("para") -%}
+The host system upon which the cross-compiler will run requires a minimum of glibc 2.14, because of API changes to glibc's memcpy API.
+{% endcall %}
 
-h3. 2015.08-rc1
+{{ urlind(8,"https://bugs.linaro.org/show_bug.cgi?id=1869") }}
 
-* @x86_64@ hosted, @armv8l-linux-gnueabihf@ targetted cross toolchain now provided.
-** Delivering on "REQ-477":https://cards.linaro.org/browse/REQ-477 - *Enable x86_64 to Aarch32 (32-bit ARMv8-A) cross binary toolchain product release* and "CARD-1637":https://cards.linaro.org/browse/CARD-1637 - *Enable Aarch32 (32-bit ARMv8-A) cross binary toolchain product releases*, @armv8l-linux-gnueabihf@ targetted toolchains are now available as part of this {{ snap_rc_release|lower }}.
-* Python support in GDB for both Linux and Mingw32 (32-bit windows).
-** Delivered as requested in the linaro-toolchain mailing list post title - *"windows binary builds with gdb-python enabled?":https://lists.linaro.org/pipermail/linaro-toolchain/2015-June/005077.html*.
-* Added missing expat support to GDB.
-** This addresses the following linaro-toolchain mailing list post - *"Missing expat support in GDB 7.8":https://lists.linaro.org/pipermail/linaro-toolchain/2015-September/005223.html*.
-* multi-lib enablement for arm bare-metal targets.
-** As discussed in "ABE Review 6862":https://review.linaro.org/#/c/6862/ , this is required for baremetal toolchains.
-* Library Paths are now congruent with older Linaro Toolchain path layouts.  This addresses "Linaro Bugzilla 1717":https://bugs.linaro.org/show_bug.cgi?id=1717 - *Linaro-4.9-2015.05 moved system libs from /libc/lib/ to /libc/usr/lib/ which breaks things*.
-** libdir=lib/ (shared objects)
-** slibdir=usr/lib/ (static libraries)
-** rtlddir=lib/ (dynamic linker)
-#}
+{{ header(2, 'Package Versions') }}
+{# Package version information specific to a release imported from
+   the NEWS.textile.<version> file.  #}
+{%- block gcc_version_block %}{% endblock %}
 
-{% if announce == "" -%}
-h2. NOTES
+{% block glibc_version_block %}{% endblock %}
 
-* The toolchain component source {{ snap_rc_release|lower }} archives for the individual components are at "http://{% if snap_rc_release|lower == "release" -%}releases{% else -%}snapshots{% endif -%}.linaro.org/components/toolchain/":http://{% if snap_rc_release|lower == "release" -%}releases{% else -%}snapshots{% endif -%}.linaro.org/components/toolchain/. Select the component (e.g. gcc, glibc, binutils, gdb) as available.  If the component isn't available then it means that a git repository tag or branch was used for the binary toolchain build.  Please refer to the manifest files for complete information on the components used to build this toolchain.
+{% block newlib_version_block %}{% endblock %}
 
-* The binary tarball has been split into 3 parts. As a result, you can install only the parts needed:
-** @gcc-linaro-*.tar.xz@ - the compiler and tools
-** @runtime-linaro-*.tar.xz@ - runtime libraries needed on the target
-** @sysroot-linaro-*.tar.xz@ - sysroot (a set of libraries and headers to develop against)
+{% block binutils_version_block %}{% endblock %}
 
-* Presently, only the bare-metal toolchains are multilib enabled.  There is a plan to enable multilib for arm-linux toolchains in the near future.
+{% block gdb_version_block %}{% endblock %}
 
-* Beginning 2014.11, sysroots will provide newer glibc versions (as chose by Linaro engineers) in order that users get the latest features and optimizations in the system libraries.
+{% call format("para") %}
+Linaro toolchain package git branches are hosted at:
+{% endcall %}
 
-* Eglibc 2.15 compatible sysroots will no longer be released. Users that require Eglibc 2.15 sysroots that need the latest Linaro GCC compiler should use a previous quarterly released sysroot of the required version.
+{{ urlind(8,"http://git.linaro.org/?a=project_list&s=toolchain%2F&btnS=Search") }}
 
-* With the exception of the arm-linux-gnueabihf targetted toolchain, the x86 (32-bit) Linux host toolchains are no longer provided. x86_64 (64-bit) Linux host toolchains are provided instead.  This is because using LTO requires a 64-bit host toolchain.
+{% set news_header="NEWS for " + linaro_gcc_version -%}
 
-* The arm-linux-gnueabihf targeted toolchain no longer supports soft-float.  The arm-linux-gnueabi targeted toolchain should be used for this purpose.
+{{ header(2, news_header) }}
+{# NEWS specific to the release is imported from the NEWS.textile.<version>
+   files if there is any.  #}
+{% block news %}{% endblock %}
 
-h3. Feedback and Support
+{{ header(2, "Contact Linaro") }}
 
-Subscribe to the important Linaro mailing lists and join our IRC channels to stay on top of Linaro development.
+File bugs at {{ url("http://bugs.linaro.org") }}
 
-** Linaro Bugzilla "bug tracker for Linaro Linux Binary Toolchains":https://bugs.linaro.org/buglist.cgi?list_id=5882&product=Linux%20Binary%20toolchain&query_format=advanced&resolution=---
-** Linaro Toolchain Development "mailing list":http://lists.linaro.org/mailman/listinfo/linaro-toolchain
-** Linaro Toolchain IRC channel on irc.freenode.net at @#linaro-tcwg@
+For Linaro member support see {{ url("http://support.linaro.org") }}
 
-* Questions? "ask Linaro":http://ask.linaro.org/.
-* Interested in commercial support? inquire at "Linaro support":mailto:support@linaro.org
-{% endif %}
+For Linaro community support email {{ email("linaro-toolchain@lists.linaro.org") }}
diff --git a/components/toolchain/binaries/README.textile.GCC-5.3-2016.02-rc1 b/components/toolchain/binaries/README.textile.GCC-5.3-2016.02-rc1
new file mode 100644
index 0000000..a5a3b66
--- /dev/null
+++ b/components/toolchain/binaries/README.textile.GCC-5.3-2016.02-rc1
@@ -0,0 +1,66 @@
+{# This document uses jinja2 templating markup.  Please refer to the #}
+{# Jinja2 template documentation for further information. #}
+{# http://jinja.pocoo.org/docs/dev/templates/ #}
+{# Pull in the macros that differentiate between textile and no-txt -#}
+{% from "components/toolchain/binaries/macros" import header with context -%}
+{% from "components/toolchain/binaries/macros" import url with context -%}
+{% from "components/toolchain/binaries/macros" import urlind with context -%}
+{% from "components/toolchain/binaries/macros" import email with context -%}
+{% from "components/toolchain/binaries/macros" import format with context -%}
+{%- extends "components/toolchain/binaries/README.textile"-%}
+
+{# Information important for the release goes into this block.
+   It is added right after the release announce in README. #}
+{% block important %}
+{% call format("para") -%}
+Notice: All Linaro GCC {{ major }} series toolchain users should migrate to the latest version of the Linaro GCC {{ major }} toolchain in order to mitigate potential security exposure to CVE-2015-7545.  See the NEWS section below for details.
+{% endcall %}
+{% endblock %}
+
+{% block gcc_version_block %}
+{{ linaro_gcc_version }}
+{% endblock %}
+
+{% block glibc_version_block %}
+FSF glibc 2.21 (release/2.21)
+{% endblock %}
+
+{% block newlib_version_block %}
+Linaro newlib 2.1.0-2014.09 (linaro_newlib-branch)
+{% endblock %}
+
+{% block binutils_version_block %}
+Linaro binutils 2.25 (linaro_binutils-2_25-branch)
+{% endblock %}
+
+{% block gdb_version_block %}
+FSF GDB 7.10 (gdb-7.10-branch)
+{% endblock %}
+
+{% block news %}
+
+{% call format("news") %}
+Applied fix for CVE-2015-7545 - A stack-based buffer overflow in glibc's getaddrinfo() was corrected in glibc 2.23 and backported into glibc 2.21.
+{% endcall %}
+
+{{ urlind(6,"https://sourceware.org/ml/libc-alpha/2016-02/msg00416.html") }}
+
+{% call format("news") -%}
+ARMv8.1 Instruction Support - ARMv8.1 instructions support was checked into GCC and binutils.   It has been backported into Linaro GCC 5.3 and Linaro binutils 2.25.
+{% endcall %}
+
+{% call format("news") -%}
+Backported -Bsymbolic-functions into Linaro binutils 2.25.
+{% endcall %}
+
+{% call format("news") -%}
+Performance related backports from Linaro GCC 5.2-2015.11, Linaro GCC 5.2-2015.12, and Linaro GCC 5.3-2016.01-1 have been included.
+
+See the following Linaro GCC snapshots:
+{% endcall %}
+
+{{ urlind(6,"http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.2-2015.11/") }}
+{{ urlind(6,"http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.3-2015.12/") }}
+{{ urlind(6,"http://snapshots.linaro.org/components/toolchain/gcc-linaro/5.3-2016.01-1/") }}
+
+{% endblock %}
diff --git a/components/toolchain/binaries/README.textile.version b/components/toolchain/binaries/README.textile.version
new file mode 100644
index 0000000..de4bb87
--- /dev/null
+++ b/components/toolchain/binaries/README.textile.version
@@ -0,0 +1,61 @@
+{# This document uses jinja2 templating markup.  Please refer to the #}
+{# Jinja2 template documentation for further information. #}
+{# http://jinja.pocoo.org/docs/dev/templates/ #}
+{# Pull in the macros that differentiate between textile and no-txt -#}
+{% from "components/toolchain/binaries/macros" import header with context -%}
+{% from "components/toolchain/binaries/macros" import url with context -%}
+{% from "components/toolchain/binaries/macros" import urlind with context -%}
+{% from "components/toolchain/binaries/macros" import email with context -%}
+{% from "components/toolchain/binaries/macros" import format with context -%}
+{%- extends "components/toolchain/binaries/README.textile"-%}
+
+{# Information important for the release goes into this block.
+   It is added right after the release announce in README. #}
+{% block important %}
+{% call format("para") -%}
+Notice: All Linaro GCC {{ major }} series toolchain users should migrate to the latest version of the Linaro GCC {{ major }} toolchain in order to mitigate potential security exposure to CVE-2015-7545.  See the NEWS section below for details.
+{% endcall %}
+{% endblock %}
+
+{% block gcc_version_block %}
+
+{{ linaro_gcc_version }}
+
+{{ urlind(2,srcurl) }}
+{% endblock %}
+
+{% block glibc_version_block %}
+FSF glibc 2.21 (release/2.21)
+
+{{ urlind(2,"https://sourceware.org/git/?p=glibc.git;a=tree;h=refs/heads/release/2.21/master;hb=refs/heads/release/2.21/master") }}
+{% endblock %}
+
+{% block newlib_version_block %}
+Linaro newlib 2.1.0-2014.09 (linaro_newlib-branch)
+
+{{ urlind(2,"http://git.linaro.org/toolchain/newlib.git/shortlog/refs/heads/linaro_newlib-branch") }}
+{% endblock %}
+
+{% block binutils_version_block %}
+Linaro binutils 2.25 (linaro_binutils-2_25-branch)
+
+{{ urlind(2,"http://git.linaro.org/toolchain/binutils-gdb.git/shortlog/refs/heads/linaro_binutils-2_25-branch") }}
+{% endblock %}
+
+{% block gdb_version_block %}
+FSF GDB 7.10 (gdb-7.10-branch)
+
+{{ urlind(2,"http://git.linaro.org/toolchain/binutils-gdb.git/shortlog/refs/heads/gdb-7.10-branch") }}
+{% endblock %}
+
+{% block news %}
+
+{% call format("news") -%}
+This is an example news section.
+
+This news section has a second line.
+{% endcall %}
+
+{{ urlind(6,"http://snapshots.linaro.org/components/toolchain/gcc-linaro/") }}
+
+{% endblock %}
diff --git a/components/toolchain/binaries/macros b/components/toolchain/binaries/macros
new file mode 100644
index 0000000..925d984
--- /dev/null
+++ b/components/toolchain/binaries/macros
@@ -0,0 +1,80 @@
+{# We can use indenting because we set lstrip_blocks=True
+   when we setup the jinja2 environment. #}
+{% set tw = 70 %}
+
+{% macro header(depth, text) %}
+    {% if announce != "yes" -%}h{{depth}}. {% endif -%}{{text}}
+    {% if announce == "yes" -%}{% for n in text -%}
+    ={% endfor -%}={% endif -%}
+{% endmacro -%}
+
+{%- macro url(text) -%}
+    {%- if announce != "yes" -%}
+        "{{ text }}":{{ text }}
+    {%- else -%}
+        {{ text }}
+    {%- endif -%}
+{%- endmacro -%}
+
+{%- macro email(text) -%}
+    {%- if announce != "yes" -%}
+        "{{ text }}":mailto:{{ text }}
+    {%- else -%}
+        {{ text }}
+    {%- endif -%}
+{%- endmacro -%}
+
+{% macro urlind(ind,text) -%}
+    {% if announce != "yes" -%}
+	p
+	{%- for i in range(0, ind // 2) -%}
+	(
+	{%- endfor -%}
+	. "{{ text }}":{{ text }}
+    {% else -%}
+	{{ text|indent(ind, true) }}
+    {%- endif -%}
+{%- endmacro -%}
+
+{# @ - 'news', '', 'para' #}
+{# if it is news we use '* ' and don't indent the first line.     #}
+{# if it is cont we don't use '* ' and we do indent the first line.     #}
+{# if it is para we don't indent and don't use '* '     #}
+{% macro format(mode) -%}
+    {%- for line in caller().splitlines() -%}
+        {%- if announce == "yes" -%}
+            {%- if mode == "news" -%}
+                {%- if loop.index0 == 0 -%}
+                  * {{ line|customwordwrap(tw, False)|indent(2, False) }}
+                {% else -%}
+                    {{ line|customwordwrap(tw, False)|indent(2, True) }}
+                {% endif %}
+            {% elif mode == "newscont" -%}
+                {{ line|customwordwrap(tw, False)|indent(2, True) }}
+            {% elif mode == "para" -%}
+                {{ line|customwordwrap(tw, False) }}
+	    {% endif %}
+        {# else this is textile mode #}
+        {%- else -%}
+            {%- if mode == "news" -%}
+                {%- if loop.index0 == 0 -%}
+		  * {{ line }}
+
+                {% else -%}
+                    p
+                    {%- for i in range(0, 3) -%}
+                    (
+                    {%- endfor -%}. {{ line }}
+
+                {% endif %}
+            {% elif mode == "newscont" -%}
+               p
+               {%- for i in range(0, 3) -%}
+               (
+               {%- endfor -%}. {{ line }}
+            {% elif mode == "para" -%}
+                {{ line }}
+	    {% endif %}
+	{%- endif -%}
+    {%- endfor -%}
+{%- endmacro -%}