Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 954473

Summary:	Address string grammar description missing in the doc
Product:	Red Hat Enterprise MRG	Reporter:	Petr Matousek <pematous>
Component:	Messaging_Programming_Reference	Assignee:	Joshua Wulf <jwulf>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Petr Matousek <pematous>
Severity:	high	Docs Contact:
Priority:	unspecified
Version:	2.3	CC:	kgiusti, lcarlon, lzhaldyb
Target Milestone:	2.5
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:
Clones:	954496 (view as bug list)		Environment:
Last Closed:	2014-05-15 14:37:31 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	954496

Description Petr Matousek 2013-04-22 12:13:08 UTC

Description of problem:
There was a description of address string grammar in the doc for MRG2.2 and prior versions.

Please see:
http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2/html-single/Programming_in_Apache_Qpid/index.html#sect-Programming_in_Apache_Qpid-Addresses-Address_String_Grammar

This paragraph is missing in the current Programming reference. I believe that this paragraph is very useful and shall be definitely covered by doc.

I am also missing proper node policies description (create, delete, assert). 
The node policies were also somehow described in the MRG2.2 a prior doc, but a bit more detailed description is desired, (ie. how are the policies applied).

Version-Release number of selected component (if applicable):
Messaging Programming Reference - revision 2.0.0-31

How reproducible:
n/a

Steps to Reproduce:
n/a
  
Actual results:
Address string grammar description missing
Node policies description missing

Expected results:
Address string grammar described in the doc
Node policies described in the doc

Comment 1 Joshua Wulf 2013-05-13 09:26:12 UTC

*** Bug 705788 has been marked as a duplicate of this bug. ***

Comment 2 Joshua Wulf 2013-05-13 09:27:11 UTC

Things to cover: 

"* What is the difference between "node" and "link" - when would I use one or the other?  I'm assuming they are mutually-exclusive.  Is "node" an AMQP-0.10 only concept, whereas the "link" option related to the new 1.0 model?

* I'm not clear on all the relevant uses of "create" and "delete" along with their options, and which options are nonsensical given a particular role (sender vs. receiver).  Specifically:

    1) Can we get a dedicated section that describes "delete", like we have for "create"?  It should contain examples of the common intended use-cases.  Like, can it be used to create a queue that auto-deletes after the last subscriber unsubscribes?  And what exactly does "delete: always" mean? 

* What does it mean to pass "create: receiver" to createSender(), or "create:sender" to createReceiver()?  Is this an invalid use of "create"?"

Comment 3 Joshua Wulf 2013-05-22 03:55:24 UTC

Added in revision 2-33

https://brewweb.devel.redhat.com/brew/taskinfo?taskID=5808854

http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2/html/Messaging_Programming_Reference/index.html

Comment 4 Petr Matousek 2013-05-22 15:33:31 UTC

Content approved.

Version used for verification:
Messaging Installation and Configuration Guide (Revision 2-33)

-> VERIFIED