[ 
https://issues.apache.org/jira/browse/DISPATCH-413?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Jiri Danek updated DISPATCH-413:
--------------------------------
    Description: 
Explain what is meant by "any standard AMQP managed endpoint". Probably 
reference the AMQP Management specification draft at 
https://www.oasis-open.org/committees/documents.php?wg_abbrev=amqp&show_descriptions=yes

----

Clarify the difference between query and read:

{{qdmanage query}} prints all entities or all entities of a given {{--type}}, 
if specified. The output then may be filtered (to a single entity) by either 
{{--name}} or {{--identity}}.

{{qdmanage read}} prints a single entity specified by either its {{--name}} or 
{{--identity}}. It does not take the {{--type}} option.

In case {{--name}} or {{--identity}} is specified, the difference is that in 
case of {{query}} it is {{qdmanage}} who does the filtering, and in case of 
{{read}} it is qdrouterd.

Also, {{query}} always prints output as JSON literal "array of objects", 
whereas {{read}} prints "object".

(at least that is my understanding of the differences)

----

Remove the mention of {{--stdin}} from {{qdmanage read}} description. It is a 
copy paste error. First noticed by [~ppatierno].

----

CC [~aconway]

  was:
Clarify the difference between query and read:

{{qdmanage query}} prints all entities or all entities of a given {{--type}}, 
if specified. The output then may be filtered (to a single entity) by either 
{{--name}} or {{--identity}}.

{{qdmanage read}} prints a single entity specified by either its {{--name}} or 
{{--identity}}. It does not take the {{--type}} option.

In case {{--name}} or {{--identity}} is specified, the difference is that in 
case of {{query}} it is {{qdmanage}} who does the filtering, and in case of 
{{read}} it is qdrouterd.

Also, {{query}} always prints output as JSON literal "array of objects", 
whereas {{read}} prints "object".

(at least that is my understanding of the differences)

----

Remove the mention of {{--stdin}} from {{qdmanage read}} description. It is a 
copy paste error. First noticed by [~ppatierno].

----

CC [~aconway]


> Improve the qdmanage man page
> -----------------------------
>
>                 Key: DISPATCH-413
>                 URL: https://issues.apache.org/jira/browse/DISPATCH-413
>             Project: Qpid Dispatch
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 0.6.0
>            Reporter: Jiri Danek
>
> Explain what is meant by "any standard AMQP managed endpoint". Probably 
> reference the AMQP Management specification draft at 
> https://www.oasis-open.org/committees/documents.php?wg_abbrev=amqp&show_descriptions=yes
> ----
> Clarify the difference between query and read:
> {{qdmanage query}} prints all entities or all entities of a given {{--type}}, 
> if specified. The output then may be filtered (to a single entity) by either 
> {{--name}} or {{--identity}}.
> {{qdmanage read}} prints a single entity specified by either its {{--name}} 
> or {{--identity}}. It does not take the {{--type}} option.
> In case {{--name}} or {{--identity}} is specified, the difference is that in 
> case of {{query}} it is {{qdmanage}} who does the filtering, and in case of 
> {{read}} it is qdrouterd.
> Also, {{query}} always prints output as JSON literal "array of objects", 
> whereas {{read}} prints "object".
> (at least that is my understanding of the differences)
> ----
> Remove the mention of {{--stdin}} from {{qdmanage read}} description. It is a 
> copy paste error. First noticed by [~ppatierno].
> ----
> CC [~aconway]



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to