[jira] [Commented] (DISPATCH-413) Improve the qdmanage man page

["ASF GitHub Bot (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/DISPATCH-413?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17406388#comment-17406388 ] 

ASF GitHub Bot commented on DISPATCH-413:
-----------------------------------------

jiridanek opened a new pull request #1358:
URL: https://github.com/apache/qpid-dispatch/pull/1358


   The spec in question is [https://www.oasis-open.org/committees/document.php?document_id=54441&wg_abbrev=amqp](AMQP Management v1.0 WD09). I managed to find a newer working draft WD12 of the spec, but I did not manage to download a readable copy of it. It looks like the spec never got past working drafts anyways.
   
   CC @pwright 


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@qpid.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


> 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 Daněk
>            Priority: Major
>             Fix For: Backlog
>
>
> 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
(v8.3.4#803005)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@qpid.apache.org
For additional commands, e-mail: dev-help@qpid.apache.org