{"action":"created","issue":{"url":"https://api.github.com/repos/akka/akka/issues/17752","labels_url":"https://api.github.com/repos/akka/akka/issues/17752/labels{/name}","comments_url":"https://api.github.com/repos/akka/akka/issues/17752/comments","events_url":"https://api.github.com/repos/akka/akka/issues/17752/events","html_url":"https://github.com/akka/akka/issues/17752","id":88882037,"number":17752,"title":"Latest version of Sphinx breaks PDF generation task","user":{"login":"kukido","id":1329454,"avatar_url":"https://avatars.githubusercontent.com/u/1329454?v=3","gravatar_id":"","url":"https://api.github.com/users/kukido","html_url":"https://github.com/kukido","followers_url":"https://api.github.com/users/kukido/followers","following_url":"https://api.github.com/users/kukido/following{/other_user}","gists_url":"https://api.github.com/users/kukido/gists{/gist_id}","starred_url":"https://api.github.com/users/kukido/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kukido/subscriptions","organizations_url":"https://api.github.com/users/kukido/orgs","repos_url":"https://api.github.com/users/kukido/repos","events_url":"https://api.github.com/users/kukido/events{/privacy}","received_events_url":"https://api.github.com/users/kukido/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/akka/akka/labels/1%20-%20triaged","name":"1 - triaged","color":"5319e7"},{"url":"https://api.github.com/repos/akka/akka/labels/t:docs","name":"t:docs","color":"CCCCCC"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/akka/akka/milestones/17","html_url":"https://github.com/akka/akka/milestones/2.4.0","labels_url":"https://api.github.com/repos/akka/akka/milestones/17/labels","id":745883,"number":17,"title":"2.4.0","description":"","creator":{"login":"patriknw","id":336161,"avatar_url":"https://avatars.githubusercontent.com/u/336161?v=3","gravatar_id":"","url":"https://api.github.com/users/patriknw","html_url":"https://github.com/patriknw","followers_url":"https://api.github.com/users/patriknw/followers","following_url":"https://api.github.com/users/patriknw/following{/other_user}","gists_url":"https://api.github.com/users/patriknw/gists{/gist_id}","starred_url":"https://api.github.com/users/patriknw/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/patriknw/subscriptions","organizations_url":"https://api.github.com/users/patriknw/orgs","repos_url":"https://api.github.com/users/patriknw/repos","events_url":"https://api.github.com/users/patriknw/events{/privacy}","received_events_url":"https://api.github.com/users/patriknw/received_events","type":"User","site_admin":false},"open_issues":206,"closed_issues":0,"state":"open","created_at":"2014-08-07T06:58:48Z","updated_at":"2015-06-17T15:26:07Z","due_on":"2015-06-29T22:00:00Z","closed_at":null},"comments":3,"created_at":"2015-06-17T01:19:33Z","updated_at":"2015-06-17T23:37:09Z","closed_at":null,"body":"After following documentation instructions from http://doc.akka.io/docs/akka/snapshot/dev/documentation.html I was not able to generate PDF and was getting the following error:\r\n\r\n```\r\n[debug] ! Undefined control sequence.\r\n[debug] <argument> \\node@class@name\r\n[debug]\r\n[debug] l.18759 ...ection{Partitioning \\DUspan{}{{[}*{]}}}\r\n[debug]\r\n[debug] ?\r\n[debug] ! Emergency stop.\r\n[debug] <argument> \\node@class@name\r\n[debug]\r\n[debug] l.18759 ...ection{Partitioning \\DUspan{}{{[}*{]}}}\r\n[debug]\r\n[debug] !  ==> Fatal error occurred, no output PDF file produced!\r\n[debug] Transcript written on AkkaJava.log.\r\n[debug] make: *** [AkkaJava.pdf] Error 1\r\n```\r\n\r\nAs it was my workstation, I tried to repeat the procedure in \"clean room\" environment of VM. Followed the instructions and got exactly the same error.\r\n\r\nObviously, something was wrong. With help from @rkuhn and @ktoso was able to eliminate MacTeX, and the only variable left was Sphinx. Since HTML generation was fine, it was never a main suspect :-)\r\n\r\n@ktoso mentioned his version of Sphinx - `1.2.3`, while the latest automatically installed by `pip` is `1.3.1`.\r\n\r\n```\r\nYou are using pip version 6.1.1, however version 7.0.3 is available.\r\nYou should consider upgrading via the 'pip install --upgrade pip' command.\r\nSphinx (1.2.3)\r\n```\r\n\r\nI was able to restore the build by forcing `1.2.3` version of Sphinx with `pip`. Will submit the documentation patch shortly."},"comment":{"url":"https://api.github.com/repos/akka/akka/issues/comments/112980299","html_url":"https://github.com/akka/akka/issues/17752#issuecomment-112980299","issue_url":"https://api.github.com/repos/akka/akka/issues/17752","id":112980299,"user":{"login":"kukido","id":1329454,"avatar_url":"https://avatars.githubusercontent.com/u/1329454?v=3","gravatar_id":"","url":"https://api.github.com/users/kukido","html_url":"https://github.com/kukido","followers_url":"https://api.github.com/users/kukido/followers","following_url":"https://api.github.com/users/kukido/following{/other_user}","gists_url":"https://api.github.com/users/kukido/gists{/gist_id}","starred_url":"https://api.github.com/users/kukido/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kukido/subscriptions","organizations_url":"https://api.github.com/users/kukido/orgs","repos_url":"https://api.github.com/users/kukido/repos","events_url":"https://api.github.com/users/kukido/events{/privacy}","received_events_url":"https://api.github.com/users/kukido/received_events","type":"User","site_admin":false},"created_at":"2015-06-17T23:37:09Z","updated_at":"2015-06-17T23:37:09Z","body":"The first version of Sphinx not working with current docs is `1.3`\r\n\r\n Looking at version `1.3` [changelog](http://sphinx-doc.org/changes.html#release-1-3-released-mar-10-2015) I see only one change which could have an effect: [Error building sphinx_rtd_theme demo docs with pdf target](https://github.com/sphinx-doc/sphinx/issues/1745)\r\n\r\nNow, back to akka documentation. It seems that taking \"footnotes\" from sections titles solves the issue."}}