You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@qpid.apache.org by "Ted Ross (JIRA)" <ji...@apache.org> on 2016/06/15 14:22:09 UTC
[jira] [Commented] (DISPATCH-363) Autogenerated part of man page
qdrouterd.conf and output of `qdmanage print-json-schema` leave out the
`name:` attribute in annotation sections
[ https://issues.apache.org/jira/browse/DISPATCH-363?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15331819#comment-15331819 ]
Ted Ross commented on DISPATCH-363:
-----------------------------------
I think the following should be done with the autogenerated man page for the configuration:
- Remove all mention of annotation sections
- Treat sslProfile as a first-class entity
- Include "name" in the sslProfile description (it is mandatory)
- Remove the attributes from sslProfile that appear in listener and connector
- Add sslProfile as an attribute of listener and connector
> Autogenerated part of man page qdrouterd.conf and output of `qdmanage print-json-schema` leave out the `name:` attribute in annotation sections
> -----------------------------------------------------------------------------------------------------------------------------------------------
>
> Key: DISPATCH-363
> URL: https://issues.apache.org/jira/browse/DISPATCH-363
> Project: Qpid Dispatch
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 0.6.0
> Reporter: Jiri Danek
>
> (Hat tip to [~enkeys])
> The man page at https://qpid.apache.org/releases/qpid-dispatch-master/man/qdrouterd.conf.html describes a `name:` attribute in the handwritten opening paragraphs. It is not mentioned later in the auto-generated list of attributes of any of the annotation sections. Neither is the `name` attribute present in the JSON schema from qdmanage. This attribute should be documented.
> In case of `sslProfile` annotation section, attribute `sslProfileName` is mentioned in the qdmanage output (but not in in the man page). This attribute is for internal use only and should be documented as such in the JSON.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@qpid.apache.org
For additional commands, e-mail: dev-help@qpid.apache.org