[doc] `make pdf` fails even though PDF is successfully built.

[ViralBShah]

The pdf build of the manual is successful (I get a complete pdf), but I get this error messge. When I look in the directory it asks me to check the .log file, I see the pdf

NEWS-update.jl  UnicodeData.txt make.jl
➜  doc git:(master) make pdf
/Users/viral/julia/deps/tools/jlchecksum "/Users/viral/julia/deps/srccache/UnicodeData-13.0.0.txt"
cp "/Users/viral/julia/deps/srccache/UnicodeData-13.0.0.txt" UnicodeData.txt
Building PDF documentation.
/Users/viral/julia/usr/bin/julia --startup-file=no --color=yes /Users/viral/julia/doc/make.jl -- pdf linkcheck= doctest= buildroot=/Users/viral/julia texplatform= revise=
Precompiling project...
  6 dependencies successfully precompiled in 28 seconds
[ Info: SetupBuildDirectory: setting up build directory.
[ Info: Doctest: skipped.
[ Info: ExpandTemplates: expanding markdown templates.
[ Info: CrossReferences: building cross-references.
[ Info: CheckDocument: running document checks.
[ Info: Populate: populating indices.
[ Info: RenderDocument: rendering document.
[ Info: LaTeXWriter: creating the LaTeX file.
[ Info: LaTeXWriter: using latexmk to compile tex.
┌ Error: LaTeXWriter: failed to compile tex with latexmk. Logs and partial output can be found in /var/folders/rj/njz8jnv11637flz6vgnb6bz00000gp/T/jl_0pW3p1.
│   exception =
│    failed process: Process(`latexmk -f -interaction=nonstopmode -view=none -lualatex -shell-escape TheJuliaLanguage.tex`, ProcessExited(12)) [12]
│    
└ @ Documenter.Writers.LaTeXWriter ~/julia/doc/deps/packages/Documenter/9rkAd/src/Writers/LaTeXWriter.jl:176
ERROR: LoadError: Compiling the .tex file failed. See logs for more information.
Stacktrace:
  [1] error(s::String)
    @ Base ./error.jl:35
  [2] (::Documenter.Writers.LaTeXWriter.var"#5#8"{Documenter.Documents.Document, Documenter.Writers.LaTeXWriter.LaTeX})()
    @ Documenter.Writers.LaTeXWriter ~/julia/doc/deps/packages/Documenter/9rkAd/src/Writers/LaTeXWriter.jl:159
  [3] cd(f::Documenter.Writers.LaTeXWriter.var"#5#8"{Documenter.Documents.Document, Documenter.Writers.LaTeXWriter.LaTeX}, dir::String)
    @ Base.Filesystem ./file.jl:112
  [4] (::Documenter.Writers.LaTeXWriter.var"#4#7"{Documenter.Documents.Document, Documenter.Writers.LaTeXWriter.LaTeX})(path::String)
    @ Documenter.Writers.LaTeXWriter ~/julia/doc/deps/packages/Documenter/9rkAd/src/Writers/LaTeXWriter.jl:104
  [5] mktempdir(fn::Documenter.Writers.LaTeXWriter.var"#4#7"{Documenter.Documents.Document, Documenter.Writers.LaTeXWriter.LaTeX}, parent::String; prefix::String)
    @ Base.Filesystem ./file.jl:760
  [6] mktempdir (repeats 2 times)
    @ ./file.jl:758 [inlined]
  [7] render(doc::Documenter.Documents.Document, settings::Documenter.Writers.LaTeXWriter.LaTeX)
    @ Documenter.Writers.LaTeXWriter ~/julia/doc/deps/packages/Documenter/9rkAd/src/Writers/LaTeXWriter.jl:102
  [8] runner(#unused#::Type{Documenter.Writers.LaTeXFormat}, fmt::Documenter.Writers.LaTeXWriter.LaTeX, doc::Documenter.Documents.Document)
    @ Documenter.Writers ~/julia/doc/deps/packages/Documenter/9rkAd/src/Writers/Writers.jl:41
  [9] dispatch(::Type{Documenter.Writers.FormatSelector}, ::Documenter.Writers.LaTeXWriter.LaTeX, ::Vararg{Any})
    @ Documenter.Utilities.Selectors ~/julia/doc/deps/packages/Documenter/9rkAd/src/Utilities/Selectors.jl:170
 [10] render(doc::Documenter.Documents.Document)
    @ Documenter.Writers ~/julia/doc/deps/packages/Documenter/9rkAd/src/Writers/Writers.jl:86
 [11] runner(#unused#::Type{Documenter.Builder.RenderDocument}, doc::Documenter.Documents.Document)
    @ Documenter.Builder ~/julia/doc/deps/packages/Documenter/9rkAd/src/Builder.jl:258
 [12] dispatch(#unused#::Type{Documenter.Builder.DocumentPipeline}, x::Documenter.Documents.Document)
    @ Documenter.Utilities.Selectors ~/julia/doc/deps/packages/Documenter/9rkAd/src/Utilities/Selectors.jl:170
 [13] #2
    @ ~/julia/doc/deps/packages/Documenter/9rkAd/src/Documenter.jl:266 [inlined]
 [14] cd(f::Documenter.var"#2#3"{Documenter.Documents.Document}, dir::String)
    @ Base.Filesystem ./file.jl:112
 [15] makedocs(; debug::Bool, format::Documenter.Writers.LaTeXWriter.LaTeX, kwargs::Base.Pairs{Symbol, Any, NTuple{11, Symbol}, NamedTuple{(:build, :modules, :clean, :doctest, :linkcheck, :linkcheck_ignore, :strict, :checkdocs, :sitename, :authors, :pages), Tuple{String, Vector{Module}, Bool, Bool, Bool, Vector{String}, Bool, Symbol, String, String, Vector{Any}}}})
    @ Documenter ~/julia/doc/deps/packages/Documenter/9rkAd/src/Documenter.jl:265
 [16] top-level scope
    @ ~/julia/doc/make.jl:300
in expression starting at /Users/viral/julia/doc/make.jl:300

And the log file also shows a successful build:

Output written on TheJuliaLanguage.pdf (946 pages, 3991084 bytes).

PDF statistics: 25307 PDF objects out of 26593 (max. 8388607)
 23748 compressed objects within 238 object streams
 8197 named destinations out of 8907 (max. 131072)
 4624 words of extra memory for PDF output out of 10000 (max. 100000000)

[ViralBShah]

Output written on TheJuliaLanguage.pdf (935 pages, 3919969 bytes).
Transcript written on TheJuliaLanguage.log.
Latexmk: Examining 'TheJuliaLanguage.log'
=== TeX engine is 'LuaHBTeX'
Latexmk: Log file says output to 'TheJuliaLanguage.pdf'
Latexmk: Summary of warnings from last run of *latex:
  =====Latex reported missing or unavailable character(s).
=====See log file for details.
Latexmk: Errors, in force_mode: so I tried finishing targets
Collected error summary (may duplicate other messages):
  lualatex: Command for 'lualatex' gave return code 1
      Refer to 'TheJuliaLanguage.log' for details

[ViralBShah]

Grepping for errors in the log file gives:

Package: infwarerr 2019/12/03 v1.5 Providing info/warning/error messages (HO)
! Package minted Error: Missing Pygments output; \inputminted was
! Package minted Error: Missing Pygments output; \inputminted was
! Package minted Error: Missing Pygments output; \inputminted was
<Repeating a lot of times>

[ViralBShah]

I installed pygments, and now I no longer get the pdf, and instead getting a bunch of these errors:

! Undefined control sequence.
<argument> \PYGZsh 
        {} Assign the value 10 to the variable x
l.2 ...GZsh{} Assign the value 10 to the variable x}
                                                  
The control sequence at the end of the top line
of your error message was never \def'ed. If you have
misspelled it (e.g., `\hobx'), type `I' and the correct
spelling (e.g., `I\hbox'). Otherwise just continue,
and I'll forget about whatever was undefined.

[fredrikekre]

Does it work better if you pass texplatform=docker to the make command? In my experience PDF docs are very sensitive to the environment and doesn't always work very nice with system tex.

[ViralBShah]

Trying that. Yes, tex environments are difficult to reproduce. I can't get the docker process working (perhaps a local permissions problem):

$ docker run -itd -u zeptodoctor --name latex-container -v /tmp/jl_leWWlv/build:/mnt/ --rm juliadocs/documenter-latex:0.1
docker: Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Post "http://%2Fvar%2Frun%2Fdocker.sock/v1.24/containers/create?name=latex-container": dial unix /var/run/docker.sock: connect: permission denied.

[ViralBShah]

Update - I was able to successfully run this. @inkydragon suggests using tectonic, which is something I have been hearing people are moving to.