From owner-freebsd-doc@FreeBSD.ORG Thu Jul 19 08:13:06 2007 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id A0B4D16A403 for ; Thu, 19 Jul 2007 08:13:06 +0000 (UTC) (envelope-from dougb@FreeBSD.org) Received: from mail2.fluidhosting.com (mx21.fluidhosting.com [204.14.89.4]) by mx1.freebsd.org (Postfix) with SMTP id 4E91013C474 for ; Thu, 19 Jul 2007 08:13:06 +0000 (UTC) (envelope-from dougb@FreeBSD.org) Received: (qmail 16775 invoked by uid 399); 19 Jul 2007 08:13:05 -0000 Received: from localhost (HELO lap.dougb.net) (dougb@dougbarton.us@127.0.0.1) by localhost with ESMTP; 19 Jul 2007 08:13:05 -0000 X-Originating-IP: 127.0.0.1 Message-ID: <469F1D0F.2090307@FreeBSD.org> Date: Thu, 19 Jul 2007 01:13:03 -0700 From: Doug Barton Organization: http://www.FreeBSD.org/ User-Agent: Thunderbird 2.0.0.4 (X11/20070617) MIME-Version: 1.0 To: Marc Fonvieille References: <200707190121.l6J1LOvd007607@repoman.freebsd.org> <20070719054803.GA1002@gothic.blackend.org> In-Reply-To: <20070719054803.GA1002@gothic.blackend.org> X-Enigmail-Version: 0.95.1 OpenPGP: id=D5B2F0FB Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: freebsd-doc@freebsd.org, doc-committers@FreeBSD.org, Chin-San Huang , cvs-doc@FreeBSD.org, cvs-all@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 Reply-To: freebsd-doc@freebsd.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Jul 2007 08:13:06 -0000 Marc Fonvieille wrote: > On Thu, Jul 19, 2007 at 01:21:23AM +0000, Chin-San Huang wrote: >> chinsan 2007-07-19 01:21:23 UTC >> >> FreeBSD doc repository >> >> Modified files: >> en_US.ISO8859-1/books/handbook/ports chapter.sgml >> Log: >> - Introduce another way for upgrading packages and ports using bpkg(8). >> > [...] > > I'm not sure the Handbook has the vocation to talk about all available > tools to manage ports and packages. What is bpkg? Is it a reliable > tool that has been extensively tested and recommended by the ports > developers? This port has been added on 24 June 2007... > Now, the Handbook talk about: portupgrade, portmanager and bpkg, and I'm > sure some will object we should talk about portmaster. > According to what I see in /usr/ports/UPDATING we should only document > both portupgrade and portmaster, then point people to ports/ports-mgmt/ > if they want to experiment other tools. FWIW, I (with portmaster author hat on) am sort of ambivalent about this issue. I've avoided adding anything to that chapter about portmaster because my personal feeling is that a laundry list of tools isn't useful to the user, especially if all the descriptions are the same size as the ones that are there now. What I think would be more useful (and again, I'm speaking only for myself) would be a list of tools available with a brief description of each, and links to outside sources (web pages, pkg-descr files, etc.) where an interested user can get more information. I do think that letting our users know that there are tools available is a good thing, I don't think mini-manuals for each tool is appropriate in that context. If anyone else thinks that this is a good idea, I'd be happy to contribute a paragraph on portmaster, and help with rewriting that section if desired. Doug PS, I set reply-to the -doc list since this is more of a meta-discussion about the idea rather than a discussion about the commit. -- This .signature sanitized for your protection