I'm writing to ask for some guidance with capnp. Many of the concepts used to explain capnp are explained in terms of other technologies which I'm not familiar with, or just assumed. So please bear with my questions and comments.
1. capnproto.org has some high level documentation, but header comments are the main documentation. Is there other documentation or samples I should read? Perhaps a suggested reading order? 2. The documentation describes capnp as a capability based system. This is a new concept to me, but Wikipedia says capabilities are object references that can't be forged. The implementation looks more like interface pointers. From my naive perspective this looks like a simple concept made difficult to understand by describing it in unfamiliar terms. 2a. I assume in capnp this reference is just the interfaceId in the [rpc protocol](https://github.com/capnproto/capnproto/blob/master/c++/src/capnp/rpc.capnp), which would refer to an address or table entry on the server. Is capnp doing anything to make the ids difficult to guess/forge/eavesdrop? 2b. The ez-rpc header states it can only support public, singleton capabilities without state. Yet the Calculator sample returns a Value RPC object. This leaves me confused about what the limitations are. Am I failing to understand something about capabilities here? 2c. Is there a sample demonstrating capabilities, assuming the Calculator sample doesn't? 4. The [install page](https://capnproto.org/install.html) suggests linux users download a tarball, however the tarball doesn't have samples from git. As a user struggling to learn the system, the samples would have helped. 5. Could you add a capnp parameter to output .cpp files? I respect that .c++ is a better name but there are a surprising number of places I have to change to handle .c++ files (build scripts, editor settings). 7. A [link](https://plus.google.com/u/0/+KentonVarda/posts/D95XKtB5DhK) on the [RPC page](https://capnproto.org/cxxrpc.html) to Google Groups is not accessible without an account. Could you move or open that document? 8. The numbers in my email didn't survive so many edits. I have the same problem with .capnp files, and it's a surprising time sink. It occurs to me the capnp tool could modify capnp files to fix indexes, the only piece of missing information is which indexes already shipped and can't be changed. Even though I'm a little frustrated right now, I do appreciate what you've done here. If nothing else, I hope my new user perspective helps highlight the new user pain points. Regards, NBR -- You received this message because you are subscribed to the Google Groups "Cap'n Proto" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/capnproto/Qkg5g2MThaUoq3RcyxxaTPAtsc8qWHsEP8BLOs0I9z2O8_oSmXaJBaNf2Fg2KiWGBUcIR8rpFOY1znNDt24RUf8y2sMUtipxOD53c_WeTiU%3D%40protonmail.com.
