Skip to content

Commit

Permalink
Add PNaCl release note about how to try out Subzero / which flag to set.
Browse files Browse the repository at this point in the history
  • Loading branch information
jvoung authored and Commit bot committed Apr 9, 2015
1 parent f4a6e44 commit 6726704
Show file tree
Hide file tree
Showing 4 changed files with 25 additions and 1 deletion.
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ <h4 id="example-of-a-program-for-portable-native-client">Example of a <code>prog
}
}
</pre>
<p>Portable Native Client applications can also specify an <code>optlevel</code> field.
<p id="pnacl-nmf-optlevels">Portable Native Client applications can also specify an <code>optlevel</code> field.
The <code>optlevel</code> field is an optimization level <em>hint</em>, which is a number
(zero and higher). Higher numbers indicate more optimization effort.
Setting a higher optimization level will improve the application&#8217;s
Expand Down
10 changes: 10 additions & 0 deletions native_client_sdk/doc_generated/sdk/release-notes.html
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,16 @@ <h3 id="pnacl">PNaCl</h3>
deprecated and will be removed in the next release. PNaCl has used libc++
(which is much more up-to-date, currently based on LLVM 3.6) as the default
since Pepper 33.</li>
<li>PNaCl&#8217;s experimental <a class="reference external" href="https://chromium.googlesource.com/native_client/pnacl-subzero/+/master/README.rst">Subzero translator</a> is available for x86-32 NaCl in
Chrome version 43, behind a flag. To give it a try, run Chrome with the
<code>--enable-pnacl-subzero</code> commandline flag, and use the <code>optlevel 0</code>
<a class="reference internal" href="/native-client/reference/nacl-manifest-format.html#pnacl-nmf-optlevels"><em>NaCl manifest option</em></a>. Application startup time
should be several times faster than the previous LLVM-based <code>optlevel 0</code>
mode, with similar code quality. Note that x86-32 NaCl requires a 32-bit
Chrome. On Windows, it also requires a 32-bit Windows OS, but 64-bit Linux
OSes can run x86-32 NaCl. If you try it out, please send us feedback
on <a class="reference external" href="https://groups.google.com/forum/#!forum/native-client-dev">native-client-dev</a>. We are working on improvements and adding
new targets.</li>
</ul>
<h3 id="pepper">Pepper</h3>
<ul class="small-gap">
Expand Down
2 changes: 2 additions & 0 deletions native_client_sdk/src/doc/reference/nacl-manifest-format.rst
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,8 @@ Example of a ``program`` for Portable Native Client:
}
}

.. _pnacl_nmf_optlevels:

Portable Native Client applications can also specify an ``optlevel`` field.
The ``optlevel`` field is an optimization level *hint*, which is a number
(zero and higher). Higher numbers indicate more optimization effort.
Expand Down
12 changes: 12 additions & 0 deletions native_client_sdk/src/doc/sdk/release-notes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,20 @@ PNaCl
deprecated and will be removed in the next release. PNaCl has used libc++
(which is much more up-to-date, currently based on LLVM 3.6) as the default
since Pepper 33.
* PNaCl's experimental `Subzero translator`_ is available for x86-32 NaCl in
Chrome version 43, behind a flag. To give it a try, run Chrome with the
``--enable-pnacl-subzero`` commandline flag, and use the ``optlevel 0``
:ref:`NaCl manifest option<pnacl_nmf_optlevels>`. Application startup time
should be several times faster than the previous LLVM-based ``optlevel 0``
mode, with similar code quality. Note that x86-32 NaCl requires a 32-bit
Chrome. On Windows, it also requires a 32-bit Windows OS, but 64-bit Linux
OSes can run x86-32 NaCl. If you try it out, please send us feedback
on `native-client-dev`_. We are working on improvements and adding
new targets.

.. _`code generation bug on ARM`: https://code.google.com/p/chromium/issues/detail?id=460432
.. _`Subzero translator`: https://chromium.googlesource.com/native_client/pnacl-subzero/+/master/README.rst
.. _`native-client-dev`: https://groups.google.com/forum/#!forum/native-client-dev

Pepper
------
Expand Down

0 comments on commit 6726704

Please sign in to comment.