Bug 766602

Summary: UG 3.1 qpid-config uses --limit-policy types with hyphens, not with underscore characters
Product: Red Hat Enterprise MRG Reporter: Leonid Zhaldybin <lzhaldyb>
Component: Messaging_Programming_ReferenceAssignee: Cheryn Tan <chetan>
Status: CLOSED CURRENTRELEASE QA Contact: Leonid Zhaldybin <lzhaldyb>
Severity: low Docs Contact:
Priority: unspecified    
Version: 2.0CC: esammons, lbrindle, rlandman
Target Milestone: 2.1.2   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-05-02 05:31:23 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Leonid Zhaldybin 2011-12-12 12:26:32 UTC
Description of problem:
Messaging User Guide version 2 contains in 3.1 "Producer Flow Control" the following description of --limit-policy option of the command 'qpid-config [options] add queue queue_name [add queue options]':

--limit-policy TYPE
    Action to take when queue limit is reached. TYPE can be:

        reject
        flow_to_disk
        ring
        ring_strict 

Two of these TYPEs (flow_to_disk and ring_strict ) are not accepted by qpid-config command, they should contain hyphens instead of the underscore characters. Find the error message returned by qpid-config below:
qpid-config: error: option --limit-policy: invalid choice: 'flow_to_disk' (choose from 'none', 'reject', 'flow-to-disk', 'ring', 'ring-strict')


Version-Release number of selected component (if applicable):
2.0

How reproducible:
always

Steps to Reproduce:
1. Read Messaging User Guide v. 2.0, PDF page 18.
  
Actual results:
Two of the documented limit policy types are not accepted by the qpid-config tool.

Expected results:
Limit policy types for qpid-config tool should use hyphens instead of the underscore characters.

Additional info:

Comment 1 Cheryn Tan 2012-01-04 06:22:12 UTC
Changed to "flow-to-disk" and "ring-strict".

Red_Hat_Enterprise_MRG-Messaging_User_Guide-2-en-US-2-15

http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/2/html/Messaging_User_Guide/chap-Messaging_User_Guide-Queues.html

Comment 2 Leonid Zhaldybin 2012-01-10 11:02:52 UTC
-> VERIFIED

Comment 3 Cheryn Tan 2012-05-02 05:31:23 UTC
Documents have been published on http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_MRG/index.html as part of the MRG-M 2.1.2 update.