{"action":"created","issue":{"url":"https://api.github.com/repos/mitsuhiko/click/issues/234","labels_url":"https://api.github.com/repos/mitsuhiko/click/issues/234/labels{/name}","comments_url":"https://api.github.com/repos/mitsuhiko/click/issues/234/comments","events_url":"https://api.github.com/repos/mitsuhiko/click/issues/234/events","html_url":"https://github.com/mitsuhiko/click/pull/234","id":45066653,"number":234,"title":"Set Command __doc__ string from the callback so Sphinx docs look nicer","user":{"login":"rayl","id":60328,"avatar_url":"https://avatars.githubusercontent.com/u/60328?v=3","gravatar_id":"","url":"https://api.github.com/users/rayl","html_url":"https://github.com/rayl","followers_url":"https://api.github.com/users/rayl/followers","following_url":"https://api.github.com/users/rayl/following{/other_user}","gists_url":"https://api.github.com/users/rayl/gists{/gist_id}","starred_url":"https://api.github.com/users/rayl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rayl/subscriptions","organizations_url":"https://api.github.com/users/rayl/orgs","repos_url":"https://api.github.com/users/rayl/repos","events_url":"https://api.github.com/users/rayl/events{/privacy}","received_events_url":"https://api.github.com/users/rayl/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2014-10-07T04:34:21Z","updated_at":"2015-02-05T17:43:29Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/mitsuhiko/click/pulls/234","html_url":"https://github.com/mitsuhiko/click/pull/234","diff_url":"https://github.com/mitsuhiko/click/pull/234.diff","patch_url":"https://github.com/mitsuhiko/click/pull/234.patch"},"body":"Signed-off-by: Ray Lehtiniemi <rayl@mail.com>"},"comment":{"url":"https://api.github.com/repos/mitsuhiko/click/issues/comments/73091167","html_url":"https://github.com/mitsuhiko/click/pull/234#issuecomment-73091167","issue_url":"https://api.github.com/repos/mitsuhiko/click/issues/234","id":73091167,"user":{"login":"untitaker","id":837573,"avatar_url":"https://avatars.githubusercontent.com/u/837573?v=3","gravatar_id":"","url":"https://api.github.com/users/untitaker","html_url":"https://github.com/untitaker","followers_url":"https://api.github.com/users/untitaker/followers","following_url":"https://api.github.com/users/untitaker/following{/other_user}","gists_url":"https://api.github.com/users/untitaker/gists{/gist_id}","starred_url":"https://api.github.com/users/untitaker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/untitaker/subscriptions","organizations_url":"https://api.github.com/users/untitaker/orgs","repos_url":"https://api.github.com/users/untitaker/repos","events_url":"https://api.github.com/users/untitaker/events{/privacy}","received_events_url":"https://api.github.com/users/untitaker/received_events","type":"User","site_admin":false},"created_at":"2015-02-05T17:43:29Z","updated_at":"2015-02-05T17:43:29Z","body":"The effort should rather go into a sphinx extension that is able to deal with commands properly (providing ``autocommand`` directives or something like that). Documenting CLI commands as classes or functions might be a good quick hack, but as @Almad said, you're missing the arguments with that.\r\n\r\nAlso, I don't think it's a semantically correct thing to set the docstring on this function, because ``click.command`` is not a \"pure\" decorator: The resulting object has no API compatibility with the wrapped function.\r\n\r\nI'll leave this open because it might be useful for others though."}}