Date: Wed, 14 Jun 2006 00:33:07 +0200 From: "Simon L. Nielsen" <simon@FreeBSD.org> To: freebsd-doc@freebsd.org Subject: Split and cleanup of Porters Handbook Message-ID: <20060613223307.GB1074@zaphod.nitro.dk>
next in thread | raw e-mail | index | archive | help
--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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20060613223307.GB1074>