Commit 8e80af91 authored by Kenton Varda's avatar Kenton Varda

Last-minute doc tweaks.

parent 5e32184b
...@@ -12,7 +12,7 @@ Version 0.3 is not a paradigm-shifting release, but rather a slew of new feature ...@@ -12,7 +12,7 @@ Version 0.3 is not a paradigm-shifting release, but rather a slew of new feature
possible by building on the rewritten compiler from the last release. Let's go through the possible by building on the rewritten compiler from the last release. Let's go through the
list... list...
## Python Support! ### Python Support!
Thanks to the tireless efforts of contributor [Jason Paryani](https://github.com/jparyani), I can Thanks to the tireless efforts of contributor [Jason Paryani](https://github.com/jparyani), I can
now comfortably claim that Cap'n Proto supports multiple languages. [His Python now comfortably claim that Cap'n Proto supports multiple languages. [His Python
...@@ -24,7 +24,10 @@ together at Google. Here's why: ...@@ -24,7 +24,10 @@ together at Google. Here's why:
* Jason's implementation parses Cap'n Proto schema files at runtime. There is no need to run a * Jason's implementation parses Cap'n Proto schema files at runtime. There is no need to run a
compiler to generate code every time you update your schema, as with protobufs. So, you get compiler to generate code every time you update your schema, as with protobufs. So, you get
to use Python the way Python was intended to be used. to use Python the way Python was intended to be used. In fact, he's hooked into the Python
import mechanism, so you can basically import a `.capnp` schema file as if it were a `.py`
module. It's even convenient to load schema files and play with Cap'n Proto messages from the
interactive interpreter prompt.
* It's _fast_. Whereas the Python Protobuf implementation -- which we made the mistake of * It's _fast_. Whereas the Python Protobuf implementation -- which we made the mistake of
implementing in pure-Python -- is _slow_. And while technically there is an experimental implementing in pure-Python -- is _slow_. And while technically there is an experimental
C-extension-based Python Protobuf implementation (which isn't enabled by default due to various C-extension-based Python Protobuf implementation (which isn't enabled by default due to various
...@@ -37,7 +40,7 @@ By the way, there is also a budding [Erlang implementation](http://ecapnp.astekk ...@@ -37,7 +40,7 @@ By the way, there is also a budding [Erlang implementation](http://ecapnp.astekk
continues on [Rust](https://github.com/dwrensha/capnproto-rust) (David Renshaw) and continues on [Rust](https://github.com/dwrensha/capnproto-rust) (David Renshaw) and
[Ruby](https://github.com/cstrahan/capnp-ruby) (Charles Strahan) implementations. [Ruby](https://github.com/cstrahan/capnp-ruby) (Charles Strahan) implementations.
## Tools: Cap'n Proto on the Command Line ### Tools: Cap'n Proto on the Command Line
The `capnp` command-line tool previously served mostly to generate code, via the `capnp compile` The `capnp` command-line tool previously served mostly to generate code, via the `capnp compile`
command. It now additionally supports converting encoded Cap'n Proto messages to a human-readable command. It now additionally supports converting encoded Cap'n Proto messages to a human-readable
...@@ -58,7 +61,7 @@ or imports.) ...@@ -58,7 +61,7 @@ or imports.)
Anyway, check out the [full documentation]({{ site.baseurl }}capnp-tool.html) for Anyway, check out the [full documentation]({{ site.baseurl }}capnp-tool.html) for
more. more.
## New Features ### New Features
The core product has been updated as well: The core product has been updated as well:
...@@ -73,13 +76,14 @@ The core product has been updated as well: ...@@ -73,13 +76,14 @@ The core product has been updated as well:
of the new union and group features, making the code more readable. of the new union and group features, making the code more readable.
* More and better tests, bug fixes, etc. * More and better tests, bug fixes, etc.
## Users! ### Users!
Some news originating outside of the project itself: Some news originating outside of the project itself:
* A Cap'n Proto package will * [Debian Unstable (sid)](http://www.debian.org/releases/sid/) now features
[soon land in Debian](http://ftp-master.debian.org/new/capnproto_0.2.1-1.html), thanks to [a Cap'n Proto package](http://packages.debian.org/sid/capnproto), thanks to
[Tom Lee](https://github.com/thomaslee). [Tom Lee](https://github.com/thomaslee). Of course, since package updates take some time, this
package is still v0.2.1 as of this writing, but it will be updated to v0.3 soon enough.
* Popular OSX-based text editor [TextMate](http://macromates.com/) now * Popular OSX-based text editor [TextMate](http://macromates.com/) now
[uses Cap'n Proto internally](https://github.com/textmate/textmate/commit/5c02b4ff5cc0c7c319d3d4f127c8ee19b81f80b7), [uses Cap'n Proto internally](https://github.com/textmate/textmate/commit/5c02b4ff5cc0c7c319d3d4f127c8ee19b81f80b7),
and the developer's feedback lead directly to several usability improvements included in this and the developer's feedback lead directly to several usability improvements included in this
......
...@@ -75,6 +75,8 @@ function initSidebar() { ...@@ -75,6 +75,8 @@ function initSidebar() {
} }
function setupSidebar() { function setupSidebar() {
var isNews = document.location.pathname.slice("/capnproto".length).slice(0, 6) == "/news/";
var toc = initSidebar(); var toc = initSidebar();
if (toc) { if (toc) {
var content = document.getElementById("main_content").childNodes; var content = document.getElementById("main_content").childNodes;
...@@ -82,8 +84,7 @@ function setupSidebar() { ...@@ -82,8 +84,7 @@ function setupSidebar() {
for (var i = 0; i < content.length; i++) { for (var i = 0; i < content.length; i++) {
if (content[i].tagName == "H2" || if (content[i].tagName == "H2" ||
content[i].tagName == "H3" || (!isNews && (content[i].tagName == "H3" || content[i].tagName == "H4"))) {
content[i].tagName == "H4") {
headings.push(content[i]); headings.push(content[i]);
} }
} }
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment