Broken build: Documentation mistake

Hello there, Looks like there is some problem with one of the recent changes to The User's Guide source code as it cannot be built any more [1] (since about June 4). Here is the error message, hopefully it helps with fixing the cause: [..] Build users_guide.ps latex failed users_guide.tex:15584: Cannot determine size of graphic in docs/users_guide//prof_scc.png (no BoundingBox). users_guide.tex:15584: leading text: ...width=645pt,height=428pt]{prof_scc.png} Unexpected error occured [ -f docs/users_guide/users_guide.ps ] docs/users_guide/ghc.mk:26: recipe for target 'docs/users_guide/users_guide.ps' failed gmake[1]: *** [docs/users_guide/users_guide.ps] Error 1 Makefile:102: recipe for target 'all' failed gmake: *** [all] Error 2 Thanks, Gábor [1] http://haskell.inf.elte.hu/builders/freebsd-amd64-head/652/10.html

Sigh. I'll revert this. I couldn't reproduce this on my two machines,
but I should have figured it would have broken something. I took a
chance. :)
I'll try it on FreeBSD before pushing.
On Mon, Jun 8, 2015 at 2:07 PM, Páli Gábor János
Hello there,
Looks like there is some problem with one of the recent changes to The User's Guide source code as it cannot be built any more [1] (since about June 4). Here is the error message, hopefully it helps with fixing the cause:
[..] Build users_guide.ps latex failed users_guide.tex:15584: Cannot determine size of graphic in docs/users_guide//prof_scc.png (no BoundingBox). users_guide.tex:15584: leading text: ...width=645pt,height=428pt]{prof_scc.png} Unexpected error occured [ -f docs/users_guide/users_guide.ps ] docs/users_guide/ghc.mk:26: recipe for target 'docs/users_guide/users_guide.ps' failed gmake[1]: *** [docs/users_guide/users_guide.ps] Error 1 Makefile:102: recipe for target 'all' failed gmake: *** [all] Error 2
Thanks, Gábor
[1] http://haskell.inf.elte.hu/builders/freebsd-amd64-head/652/10.html _______________________________________________ ghc-devs mailing list ghc-devs@haskell.org http://mail.haskell.org/cgi-bin/mailman/listinfo/ghc-devs
-- Regards, Austin Seipp, Haskell Consultant Well-Typed LLP, http://www.well-typed.com/

2015-06-08 23:19 GMT+02:00 Austin Seipp
Sigh. I'll revert this. I couldn't reproduce this on my two machines, but I should have figured it would have broken something. I took a chance. :)
So the documentation builds fine for you? I believed the FreeBSD builders failed only because the they always try to build the documentation as well, while that might not be the part of the standard validation pass.
I'll try it on FreeBSD before pushing.
I can help with this, you do not have to struggle with FreeBSD just because of this -- just send me the patch to try. However, I think this may not be fully an operating system-related issue, perhaps the documentation toolchain is not up-to-date enough. For example, I have this version of the latex command installed currently: pdfTeX 3.14159265-2.6-1.40.15 (Web2C 2014) kpathsea version 6.2.0 [..] Compiled with libpng 1.6.16; using libpng 1.6.16 Compiled with zlib 1.2.3; using zlib 1.2.3 Compiled with xpdf version 3.03

Yes, please try the patch here - I think it should fix it (it carries
an explanation too): https://phabricator.haskell.org/D970
On Tue, Jun 9, 2015 at 2:10 AM, Páli Gábor János
2015-06-08 23:19 GMT+02:00 Austin Seipp
: Sigh. I'll revert this. I couldn't reproduce this on my two machines, but I should have figured it would have broken something. I took a chance. :)
So the documentation builds fine for you? I believed the FreeBSD builders failed only because the they always try to build the documentation as well, while that might not be the part of the standard validation pass.
I'll try it on FreeBSD before pushing.
I can help with this, you do not have to struggle with FreeBSD just because of this -- just send me the patch to try. However, I think this may not be fully an operating system-related issue, perhaps the documentation toolchain is not up-to-date enough. For example, I have this version of the latex command installed currently:
pdfTeX 3.14159265-2.6-1.40.15 (Web2C 2014) kpathsea version 6.2.0 [..] Compiled with libpng 1.6.16; using libpng 1.6.16 Compiled with zlib 1.2.3; using zlib 1.2.3 Compiled with xpdf version 3.03
-- Regards, Austin Seipp, Haskell Consultant Well-Typed LLP, http://www.well-typed.com/

2015-06-09 14:34 GMT+02:00 Austin Seipp
Yes, please try the patch here - I think it should fix it (it carries an explanation too): https://phabricator.haskell.org/D970
Yeah, thanks, this appears to be working.

Hi Austin, Looks like the build is failing again, with another error message from LaTeX [1]: <snip> Build users_guide.ps latex failed users_guide.tex:17168: Undefined control sequence \Colon. users_guide.tex:17168: leading text: } Unexpected error occured Missing character ⤙ Missing character ⤚ Missing character ⤛ Missing character ⤜ [ -f docs/users_guide/users_guide.ps ] docs/users_guide/ghc.mk:26: recipe for target 'docs/users_guide/users_guide.ps' failed gmake[1]: *** [docs/users_guide/users_guide.ps] Error 1 Makefile:102: recipe for target 'all' failed gmake: *** [all] Error 2 Do you have any ideas why this is happening? Thanks, Gábor [1] http://haskell.inf.elte.hu/builders/freebsd-i386-head/650/10.html

