Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 24 Jul 2013 01:03:50 +0200
From:      Gabor Kovesdan <gabor.kovesdan@gmail.com>
To:        Michael Ross <gmx@ross.cx>, FBSD Doc project <doc@freebsd.org>
Subject:   Re: CFR: documentation rendered in PDF with FOP
Message-ID:  <51EF0BD6.7040901@FreeBSD.org>
In-Reply-To: <op.w0o26j0gg7njmm@michael-think>
References:  <51EE8750.7040208@FreeBSD.org> <op.w0o26j0gg7njmm@michael-think>

next in thread | previous in thread | raw e-mail | index | archive | help
On 2013.07.23. 23:55, Michael Ross wrote:
> I just skimmed through the pdf of the german version of the 
> developer's handbook and noticed some problems with syllabification at 
> the end of lines.
>
> Examples:
>     filename "fromboz.c" printed as
>         from-
>         boz.c
Do you think filenames and such should not be hyphenated at all? I've 
been thinking of it but that may sometimes result in weird spacing 
because of the justification.
>
>     "/usr/share/mk" printed as
>         /
>         share/mk
>
>     "Option -o" printed as
>         Option -
>         o
>
> From the english version:
>     "<des@FreeBSD.org>" printed as
>         <des@FreeB-
>         SD.org>
>
> Plus, in some paragraphs nearly all lines end with a hyphen; I think 
> that makes the whole hard to read.
>
> If possible, I would turn syllabification off altogether. 
Hyphenation can still be improved and actually it is a requirement for 
printed publications. With hyphenation, justification works better and 
text should have a more pleasant outlook. We can tweak the dictionaries 
to avoid hyphenating the word FreeBSD and such. And as a last resort, we 
can still easily turn it off if we are not satisfied with the result. 
The rendering is still a work in progress. I'll see what I can do here.

Gabor



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?51EF0BD6.7040901>