{"action":"created","issue":{"url":"https://api.github.com/repos/OSGeo/proj.4/issues/869","repository_url":"https://api.github.com/repos/OSGeo/proj.4","labels_url":"https://api.github.com/repos/OSGeo/proj.4/issues/869/labels{/name}","comments_url":"https://api.github.com/repos/OSGeo/proj.4/issues/869/comments","events_url":"https://api.github.com/repos/OSGeo/proj.4/issues/869/events","html_url":"https://github.com/OSGeo/proj.4/pull/869","id":306247281,"number":869,"title":"Auto-generate man pages from Sphinx docs","user":{"login":"kbevers","id":13132571,"avatar_url":"https://avatars3.githubusercontent.com/u/13132571?v=4","gravatar_id":"","url":"https://api.github.com/users/kbevers","html_url":"https://github.com/kbevers","followers_url":"https://api.github.com/users/kbevers/followers","following_url":"https://api.github.com/users/kbevers/following{/other_user}","gists_url":"https://api.github.com/users/kbevers/gists{/gist_id}","starred_url":"https://api.github.com/users/kbevers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kbevers/subscriptions","organizations_url":"https://api.github.com/users/kbevers/orgs","repos_url":"https://api.github.com/users/kbevers/repos","events_url":"https://api.github.com/users/kbevers/events{/privacy}","received_events_url":"https://api.github.com/users/kbevers/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":3,"created_at":"2018-03-18T14:57:49Z","updated_at":"2018-03-18T21:13:54Z","closed_at":null,"author_association":"MEMBER","pull_request":{"url":"https://api.github.com/repos/OSGeo/proj.4/pulls/869","html_url":"https://github.com/OSGeo/proj.4/pull/869","diff_url":"https://github.com/OSGeo/proj.4/pull/869.diff","patch_url":"https://github.com/OSGeo/proj.4/pull/869.patch"},"body":"This PR reformats the existing application doc pages on the webpage to better use the Sphinx syntax. A new page for the gie application has been added as well. Using the proper Sphinx syntax makes it possible to generate man pages from the Sphinx docs making sure that the web page and man pages are aligned and up to date.\r\n\r\nBecause the way options are described in Sphinx is not as flexible as I would like it has been necessary to describe them a little differently to the old man-pages. This is especially with regards to flags like `-w` and `-W` that are described as `-[wIW]n` in the current man pages. This is hard to do in Sphinx so I have split those into two different flags `-w` and `-W` with each it's own description. I might have interpreted the original text wrong so please take a good look on those and check that the description matches reality.\r\n\r\nI have added rule to the autoconf makefiles that takes care of building the man pages. I am not entirely happy with the way I have manage to set it up since the man-pages are generated every time `make` is called. Even if nothing in the docs has changed. Ideally I would like the man-pages only be generated when running `make install` and `make dist` but haven't been able to figure out how to do this. Ideas how to change that are welcome. \r\n\r\nI haven't looked at CMake yet and have most likely mocked that up by changing the folder structure in `man/`. Also, Sphinx is now a dependency when building with automake. I don't think this is too big a deal since we are already using it, but with this it is a hard dependency instead of a soft dependency. If it is possible to reconfigure the makefiles as described above it will only have to be a soft dependency.\r\n\r\nI expect this needs some changes before merging but I wanted it out there to show what I am working on and hopefully get some tips on how to configure the makefiles in a better way."},"comment":{"url":"https://api.github.com/repos/OSGeo/proj.4/issues/comments/374047748","html_url":"https://github.com/OSGeo/proj.4/pull/869#issuecomment-374047748","issue_url":"https://api.github.com/repos/OSGeo/proj.4/issues/869","id":374047748,"user":{"login":"kbevers","id":13132571,"avatar_url":"https://avatars3.githubusercontent.com/u/13132571?v=4","gravatar_id":"","url":"https://api.github.com/users/kbevers","html_url":"https://github.com/kbevers","followers_url":"https://api.github.com/users/kbevers/followers","following_url":"https://api.github.com/users/kbevers/following{/other_user}","gists_url":"https://api.github.com/users/kbevers/gists{/gist_id}","starred_url":"https://api.github.com/users/kbevers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kbevers/subscriptions","organizations_url":"https://api.github.com/users/kbevers/orgs","repos_url":"https://api.github.com/users/kbevers/repos","events_url":"https://api.github.com/users/kbevers/events{/privacy}","received_events_url":"https://api.github.com/users/kbevers/received_events","type":"User","site_admin":false},"created_at":"2018-03-18T21:13:54Z","updated_at":"2018-03-18T21:13:54Z","author_association":"MEMBER","body":"I have abandoned the idea with the build systems and added a script for updating man pages semi-automatically. New versions of the man pages have been committed as a test of the script and to show the resulting Sphinx-build man pages."}}
{"actor":{"display_login":"kbevers"}}