From owner-freebsd-doc@FreeBSD.ORG Wed Jun 14 16:18:05 2006 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 31C7E16A9AC; Wed, 14 Jun 2006 16:18:05 +0000 (UTC) (envelope-from remko@freebsd.org) Received: from caelis.elvandar.org (caelis.elvandar.org [217.148.169.59]) by mx1.FreeBSD.org (Postfix) with ESMTP id B84BF43D49; Wed, 14 Jun 2006 16:18:04 +0000 (GMT) (envelope-from remko@freebsd.org) Received: from localhost (caelis.elvandar.org [217.148.169.59]) by caelis.elvandar.org (Postfix) with ESMTP id 9AD1292FD5E; Wed, 14 Jun 2006 18:18:03 +0200 (CEST) Received: from caelis.elvandar.org ([217.148.169.59]) by localhost (caelis.elvandar.org [217.148.169.59]) (amavisd-new, port 10024) with ESMTP id 14665-03; Wed, 14 Jun 2006 18:18:03 +0200 (CEST) Received: from [192.168.1.65] (a82-93-208-228.adsl.xs4all.nl [82.93.208.228]) by caelis.elvandar.org (Postfix) with ESMTP id 42AE392FC46; Wed, 14 Jun 2006 18:18:03 +0200 (CEST) Message-ID: <449036BA.2030803@FreeBSD.org> Date: Wed, 14 Jun 2006 18:18:02 +0200 From: Remko Lodder User-Agent: Thunderbird 1.5.0.4 (Macintosh/20060530) MIME-Version: 1.0 To: "Simon L. Nielsen" References: <20060613223307.GB1074@zaphod.nitro.dk> In-Reply-To: <20060613223307.GB1074@zaphod.nitro.dk> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: by the elvandar.org maildomain Cc: freebsd-doc@freebsd.org Subject: Re: Split and cleanup of Porters Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: remko@FreeBSD.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 Jun 2006 16:18:05 -0000 Simon L. Nielsen wrote: > Hey, > > For quite a while the Porters Handbook book.sgml has just been growing > and has for a while been way to big for comfort (at least to me), and > there has been talk on several occasions on splitting it. book.sgml > is currently over 10000 lines long and 354KB. Other than that, a big > part of the indentation is wrong, which is a pain at least for Emacs > users since it partly breaks automatic indentation. > > So, I would like to split book.sgml into chapter files like we have > for the FreeBSD Handbook and fix/style the indentation is the process. > > Currently the book.sgml,v file is 1.5MB which means that if we have to > repo-copy it for each of the 14 chapters that will result in 21MB > extra repository space, and due to style fixes "cvs annotate" still > won't be able to show the history right anyaway. Yes, 21MB isn't much > on today's disks, but if it doesn't buy you anything I don't reallly > see a reason to get the extra repo space. > > Therefor I suggest simply creating new files for each chapter without > repo-copy. The last pre-split version of book.sgml will still be in > the repository so you can run cvs annotate on that for history. > > So, are there strong objections to doing this, and/or do anyone have > better ideas for handling this? > No better ideas, go for it! -- Kind regards, Remko Lodder ** remko@elvandar.org FreeBSD ** remko@FreeBSD.org /* Quis custodiet ipsos custodes */