Date: Wed, 30 Jan 2013 20:43:44 +0100 From: Benedict Reuschling <bcr@FreeBSD.org> To: Gabor Kovesdan <gabor@FreeBSD.org> Cc: svn-doc-projects@FreeBSD.org, doc-committers@FreeBSD.org Subject: Re: svn commit: r40831 - in projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook: . preface Message-ID: <510977F0.2040106@FreeBSD.org> In-Reply-To: <51096FC6.2000205@FreeBSD.org> References: <201301301901.r0UJ1YY6051367@svn.freebsd.org> <51096FC6.2000205@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Am 30.01.13 20:08, schrieb Gabor Kovesdan: > Em 30-01-2013 20:01, Benedict Reuschling escreveu: >> Author: bcr Date: Wed Jan 30 19:01:33 2013 New Revision: 40831 >> URL:http://svnweb.freebsd.org/changeset/doc/40831 >> >> Log: Deactivate the build of the PGP Keys section from the >> appendix. This will not be part of the print edition, but will >> still be kept in the online version. > Are you sure that this is the best way of doing this? This will > make merges more difficult. I don't know if it has been discussed > somewhere but I'd prefer a single-source solution. We could add a > custom profiling attribute for online or print-only chunks. Well, there is the WITH_PGPKEYS variable that just uses the fingerprints for the print version. I could revert the above change, no problem. But what about other chapters? I'm working on removing the 8.x install chapter in that branch since the print edition will only cover 9.x. There are still many links to the old install chapter in many parts of the handbook. I planned to update them all to point to the bsdinstall chapter. However, it might make sense (not just for this chapter) to just keep links to old chapters in the online version that are removed in the print edition. I don't know how difficult it would be to add such a profiling attribute to every such link, but I guess it would be. I'm in favour of a single source solution, especially for merges back to the online version. Right now, we try to put all changes that make sense to both head and the book branch. However, there are going to be changes (like deleting non-9.x content) that will be made to the book branch sooner while keeping it for the online handbook. Of course this makes merging difficult later on. But my view on this is that at one point the print edition will become the new online version of the handbook, so everything that we delete now for the book will also be deleted for the online edition. The PGPkeys chapter can be reactivated easier than other changes. But I think we should discuss this now before both the branch and the online edition drift further apart. I don't have a problem to revert the above change, though if that is the consensus and a solution can be found that is easier to merge. Regards Benedict -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.8 (Darwin) Comment: GPGTools - http://gpgtools.org Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iEYEARECAAYFAlEJd/AACgkQTSZQLkqBk0h5MACg1pCso0sDYuO3EJazwKLkzS5p 9+sAoI97m8T8Sru3zS3/afLMTNVNJIoL =7ZdP -----END PGP SIGNATURE-----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?510977F0.2040106>