[
https://issues.apache.org/jira/browse/DISPATCH-363?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15335654#comment-15335654
]
Jiri Danek commented on DISPATCH-363:
-------------------------------------
Since Paolo brought up ordering in DISPATCH-391, I'd like to suggest ordering
the configuration sections in the man page either alphabetically, or by
internal logic, with deprecated sections being last. For example:
# router
# sslProfile
# listener
# connector
# address
# ...
# and finally all the depreciated stuff.
> 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
> Assignee: Ganesh Murthy
> Fix For: 0.7.0
>
>
> (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: [email protected]
For additional commands, e-mail: [email protected]
