[
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-unsubscr...@qpid.apache.org
For additional commands, e-mail: dev-h...@qpid.apache.org
