On 09/24/2010 08:50 PM, Robin Palotai wrote:
Hi List,
I just started reading on / using QPID and downloaded the stable release
0.6. However the documentation confuses me a bit
- In http://qpid.apache.org/apis/0.6/cpp/html/index.html for
<http://qpid.apache.org/apis/0.6/cpp/html/index.html>
qpid::messaging::Connection, the open() method is documented
parameterless, while in the downloaded bundle it seems to have url
parameter and is static method (and indeed, it works that way)
- Also, the book I fould at
http://qpid.apache.org/books/0.6/Programming-In-Apache-Qpid/pdf/Programming-In-Apache-Qpid.pdf
describes the address string syntax, which seems to be different than
what is actually accepted / used in the example program in
examples/messaging/client.cpp, which uses fields "node-properties",
"x-properties" instead of "node", "link", "x-declare" etc.
So I'm interested in why is there such inconsistency or lack of
documentation, and what is the suggested way for starting using QPID? Is
v0.6 too old? Also please see my related question at
http://stackoverflow.com/questions/3789822/qpid-finer-amqp-control-with-the-high-level-api
The messaging API work was in progress at the time the 0.6 release was
branched. It changed a bit since then in terms of the details of the API
(the essential shape remained the same) and the address syntax.
We also started working on a guide to help explain the new API. A
version of that from trunk was incorrectly labelled as 0.6 along with a
set of the latest (at that time API reference). I would ignore the
programming guide for the 0.6 release as ,much of it is not applicable.
The reference docs can be generated from the source release (make html
in docs/api). (The 0.7 docs are also - correctly - based on trunk, but
are more up to date).
The messaging API is not ready for use in 0.6, it is now stable on trunk
and will be part of the next release (scheduled for the end of October).
I do apologise for the confusion around the incorrectly labelled docs on
the site.
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:[email protected]
