[GHC] #16352: Hadrian: generation of PDF documents doesn't work

22 Feb 2019

      #16352: Hadrian: generation of PDF documents doesn't work
-------------------------------------+-------------------------------------
           Reporter:  alpmestan      |             Owner:  (none)
               Type:  bug            |            Status:  new
           Priority:  high           |         Milestone:
          Component:  Build System   |           Version:  8.7
  (Hadrian)                          |
           Keywords:                 |  Operating System:  Linux
       Architecture:                 |   Type of failure:  None/Unknown
  Unknown/Multiple                   |
          Test Case:                 |        Blocked By:
           Blocking:                 |   Related Tickets:
Differential Rev(s):                 |         Wiki Page:
-------------------------------------+-------------------------------------
 1) With [https://github.com/alpmestan/ghc.nix ghc.nix]

 While trying to produce `_build/docs/pdfs/Haddock.pdf`:

 {{{
 kpathsea: Running mktexmf pcrr8t

 ! I can't find file `pcrr8t'.
 <*> ...:=ljfour; mag:=1; nonstopmode; input pcrr8t

 Please type another input file name
 ! Emergency stop.
 <*> ...:=ljfour; mag:=1; nonstopmode; input pcrr8t

 Transcript written on mfput.log.
 grep: pcrr8t.log: No such file or directory

 }}}

 2) With the CI docker images

 (e.g
 [https://gitlab.haskell.org/ghc/ghc/blob/master/.circleci/images/x86_64
 -linux-deb8/Dockerfile this x86_64 debian8 one])

 Agian, while trying to product the PDF version of the haddock manual:

 {{{
 | Run Xelatex: Haddock.tex => /tmp/extra-dir-87721391039866
 This is XeTeX, Version 3.14159265-2.6-0.99992 (TeX Live 2015/dev/Debian)
 (preloaded format=xelatex)
  restricted \write18 enabled.
 entering extended mode
 (./Haddock.tex
 LaTeX2e <2014/05/01>
 Babel <3.9l> and hyphenation patterns for 2 languages loaded.
 (./sphinxmanual.cls
 Document Class: sphinxmanual 2009/06/02 Document class (Sphinx manual)
 (/usr/share/texlive/texmf-dist/tex/latex/base/report.cls
 Document Class: report 2014/09/29 v1.4h Standard LaTeX document class
 (/usr/share/texlive/texmf-dist/tex/latex/base/size10.clo)))
 (/usr/share/texlive/texmf-dist/tex/latex/base/inputenc.sty

 Package inputenc Warning: inputenc package ignored with utf8 based
 engines.

 )
 ! Undefined control sequence.
 <recently read> \DeclareUnicodeCharacter

 l.5 \DeclareUnicodeCharacter
                             {00A0}{\nobreakspace}
 No pages of output.
 Transcript written on Haddock.log.
 }}}

 [https://tex.stackexchange.com/a/378643 This StackExchange post] that
 Matthew pointed me to gives a clue as to as why this happens.

 ---

 I am going to comment out the `need`s that make us produce these files in
 Hadrian when we ask for the docs, for now, leaving a comment pointing to
 this ticket. Then as we figure out solutions to these issues (especially
 2), since that's GHC's CI system), we can put those PDFs back in and mark
 this ticket as solved.

-- 
Ticket URL: http://ghc.haskell.org/trac/ghc/ticket/16352
GHC http://www.haskell.org/ghc/
The Glasgow Haskell Compiler