From owner-freebsd-doc@FreeBSD.ORG Tue Jul 23 23:28:22 2013 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 14BB4F01 for ; Tue, 23 Jul 2013 23:28:22 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id C116E2C50 for ; Tue, 23 Jul 2013 23:28:21 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r6NNSK6P061580; Tue, 23 Jul 2013 17:28:20 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r6NNSKZq061577; Tue, 23 Jul 2013 17:28:20 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Tue, 23 Jul 2013 17:28:20 -0600 (MDT) From: Warren Block To: Gabor Kovesdan Subject: Re: CFR: documentation rendered in PDF with FOP In-Reply-To: <51EF0A9D.8060109@FreeBSD.org> Message-ID: References: <51EE8750.7040208@FreeBSD.org> <51EF0A9D.8060109@FreeBSD.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Tue, 23 Jul 2013 17:28:20 -0600 (MDT) Cc: FBSD Doc project 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:28:22 -0000 On Wed, 24 Jul 2013, Gabor Kovesdan wrote: > On 2013.07.23. 23:11, Warren Block wrote: > >> There is something weird about bulleted lists and sub-lists, starting on >> page 35 of the PDF Handbook (page 7-9 of the content). Some entries in the >> first list are blank, the ones in the second list have an extra linefeed >> after the bullet. > It is a known issue and is actually the result of misplaced indexterms, not a > bug in the rendering. I've already fixed some of them in the English docs but > translations still has to be fixed and there may be slightly different cases, > which I haven't caught yet. We should document in fdp-primer that indexterms > should be put right inside of the text after the referred word. Not between > paragraphs, not into , not into but right inside > after the referred word without leaving a single a space. If they are > not in , it can cuase such problems. And if you put a space before the > indexterm, there may be a page break and you get a wrong page number in the > index. But the probability of this latter is very low, the former thing is > more important. Presently, indexes and indeterms are not even mentioned in the FDPP. I'll start a list of things to add after the doc slush. If you or anyone else have found things which are not documented well or at all in the FDPP, please let me know or enter a PR.