{"action":"created","issue":{"url":"https://api.github.com/repos/awesomeWM/awesome/issues/177","labels_url":"https://api.github.com/repos/awesomeWM/awesome/issues/177/labels{/name}","comments_url":"https://api.github.com/repos/awesomeWM/awesome/issues/177/comments","events_url":"https://api.github.com/repos/awesomeWM/awesome/issues/177/events","html_url":"https://github.com/awesomeWM/awesome/pull/177","id":63820197,"number":177,"title":"Integrate documentation into C files","user":{"login":"juw","id":5359507,"avatar_url":"https://avatars.githubusercontent.com/u/5359507?v=3","gravatar_id":"","url":"https://api.github.com/users/juw","html_url":"https://github.com/juw","followers_url":"https://api.github.com/users/juw/followers","following_url":"https://api.github.com/users/juw/following{/other_user}","gists_url":"https://api.github.com/users/juw/gists{/gist_id}","starred_url":"https://api.github.com/users/juw/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/juw/subscriptions","organizations_url":"https://api.github.com/users/juw/orgs","repos_url":"https://api.github.com/users/juw/repos","events_url":"https://api.github.com/users/juw/events{/privacy}","received_events_url":"https://api.github.com/users/juw/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/awesomeWM/awesome/labels/enhancement","name":"enhancement","color":"84b6eb"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":14,"created_at":"2015-03-23T20:08:07Z","updated_at":"2015-03-29T17:09:28Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/awesomeWM/awesome/pulls/177","html_url":"https://github.com/awesomeWM/awesome/pull/177","diff_url":"https://github.com/awesomeWM/awesome/pull/177.diff","patch_url":"https://github.com/awesomeWM/awesome/pull/177.patch"},"body":"This PR moves the documentation of the C-API as good, as it is currently (to my knowledge) possible with ldoc, into the C source files. Furthermore it rips out the (in the current state) useless doxygen support and makes it possible to build awesome against Lua 5.2."},"comment":{"url":"https://api.github.com/repos/awesomeWM/awesome/issues/comments/87444720","html_url":"https://github.com/awesomeWM/awesome/pull/177#issuecomment-87444720","issue_url":"https://api.github.com/repos/awesomeWM/awesome/issues/177","id":87444720,"user":{"login":"juw","id":5359507,"avatar_url":"https://avatars.githubusercontent.com/u/5359507?v=3","gravatar_id":"","url":"https://api.github.com/users/juw","html_url":"https://github.com/juw","followers_url":"https://api.github.com/users/juw/followers","following_url":"https://api.github.com/users/juw/following{/other_user}","gists_url":"https://api.github.com/users/juw/gists{/gist_id}","starred_url":"https://api.github.com/users/juw/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/juw/subscriptions","organizations_url":"https://api.github.com/users/juw/orgs","repos_url":"https://api.github.com/users/juw/repos","events_url":"https://api.github.com/users/juw/events{/privacy}","received_events_url":"https://api.github.com/users/juw/received_events","type":"User","site_admin":false},"created_at":"2015-03-29T17:09:28Z","updated_at":"2015-03-29T17:09:28Z","body":"> I think signals should be listed after \"Tables\" and\n> \"Methods\" (http://codeprobe.de/tmp/awesome-doc/classes/client.html).\n\nThis is how ldoc orders them automatically, I do not think, that one\ncan influence that.\n\n\n> Why is there a dot for the client `manage` signal (and others)?\n> (http://codeprobe.de/tmp/awesome-doc/classes/client.html)\n\nOtherwise ldoc would automatically replace `name` with `class.name`\nbefore it, eg. `client.press` instead of `press`. I could not find how\nto stop ldoc from doing that, probably one would need to extend ldoc\nfor that case.\n\n\n> Is it possible to have a section / item in the navigation that would\n> list all signals, like in the wiki?\n\nOnly if one would add an extra page in the docs and therefore would add\nan extra page in the source code, which only describes the signals. I\ndo not see the benefit of that, since the signals make only sense and\nwork if one uses the respective classes.\n"}}