From owner-freebsd-doc@FreeBSD.ORG Thu Jun 20 16:00:02 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 8C55C306 for ; Thu, 20 Jun 2013 16:00:02 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (gatekeeper.allbsd.org [IPv6:2001:2f0:104:e001::32]) by mx1.freebsd.org (Postfix) with ESMTP id 7CA9E1265 for ; Thu, 20 Jun 2013 16:00:01 +0000 (UTC) Received: from alph.d.allbsd.org (p3086-ipbf906funabasi.chiba.ocn.ne.jp [122.26.46.86]) (authenticated bits=128) by mail.allbsd.org (8.14.5/8.14.5) with ESMTP id r5KFxi5w055531 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 21 Jun 2013 00:59:54 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (localhost [127.0.0.1]) (authenticated bits=0) by alph.d.allbsd.org (8.14.5/8.14.5) with ESMTP id r5KFxf44071964; Fri, 21 Jun 2013 00:59:43 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Fri, 21 Jun 2013 00:55:00 +0900 (JST) Message-Id: <20130621.005500.1354772635358785822.hrs@allbsd.org> To: wblock@wonkity.com Subject: Re: RFC: Profiling and merging for the print edition From: Hiroki Sato In-Reply-To: References: X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.5 on Emacs 24.3 / Mule 6.0 (HANACHIRUSATO) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Fri_Jun_21_00_55_00_2013_389)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.97.4 at gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7 (mail.allbsd.org [133.31.130.32]); Fri, 21 Jun 2013 00:59:54 +0900 (JST) X-Spam-Status: No, score=-89.5 required=13.0 tests=CONTENT_TYPE_PRESENT, DIRECTOCNDYN,DYN_PBL,ONLY1HOPDIRECT,RCVD_IN_PBL,SAMEHELOBY2HOP, USER_IN_WHITELIST autolearn=no version=3.3.2 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on gatekeeper.allbsd.org Cc: 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: Thu, 20 Jun 2013 16:00:02 -0000 ----Security_Multipart(Fri_Jun_21_00_55_00_2013_389)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Warren Block wrote in : wb> My proposal for merging the ISBN branch and getting out of our wb> two-branch problem. wb> wb> First, profiling works. A demo file of the Porter's Handbook is here: wb> http://wonkity.com/~wblock/profiledemo/ wb> wb> After applying the patch, build either the online or print version of wb> the book with: wb> wb> make EDITION=online clean book.html wb> make EDITION=print clean book.html wb> wb> The "online" version includes all sections with edition="online" or an wb> edition not set. Please do not add a separate make variable for that. We already have FORMATS, and setting profiling variables (profile.attribute and profile.value in XSLT) based on it should work. Also, we should consider/discuss what kind of difference we need actually and should allow between the two first. Basically I am against marking up everything with "online" or "print" because it just makes the source files complicated. I think it is useful only for separating lengthy preface, edition history, and pgpkey list from the body in book.xml. wb> Immediately merge the ISBN branch to head wb> wb> Start using profiling in the entire Handbook wb> wb> When ready to print the book: wb> wb> branch ISBN wb> wb> in the branch, make only the changes absolutely needed for print wb> that cannot be done with profiling wb> wb> print the book wb> wb> the ISBN branch becomes historical, no new changes are merged to wb> it I agree with the above plan. We should work on content changes on head. -- Hiroki ----Security_Multipart(Fri_Jun_21_00_55_00_2013_389)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.13 (FreeBSD) iEYEABECAAYFAlHDJdQACgkQTyzT2CeTzy0+vQCeP1b3RLh7WRwGDeKARlharsGo Eg0An3QBq6aXW67pRdCbMMza6t8kLV2l =QLmk -----END PGP SIGNATURE----- ----Security_Multipart(Fri_Jun_21_00_55_00_2013_389)----