Update with new information on binary toolchain release notes.

1 files changed, 84 insertions, 42 deletions

diff --git a/components/toolchain/binaries/README.textile b/components/toolchain/binaries/README.textile
index accd40a..bd49258 100644
--- a/components/toolchain/binaries/README.textile
+++ b/components/toolchain/binaries/README.textile
@@ -1,90 +1,132 @@
-p. The Linaro Toolchain Working Group is pleased to announce this quarter's release of the Linaro Toolchain Binaries, a pre-built version of Linaro GCC and Linaro GDB that runs on generic Linux or Windows and targets the glibc Linaro Engineering Build.
+h1. Linaro *Stable* Binary Toolchain Release
 
-p. Beginning 2014.11, Linaro is changing the layout and structure of its prebuilt toolchain binary releases. 2014.11 is the first release built with ABE, adding more maintainable code base and automatic testing. For further details on ABE, please visit https://wiki.linaro.org/ABE.
+p. The Linaro Toolchain Working Group is pleased to announce this quarter's release of the Linaro *stable* Toolchain Binary Release Archives.
 
-p. The folder names above describe the 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. 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.
 
-p. Inside each folder is also a @manifest.txt@ file further describing the target and host systems meant for the toolchain, plus source component versions.
+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. Essentially, the main folder contents are as follows:
+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.
 
-aarch64-linux-gnu
-* gcc-linaro-*x86_64_aarch64-linux-gnu.tar.xz
+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
+* @gcc-linaro-*i686-mingw32_aarch64-linux-gnu.tar.xz@
 ** Windows 32-bit binaries for the Aarch64 Linux cross-toolchain
 
-aarch64-none-elf
-* gcc-linaro-*x86_64_aarch64-elf.tar.xz
+h3. armv8l-linux-gnueabihf
+
+p. _Toolchains for little-endian, 32-bit ARMv8 for GNU/Linux systems_
+
+* _Not yet available_
+
+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
+* @gcc-linaro-*i686-mingw32_aarch64-elf.tar.xz@
 ** Windows 32-bit binaries for the Aarch64 bare-metal cross-toolchain
 
-aarch64_be-linux-gnu
-* gcc-linaro-*x86_64_aarch64_be-linux-gnu.tar.xz
+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
+* @gcc-linaro-*i686-mingw32_aarch64_be-linux-gnu.tar.xz@
 ** Windows 32-bit binaries for the Aarch64 Linux Big Endian cross-toolchain
 
-aarch64_be-none-elf
-* gcc-linaro-*x86_64_aarch64_be-elf.tar.xz
+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
+* @gcc-linaro-*i686-mingw32_aarch64_be-elf.tar.xz@
 ** Windows 32-bit binaries for the Aarch64 bare-metal Big Endian cross-toolchain
 
-arm-linux-gnueabi
-* gcc-linaro-*x86_64_arm-linux-gnueabi.tar.xz
+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
+* @gcc-linaro-*i686-mingw32_arm-linux-gnueabi.tar.xz@
 ** Windows 32-bit binaries for the ARMv7 Linux soft float cross-toolchain
 
-arm-linux-gnueabihf
-* gcc-linaro-*x86_64_arm-linux-gnueabihf.tar.xz
+h3. arm-linux-gnueabihf
+
+p. _Toolchains for little-endian, hard-float, 32-bit ARMv7 (and earlier) for GNU/Linux systems_
+
+* @gcc-linaro-*x86_arm-linux-gnueabihf.tar.xz@
+** _Not yet available- 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
+* @gcc-linaro-*i686-mingw32_arm-linux-gnueabihf.tar.xz@
 ** Windows 32-bit binaries for the ARMv7 Linux hard float cross-toolchain
 
-arm-none-eabi
-* gcc-linaro-*x86_64_arm-eabi.tar.xz
+h3. arm-none-eabi
+
+p. _Toolchains for little-endian, soft-float, 32-bit ARMv7 (and earlier) for bare-metal systems_
+
+* @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
+* @gcc-linaro-*i686-mingw32_arm-eabi.tar.xz@
 ** Windows 32-bit binaries for the ARMv7 bare-metal cross-toolchain
 
-armeb-linux-gnueabihf
-* gcc-linaro-*x86_64_armeb-linux-gnueabihf.tar.xz
+h3. armeb-linux-gnueabihf
+
+p. _Toolchains for big-endian, hard-float, 32-bit ARMv7 (and earlier) for GNU/Linux systems_
+
+* @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
+* @gcc-linaro-*i686-mingw32_armeb-linux-gnueabihf.tar.xz@
 ** Windows 32-bit binaries for the ARMv7 Linux Big Endian hard float cross-toolchain
 
-armeb-none-eabi
-* gcc-linaro-*x86_64_armeb-eabi.tar.xz
+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
+* @gcc-linaro-*i686-mingw32_armeb-eabi.tar.xz@
 ** Windows 32-bit binaries for the ARMv7 bare-metal Big Endian cross-toolchain
 
-h4. NOTE
+h2. NOTE
 
-* The binary source package is no longer distributed as the components are now archived at http://abe.tcwglab.linaro.org/snapshots and downloaded automatically based on manifest.txt when (re)building with ABE.
+* The toolchain component source release archives for the individual components are at http://releases.linaro.org/latest/components/toolchain. Select the component (e.g. gcc, glibc, binutils, gdb) as necessary.
 
-* The source package releases for the individual components are still at http://releases.linaro.org/latest/components/toolchain. Select the component (e.g. gcc, glibc, binutils, gdb) as necessary.
+* 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)
 
-* The binary tarball has been splitted 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)
+* Presently, only the bare-metal toolchains are multilib enabled.  There is a plan to enable multilib for arm-linux toolchains in the near future.
 
-* Beginning 2014.11, sysroots will use the latest glibc release provided by Linaro engineers in order that users get the latest features and optimizations in the system libraries.
+* 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.
 
-* 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 the previous quarterly released sysroot.
+* 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.
 
 * x86 (32-bit) Linux host toolchains are no longer provided. x86_64 (64-bit) Linux host toolchains are provided instead.
 
-* Soft-float targeted linux toolchains are no longer supported.
+* The arm-linux-gnueabihf targeted toolchain no longer supports soft-float.  The arm-linux-gnueabi targeted toolchain should be used for this purpose.
 
 h3. Feedback and Support
 
 Subscribe to the important Linaro mailing lists and join our IRC channels to stay on top of Linaro development.
 
+** 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@