[jira] [Assigned] (PROTON-999) Docs: pn_messenger_subscribe(): "source" is undocumented

["Justin Ross (JIRA)" <ji...@apache.org>]

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

Justin Ross reassigned PROTON-999:
----------------------------------

    Assignee: Justin Ross

> Docs: pn_messenger_subscribe(): "source" is undocumented
> --------------------------------------------------------
>
>                 Key: PROTON-999
>                 URL: https://issues.apache.org/jira/browse/PROTON-999
>             Project: Qpid Proton
>          Issue Type: Bug
>          Components: proton-c
>    Affects Versions: 0.10
>            Reporter: Graham Leggett
>            Assignee: Justin Ross
>              Labels: documentation
>
> The pn_messenger_subscribe() function is documented to take a const char * as a "source":
> https://qpid.apache.org/releases/qpid-proton-0.10/proton/c/api/group__messenger.html#gaf1f1bfe4894d971f0b8d679bcab5cae6
> The definition of a "source" isn't specified, nor is the acceptable source format specified.
> In addition, it isn't specified in the docs whether this function must be called once, or whether it can be called multiple times. Reverse engineering the source seems to indicate that it should be called just once, and if you call it multiple times the underlying event loop will be corrupted.



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