From owner-freebsd-doc@FreeBSD.ORG Wed Jul 25 08:52:21 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 83BB616A41F; Wed, 25 Jul 2007 08:52:21 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (pittgoth.com [205.134.163.206]) by mx1.freebsd.org (Postfix) with ESMTP id 4121813C494; Wed, 25 Jul 2007 08:52:21 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from localhost.fbsdsecure.org (net-ix.gw.ai.net [205.134.160.6]) (authenticated bits=0) by pittgoth.com (8.13.6/8.13.6) with ESMTP id l6P8Gkc6072422 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 25 Jul 2007 04:16:47 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Wed, 25 Jul 2007 04:16:29 -0400 From: Tom Rhodes To: "Simon L. Nielsen" Message-Id: <20070725041629.5d3e2f9e.trhodes@FreeBSD.org> In-Reply-To: <20070724124356.GB1065@zaphod.nitro.dk> 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> <20070724123159.GA37556@abigail.blackend.org> <20070724124356.GB1065@zaphod.nitro.dk> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; i386-portbld-freebsd7.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: linimon@lonesome.com, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org, chinsan@FreeBSD.org 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: Wed, 25 Jul 2007 08:52:21 -0000 On Tue, 24 Jul 2007 14:43:56 +0200 "Simon L. Nielsen" wrote: > [Moved entirely to doc since his is certainly a general discussion > now] > > On 2007.07.24 14:32:00 +0200, Marc Fonvieille wrote: > > > I also agree but Giorgos and Mark's ideas are interesting. > > Adding, removing, upgrading applications is one of the most important > > managing task for the normal user. I would even add this task is maybe > > the only one a normal user will use to perform on a frequent basis, once > > the system has been installed. So, it's difficult to imagine the > > Handbook without a chapter about these operations. > > Indeed. > > > But this normal user > > doesn't need to become a ports system expert, he just need to know > > simple/general methods to install, remove and upgrade his applications. > > The specific/expert methods (and tools?) should be the subject of > > specific articles or parts of the Porters Handbook. > > I think at least one tool should be documented in the Handbook so the > common user will be able to get by just reading the Handbook. I don't > have a problem at with more advanced stuff or other more uncommon > tools being moved out of the Handbook. > > Note that the Porters Handbook is for port maintainers / developers / > committers so this information for users really doesn't belong there, > as Mark already has pointed out. > > In any case, as usual, the person / people who decide to actually do > some cleanup in the area will get to decide what to do, and I doubt > that will be me. I've thought for awhile that some things could do with a clean up. Not just this chapter, but others as well. -- Tom Rhodes