I'm afraid I have no idea... I pushed several documentation patches to
the ghc-7.10 branch:
https://phabricator.haskell.org/diffusion/GHC/history/ghc-7.10/
Can you try reverting some of those 'More 7.10.2 release notes
commits'? That's the only thing I can think that might be the
culprit...
On Sun, Jun 14, 2015 at 10:08 AM, Páli Gábor János
Hi Austin,
Looks like the build is failing again, with another error message from LaTeX [1]:
<snip> Build users_guide.ps latex failed users_guide.tex:17168: Undefined control sequence \Colon. users_guide.tex:17168: leading text: } Unexpected error occured Missing character ⤙ Missing character ⤚ Missing character ⤛ Missing character ⤜ [ -f docs/users_guide/users_guide.ps ] docs/users_guide/ghc.mk:26: recipe for target 'docs/users_guide/users_guide.ps' failed gmake[1]: *** [docs/users_guide/users_guide.ps] Error 1 Makefile:102: recipe for target 'all' failed gmake: *** [all] Error 2
Do you have any ideas why this is happening?
Thanks, Gábor
[1] http://haskell.inf.elte.hu/builders/freebsd-i386-head/650/10.html
-- Regards, Austin Seipp, Haskell Consultant Well-Typed LLP, http://www.well-typed.com/

Missing character ⤙ Missing character ⤚ Missing character ⤛ Missing character ⤜
That is from the patch in https://ghc.haskell.org/trac/ghc/ticket/10509. The user's guide builds and looks fine for me, and Phabricator validates it as well. These are some related packages I have installed: ii dblatex 0.3.4-3build1 ii docbook-dsssl 1.79-7ubuntu1 ii docbook-utils 0.6.14-3ubuntu1 ii docbook-xml 4.5-7.2 ii docbook-xsl 1.78.1+dfsg-1 ii texlive-latex-base 2013.20140215-1 ii texlive-latex-extra 2013.20140215-2 ii texlive-latex-recommended 2013.20140215-1

Hi Thomas,
2015-06-14 19:07 GMT+02:00 Thomas Miedema
The user's guide builds and looks fine for me, and Phabricator validates it as well.
I tried to make this work with a recent set of those related packages (dblatex, docbook, LaTeX etc.) but it still does not fully work for me. The best result I was able to achive is that I passed the -P 'latex.unicode.use=1' flag to dblatex so it could build the PS file. It still says that, though: Missing character ⤙ Missing character ⤚ Missing character ⤛ Missing character ⤜ Note that this way the PS file is generated, but when I checked the table in 7.3.1, it had the entity codes in place of the Unicode symbols. May I see the build logs of yours somewhere? Thanks, Gábor

2015-06-15 23:39 GMT+02:00 Páli Gábor János
The best result I was able to achive is that I passed the -P 'latex.unicode.use=1' flag to dblatex so it could build the PS file.
So, would you mind if I added this flag for dblatex, so it would at least unbreak the build for me? That is, consider the following patch: --- a/mk/config.mk.in +++ b/mk/config.mk.in @@ -731,7 +731,7 @@ BUILD_DOCBOOK_PS = @BUILD_DOCBOOK_PS@ BUILD_DOCBOOK_PDF = @BUILD_DOCBOOK_PDF@ DBLATEX = @DblatexCmd@ # filename.as.url=0 is needed with dblatex 0.3.4 (#7486) -DBLATEX_OPTS = -P 'filename.as.url=0' +DBLATEX_OPTS = -P 'filename.as.url=0' -P 'latex.unicode.use=1' XSLTPROC = @XsltprocCmd@ XMLLINT = @XmllintCmd@ HAVE_DOCBOOK_XSL = @HAVE_DOCBOOK_XSL@ I have not yet given up the hope to understand the exact causes, but this could serve as an interim solution for me until I can solve it -- unless if it breaks something on Ubuntu.
Note that this way the PS file is generated, but when I checked the table in 7.3.1, it had the entity codes in place of the Unicode symbols. May I see the build logs of yours somewhere?
In the meantime, I tried to look up some logs for the referenced Phabricator builds, but unfortunately they are not run in verbose mode, so I cannot exactly tell if the PS/PDF versions of the User's Guide are built or not at all. (Though, the configure output indicates that they are.) Note that the HTML version builds just fine for me as well, as dblatex simply puts the corresponding Unicode codes right into the generated files. The problem is with LaTeX because it cannot handle those codes -- after studying the sources of both dblatex, passivetex, the latex ucs package, and the DocBook XML 4.5 entities, I could not yet get how it is able to work on your system. That is why it would be good to see a detailed build log as a reference.
participants (3)
-
Austin Seipp
-
Páli Gábor János
-
Thomas Miedema