summaryrefslogtreecommitdiffstats
path: root/native_client_sdk
diff options
context:
space:
mode:
authorJF Bastien <jfb@chromium.org>2015-01-19 10:06:14 -0800
committerJF Bastien <jfb@chromium.org>2015-01-19 18:07:12 +0000
commitd8377eb3f7c6e38ea2a63801d8a570128b90ebd0 (patch)
tree8e96aa0fae945915fc0b384351a89087c9dc7c74 /native_client_sdk
parent30a44820fec96b46078c9355e7c04da4d4d8270b (diff)
downloadchromium_src-d8377eb3f7c6e38ea2a63801d8a570128b90ebd0.zip
chromium_src-d8377eb3f7c6e38ea2a63801d8a570128b90ebd0.tar.gz
chromium_src-d8377eb3f7c6e38ea2a63801d8a570128b90ebd0.tar.bz2
NaCl docs: a few improvements
* Mention Stack Overflow in more places. * Add https to a few links that support it, instead of http. I wasn't exhaustive in my replacement, we should probably do a full sweep at some point. * Expand on the languages section a bit. * Comment out the broken "talk" link. TEST= none BUG= none TBR= binji@chromium.org, jmedley@chromium.org NOTRY=true (documentation only change) Review URL: https://codereview.chromium.org/863543002 Cr-Commit-Position: refs/heads/master@{#312133}
Diffstat (limited to 'native_client_sdk')
-rw-r--r--native_client_sdk/doc_generated/cds2014/cpp.html8
-rw-r--r--native_client_sdk/doc_generated/cds2014/python.html4
-rw-r--r--native_client_sdk/doc_generated/devguide/index.html5
-rw-r--r--native_client_sdk/doc_generated/faq.html6
-rw-r--r--native_client_sdk/doc_generated/help.html5
-rw-r--r--native_client_sdk/doc_generated/index.html5
-rw-r--r--native_client_sdk/src/doc/cds2014/cpp.rst12
-rw-r--r--native_client_sdk/src/doc/cds2014/python.rst7
-rw-r--r--native_client_sdk/src/doc/devguide/index.rst8
-rw-r--r--native_client_sdk/src/doc/faq.rst10
-rw-r--r--native_client_sdk/src/doc/help.rst9
-rw-r--r--native_client_sdk/src/doc/index.rst8
12 files changed, 53 insertions, 34 deletions
diff --git a/native_client_sdk/doc_generated/cds2014/cpp.html b/native_client_sdk/doc_generated/cds2014/cpp.html
index 8bf6f95..6286b27 100644
--- a/native_client_sdk/doc_generated/cds2014/cpp.html
+++ b/native_client_sdk/doc_generated/cds2014/cpp.html
@@ -158,7 +158,7 @@ git config --global user.email johndoe&#64;example.com
you with a zip file containing a starting point.</p>
<p>Download the codelab:</p>
<pre class="prettyprint">
-curl http://nacltools.storage.googleapis.com/cds2014/cds2014_cpp.zip -O
+curl https://nacltools.storage.googleapis.com/cds2014/cds2014_cpp.zip -O
</pre>
<p>Unzip it:</p>
<pre class="prettyprint">
@@ -250,13 +250,13 @@ you&#8217;ve discovered how easy it is to modify, build,
and run a NaCl application that uses PPAPI.</p>
<p>2D graphics is fun, but now you&#8217;re ready to check out the wealth of
other
-<a class="reference external" href="http://src.chromium.org/viewvc/chrome/trunk/src/ppapi/cpp/">PPAPI interfaces available</a>.</p>
+<a class="reference external" href="https://src.chromium.org/viewvc/chrome/trunk/src/ppapi/cpp/">PPAPI interfaces available</a>.</p>
<p>While our in-browser environment is rapidly evolving
to become a complete development solution,
for the broadest range of development options, check out the
<a class="reference external" href="https://developer.chrome.com/native-client/cpp-api">NaCl SDK</a>.</p>
-<p>For questions, concerns, or help contact us at
-<a class="reference external" href="https://groups.google.com/forum/#!forum/native-client-discuss">native-client-discuss&#64;googlegroups.com</a>.</p>
+<p>Send us comments and feedback on the <a class="reference external" href="https://groups.google.com/forum/#!forum/native-client-discuss">native-client-discuss</a> mailing list,
+or ask questions using Stack Overflow&#8217;s <a class="reference external" href="https://stackoverflow.com/questions/tagged/google-nativeclient">google-nativeclient</a> tag.</p>
<p>I hope this codelab has lit a fire in you to go out there,
and bring an awesome C/C++ application to NaCl or PNaCl today!</p>
<h2 id="cleanup">Cleanup</h2>
diff --git a/native_client_sdk/doc_generated/cds2014/python.html b/native_client_sdk/doc_generated/cds2014/python.html
index 5fd4e06..a26bd35 100644
--- a/native_client_sdk/doc_generated/cds2014/python.html
+++ b/native_client_sdk/doc_generated/cds2014/python.html
@@ -226,8 +226,8 @@ interpreted languages that have been ported to PNaCl.</p>
to become a complete development solution,
for the broadest range of development options, check out the
<a class="reference external" href="https://developer.chrome.com/native-client/sdk/download">NaCl SDK</a>.</p>
-<p>For questions, concerns, or help contact us at
-<a class="reference external" href="https://groups.google.com/forum/#!forum/native-client-discuss">native-client-discuss&#64;googlegroups.com</a>.</p>
+<p>Send us comments and feedback on the <a class="reference external" href="https://groups.google.com/forum/#!forum/native-client-discuss">native-client-discuss</a> mailing list,
+or ask questions using Stack Overflow&#8217;s <a class="reference external" href="https://stackoverflow.com/questions/tagged/google-nativeclient">google-nativeclient</a> tag.</p>
<p>Bring your interpreted app to PNaCl today!</p>
<h2 id="cleanup">Cleanup</h2>
<p>The Web-based version of the Chrome Dev Environment installs
diff --git a/native_client_sdk/doc_generated/devguide/index.html b/native_client_sdk/doc_generated/devguide/index.html
index 1fcb622..ad96c72 100644
--- a/native_client_sdk/doc_generated/devguide/index.html
+++ b/native_client_sdk/doc_generated/devguide/index.html
@@ -7,8 +7,9 @@ get your development cycle up and running (e.g., how to compile and test-run
your application), as well as important concepts you need to understand in order
to code your application (e.g., how an application is structured, and how to use
the Pepper APIs).</p>
-<p>The Developer&#8217;s Guide is a work-in-progress. Please send feedback to the
-<a class="reference external" href="https://groups.google.com/group/native-client-discuss">native-client-discuss group</a>.</p>
+<p>The Developer&#8217;s Guide is a work-in-progress.
+Send us comments and feedback on the <a class="reference external" href="https://groups.google.com/forum/#!forum/native-client-discuss">native-client-discuss</a> mailing list,
+or ask questions using Stack Overflow&#8217;s <a class="reference external" href="https://stackoverflow.com/questions/tagged/google-nativeclient">google-nativeclient</a> tag.</p>
</section>
{{/partials.standard_nacl_article}}
diff --git a/native_client_sdk/doc_generated/faq.html b/native_client_sdk/doc_generated/faq.html
index 3f5dcfe..fd20ff2 100644
--- a/native_client_sdk/doc_generated/faq.html
+++ b/native_client_sdk/doc_generated/faq.html
@@ -243,7 +243,11 @@ Native Client. Moreover, there are several ongoing projects to support
additional language runtimes (e.g. <a class="reference external" href="https://code.google.com/p/naclports/source/browse#svn%2Ftrunk%2Fsrc%2Fexamples%2Ftools">naclports supports Lua, Python and Ruby</a>)
as well as to compile more languages to LLVM&#8217;s intermediate representation
(e.g. support <a class="reference external" href="http://halide-lang.org/">Halide</a>, Haskell with <a class="reference external" href="http://www.haskell.org/ghc/docs/latest/html/users_guide/code-generators.html">GHC</a> or support Fortran with <a class="reference external" href="https://flang-gsoc.blogspot.ie/2013/09/end-of-gsoc-report.html">flang</a>), or
-transpile languages to C/C++ (source-to-source compilation).</p>
+transpile languages to C/C++ (source-to-source compilation). Even JavaScript is
+supported by compiling <a class="reference external" href="https://code.google.com/p/v8/">V8</a> to target PNaCl.</p>
+<p>The PNaCl toolchain is built on LLVM and can therefore generate code from
+languages such as <a class="reference external" href="http://www.rust-lang.org/">Rust</a>, <a class="reference external" href="https://golang.org">Go</a>, or Objective-C, but there may still be a few rough
+edges.</p>
<p>If you&#8217;re interested in getting other languages working, please contact the
Native Client team by way of the <a class="reference external" href="https://groups.google.com/group/native-client-discuss">native-client-discuss</a> mailing list.</p>
<h3 id="do-you-only-support-chrome-what-about-other-browsers">Do you only support Chrome? What about other browsers?</h3>
diff --git a/native_client_sdk/doc_generated/help.html b/native_client_sdk/doc_generated/help.html
index f59bd39..c459fe0 100644
--- a/native_client_sdk/doc_generated/help.html
+++ b/native_client_sdk/doc_generated/help.html
@@ -9,8 +9,6 @@ community in the forums below. You can also <a class="reference internal" href="
<ul class="small-gap">
<li><a class="reference internal" href="/native-client/sdk/release-notes.html"><em>Release Notes</em></a>.</li>
<li><a class="reference internal" href="/native-client/faq.html"><em>FAQ</em></a>.</li>
-<li><a class="reference external" href="https://devsite.googleplex.com/native-client/community/talks">Talks, Demos, and Publications</a> (see
-especially Colt McAnlis&#8217; talk on porting C++ games to Native Client).</li>
</ul>
<h2 id="forums">Forums</h2>
<ul class="small-gap">
@@ -20,7 +18,8 @@ questions.</li>
<li>For in-depth technical discussions: <a class="reference external" href="https://groups.google.com/group/native-client-discuss">native-client-discuss mailing
list</a> is a good
group for detailed technical discussions about bugs and other Native Client
-issues. * For announcements, follow the <a class="reference external" href="http://groups.google.com/group/native-client-announce">native-client-announce mailing list</a>.</li>
+issues.</li>
+<li>For announcements, follow the <a class="reference external" href="http://groups.google.com/group/native-client-announce">native-client-announce mailing list</a>.</li>
<li>For 140 character goodness follow <a class="reference external" href="https://twitter.com/nativeclient">&#64;nativeclient</a> on Twitter.</li>
</ul>
<h2 id="issue-tracker"><span id="report-issue"></span>Issue tracker</h2>
diff --git a/native_client_sdk/doc_generated/index.html b/native_client_sdk/doc_generated/index.html
index a3528c8..e9d95e7 100644
--- a/native_client_sdk/doc_generated/index.html
+++ b/native_client_sdk/doc_generated/index.html
@@ -18,7 +18,7 @@ Native Client, including its goals, how it works, and how
Portable Native Client lets developers run native compiled code on the web.</p>
<aside class="note">
This site uses several examples of Native Client. For the best experience,
-consider downloading the <a class="reference external" href="http://www.google.com/chrome/">latest version of Chrome</a>. When you come back, be sure to <a class="reference external" href="https://gonativeclient.appspot.com/demo">check out
+consider downloading the <a class="reference external" href="https://www.google.com/chrome/">latest version of Chrome</a>. When you come back, be sure to <a class="reference external" href="https://gonativeclient.appspot.com/demo">check out
our demos</a>.
</aside>
</div>
@@ -68,7 +68,8 @@ Reference</em></a> or the <a class="reference internal" href="/native-client/ref
</div>
</div><h2 id="i-want-to-know-everything">I Want to Know Everything</h2>
<p>So, you like to read now and try later. Start with our <a class="reference internal" href="/native-client/overview.html"><em>Technical Overview</em></a></p>
-<div class="big-intro" style="clear: both;"><p>Send us questions, comments, and feedback: <a class="reference external" href="https://groups.google.com/forum/#!forum/native-client-discuss">native-client-discuss</a>.</p>
+<div class="big-intro" style="clear: both;"><p>Send us comments and feedback on the <a class="reference external" href="https://groups.google.com/forum/#!forum/native-client-discuss">native-client-discuss</a> mailing list,
+or ask questions using Stack Overflow&#8217;s <a class="reference external" href="https://stackoverflow.com/questions/tagged/google-nativeclient">google-nativeclient</a> tag.</p>
</div></section>
{{/partials.standard_nacl_article}}
diff --git a/native_client_sdk/src/doc/cds2014/cpp.rst b/native_client_sdk/src/doc/cds2014/cpp.rst
index 8099dc8..067e74e 100644
--- a/native_client_sdk/src/doc/cds2014/cpp.rst
+++ b/native_client_sdk/src/doc/cds2014/cpp.rst
@@ -19,7 +19,7 @@ you with a zip file containing a starting point.
Download the codelab::
- curl http://nacltools.storage.googleapis.com/cds2014/cds2014_cpp.zip -O
+ curl https://nacltools.storage.googleapis.com/cds2014/cds2014_cpp.zip -O
Unzip it::
@@ -137,7 +137,7 @@ and run a NaCl application that uses PPAPI.
2D graphics is fun, but now you're ready to check out the wealth of
other
`PPAPI interfaces available
-<http://src.chromium.org/viewvc/chrome/trunk/src/ppapi/cpp/>`_.
+<https://src.chromium.org/viewvc/chrome/trunk/src/ppapi/cpp/>`_.
While our in-browser environment is rapidly evolving
to become a complete development solution,
@@ -145,9 +145,11 @@ for the broadest range of development options, check out the
`NaCl SDK
<https://developer.chrome.com/native-client/cpp-api>`_.
-For questions, concerns, or help contact us at
-`native-client-discuss@googlegroups.com
-<https://groups.google.com/forum/#!forum/native-client-discuss>`_.
+Send us comments and feedback on the `native-client-discuss
+<https://groups.google.com/forum/#!forum/native-client-discuss>`_ mailing list,
+or ask questions using Stack Overflow's `google-nativeclient
+<https://stackoverflow.com/questions/tagged/google-nativeclient>`_ tag.
+
I hope this codelab has lit a fire in you to go out there,
and bring an awesome C/C++ application to NaCl or PNaCl today!
diff --git a/native_client_sdk/src/doc/cds2014/python.rst b/native_client_sdk/src/doc/cds2014/python.rst
index cfd6866..be988da 100644
--- a/native_client_sdk/src/doc/cds2014/python.rst
+++ b/native_client_sdk/src/doc/cds2014/python.rst
@@ -109,9 +109,10 @@ for the broadest range of development options, check out the
`NaCl SDK
<https://developer.chrome.com/native-client/sdk/download>`_.
-For questions, concerns, or help contact us at
-`native-client-discuss@googlegroups.com
-<https://groups.google.com/forum/#!forum/native-client-discuss>`_.
+Send us comments and feedback on the `native-client-discuss
+<https://groups.google.com/forum/#!forum/native-client-discuss>`_ mailing list,
+or ask questions using Stack Overflow's `google-nativeclient
+<https://stackoverflow.com/questions/tagged/google-nativeclient>`_ tag.
Bring your interpreted app to PNaCl today!
diff --git a/native_client_sdk/src/doc/devguide/index.rst b/native_client_sdk/src/doc/devguide/index.rst
index 9723506..8f45b6e 100644
--- a/native_client_sdk/src/doc/devguide/index.rst
+++ b/native_client_sdk/src/doc/devguide/index.rst
@@ -10,6 +10,8 @@ your application), as well as important concepts you need to understand in order
to code your application (e.g., how an application is structured, and how to use
the Pepper APIs).
-The Developer's Guide is a work-in-progress. Please send feedback to the
-`native-client-discuss group
-<https://groups.google.com/group/native-client-discuss>`_.
+The Developer's Guide is a work-in-progress.
+Send us comments and feedback on the `native-client-discuss
+<https://groups.google.com/forum/#!forum/native-client-discuss>`_ mailing list,
+or ask questions using Stack Overflow's `google-nativeclient
+<https://stackoverflow.com/questions/tagged/google-nativeclient>`_ tag.
diff --git a/native_client_sdk/src/doc/faq.rst b/native_client_sdk/src/doc/faq.rst
index 099ce6c..398e4c3 100644
--- a/native_client_sdk/src/doc/faq.rst
+++ b/native_client_sdk/src/doc/faq.rst
@@ -233,7 +233,12 @@ Native Client. Moreover, there are several ongoing projects to support
additional language runtimes (e.g. `naclports supports Lua, Python and Ruby`_)
as well as to compile more languages to LLVM's intermediate representation
(e.g. support Halide_, Haskell with GHC_ or support Fortran with flang_), or
-transpile languages to C/C++ (source-to-source compilation).
+transpile languages to C/C++ (source-to-source compilation). Even JavaScript is
+supported by compiling V8_ to target PNaCl.
+
+The PNaCl toolchain is built on LLVM and can therefore generate code from
+languages such as Rust_, Go_, or Objective-C, but there may still be a few rough
+edges.
If you're interested in getting other languages working, please contact the
Native Client team by way of the native-client-discuss_ mailing list.
@@ -570,6 +575,9 @@ Here are ways to resolve some common problems that can prevent loading:
.. _Halide: http://halide-lang.org/
.. _GHC: http://www.haskell.org/ghc/docs/latest/html/users_guide/code-generators.html
.. _flang: https://flang-gsoc.blogspot.ie/2013/09/end-of-gsoc-report.html
+.. _V8: https://code.google.com/p/v8/
+.. _Rust: http://www.rust-lang.org/
+.. _Go: https://golang.org
.. _native-client-discuss: https://groups.google.com/group/native-client-discuss
.. _deprecated in Chrome: http://blog.chromium.org/2013/09/saying-goodbye-to-our-old-friend-npapi.html
.. _OpenGL ES 2.0: https://www.khronos.org/opengles/
diff --git a/native_client_sdk/src/doc/help.rst b/native_client_sdk/src/doc/help.rst
index 68b5e21..3d64c9f 100644
--- a/native_client_sdk/src/doc/help.rst
+++ b/native_client_sdk/src/doc/help.rst
@@ -14,11 +14,9 @@ Documentation
* :doc:`Release Notes <sdk/release-notes>`.
* :doc:`FAQ <faq>`.
-* `Talks, Demos, and Publications
- <https://devsite.googleplex.com/native-client/community/talks>`_ (see
- especially Colt McAnlis' talk on porting C++ games to Native Client).
-.. TODO: Fix the talk link once ReST-ified.
+.. TODO: Fix the following talk link once ReST-ified.
+.. * :doc:`Talks, Demos, and Publications <community/talks>` (see especially Colt McAnlis' talk on porting C++ games to Native Client).
Forums
======
@@ -30,7 +28,8 @@ Forums
* For in-depth technical discussions: `native-client-discuss mailing
list <https://groups.google.com/group/native-client-discuss>`_ is a good
group for detailed technical discussions about bugs and other Native Client
- issues. * For announcements, follow the `native-client-announce mailing list
+ issues.
+* For announcements, follow the `native-client-announce mailing list
<http://groups.google.com/group/native-client-announce>`_.
* For 140 character goodness follow `@nativeclient
<https://twitter.com/nativeclient>`_ on Twitter.
diff --git a/native_client_sdk/src/doc/index.rst b/native_client_sdk/src/doc/index.rst
index 0a8c030..b1ebdfd 100644
--- a/native_client_sdk/src/doc/index.rst
+++ b/native_client_sdk/src/doc/index.rst
@@ -27,7 +27,7 @@ Portable Native Client lets developers run native compiled code on the web.
This site uses several examples of Native Client. For the best experience,
consider downloading the `latest version of Chrome
- <http://www.google.com/chrome/>`_. When you come back, be sure to `check out
+ <https://www.google.com/chrome/>`_. When you come back, be sure to `check out
our demos <https://gonativeclient.appspot.com/demo>`_.
.. raw:: html
@@ -115,8 +115,10 @@ So, you like to read now and try later. Start with our :doc:`Technical Overview
<div class="big-intro" style="clear: both;">
-Send us questions, comments, and feedback: `native-client-discuss
-<https://groups.google.com/forum/#!forum/native-client-discuss>`_.
+Send us comments and feedback on the `native-client-discuss
+<https://groups.google.com/forum/#!forum/native-client-discuss>`_ mailing list,
+or ask questions using Stack Overflow's `google-nativeclient
+<https://stackoverflow.com/questions/tagged/google-nativeclient>`_ tag.
.. raw:: html