From owner-freebsd-doc@FreeBSD.ORG Tue Jul 23 23:04:04 2013 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id AFB69BE6 for ; Tue, 23 Jul 2013 23:04:04 +0000 (UTC) (envelope-from gabor.kovesdan@gmail.com) Received: from mail-ee0-x235.google.com (mail-ee0-x235.google.com [IPv6:2a00:1450:4013:c00::235]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4793A2B80 for ; Tue, 23 Jul 2013 23:04:04 +0000 (UTC) Received: by mail-ee0-f53.google.com with SMTP id e53so542529eek.26 for ; Tue, 23 Jul 2013 16:04:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:user-agent:mime-version:to:subject:references :in-reply-to:content-type:content-transfer-encoding; bh=f2zqNOSd8H131eiUUvZ9zIk3HRdf+BMGOEwH8vrO7ds=; b=aiFNshA2T2nh3GWuxtMc7efsVqmskuPv0y/LMcA2rs/nRwoR7j9EDR+KQxXXJ+KXiz yfC836ba1MRs0RVeMZdeU5KdaB0iEfGZJM1xaPasKTCy+yXkmzy/bU/uhcRefVGcJprv K0qm2CFCLGDBbCNxAj8RzT1jOgvBXfKJ7ccpvS8UbRK09Zkua2OdzLK9QNz3n/7I1mJe Hcd+hg3zEuXaPZHA4P6bVuoPOXj+TnOeMLU/JNegfugOQJ4q18/Cfq1zs/dFQ+CUHI0u Hu59hM4i2zbKOa23Q+nN0iNzVVNCrB4F1RoOzhdvOBNq58fHOUzZPcNKeB3uwy49exCP F+Og== X-Received: by 10.14.199.134 with SMTP id x6mr34897560een.114.1374620642606; Tue, 23 Jul 2013 16:04:02 -0700 (PDT) Received: from [192.168.1.117] (catv-80-99-23-232.catv.broadband.hu. [80.99.23.232]) by mx.google.com with ESMTPSA id r54sm61822223eev.8.2013.07.23.16.04.01 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Tue, 23 Jul 2013 16:04:02 -0700 (PDT) Message-ID: <51EF0BD6.7040901@FreeBSD.org> Date: Wed, 24 Jul 2013 01:03:50 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:24.0) Gecko/20100101 Thunderbird/24.0a2 MIME-Version: 1.0 To: Michael Ross , FBSD Doc project Subject: Re: CFR: documentation rendered in PDF with FOP References: <51EE8750.7040208@FreeBSD.org> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-15; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 23 Jul 2013 23:04:04 -0000 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: > "" printed as > 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