Documenter.jl icon indicating copy to clipboard operation
Documenter.jl copied to clipboard

Julia pdf manual overfull

Open shabmk opened this issue 7 years ago • 2 comments

From https://raw.githubusercontent.com/JuliaLang/docs.julialang.org/assets/julia-1.2.0-DEV.pdf page 18.

In any case, it's awesome that now there's a pdf manual. Great work.

shabmk avatar Dec 22 '18 12:12 shabmk

I could only find a couple of places of overfull, for example, on page 256 of https://raw.githubusercontent.com/JuliaLang/docs.julialang.org/assets/julia-1.8.1.pdf there is: image

I don't know what we should do about that though. If this was ever to be typeset into a printed book, we'd likely save the .tex and then manually tweak. It doesn't seem to be fixable in general on the Documenter side.

odow avatar Sep 16 '22 00:09 odow

Isn't one problem here that the \texttt bits don't switch over to new lines properly? E.g. with a simple article I can easily get

image

with the following Tex

\section{Introduction}
Welcome to the latest release of Gummi - the simple {\LaTeX} editor, \texttt{some-very-long-code-thingy-that-just-doesnt-stop} and then more text.

That one might have some generic fix? Basically, I would expect it to jump to the second line and leave a big white space on the first one, i.e.

image

mortenpi avatar Sep 17 '22 05:09 mortenpi