From owner-freebsd-doc@FreeBSD.ORG Wed Jun 5 15:16:51 2013 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id D290E75E; Wed, 5 Jun 2013 15:16:51 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 90E971ECF; Wed, 5 Jun 2013 15:16:51 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id CFA1E14D2403; Wed, 5 Jun 2013 17:16:50 +0200 (CEST) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id bpCE7OfwivJQ; Wed, 5 Jun 2013 17:16:50 +0200 (CEST) Received: from [192.168.0.10] (54034B4D.catv.pool.telekom.hu [84.3.75.77]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 2664A14D2400; Wed, 5 Jun 2013 17:16:50 +0200 (CEST) Message-ID: <51AF5668.1080301@FreeBSD.org> Date: Wed, 05 Jun 2013 17:16:56 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:22.0) Gecko/20100101 Thunderbird/22.0 MIME-Version: 1.0 To: Hiroki Sato , wblock@wonkity.com Subject: Re: print edition References: <51AB59EB.4080400@FreeBSD.org> <51AB6D32.1060906@FreeBSD.org> <20130605.213409.1227556973787602992.hrs@allbsd.org> In-Reply-To: <20130605.213409.1227556973787602992.hrs@allbsd.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org 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: Wed, 05 Jun 2013 15:16:51 -0000 Em 05-06-2013 14:34, Hiroki Sato escreveu: > Gabor Kovesdan wrote > in<51AB6D32.1060906@FreeBSD.org>: > > ga> Em 02-06-2013 17:03, Warren Block escreveu: > ga> > That means "include elements marked with edition="print" and all > ga> > unprofiled elements"? > ga> Yes. In other words: exclude elements, whose edition is not print. > ga> > > ga> > For a print version, it might be easier to just go the opposite way: > ga> > leave everything unprofiled as defaulting to print, and marking > ga> > online-only sections as "online". > ga> In the print branch it is possible to just mark online parts but if we > ga> want to work with single source we need both ways since there are some > ga> parts that are print-only. But I guess that the most of the Handbook > ga> may be unprofiled. Maybe we are late for going to a totally single > ga> source solution now but imho, we should do it the next time. > > I agree that preface and the pgpkey section can be different between > the online and print version, but are there other parts like them? Probably few. Maybe the formatting conventions since I suspect they may be different in the print edition. > DocBook profiling will make the source complex, so we should try to > minimize the differences between the online and print version, and > separate the differences into different files wherever possible. The > profiling is like #ifdef in a C program. It is useful for small > parts, but using it too much just makes things complicated. I believe the online/print markup will be limited and applied to upper-level elements like sect1 and won't normally escalated down to finer-grained markup. The separation in files is a good idea. As for the version-specific markup, it would affect more parts but this is something that we have talked about for a long time. It wouldn't be just a support for the print edition but a desired feature. Gabor