{"action":"created","issue":{"url":"https://api.github.com/repos/systemd/kdbus/issues/3","labels_url":"https://api.github.com/repos/systemd/kdbus/issues/3/labels{/name}","comments_url":"https://api.github.com/repos/systemd/kdbus/issues/3/comments","events_url":"https://api.github.com/repos/systemd/kdbus/issues/3/events","html_url":"https://github.com/systemd/kdbus/issues/3","id":91729688,"number":3,"title":"Issues with kdbus.match documentation","user":{"login":"heftig","id":204006,"avatar_url":"https://avatars.githubusercontent.com/u/204006?v=3","gravatar_id":"","url":"https://api.github.com/users/heftig","html_url":"https://github.com/heftig","followers_url":"https://api.github.com/users/heftig/followers","following_url":"https://api.github.com/users/heftig/following{/other_user}","gists_url":"https://api.github.com/users/heftig/gists{/gist_id}","starred_url":"https://api.github.com/users/heftig/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/heftig/subscriptions","organizations_url":"https://api.github.com/users/heftig/orgs","repos_url":"https://api.github.com/users/heftig/repos","events_url":"https://api.github.com/users/heftig/events{/privacy}","received_events_url":"https://api.github.com/users/heftig/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-06-29T07:58:49Z","updated_at":"2015-06-29T16:57:18Z","closed_at":null,"body":"https://github.com/systemd/kdbus/blob/devel/Documentation/kdbus/kdbus.match.xml#L218 says:\r\n\r\n```xml\r\n            <varlistentry>\r\n              <term><constant>KDBUS_MATCH_REPLACE</constant></term>\r\n              <listitem>\r\n                <para>Make the endpoint file group-accessible</para>\r\n              </listitem>\r\n            </varlistentry>\r\n```\r\nIs obviously wrong. My guess is the paragraph should be:\r\n```xml\r\n                <para>Remove all previously existing matches with the same cookie</para>\r\n```\r\n\r\nhttps://github.com/systemd/kdbus/blob/devel/Documentation/kdbus/kdbus.match.xml#L407 says:\r\n```xml\r\n      <varlistentry>\r\n        <term><varname>flags</varname></term>\r\n        <listitem><para>\r\n          No flags are supported for this use case.\r\n          <constant>KDBUS_FLAG_NEGOTIATE</constant> is accepted to probe for\r\n          valid flags. If set, the ioctl will fail with\r\n          <errorcode>-1</errorcode>, <varname>errno</varname> is set to\r\n          <constant>EPROTO</constant>, and the <varname>flags</varname> field\r\n          is set to <constant>0</constant>.\r\n        </para></listitem>\r\n      </varlistentry>\r\n```\r\nThis is a bit confusing, reading as if `If set, the ioctl will fail` applies to `KDBUS_FLAG_NEGOTIATE`."},"comment":{"url":"https://api.github.com/repos/systemd/kdbus/issues/comments/116760778","html_url":"https://github.com/systemd/kdbus/issues/3#issuecomment-116760778","issue_url":"https://api.github.com/repos/systemd/kdbus/issues/3","id":116760778,"user":{"login":"zonque","id":106304,"avatar_url":"https://avatars.githubusercontent.com/u/106304?v=3","gravatar_id":"","url":"https://api.github.com/users/zonque","html_url":"https://github.com/zonque","followers_url":"https://api.github.com/users/zonque/followers","following_url":"https://api.github.com/users/zonque/following{/other_user}","gists_url":"https://api.github.com/users/zonque/gists{/gist_id}","starred_url":"https://api.github.com/users/zonque/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zonque/subscriptions","organizations_url":"https://api.github.com/users/zonque/orgs","repos_url":"https://api.github.com/users/zonque/repos","events_url":"https://api.github.com/users/zonque/events{/privacy}","received_events_url":"https://api.github.com/users/zonque/received_events","type":"User","site_admin":false},"created_at":"2015-06-29T16:57:18Z","updated_at":"2015-06-29T16:57:18Z","body":"(sorry, the previos comment was totally unreleated, so I removed it again)"}}