{"action":"created","issue":{"url":"https://api.github.com/repos/CGAL/cgal/issues/224","labels_url":"https://api.github.com/repos/CGAL/cgal/issues/224/labels{/name}","comments_url":"https://api.github.com/repos/CGAL/cgal/issues/224/comments","events_url":"https://api.github.com/repos/CGAL/cgal/issues/224/events","html_url":"https://github.com/CGAL/cgal/pull/224","id":98397330,"number":224,"title":"Allow documentation builds from release","user":{"login":"bo0ts","id":76102,"avatar_url":"https://avatars.githubusercontent.com/u/76102?v=3","gravatar_id":"","url":"https://api.github.com/users/bo0ts","html_url":"https://github.com/bo0ts","followers_url":"https://api.github.com/users/bo0ts/followers","following_url":"https://api.github.com/users/bo0ts/following{/other_user}","gists_url":"https://api.github.com/users/bo0ts/gists{/gist_id}","starred_url":"https://api.github.com/users/bo0ts/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bo0ts/subscriptions","organizations_url":"https://api.github.com/users/bo0ts/orgs","repos_url":"https://api.github.com/users/bo0ts/repos","events_url":"https://api.github.com/users/bo0ts/events{/privacy}","received_events_url":"https://api.github.com/users/bo0ts/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/CGAL/cgal/labels/doc","name":"doc","color":"fef2c0"},{"url":"https://api.github.com/repos/CGAL/cgal/labels/enhancement","name":"enhancement","color":"84b6eb"},{"url":"https://api.github.com/repos/CGAL/cgal/labels/not%20yet%20approved","name":"not yet approved","color":"eb6420"}],"state":"open","locked":false,"assignee":{"login":"lrineau","id":5746675,"avatar_url":"https://avatars.githubusercontent.com/u/5746675?v=3","gravatar_id":"","url":"https://api.github.com/users/lrineau","html_url":"https://github.com/lrineau","followers_url":"https://api.github.com/users/lrineau/followers","following_url":"https://api.github.com/users/lrineau/following{/other_user}","gists_url":"https://api.github.com/users/lrineau/gists{/gist_id}","starred_url":"https://api.github.com/users/lrineau/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lrineau/subscriptions","organizations_url":"https://api.github.com/users/lrineau/orgs","repos_url":"https://api.github.com/users/lrineau/repos","events_url":"https://api.github.com/users/lrineau/events{/privacy}","received_events_url":"https://api.github.com/users/lrineau/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/CGAL/cgal/milestones/7","html_url":"https://github.com/CGAL/cgal/milestones/4.8-beta","labels_url":"https://api.github.com/repos/CGAL/cgal/milestones/7/labels","id":1202221,"number":7,"title":"4.8-beta","description":"","creator":{"login":"lrineau","id":5746675,"avatar_url":"https://avatars.githubusercontent.com/u/5746675?v=3","gravatar_id":"","url":"https://api.github.com/users/lrineau","html_url":"https://github.com/lrineau","followers_url":"https://api.github.com/users/lrineau/followers","following_url":"https://api.github.com/users/lrineau/following{/other_user}","gists_url":"https://api.github.com/users/lrineau/gists{/gist_id}","starred_url":"https://api.github.com/users/lrineau/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lrineau/subscriptions","organizations_url":"https://api.github.com/users/lrineau/orgs","repos_url":"https://api.github.com/users/lrineau/repos","events_url":"https://api.github.com/users/lrineau/events{/privacy}","received_events_url":"https://api.github.com/users/lrineau/received_events","type":"User","site_admin":false},"open_issues":9,"closed_issues":0,"state":"open","created_at":"2015-07-10T10:06:47Z","updated_at":"2015-07-31T14:53:44Z","due_on":null,"closed_at":null},"comments":4,"created_at":"2015-07-31T14:02:12Z","updated_at":"2015-07-31T15:36:36Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/CGAL/cgal/pulls/224","html_url":"https://github.com/CGAL/cgal/pull/224","diff_url":"https://github.com/CGAL/cgal/pull/224.diff","patch_url":"https://github.com/CGAL/cgal/pull/224.patch"},"body":"This PR enables the CMake scripts to build the documentation from a release.\r\n\r\nThis comes with two visible changes to package developers in `Doxyfile.in`:\r\n\r\n- `INPUT` is now computed and it is only necessary to specify it when in-source comments are used.\r\n- When using in-source comments it is necessary to specify all source files with comments explicitly. This is necessary so that doxygen knows which files to process in a release where all include folders are collapsed. It is still possible to specify unique sub-folders. This has the added benefit of encouraging better include layout per package.\r\n\r\nThe documentation testsuite reports some warnings when the documentation is built from a release. This is caused by example files which are specified in `Package/doc/Package/examples.txt` but which are not present in a release due to `dont_submit` rules. This still requires verification and fixes. \r\n\r\nOutput postprocessing seems to work but requires more checking.\r\n\r\nI don't think this should go into 4.7 since I'm not comfortable with last minute changes in a crucial component like documentation. Please mark for 4.8."},"comment":{"url":"https://api.github.com/repos/CGAL/cgal/issues/comments/126726724","html_url":"https://github.com/CGAL/cgal/pull/224#issuecomment-126726724","issue_url":"https://api.github.com/repos/CGAL/cgal/issues/224","id":126726724,"user":{"login":"lrineau","id":5746675,"avatar_url":"https://avatars.githubusercontent.com/u/5746675?v=3","gravatar_id":"","url":"https://api.github.com/users/lrineau","html_url":"https://github.com/lrineau","followers_url":"https://api.github.com/users/lrineau/followers","following_url":"https://api.github.com/users/lrineau/following{/other_user}","gists_url":"https://api.github.com/users/lrineau/gists{/gist_id}","starred_url":"https://api.github.com/users/lrineau/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lrineau/subscriptions","organizations_url":"https://api.github.com/users/lrineau/orgs","repos_url":"https://api.github.com/users/lrineau/repos","events_url":"https://api.github.com/users/lrineau/events{/privacy}","received_events_url":"https://api.github.com/users/lrineau/received_events","type":"User","site_admin":false},"created_at":"2015-07-31T15:36:36Z","updated_at":"2015-07-31T15:36:36Z","body":"> ALL_PACKAGE_INCLUDE\r\n\r\n`ALL_PACKAGE_HEADERS` might be a better name. And even this name could be improved.\r\n"}}