From owner-freebsd-doc@FreeBSD.ORG Tue Jul 24 13:01:45 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 EA00316A420; Tue, 24 Jul 2007 13:01:45 +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 965F213C483; Tue, 24 Jul 2007 13:01:45 +0000 (UTC) (envelope-from simon@zaphod.nitro.dk) Received: from zaphod.nitro.dk (unknown [192.168.3.39]) by mx.nitro.dk (Postfix) with ESMTP id F06AF2DA1AB; Tue, 24 Jul 2007 12:43:56 +0000 (UTC) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id E2CDD1141D; Tue, 24 Jul 2007 14:43:56 +0200 (CEST) Date: Tue, 24 Jul 2007 14:43:56 +0200 From: "Simon L. Nielsen" To: "Peter N. M. Hansteen" , freebsd-doc@freebsd.org, Giorgos Keramidas , Mark Linimon , Chin-San Huang Message-ID: <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> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20070724123159.GA37556@abigail.blackend.org> User-Agent: Mutt/1.5.16 (2007-06-09) Cc: 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 13:01:46 -0000 [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. -- Simon L. Nielsen