From owner-freebsd-doc@FreeBSD.ORG Tue Jul 24 17:46:59 2007 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8B86916A418; Tue, 24 Jul 2007 17:46:59 +0000 (UTC) (envelope-from peter@bsdly.net) Received: from skapet.datadok.no (skapet.datadok.no [194.54.107.19]) by mx1.freebsd.org (Postfix) with ESMTP id 2A36313C478; Tue, 24 Jul 2007 17:46:59 +0000 (UTC) (envelope-from peter@bsdly.net) Received: from thingy.bsdly.net ([10.168.103.11] helo=thingy.datadok.no.bsdly.net ident=peter) by skapet.datadok.no with esmtp (Exim 4.62) (envelope-from ) id 1IDOTK-0006Bg-2u; Tue, 24 Jul 2007 19:46:58 +0200 To: Doug Barton References: <200707190121.l6J1LOvd007607@repoman.freebsd.org> <20070719054803.GA1002@gothic.blackend.org> <469F1D0F.2090307@FreeBSD.org> <20070719125410.GA9766@kobe.laptop> <20070720101143.GB1002@gothic.blackend.org> <20070724081342.GA32106@soaustin.net> <20070724094216.GA1003@zaphod.nitro.dk> <87vecam7ym.fsf@thingy.datadok.no> <46A62652.6020208@FreeBSD.org> From: peter@bsdly.net (Peter N. M. Hansteen) Date: Tue, 24 Jul 2007 19:46:54 +0200 In-Reply-To: <46A62652.6020208@FreeBSD.org> (Doug Barton's message of "Tue, 24 Jul 2007 09:18:26 -0700") Message-ID: <876449eltd.fsf@thingy.datadok.no> User-Agent: Gnus/5.1007 (Gnus v5.10.7) XEmacs/21.4.19 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: freebsd-doc@freebsd.org, "Simon L. Nielsen" , Giorgos Keramidas , Mark Linimon , doc-committers@freebsd.org, Chin-San Huang Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml 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, 24 Jul 2007 17:46:59 -0000 Doug Barton writes: > management tools in the handbook is a bad idea. I think the problem is > where do we draw the line. You mentioned two issues, how to install > ports (which I don't think there is any dispute about) and how to > maintain them. If your idea of describing "how to maintain them" means > detailed descriptions of the operations of "how to maintain them" with > each of the tools available, then we disagree. I don't think that > scales, and I think it bloats the handbook with a lot of repetitive > information. I realize I probably sounded more than a little alarmist on this bit, and I apologize. It's been a while since I took a serious look at the non-firewalls parts of the handbook, but if a brush-up of the ports sections is needed, to me it sounds like we are not really that far apart. In fact it sounds like an interesting writing project which I might take a stab at once I'm done with the one I'm doing now. The time frame would be some time after Copenhagen (EuroBSDCon). > When I say "how to maintain them" I think we should describe in > general terms that there are various tools that can be used to do this > job, here is a little information about them, and here is where you > can find more detailed information. Yes, we're basically agreed here. Sorry for the noise. I'll be back whif I have something tangible to contribute. All the best, -- Peter N. M. Hansteen, member of the first RFC 1149 implementation team http://www.blug.linux.no/rfc1149/ http://www.datadok.no/ http://www.nuug.no/ "Remember to set the evil bit on all malicious network traffic" delilah spamd[29949]: 85.152.224.147: disconnected after 42673 seconds.