{"action":"created","issue":{"url":"https://api.github.com/repos/commercialhaskell/stack/issues/761","labels_url":"https://api.github.com/repos/commercialhaskell/stack/issues/761/labels{/name}","comments_url":"https://api.github.com/repos/commercialhaskell/stack/issues/761/comments","events_url":"https://api.github.com/repos/commercialhaskell/stack/issues/761/events","html_url":"https://github.com/commercialhaskell/stack/issues/761","id":100366430,"number":761,"title":"Programmaticly generate a man page","user":{"login":"drwebb","id":178769,"avatar_url":"https://avatars.githubusercontent.com/u/178769?v=3","gravatar_id":"","url":"https://api.github.com/users/drwebb","html_url":"https://github.com/drwebb","followers_url":"https://api.github.com/users/drwebb/followers","following_url":"https://api.github.com/users/drwebb/following{/other_user}","gists_url":"https://api.github.com/users/drwebb/gists{/gist_id}","starred_url":"https://api.github.com/users/drwebb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/drwebb/subscriptions","organizations_url":"https://api.github.com/users/drwebb/orgs","repos_url":"https://api.github.com/users/drwebb/repos","events_url":"https://api.github.com/users/drwebb/events{/privacy}","received_events_url":"https://api.github.com/users/drwebb/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/commercialhaskell/stack/labels/documentation","name":"documentation","color":"bfd4f2"}],"state":"open","locked":false,"assignee":{"login":"drwebb","id":178769,"avatar_url":"https://avatars.githubusercontent.com/u/178769?v=3","gravatar_id":"","url":"https://api.github.com/users/drwebb","html_url":"https://github.com/drwebb","followers_url":"https://api.github.com/users/drwebb/followers","following_url":"https://api.github.com/users/drwebb/following{/other_user}","gists_url":"https://api.github.com/users/drwebb/gists{/gist_id}","starred_url":"https://api.github.com/users/drwebb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/drwebb/subscriptions","organizations_url":"https://api.github.com/users/drwebb/orgs","repos_url":"https://api.github.com/users/drwebb/repos","events_url":"https://api.github.com/users/drwebb/events{/privacy}","received_events_url":"https://api.github.com/users/drwebb/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/commercialhaskell/stack/milestones/8","html_url":"https://github.com/commercialhaskell/stack/milestones/Support","labels_url":"https://api.github.com/repos/commercialhaskell/stack/milestones/8/labels","id":1208081,"number":8,"title":"Support","description":"Issues without clear work items for the codebase","creator":{"login":"snoyberg","id":49415,"avatar_url":"https://avatars.githubusercontent.com/u/49415?v=3","gravatar_id":"","url":"https://api.github.com/users/snoyberg","html_url":"https://github.com/snoyberg","followers_url":"https://api.github.com/users/snoyberg/followers","following_url":"https://api.github.com/users/snoyberg/following{/other_user}","gists_url":"https://api.github.com/users/snoyberg/gists{/gist_id}","starred_url":"https://api.github.com/users/snoyberg/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/snoyberg/subscriptions","organizations_url":"https://api.github.com/users/snoyberg/orgs","repos_url":"https://api.github.com/users/snoyberg/repos","events_url":"https://api.github.com/users/snoyberg/events{/privacy}","received_events_url":"https://api.github.com/users/snoyberg/received_events","type":"User","site_admin":false},"open_issues":5,"closed_issues":16,"state":"open","created_at":"2015-07-14T20:38:48Z","updated_at":"2015-08-12T14:33:25Z","due_on":null,"closed_at":null},"comments":6,"created_at":"2015-08-11T17:42:20Z","updated_at":"2015-08-13T04:32:40Z","closed_at":null,"body":"Now that many cli options parsers moved out of `main.hs` I'd like to use pandoc to construct the man page programtically. From my experiments before this is entirely possible, it's just a matter of writing a new executable that generates the output. If we have text that we want to be included in the manual it's also possible to include snippets from the README, or to have auxiliary texts in markdown form that will be included. \r\n\r\nHopefully this may lead to organization of the code as it will be easier to generate the manual, as moving the options parsers did.\r\n\r\nAt the man page is too much work to update manually.Speaking from experience, writing Groff by hand is not something I would wish to subjugate anyone to. The man page can also suffer from being incomplete before every release."},"comment":{"url":"https://api.github.com/repos/commercialhaskell/stack/issues/comments/130529490","html_url":"https://github.com/commercialhaskell/stack/issues/761#issuecomment-130529490","issue_url":"https://api.github.com/repos/commercialhaskell/stack/issues/761","id":130529490,"user":{"login":"borsboom","id":2164261,"avatar_url":"https://avatars.githubusercontent.com/u/2164261?v=3","gravatar_id":"","url":"https://api.github.com/users/borsboom","html_url":"https://github.com/borsboom","followers_url":"https://api.github.com/users/borsboom/followers","following_url":"https://api.github.com/users/borsboom/following{/other_user}","gists_url":"https://api.github.com/users/borsboom/gists{/gist_id}","starred_url":"https://api.github.com/users/borsboom/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/borsboom/subscriptions","organizations_url":"https://api.github.com/users/borsboom/orgs","repos_url":"https://api.github.com/users/borsboom/repos","events_url":"https://api.github.com/users/borsboom/events{/privacy}","received_events_url":"https://api.github.com/users/borsboom/received_events","type":"User","site_admin":false},"created_at":"2015-08-13T04:32:40Z","updated_at":"2015-08-13T04:32:40Z","body":"I've adjusted the RPM/DEB generation to leave out the man page for now.  When the man page is being generated, revert 2b46df3c4e697d6d9325ac367090176a654a59c2 to add the man page back again.\r\n"}}