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
possible by building on the rewritten compiler from the last release. Let's go through the
list...
## Python Support!
### Python Support!
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
......@@ -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
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
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
......@@ -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
[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`
command. It now additionally supports converting encoded Cap'n Proto messages to a human-readable
......@@ -58,7 +61,7 @@ or imports.)
Anyway, check out the [full documentation]({{ site.baseurl }}capnp-tool.html) for
more.
## New Features
### New Features
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.
* More and better tests, bug fixes, etc.
## Users!
### Users!
Some news originating outside of the project itself:
* A Cap'n Proto package will
[soon land in Debian](http://ftp-master.debian.org/new/capnproto_0.2.1-1.html), thanks to
[Tom Lee](https://github.com/thomaslee).
* [Debian Unstable (sid)](http://www.debian.org/releases/sid/) now features
[a Cap'n Proto package](http://packages.debian.org/sid/capnproto), thanks to
[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
[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
......
......@@ -75,6 +75,8 @@ function initSidebar() {
}
function setupSidebar() {
var isNews = document.location.pathname.slice("/capnproto".length).slice(0, 6) == "/news/";
var toc = initSidebar();
if (toc) {
var content = document.getElementById("main_content").childNodes;
......@@ -82,8 +84,7 @@ function setupSidebar() {
for (var i = 0; i < content.length; i++) {
if (content[i].tagName == "H2" ||
content[i].tagName == "H3" ||
content[i].tagName == "H4") {
(!isNews && (content[i].tagName == "H3" || content[i].tagName == "H4"))) {
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