PNaCl documentation: add SIMD vectors.

native_client_sdk/doc_generated/sdk/release-notes.html

 {{+bindTo:partials.standard_nacl_article}}
 
 <section id="release-notes">
 <span id="sdk-release-notes"></span><h1 id="release-notes"><span id="sdk-release-notes"></span>Release Notes</h1>
-<section id="chrome-pepper-35-31-mar-2014">
-<h2 id="chrome-pepper-35-31-mar-2014">Chrome/Pepper 35 (31 Mar 2014)</h2>
+<section id="chrome-pepper-36-09-may-2014">
+<h2 id="chrome-pepper-36-09-may-2014">Chrome/Pepper 36 (09 May 2014)</h2>
 <section id="pnacl">
 <h3 id="pnacl">PNaCl</h3>
 <ul class="small-gap">
+<li>Support <a class="reference external" href="http://clang.llvm.org/docs/LanguageExtensions.html#vectors-and-extended-vectors">LLVM vectors</a>
+/ <a class="reference external" href="http://gcc.gnu.org/onlinedocs/gcc/Vector-Extensions.html">GCC vectors</a> for SIMD
+vectors.</li>
+</ul>
+</section></section><section id="chrome-pepper-35-31-mar-2014">
+<h2 id="chrome-pepper-35-31-mar-2014">Chrome/Pepper 35 (31 Mar 2014)</h2>
+<section id="id1">
+<h3 id="id1">PNaCl</h3>
+<ul class="small-gap">
 <li>Upgraded LLVM to version 3.4.</li>
 <li>Translation now uses dynamic load balancing, making translation time faster.</li>
 <li>Unstable pexes (i.e. non-finalized) with debug information can be loaded by
 Chrome, simplifying debugging with PNaCl. See <a class="reference internal" href="/native-client/devguide/devcycle/debugging.html#debugging-pnacl-pexes"><em>Debugging PNaCl pexes</em></a></li>
 </ul>
 </section></section><section id="chrome-pepper-34-20-feb-2014">
 <h2 id="chrome-pepper-34-20-feb-2014">Chrome/Pepper 34 (20 Feb 2014)</h2>
 <section id="pepper">
 <h3 id="pepper">Pepper</h3>
 <ul class="small-gap">
 <li>Filesystems can now be passed from JavaScript to NaCl. The resulting
 <code>pp::Var</code> will contain a <code>pp::Resource</code> that can be given to the
 <code>pp::FileSystem</code> constructor.</li>
 <li>New Audio and Video input APIs have been added as dev interfaces. See
 <a class="reference external" href="/native-client/pepper_dev/cpp/classpp_1_1_media_stream_audio_track">pp::MediaStreamAudioTrack</a> and
 <a class="reference external" href="/native-client/pepper_dev/cpp/classpp_1_1_media_stream_video_track">pp::MediaStreamVideoTrack</a> for
 more details.</li>
 </ul>
-</section><section id="id1">
-<h3 id="id1">PNaCl</h3>
+</section><section id="id2">
+<h3 id="id2">PNaCl</h3>
 <ul class="small-gap">
 <li>Parallel translation: at least 1.7x faster, even with older pexes.</li>
 <li>Intelligent abbreviations in the bitcode: 20% reduction in binary size using
 the <a class="reference internal" href="/native-client/devguide/devcycle/building.html#pnacl-compress"><em>pnacl-compress</em></a> tool.</li>
 </ul>
 </section></section><section id="chrome-pepper-33-16-dec-2013">
 <h2 id="chrome-pepper-33-16-dec-2013">Chrome/Pepper 33 (16 Dec 2013)</h2>
 <section id="portable-native-client">
 <h3 id="portable-native-client">Portable Native Client</h3>
 <ul class="small-gap">
@@ skipping 118 matching lines @@
 <li>Common makefiles, including <code>tools/common.mk</code>, can now handle source files
 located outside of an application&#8217;s root directory. For example, a Makefile
 for an application can specify a source file to compile such as
 <code>../../some/other/place.cpp</code>.</li>
 </ul>
 </section></section><section id="pepper-26-29-march-2013">
 <h2 id="pepper-26-29-march-2013">Pepper 26 (29 March 2013)</h2>
 <p>The Pepper 26 bundle includes a new HTTP filesystem type in the nacl_mounts
 library (which has been renamed nacl_io), changes to the example Makefiles, a
 simple new 3D example, and a threaded file IO example.</p>
-<section id="id2">
-<h3 id="id2">Build tools and toolchains</h3>
+<section id="id3">
+<h3 id="id3">Build tools and toolchains</h3>
 <ul class="small-gap">
 <li><p class="first">Makefiles have been changed significantly:</p>
 <ul class="small-gap">
 <li>Build commands are now specified in a number of common files
 (<code>tools/*.mk</code>), which are included in the Makefiles in the examples.</li>
 <li>By default, make displays a simplified list of build steps (e.g., <code>CC
 newlib/Debug/hello_world_x86_32.o</code>) rather than the actual build commands.
 To see the actual build commands, run <code>make V=1</code>.</li>
 <li>By default, most examples are built using one toolchain (newlib) and one
 configuration (Debug). To build an example using a different toolchain or
 configuration, run <code>make</code> with the parameters <code>TOOLCHAIN=&lt;x&gt;</code> or
 <code>CONFIG=&lt;y&gt;</code>.  You can also run make <code>all_versions</code> to build an example
 with all toolchains.</li>
 </ul>
 </li>
 <li>Header files have been moved out of the toolchains. All toolchains now share
 the same set of header files as host builds. Previously host and NaCl builds
 used different headers, which could cause build problems.</li>
 </ul>
-</section><section id="id3">
-<h3 id="id3">Libraries</h3>
+</section><section id="id4">
+<h3 id="id4">Libraries</h3>
 <ul class="small-gap">
 <li>The nacl_mounts library has been renamed <strong>nacl_io</strong>, and has been expanded
 with a new type of mount, httpfs, which can be used to read URLs via HTTP.
 For details see <code>include/nacl_io/nacl_io.h</code>, as well as the
 <code>hello_nacl_io</code> example.</li>
 </ul>
-</section><section id="id4">
-<h3 id="id4">Examples</h3>
+</section><section id="id5">
+<h3 id="id5">Examples</h3>
 <ul class="small-gap">
 <li>A new example, <strong>hello_world_instance3d</strong>, has been added to demonstrate a
 simplified 3D app.</li>
 <li>The <strong>file_io</strong> example has been rewritten to do all file operations on a
 thread.  The example demonstrates how to use the MessageLoop API and blocking
 callbacks on a thread.</li>
 </ul>
 </section><section id="general">
 <h3 id="general">General</h3>
 <ul class="small-gap">
 <li>Old bundles (<code>pepper_20</code> and earlier) have been removed from the Native
 Client SDK Manifest, and will no longer be updated by the <code>naclsdk</code>
 command.</li>
 </ul>
 </section></section><section id="pepper-25-21-december-2012">
 <h2 id="pepper-25-21-december-2012">Pepper 25 (21 December 2012)</h2>
 <p>The Pepper 25 bundle features an ARM toolchain to build Native Client modules
 for ARM devices, two new Pepper APIs (including the MessageLoop API, which lets
 you make Pepper calls on background threads), two new libraries (nacl_mounts,
 which provides a virtual file system that you can use with standard C file
 operations, and ppapi_main, which lets you implement a Native Client module
 using a simple ppapi_main function), and two new examples that demonstrate how
 to use the nacl_mounts and ppapi_main libraries.</p>
-<section id="id5">
-<h3 id="id5">Build tools and toolchains</h3>
+<section id="id6">
+<h3 id="id6">Build tools and toolchains</h3>
 <ul class="small-gap">
 <li><p class="first">The SDK includes a new toolchain to build Native Client executables (.nexe
 files) for <strong>ARM devices</strong>.</p>
 <ul class="small-gap">
 <li>Currently the ARM toolchain can only be used to compile modules that use
 the <a class="reference internal" href="/native-client/devguide/devcycle/dynamic-loading.html#c-libraries"><em>newlib C library</em></a>. You cannot use the ARM toolchain
 to compile modules that use the glibc library.</li>
 <li>The ARM toolchain is in the directory
 <code>pepper_25/toolchain/&lt;host&gt;_arm_newlib</code>.  The bin subdirectory contains
 the compiler (<code>arm-nacl-gcc</code>), the linker (<code>arm-nacl-g++</code>), and the
@@ skipping 17 matching lines @@
 lets your module log messages to the JavaScript console in the Chrome browser.</li>
 <li>The <a class="reference external" href="https://developers.google.com/native-client/dev/peppercpp/classpp_1_1_message_loop">MessageLoop</a>
 API lets your module make PPAPI calls on a background thread.  Once you&#8217;ve
 created a message loop resource, attached it to a thread, and run it, you can
 post work to the thread, including completion callbacks for asynchronous
 operations. For a C++ example of how to use the MessageLoop API,
 see <code>pepper_25/include/ppapi/utility/threading/simple_thread.h</code>. Note that
 you cannot make asynchronous PPAPI calls on a background thread without
 creating and using a message loop.</li>
 </ul>
-</section><section id="id6">
-<h3 id="id6">Libraries</h3>
+</section><section id="id7">
+<h3 id="id7">Libraries</h3>
 <p>The SDK includes two new libraries:</p>
 <ul class="small-gap">
 <li><p class="first">The <strong>nacl_mounts</strong> library provides a virtual file system that your module
 can &#8220;mount&#8221; in a given directory tree. The file system can be one of several
 types:</p>
 <ul class="small-gap">
 <li>&#8220;memfs&#8221; is an in-memory file system,</li>
 <li>&#8220;dev&#8221; is a file system with various utility nodes (e.g., <code>/dev/null</code>,
 <code>/dev/console[0-3]</code>, <code>/dev/tty</code>), and</li>
 <li>&#8220;html5fs&#8221; is a persistent file system.</li>
@@ skipping 13 matching lines @@
 providing a familiar C programming environment. With this library, your
 module can have a simple entry point called ppapi_main(), which is similar to
 the standard C main() function, complete with argc and argv[] parameters.
 Your module can also use standard C functions such as printf(), fopen(), and
 fwrite(). For details see include/ppapi_main/ppapi_main.h. For an example of
 how to use ppapi_main, see examples/hello_world_stdio.</li>
 </ul>
 <p>Header files for the new libraries are in the <code>include/</code> directory, source
 files are in the <code>src/</code> directory, and compiled libraries are in the <code>lib/</code>
 directory.</p>
-</section><section id="id7">
-<h3 id="id7">Examples</h3>
+</section><section id="id8">
+<h3 id="id8">Examples</h3>
 <ul class="small-gap">
 <li><p class="first">The SDK includes two new examples:</p>
 <ul class="small-gap">
 <li><strong>hello_nacl_mounts</strong> illustrates how to use standard C library file
 operations in a Native Client module through the use of the nacl_mounts
 library.</li>
 <li><strong>hello_world_stdio</strong> illustrates how to implement a Native Client module
 with a ppapi_main() function, and how to write to STDOUT and STDERR in a
 module, through the use of the nacl_mounts and ppapi_main libraries. This
 example makes it easy for new users to get started with Native Client by
@@ skipping 21 matching lines @@
 <li>The hello_world_stdio example includes a simplified Makefile that only lists
 source dependencies, and invokes the build rules in a separate file
 (common.mk).</li>
 </ul>
 </section></section><section id="pepper-24-5-december-2012">
 <h2 id="pepper-24-5-december-2012">Pepper 24 (5 December 2012)</h2>
 <p>The Pepper 24 bundle features a new, experimental toolchain called PNaCl (short
 for &#8220;Portable Native Client&#8221;), a new library (pthreads-win32) for the Windows
 SDK, and an expanded list of attributes for Pepper 3D contexts that lets
 applications specify a GPU preference for low power or performance.</p>
-<section id="id8">
-<h3 id="id8">Build tools and toolchains</h3>
+<section id="id9">
+<h3 id="id9">Build tools and toolchains</h3>
 <ul class="small-gap">
 <li>The SDK includes a new, experimental toolchain called <a class="reference external" href="http://nativeclient.googlecode.com/svn/data/site/pnacl.pdf">PNaCl</a> (pronounced
 &#8220;pinnacle&#8221;). The PNaCl toolchain produces architecture-independent executable
 files (.pexe files). Chrome doesn&#8217;t yet support .pexe files directly, but if
 you want to experiment with this early preview of PNaCl, the toolchain
 includes a tool to translate .pexe files into architecture-specific .nexe
 files. Take a look at the <code>hello_world</code> example to see how to build a .pexe
 file and translate it into multiple .nexe files. Note that PNaCl is currently
 restricted to the newlib C standard library – if your application uses glibc,
 you can&#8217;t build it with PNaCl.</li>
 <li>The <code>create_nmf.py</code> script uses ELF headers (rather than file names) to
 determine the architecture of .nexe files. That means you can change the
 names of your .nexe files and <code>create_nmf.py</code> will still be able to
 generate the appropriate Native Client manifest file for your application.</li>
 </ul>
-</section><section id="id10">
-<h3 id="id10">Examples</h3>
+</section><section id="id11">
+<h3 id="id11">Examples</h3>
 <ul class="small-gap">
 <li>The SDK examples now build with four toolchains: the glibc and newlib
 toolchains, the experimental PNaCl toolchain, and the hosted toolchain on
 your development machine. Within each toolchain build, each example also
 builds both a debug and a release version.</li>
 <li>The example Makefiles use dependency (.d) files to enable incremental builds.</li>
 <li>The pong example has been cleaned up and modified to run more smoothly. The
 drawing function is now set up as the Flush() callback, which allows 2D
 drawing to occur as quickly as possible.</li>
 </ul>
-</section><section id="id11">
-<h3 id="id11">PPAPI</h3>
+</section><section id="id12">
+<h3 id="id12">PPAPI</h3>
 <ul class="small-gap">
 <li>When creating a 3D rendering context, the <a class="reference external" href="https://developers.google.com/native-client/dev/pepperc/group___enums#ga7df48e1c55f6401beea2a1b9c07967e8">attribute list</a>
 for the context can specify whether to prefer low power or performance for
 the GPU. Contexts with a low power preference may be created on an integrated
 GPU; contexts with a performance preference may be created on a discrete GPU.</li>
 </ul>
 </section><section id="windows-sdk">
 <h3 id="windows-sdk">Windows SDK</h3>
 <ul class="small-gap">
 <li>The Windows SDK includes the pthreads-win32 library to assist in porting from
@@ skipping 55 matching lines @@
 <ul class="small-gap">
 <li>Look at the example Makefiles or run <code>make</code> in the example directories to
 see the commands and flags used to build modules as Pepper plugins.</li>
 <li>Run <code>make LAUNCH</code> in the example directories to see how to use the
 <code>--register-pepper-plugins</code> argument to load a Pepper plugin in Chrome.
 Note that you must set the <code>CHROME_PATH</code> environment variable and start a
 <a class="reference internal" href="/native-client/devguide/devcycle/running.html#web-server"><em>local server</em></a> prior to running this command.</li>
 </ul>
 </li>
 </ul>
-</section><section id="id12">
-<h3 id="id12">Examples</h3>
+</section><section id="id13">
+<h3 id="id13">Examples</h3>
 <ul class="small-gap">
 <li>On Linux and Windows systems, most of the examples now build with three
 toolchains: the Native Client glibc and newlib toolchains, and the native
 toolchain on the host system. Modules built with the native toolchain on the
 host system can only run as Pepper plugins.</li>
 <li>All examples in the SDK now comply with version 2 of the Chrome Web Store
 <a class="reference external" href="http://developer.chrome.com/extensions/manifest.html">manifest file format</a>. By default,
 applications that use version 2 of the manifest file format apply a strict
 <a class="reference external" href="http://developer.chrome.com/extensions/contentSecurityPolicy.html">content security policy</a>, which
 includes a restriction against inline JavaScript. This restriction prohibits
 both inline <code>&lt;script&gt;</code> blocks and inline event handlers (e.g., <code>&lt;button
 onclick=&quot;...&quot;&gt;</code>).  See <a class="reference external" href="http://developer.chrome.com/extensions/manifestVersion.html">Manifest Version</a> for a list of
 changes between version 1 and version 2 of the manifest file format, and a
 support schedule for applications that use version 1.</li>
 </ul>
-</section><section id="id13">
-<h3 id="id13">PPAPI</h3>
+</section><section id="id14">
+<h3 id="id14">PPAPI</h3>
 <ul class="small-gap">
 <li><a class="reference external" href="https://developers.google.com/native-client/pepper23/pepperc/group___enums#ga21b811ac0484a214a8751aa3e1c959d9">PP_InputEvent_Modifier</a>
 has two new enum values (_ISLEFT and _ISRIGHT).</li>
 <li>The memory leak in the <a class="reference external" href="https://developers.google.com/native-client/pepper23/pepperc/struct_p_p_b___web_socket__1__0">WebSocket</a>
 API has been fixed.</li>
 </ul>
 </section></section><section id="pepper-22-22-august-2012">
 <h2 id="pepper-22-22-august-2012">Pepper 22 (22 August 2012)</h2>
 <p>The Pepper 22 bundle includes a <strong>command-line debugger</strong>, resources to enable
 <strong>hosted development on Windows</strong>, and changes to the example Makefiles (each
 example now builds both a debug and a release version).</p>
-<section id="id14">
-<h3 id="id14">Tools</h3>
+<section id="id15">
+<h3 id="id15">Tools</h3>
 <ul class="small-gap">
 <li>The SDK now includes a <strong>command-line debugger</strong> that you can use to debug
 Native Client modules. See <a class="reference internal" href="/native-client/devguide/devcycle/debugging.html#devcycle-debugging"><em>Debugging with nacl-gdb</em></a> for instructions on how to use this debugger. For now,
 nacl-gdb only works on 64-bit Windows, 64-bit Linux, and 32-bit Linux
 systems. Support for Mac and 32-bit Windows systems will be added soon.</li>
 </ul>
-</section><section id="id15">
-<h3 id="id15">Windows SDK</h3>
+</section><section id="id16">
+<h3 id="id16">Windows SDK</h3>
 <ul class="small-gap">
 <li><p class="first">Developers using the Windows SDK can now <strong>build a module as a Pepper
 plugin</strong> (sometimes called a &#8220;trusted&#8221; or &#8220;in-process&#8221; plugin) using the
 native C/C++ compiler on their development system. In essence this makes
 developing a Native Client module a two-step process:</p>
 <ol class="arabic simple">
 <li>Build the module into a DLL using your system&#8217;s C/C++ compiler. Test and
 debug the DLL using the tools in your normal development environment.</li>
 <li>Build the module into a .nexe using the compiler from one of the Native
 Client toolchains in the SDK (nacl-gcc or nacl-g++). Test and debug the
@@ skipping 27 matching lines @@
 <strong>Note:</strong> It&#8217;s also possible to build a module as a trusted plugin on Mac and
 Linux systems, but doing so requires more work because the SDK does not yet
 include the above resources (library source files and pre-built libraries)
 for Mac and Linux systems. To build and debug a trusted plugin on Mac and
 Linux systems, you need to <a class="reference external" href="http://dev.chromium.org/developers/how-tos/get-the-code">get the Chromium code</a> and then follow
 the <a class="reference external" href="http://www.chromium.org/nativeclient/how-tos/debugging-documentation/debugging-a-trusted-plugin/trusted-debugging-on-mac">Mac instructions</a>
 or <a class="reference external" href="http://www.chromium.org/nativeclient/how-tos/debugging-documentation/debugging-a-trusted-plugin/debugging-a-trusted-plugin-on-linux">Linux instructions</a>.
 In the future, the SDK will include resources for hosted development on Mac
 and Linux as well as Windows.
 </aside>
-</section><section id="id16">
-<h3 id="id16">Examples</h3>
+</section><section id="id17">
+<h3 id="id17">Examples</h3>
 <ul class="small-gap">
 <li>Each example in the SDK now builds both a debug and a release version. As
 before, most examples also build newlib and glibc versions, which means that
 there are now four versions for each example. Take a look at the Makefiles in
 the examples to see the compiler flags that are used for debug and release
 versions. For a description of those flags, see <a class="reference internal" href="/native-client/devguide/devcycle/building.html#compile-flags"><em>Compile flags for
 different development scenarios</em></a>.</li>
 <li>Comments have been added to common.js, which is used in all the examples. The
 JavaScript in common.js inserts an &lt;embed&gt; element that loads the NaCl module
 in each example&#8217;s web page, attaches event listeners to monitor the loading
 of the module, and implements handleMessage() to respond to messages sent
 from the NaCl module to the JavaScript side of the application</li>
 </ul>
-</section><section id="id17">
-<h3 id="id17">PPAPI</h3>
+</section><section id="id18">
+<h3 id="id18">PPAPI</h3>
 <ul class="small-gap">
 <li>The <code>CompletionCallbackFactory</code> class template now takes a thread traits
 class as its second parameter. For details see the <a class="reference external" href="https://developers.google.com/native-client/pepper22/peppercpp/classpp_1_1_completion_callback_factory#details">CompletionCallbackFactory
 class template reference</a>.</li>
 </ul>
 </section></section></section>
 
 {{/partials.standard_nacl_article}}