{"action":"created","issue":{"url":"https://api.github.com/repos/jedisct1/libsodium/issues/294","labels_url":"https://api.github.com/repos/jedisct1/libsodium/issues/294/labels{/name}","comments_url":"https://api.github.com/repos/jedisct1/libsodium/issues/294/comments","events_url":"https://api.github.com/repos/jedisct1/libsodium/issues/294/events","html_url":"https://github.com/jedisct1/libsodium/issues/294","id":105075318,"number":294,"title":"function declare confusing","user":{"login":"byronhe","id":1394332,"avatar_url":"https://avatars.githubusercontent.com/u/1394332?v=3","gravatar_id":"","url":"https://api.github.com/users/byronhe","html_url":"https://github.com/byronhe","followers_url":"https://api.github.com/users/byronhe/followers","following_url":"https://api.github.com/users/byronhe/following{/other_user}","gists_url":"https://api.github.com/users/byronhe/gists{/gist_id}","starred_url":"https://api.github.com/users/byronhe/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/byronhe/subscriptions","organizations_url":"https://api.github.com/users/byronhe/orgs","repos_url":"https://api.github.com/users/byronhe/repos","events_url":"https://api.github.com/users/byronhe/events{/privacy}","received_events_url":"https://api.github.com/users/byronhe/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-09-06T06:41:04Z","updated_at":"2015-09-06T09:26:47Z","closed_at":"2015-09-06T08:59:13Z","body":"I think the function prototype in the header files is confusing.\r\n\r\nfor example : \r\n```\r\nint crypto_box_seal(unsigned char *c, const unsigned char *m,\r\n                    unsigned long long mlen, const unsigned char *pk);\r\n```\r\n\r\nif a do not read the documents , i do not know what does `c`, `m`,`mlen`, `pk` means ?\r\nmaybe it can be renamed to `ciphertext`, `message`,`message_length`,`private_key`, to make it more  easy to understand by newbies .\r\n"},"comment":{"url":"https://api.github.com/repos/jedisct1/libsodium/issues/comments/138059686","html_url":"https://github.com/jedisct1/libsodium/issues/294#issuecomment-138059686","issue_url":"https://api.github.com/repos/jedisct1/libsodium/issues/294","id":138059686,"user":{"login":"paragonie-scott","id":11591518,"avatar_url":"https://avatars.githubusercontent.com/u/11591518?v=3","gravatar_id":"","url":"https://api.github.com/users/paragonie-scott","html_url":"https://github.com/paragonie-scott","followers_url":"https://api.github.com/users/paragonie-scott/followers","following_url":"https://api.github.com/users/paragonie-scott/following{/other_user}","gists_url":"https://api.github.com/users/paragonie-scott/gists{/gist_id}","starred_url":"https://api.github.com/users/paragonie-scott/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/paragonie-scott/subscriptions","organizations_url":"https://api.github.com/users/paragonie-scott/orgs","repos_url":"https://api.github.com/users/paragonie-scott/repos","events_url":"https://api.github.com/users/paragonie-scott/events{/privacy}","received_events_url":"https://api.github.com/users/paragonie-scott/received_events","type":"User","site_admin":false},"created_at":"2015-09-06T09:26:47Z","updated_at":"2015-09-06T09:26:47Z","body":"I could send a PR (but only for the public API bits, I'd not feel comfortable rewriting any of the code used in the primitives) to address this, since it *is* on the roadmap."}}