Index: native_client_sdk/doc_generated/sdk/download.html |
diff --git a/native_client_sdk/doc_generated/sdk/download.html b/native_client_sdk/doc_generated/sdk/download.html |
index 8a57dbc71f0b839faafe81fd9cee706ee1e004c6..0cb7af41cadfd37394181602876fa194aab15d70 100644 |
--- a/native_client_sdk/doc_generated/sdk/download.html |
+++ b/native_client_sdk/doc_generated/sdk/download.html |
@@ -2,18 +2,16 @@ |
<section id="download-the-native-client-sdk"> |
<span id="download"></span><h1 id="download-the-native-client-sdk"><span id="download"></span>Download the Native Client SDK</h1> |
-<p>To build Native Client modules, you must download and install the Native Client |
-Software Development Kit (SDK). This page provides an overview of the Native |
-Client SDK, and instructions for how to download and install the SDK.</p> |
+<p>This page provides an overview of the Native Client SDK, and instructions for |
+downloading and installing the SDK.</p> |
<div id="home"> |
<a class="button-nacl button-download" href="http://storage.googleapis.com/nativeclient-mirror/nacl/nacl_sdk/nacl_sdk.zip">Download SDK Zip File</a> |
-</div><h2 id="overview">Overview</h2> |
-<p>The Native Client SDK includes the following:</p> |
+</div><h2 id="overview"><span id="sdk-overview"></span>Overview</h2> |
+<p>The Native Client SDK includes:</p> |
<ul class="small-gap"> |
<li><strong>Support for multiple Pepper versions</strong> to compile for specific minimum |
versions of Chrome.</li> |
-<li><strong>Update utility</strong> to download new bundles that are available, as well as new |
-versions of existing bundles.</li> |
+<li><strong>Update utility</strong> to download new bundles and updates to existing bundles.</li> |
<li><strong>Toolchains</strong> to compile for Portable Native Client (PNaCl), traditional |
Native Client (NaCl), and for compiling architecture-specific Native Client |
applications with glibc.</li> |
@@ -24,45 +22,40 @@ the toolchains.</li> |
command line.</li> |
</ul> |
<p>Follow the steps below to download and install the Native Client SDK.</p> |
-<h2 id="prerequisites">Prerequisites</h2> |
+<h2 id="prerequisites"><span id="id1"></span>Prerequisites</h2> |
+<h3 id="python-2-6-or-2-7"><span id="python26-27"></span>Python 2.6 or 2.7</h3> |
+<p>Make sure that the Python executable is in your <code>PATH</code> variable. Python 2.7 is |
+preferred. Python 3.x is not yet supported.</p> |
<ul class="small-gap"> |
-<li><p class="first"><strong>Python 2.6 or 2.7:</strong> Make sure that the Python executable is in your path. |
-Python 2.7 is preferred. Python 3.x is not yet supported.</p> |
-<ul class="small-gap"> |
-<li>On Mac and Linux, Python is likely preinstalled. Run the command “<code>python |
--V</code>” in a terminal window, and make sure that the version you have is 2.6.x |
-or 2.7.x.</li> |
-<li>On Windows, you may need to install Python. Go to |
-<a class="reference external" href="http://www.python.org/download/">http://www.python.org/download/</a> and |
-select the latest 2.x version. In addition, be sure to add the Python |
-directory (for example, <code>C:\python27</code>) to the PATH <a class="reference external" href="http://en.wikipedia.org/wiki/Environment_variable">environment |
-variable</a>. Run |
-“<code>python -V</code>” from a command line to verify that you properly configured |
-the PATH variable.</li> |
-</ul> |
-</li> |
-<li><strong>Make:</strong> On the Mac, you need to install the <code>make</code> command on your system |
-before you can build and run the examples in the SDK. One easy way to get |
-<code>make</code>, along with several other useful tools, is to install |
-<a class="reference external" href="https://developer.apple.com/technologies/tools/">Xcode Developer Tools</a>. |
-After installing Xcode, go to the XCode menu, open the Preferences dialog box |
-then select Downloads and Components. Verify that Command Line Tools are |
-installed. If you’d rather not install Xcode, you can download and build an |
-<a class="reference external" href="http://mac.softpedia.com/dyn-postdownload.php?p=44632&t=4&i=1">open source version</a> of <code>make</code>. |
-To build the command you may also need to download and install |
-<a class="reference external" href="https://github.com/kennethreitz/osx-gcc-installer">gcc</a>.</li> |
+<li>On Mac and Linux, Python is likely preinstalled. Run the command <code>python -V</code> |
+in a terminal window, and make sure that the version you have is 2.6.x or |
+2.7.x.</li> |
+<li>On Windows, you may need to install Python. Go to <a class="reference external" href="http://www.python.org/download/">http://www.python.org/ |
+download/</a> and select the latest 2.x |
+version. In addition, be sure to add the Python directory (for example, |
+<code>C:\python27</code>) to the <code>PATH</code> <a class="reference external" href="http://en.wikipedia.org/wiki/Environment_variable">environment variable</a>. Run <code>python -V</code> from a command line to |
+verify that you properly configured the PATH variable.</li> |
</ul> |
-<h2 id="installing-the-sdk">Installing the SDK</h2> |
+<h3 id="make"><span id="id2"></span>Make</h3> |
+<p>On the Mac, you need to install <code>make</code> on your system before you can build and |
+run the examples in the SDK. One easy way to get <code>make</code>, along with several |
+other useful tools, is to install <a class="reference external" href="https://developer.apple.com/technologies/tools/">Xcode Developer Tools</a>. After installing Xcode, go |
+to the XCode menu, open the Preferences dialog box then select Downloads and |
+Components. Verify that Command Line Tools are installed. If you’d rather not |
+install Xcode, you can download and build an <a class="reference external" href="http://mac.softpedia.com/dyn-postdownload.php?p=44632&t=4&i=1">open source version</a> of <code>make</code>. |
+To build the program you may also need to download and install <a class="reference external" href="https://github.com/kennethreitz/osx-gcc-installer">gcc</a>.</p> |
+<h2 id="installing-the-sdk"><span id="id3"></span>Installing the SDK</h2> |
+<h3 id="downloading-and-unzipping"><span id="id4"></span>Downloading and Unzipping</h3> |
<ol class="arabic"> |
-<li><p class="first">Download the SDK update zip file: <a class="reference external" href="http://storage.googleapis.com/nativeclient-mirror/nacl/nacl_sdk/nacl_sdk.zip">nacl_sdk.zip</a>.</p> |
+<li><p class="first">Download the <a class="reference external" href="http://storage.googleapis.com/nativeclient-mirror/nacl/nacl_sdk/nacl_sdk.zip">SDK update zip file</a>.</p> |
</li> |
<li><p class="first">Unzip the file:</p> |
<ul class="small-gap"> |
-<li><p class="first">On Mac/Linux, run the command “<code>unzip nacl_sdk.zip</code>” in a terminal |
+<li><p class="first">On Mac/Linux, run the command <code>unzip nacl_sdk.zip</code> in a terminal |
window.</p> |
</li> |
<li><p class="first">On Windows, right-click on the .zip file and select “Extract All...”. A |
-dialog box will open; enter a location and click “Extract”.</p> |
+dialog box opens; enter a location and click “Extract”.</p> |
</li> |
</ul> |
<p>A directory is created called <code>nacl_sdk</code> with the following files and |
@@ -79,11 +72,11 @@ you have already downloaded.</p> |
</ul> |
</li> |
</ol> |
-<h2 id="installing-bundles">Installing bundles</h2> |
+<h3 id="installing-the-stable-bundle"><span id="id5"></span>Installing the stable bundle</h3> |
<ol class="arabic"> |
<li><p class="first">To see the SDK bundles that are available for download, go to the |
-<code>nacl_sdk</code> directory and run <code>naclsdk</code> with the “<code>list</code>” command. The |
-SDK includes a separate bundle for each version of Chrome/Pepper.</p> |
+<code>nacl_sdk</code> directory and run <code>naclsdk</code> with the <code>list</code> command. The SDK |
+includes a separate bundle for each version of Chrome/Pepper.</p> |
<p>On Mac/Linux:</p> |
<pre class="prettyprint"> |
$ cd nacl_sdk |
@@ -114,16 +107,18 @@ Bundles: |
</pre> |
<p>The sample output above shows that several bundles are available for |
download, and that you have already installed the latest revision of the |
-<code>sdk_tools</code> bundle. (It was included in the zip file you downloaded.) Each |
-bundle is labeled post-stable, stable, beta, dev, or canary. These labels |
-usually correspond to the current versions of Chrome.</p> |
-<p>We recommend that you download and use a “stable” bundle, because |
-applications developed with “stable” bundles can be used by all current |
-Chrome users. This is because Native Client is designed to be |
-backward-compatible (for example, applications developed with the |
-<code>pepper_31</code> bundle can run in Chrome 31, Chrome 32, etc.).</p> |
+<code>sdk_tools</code> bundle, which was included in the zip file. You never need to |
+update the <code>sdk_tools</code> bundle. It is updated automatically (if necessary) |
+whenever you run <code>naclsdk</code>.</p> |
+<p>Bundles are labeled post-stable, stable, beta, dev, or canary. These labels |
+usually correspond to the current versions of Chrome. We recommend that you |
+develop against a “stable” bundle, because such bundles can be used by all |
+current Chrome users. Native Client is designed to be backward-compatible.For |
+example, applications developed with the <code>pepper_31</code> bundle can run in |
+Chrome 31, Chrome 32, etc..</p> |
</li> |
-<li><p class="first">Run <code>naclsdk</code> with the “update” command to download recommended bundles.</p> |
+<li><p class="first">Run <code>naclsdk</code> with the <code>update</code> command to download recommended bundles, |
+including the current “stable” bundle.</p> |
<p>On Mac/Linux:</p> |
<pre class="prettyprint"> |
$ ./naclsdk update |
@@ -132,25 +127,18 @@ $ ./naclsdk update |
<pre class="prettyprint"> |
> naclsdk update |
</pre> |
-<p>By default, <code>naclsdk</code> only downloads bundles that are recommended— |
-generally those that are “stable.” Continuing with the earlier example, the |
-“update” command would only download the <code>pepper_35</code> bundle, since the |
-bundles <code>pepper_36</code> and greater are not yet stable. If you want the |
-<code>pepper_36</code> bundle, you must ask for it explicitly:</p> |
+<p>By default, <code>naclsdk</code> only downloads bundles that are recommended, |
+generally those that are “stable.” For example, if the current “stable” |
+bundle is <code>pepper_35</code>, then the <code>update</code> downloads that bundle. To |
+download the <code>pepper_36</code> bundle you must ask for it explicitly:</p> |
<pre class="prettyprint"> |
$ ./naclsdk update pepper_36 |
</pre> |
</li> |
</ol> |
-<aside class="note"> |
-<blockquote> |
-<div>You never need to update the <code>sdk_tools</code> bundle. It is updated |
-automatically (if necessary) whenever you run <code>naclsdk</code>.</div></blockquote> |
- |
-</aside> |
-<h2 id="updating-bundles">Updating bundles</h2> |
+<h2 id="updating-bundles"><span id="id6"></span>Updating bundles</h2> |
<ol class="arabic"> |
-<li><p class="first">Run <code>naclsdk</code> with the “list” command. This shows you the list of available |
+<li><p class="first">Run <code>naclsdk</code> with the <code>list</code> command. This shows you the list of available |
bundles and verifies which bundles you have installed.</p> |
<p>On Mac/Linux:</p> |
<pre class="prettyprint"> |
@@ -160,7 +148,8 @@ $ ./naclsdk list |
<pre class="prettyprint"> |
> naclsdk list |
</pre> |
-<p>If an update is available, you’ll see something like this.:</p> |
+<p>An asterisk (*) next to a bundle indicates that there is an update available |
+it. For example:</p> |
<pre class="prettyprint"> |
Bundles: |
I: installed |
@@ -178,8 +167,7 @@ Bundles: |
pepper_canary (canary) |
bionic_canary (canary) |
</pre> |
-<p>An asterisk next to a bundle indicates that there is an update available it. |
-If you run “<code>naclsdk update</code>” now, it warns you with a message similar to |
+<p>If you run <code>naclsdk update</code> now, it warns you with a message similar to |
this:</p> |
<pre class="prettyprint"> |
WARNING: pepper_35 already exists, but has an update available. Run update |
@@ -198,7 +186,7 @@ $ ./naclsdk update --force |
</pre> |
</li> |
</ol> |
-<h2 id="help-with-the-naclsdk-utility">Help with the <code>naclsdk</code> utility</h2> |
+<h2 id="help-with-the-naclsdk-utility"><span id="id7"></span>Help with the <code>naclsdk</code> utility</h2> |
<ol class="arabic"> |
<li><p class="first">For more information about the <code>naclsdk</code> utility, run:</p> |
<p>On Mac/Linux:</p> |
@@ -211,14 +199,14 @@ $ ./naclsdk help |
</pre> |
</li> |
</ol> |
-<p><strong>Next steps:</strong></p> |
+<h2 id="next-steps"><span id="id8"></span>Next steps</h2> |
<ul class="small-gap"> |
-<li>Browse through the <a class="reference external" href="release-notes">Release Notes</a> for important |
+<li>Browse the <a class="reference external" href="release-notes">Release Notes</a> for important |
information about the SDK and new bundles.</li> |
<li>If you’re just starting with Native Client, we recommend reading the |
<a class="reference external" href="../overview">Technical Overview</a> and walking through the |
<a class="reference external" href="devguide/tutorial/tutorial-part1">Getting Started Tutorial</a>.</li> |
-<li>If you’d rather dive into information about the toolchains, see |
+<li>If you’d rather dive in, see |
<a class="reference external" href="devguide/devcycle/building">Building Native Client Modules</a>.</li> |
</ul> |
</section> |