{"action":"created","issue":{"url":"https://api.github.com/repos/paroj/ogre/issues/68","labels_url":"https://api.github.com/repos/paroj/ogre/issues/68/labels{/name}","comments_url":"https://api.github.com/repos/paroj/ogre/issues/68/comments","events_url":"https://api.github.com/repos/paroj/ogre/issues/68/events","html_url":"https://github.com/paroj/ogre/issues/68","id":119369493,"number":68,"title":"[OGRE-305] Missing instructions for building documentation","user":{"login":"paroj","id":4941802,"avatar_url":"https://avatars.githubusercontent.com/u/4941802?v=3","gravatar_id":"","url":"https://api.github.com/users/paroj","html_url":"https://github.com/paroj","followers_url":"https://api.github.com/users/paroj/followers","following_url":"https://api.github.com/users/paroj/following{/other_user}","gists_url":"https://api.github.com/users/paroj/gists{/gist_id}","starred_url":"https://api.github.com/users/paroj/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/paroj/subscriptions","organizations_url":"https://api.github.com/users/paroj/orgs","repos_url":"https://api.github.com/users/paroj/repos","events_url":"https://api.github.com/users/paroj/events{/privacy}","received_events_url":"https://api.github.com/users/paroj/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/paroj/ogre/labels/Build%20/%20Compilation","name":"Build / Compilation","color":"5c3f53"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":6,"created_at":"2015-11-29T16:36:12Z","updated_at":"2015-11-29T16:36:33Z","closed_at":null,"body":"<b>[reporter=\"mafm\", created=\"Tue, 15 Oct 2013 01:21:24 +0200\"]</b>\n<p>I am trying to build the Debian package for 1.9 RC2 and I am finding some inaccuracies and difficulties to build the documentation.</p>\n\n<p>The instructions in BuildingOgre.txt mention \"make doc\", which I think that it became \"make OgreDoc\".</p>\n\n<p>graphviz seems necessary (additionally to Doxygen) to build the documentation with graphics.</p>\n\n<p>The manual and vbo-update doc can be built with the help of the script makedocs.sh (needs texi2html), but tries to build the API again with doxygen again first of all.  It looks as if the API was updated to built through cmake, but the other documentation was not, or is considered obsolete.</p>\n\n<p>It would be great if you can provide clear instructions so we know the best way to provide useful, accurate and up to date documentation to users.</p>\n\n<p>Hope that helps.</p>"},"comment":{"url":"https://api.github.com/repos/paroj/ogre/issues/comments/160430951","html_url":"https://github.com/paroj/ogre/issues/68#issuecomment-160430951","issue_url":"https://api.github.com/repos/paroj/ogre/issues/68","id":160430951,"user":{"login":"paroj","id":4941802,"avatar_url":"https://avatars.githubusercontent.com/u/4941802?v=3","gravatar_id":"","url":"https://api.github.com/users/paroj","html_url":"https://github.com/paroj","followers_url":"https://api.github.com/users/paroj/followers","following_url":"https://api.github.com/users/paroj/following{/other_user}","gists_url":"https://api.github.com/users/paroj/gists{/gist_id}","starred_url":"https://api.github.com/users/paroj/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/paroj/subscriptions","organizations_url":"https://api.github.com/users/paroj/orgs","repos_url":"https://api.github.com/users/paroj/repos","events_url":"https://api.github.com/users/paroj/events{/privacy}","received_events_url":"https://api.github.com/users/paroj/received_events","type":"User","site_admin":false},"created_at":"2015-11-29T16:36:33Z","updated_at":"2015-11-29T16:36:33Z","body":"<b><i>[author=\"mafm\", created=\"Sat, 19 Oct 2013 13:32:27 +0200\"]</i></b>\n<p>Well, any other syntax that works in a more or less modern makeinfo version, or even other popular tools, is fine for including in Debian/Ubuntu.</p>\n\n<p>Or also it's fine  if you want to keep using texi2html for a while (we apply the change above to build with makeinfo, so it's not an immediate problem).  The thing is that texi2html has not been updated for quite a while already, so I think that it's wise to move away from it, that's why I suggested it, and makeinfo seems like the \"natual heir\".</p>\n\n<p>Hope that helps.</p>"}}