From e05420bdf7f5d8691c5737eb6086483f3bbc4598 Mon Sep 17 00:00:00 2001 From: Gordon Sim Date: Thu, 8 Jul 2010 09:29:26 +0000 Subject: Corrections for hello world callouts. git-svn-id: https://svn.apache.org/repos/asf/qpid/trunk/qpid@961660 13f79535-47bb-0310-9956-ffa450edef68 --- doc/book/src/Programming-In-Apache-Qpid.xml | 26 ++++++++++++++++---------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/doc/book/src/Programming-In-Apache-Qpid.xml b/doc/book/src/Programming-In-Apache-Qpid.xml index b11dff420b..f8b7692d11 100644 --- a/doc/book/src/Programming-In-Apache-Qpid.xml +++ b/doc/book/src/Programming-In-Apache-Qpid.xml @@ -177,19 +177,21 @@ int main(int argc, char** argv) { Establishes the connection with the messaging broker. - Creates a session object, which maintains the state of all interactions with the messaging broker, and manages senders and receivers. + Creates a session object on which messages will be sent and received. - Creates a receiver that reads from the given address. + Creates a receiver to receive messages from the given address. Creates a sender that sends to the given address. - Reads the next message. The duration is optional, if omitted, will wait indefinitely for the next message. + Receives the next message. The duration is optional, if omitted, will wait indefinitely for the next message. - Acknowledges messages that have been read. To guarantee delivery, a message remains on the messaging broker until it is acknowledged by a client. session.acknowledge() acknowledges all unacknowledged messages for the given session—this allows acknowledgements to be batched, which is more efficient than acknowledging messages individually. + Acknowledges receipt of all fetched messages on the + session. This informs the broker that the messages were + transfered and processed by the client successfully. Closes the connection, all sessions managed by the connection, and all senders and receivers managed by each session. @@ -242,10 +244,10 @@ finally: Establishes the connection with the messaging broker. - Creates a session object, which maintains the state of all interactions with the messaging broker, and manages senders and receivers. + Creates a session object on which messages will be sent and received. - Creates a receiver that reads from the given address. + Creates a receiver with which to receive messages from the given address. Creates a sender that sends to the given address. @@ -254,7 +256,9 @@ finally: Reads the next message. The duration is optional, if omitted, will wait indefinitely for the next message. - Acknowledges messages that have been read. To guarantee delivery, a message remains on the messaging broker until it is acknowledged by a client. session.acknowledge() acknowledges all unacknowledged messages for the given session—this allows acknowledgements to be batched, which is more efficient than acknowledging messages individually. + Acknowledges receipt of all fetched messages on + the session. This informs the broker that the messages were + transfered and processed by the client successfully. Closes the connection, all sessions managed by the connection, and all senders and receivers managed by each session. @@ -323,10 +327,10 @@ namespace Org.Apache.Qpid.Messaging { Establishes the connection with the messaging broker. - Creates a session object, which maintains the state of all interactions with the messaging broker, and manages senders and receivers. + Creates a session object on which messages will be sent and received. - Creates a receiver that reads from the given address. + Creates a receiver with which to receive messages from the given address. Creates a sender that sends to the given address. @@ -335,7 +339,9 @@ namespace Org.Apache.Qpid.Messaging { Reads the next message. The duration is optional, if omitted, will wait indefinitely for the next message. - Acknowledges messages that have been read. To guarantee delivery, a message remains on the messaging broker until it is acknowledged by a client. session.acknowledge() acknowledges all unacknowledged messages for the given session—this allows acknowledgements to be batched, which is more efficient than acknowledging messages individually. + Acknowledges receipt of all fetched messages on the + session. This informs the broker that the messages were + transfered and processed by the client successfully. Closes the connection, all sessions managed by the connection, and all senders and receivers managed by each session. -- cgit v1.2.1