From owner-freebsd-doc@FreeBSD.ORG  Sun Jun  2 15:03:39 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-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 5132D459;
 Sun,  2 Jun 2013 15:03:39 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 by mx1.freebsd.org (Postfix) with ESMTP id 13F121D1A;
 Sun,  2 Jun 2013 15:03:38 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.7/8.14.7) with ESMTP id r52F3csG009162;
 Sun, 2 Jun 2013 09:03:38 -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 r52F3b3D009159;
 Sun, 2 Jun 2013 09:03:38 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Sun, 2 Jun 2013 09:03:37 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Gabor Kovesdan <gabor@FreeBSD.org>
Subject: Re: print edition (was Re: removing 'changes' section from the online
 edition)
In-Reply-To: <51AB59EB.4080400@FreeBSD.org>
Message-ID: <alpine.BSF.2.00.1306020853110.8625@wonkity.com>
References: <CAF6rxgmionFt8Z7mrN0_JciThfyL4AMXcChRHWX1m+DE51FYLQ@mail.gmail.com>
 <51AA31C7.4010202@FreeBSD.org>
 <alpine.BSF.2.00.1306011250320.1365@wonkity.com>
 <51AA57E8.2030105@FreeBSD.org>
 <alpine.BSF.2.00.1306011612580.3184@wonkity.com>
 <51AAFF0A.2060009@FreeBSD.org>
 <alpine.BSF.2.00.1306020751010.8625@wonkity.com>
 <51AB59EB.4080400@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]); Sun, 02 Jun 2013 09:03:38 -0600 (MDT)
Cc: freebsd-doc@freebsd.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 02 Jun 2013 15:03:39 -0000

On Sun, 2 Jun 2013, Gabor Kovesdan wrote:

> Em 02-06-2013 15:56, Warren Block escreveu:
>>> There's an XSLT stylesheet provided by DocBook that preprocesses the 
>>> markup and only leaves in the corresponding content. This is not enabled 
>>> by default, only if you set it up with a knob in the Makefile of the 
>>> actual document.
>> 
>> I'd like to try an actual test on the Handbook.  Is that feasible with what 
>> we have currently?  What specific changes need to be made to the Makefiles? 
> You have to mark up something with edition="print", then set this either in 
> Makefile or at the command line when calling make all:
> PROFILING+= --param profile.attribute "'edition'" --param profile.value "'print'"

That means "include elements marked with edition="print" and all 
unprofiled elements"?

For a print version, it might be easier to just go the opposite way: 
leave everything unprofiled as defaulting to print, and marking 
online-only sections as "online".

> You have to watch out that the DocBook sources are valid both with and 
> without the profiled element. For example, you cannot have two titles for the 
> section with different edition values since only one title is allowed. In 
> this case, you have to use the phrase element in the title.

That will probably be necessary for some things, like a print chapter 
that links to online-only chapters.

> Further reading: http://www.sagehill.net/docbookxsl/Profiling.html

Thanks!