diff options
author | JF Bastien <jfb@chromium.org> | 2015-01-19 10:06:14 -0800 |
---|---|---|
committer | JF Bastien <jfb@chromium.org> | 2015-01-19 18:07:12 +0000 |
commit | d8377eb3f7c6e38ea2a63801d8a570128b90ebd0 (patch) | |
tree | 8e96aa0fae945915fc0b384351a89087c9dc7c74 /native_client_sdk | |
parent | 30a44820fec96b46078c9355e7c04da4d4d8270b (diff) | |
download | chromium_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.html | 8 | ||||
-rw-r--r-- | native_client_sdk/doc_generated/cds2014/python.html | 4 | ||||
-rw-r--r-- | native_client_sdk/doc_generated/devguide/index.html | 5 | ||||
-rw-r--r-- | native_client_sdk/doc_generated/faq.html | 6 | ||||
-rw-r--r-- | native_client_sdk/doc_generated/help.html | 5 | ||||
-rw-r--r-- | native_client_sdk/doc_generated/index.html | 5 | ||||
-rw-r--r-- | native_client_sdk/src/doc/cds2014/cpp.rst | 12 | ||||
-rw-r--r-- | native_client_sdk/src/doc/cds2014/python.rst | 7 | ||||
-rw-r--r-- | native_client_sdk/src/doc/devguide/index.rst | 8 | ||||
-rw-r--r-- | native_client_sdk/src/doc/faq.rst | 10 | ||||
-rw-r--r-- | native_client_sdk/src/doc/help.rst | 9 | ||||
-rw-r--r-- | native_client_sdk/src/doc/index.rst | 8 |
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@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’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’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@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’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@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’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’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’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’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’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’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’ 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">@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’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 |