From owner-freebsd-doc@FreeBSD.ORG Tue Jun 13 22:33:09 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 B585D16A47C for ; Tue, 13 Jun 2006 22:33:09 +0000 (UTC) (envelope-from simon@zaphod.nitro.dk) Received: from mx.nitro.dk (zarniwoop.nitro.dk [83.92.207.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 39D0043D49 for ; Tue, 13 Jun 2006 22:33:08 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: from zaphod.nitro.dk (unknown [192.168.3.18]) by mx.nitro.dk (Postfix) with ESMTP id B2C0D2D48BA for ; Tue, 13 Jun 2006 22:33:07 +0000 (UTC) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 991F611420; Wed, 14 Jun 2006 00:33:07 +0200 (CEST) Date: Wed, 14 Jun 2006 00:33:07 +0200 From: "Simon L. Nielsen" To: freebsd-doc@freebsd.org Message-ID: <20060613223307.GB1074@zaphod.nitro.dk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="St7VIuEGZ6dlpu13" Content-Disposition: inline User-Agent: Mutt/1.5.11 Subject: Split and cleanup of Porters Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 13 Jun 2006 22:33:09 -0000 --St7VIuEGZ6dlpu13 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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? --=20 Simon L. Nielsen --St7VIuEGZ6dlpu13 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.3 (FreeBSD) iD8DBQFEjz0jh9pcDSc1mlERAurPAJwPjQYihyojJ08u+3VRIt5izuyQrgCfeYEb Y62rDoNrEBqNilzQ9VMnqpo= =S2Hk -----END PGP SIGNATURE----- --St7VIuEGZ6dlpu13--